Aller au contenu principal

Linux – TrustedFiscalService sous forme de conteneur Docker

DEVELOPMENT
  • Mise à jour

Cet article décrit comment utiliser le TrustedFiscalService sous forme de conteneur Docker.

Prérequis 

  • La prise en charge de Docker est disponible depuis la version 1.2.5. 
  • Connaissances en matière d’utilisation de Docker, notamment des volumes Docker

Informations

Des images Docker (y compris pour l’architecture ARMx64) sont disponibles sur hub.docker.com.

L’image peut être chargée depuis Docker Hub à l’aide de la commande suivante :

docker pull retailforce/trusted-fiscal-service:latest

Pour accéder au service REST, vous devez mapper le port 7678 (ou 7677 pour HTTPS) dans le conteneur Docker.

Création de volumes

Avant de lancer le conteneur Docker, créez les volumes afin de garantir la persistance des données au-delà du cycle de vie du conteneur :

docker volume create fiscal-service-data
docker volume create fiscal-service-config

Commande de démarrage

Le conteneur Docker peut ensuite être lancé à l'aide de la commande suivante :

docker run --name trusted-fiscal-service -p 7678:7678 -d -v fiscal-service-data:/usr/share/RetailForce -v fiscal-service-config:/app/Config retailforce/trusted-fiscal-service:latest
Attention : le répertoire /usr/share/RetailForce doit être mappé localement au volume « fiscal-service-data ». Il en va de même pour le fichier de configuration, qui doit être mappé au volume « fiscal-service-config ».

Montage direct

Pour une meilleure gestion, il est recommandé de lier directement les répertoires de données à l’aide de chemins absolus :

docker run --name trusted-fiscal-service -p 7678:7678 -d -v /absolute/path/to/fiscal-service-data:/usr/share/RetailForce -v /absolute/path/to/fiscal-service-config:/app/Config retailforce/trusted-fiscal-service:latest

Remarque : assurez-vous que les répertoires existent déjà et qu’ils disposent des droits d’accès appropriés.

Extraction des données du conteneur

Pour récupérer les fichiers et les journaux créés ou utilisés par RetailForce à partir du conteneur Docker, procédez comme suit :

Attention : au cours de ce processus, le RetailForce Middleware doit être actif ; dans le cas contraire, des répertoires vides seront exportés.

  1. Créez un répertoire à l’emplacement de votre choix : 
    mkdir /path/to/your/local/destination/RetailForce_Directory
  2. Copiez les répertoires : 
    docker cp trusted-fiscal-service:/usr/share/RetailForce /path/to/your/local/destination/RetailForce_Directory/fiscal-service-data
docker cp trusted-fiscal-service:/app/Config /path/to/your/local/destination/RetailForce_Directory/fiscal-service-config

Remarque : si des modifications ont été apportées après l’exportation des données vers le bureau, vous devrez réexécuter ces commandes pour obtenir les données mises à jour.

Mise à jour à partir d’une version antérieure à la 1.2.13

Dans les versions antérieures, la configuration du conteneur n’était pas prise en compte dans la commande de démarrage ; le fichier doit donc être copié au préalable depuis le conteneur (par exemple, dans un volume créé au préalable) :

docker cp trusted-fiscal-service:/app/Config/fiscalService.config.json fiscal-service-config

 

Attention : vous devez copier la configuration depuis le conteneur Docker vers Docker avant de quitter (ou de remplacer le conteneur), sinon le fichier sera perdu !

Accès au service

Une fois le conteneur en cours d’exécution, vous devriez pouvoir accéder au service à l’URL suivante :

http://localhost:7678/swagger/index.html

Cet article a été traduit automatiquement.

Articles associés

Commentaires

0 commentaire

Vous devez vous connecter pour laisser un commentaire.

Réalisé par Zendesk