Il presente articolo illustra come utilizzare il TrustedFiscalService come container Docker.
Prerequisiti
- Il supporto per Docker è disponibile a partire dalla versione 1.2.5.
- Conoscenza del funzionamento di Docker, in particolare dei volumi Docker
Informazioni
Le immagini Docker (anche per l’architettura ARMx64) sono disponibili su hub.docker.com.
L'immagine può essere caricata da Docker Hub mediante il seguente comando:
docker pull retailforce/trusted-fiscal-service:latest
Per accedere al servizio REST, è necessario mappare la porta 7678 (o 7677 per HTTPS) all’interno del container Docker.
Creazione dei volumi
Prima di avviare il container Docker, creare i volumi per garantire la persistenza dei dati oltre il ciclo di vita del container:
docker volume create fiscal-service-data docker volume create fiscal-service-config
Comando di avvio
Il container Docker può quindi essere avviato utilizzando il seguente comando:
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
Montaggio diretto
Per una gestione più efficiente, si raccomanda di montare direttamente le directory dei dati utilizzando percorsi assoluti:
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
Nota: assicurarsi che le directory esistano già e che dispongano dei permessi corretti.
Estrazione dei dati dal container
Per recuperare i file e i log generati o utilizzati da RetailForce all’interno del container Docker, segua questi passaggi:
Attenzione: durante questa procedura, il RetailForce Middleware deve essere in esecuzione; in caso contrario, verranno esportate directory vuote.
-
Creare una directory nella posizione desiderata:
mkdir /path/to/your/local/destination/RetailForce_Directory
-
Copiare le directory:
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
Nota: se sono state apportate modifiche dopo l’esportazione dei dati sul desktop, sarà necessario eseguire nuovamente questi comandi per ottenere i dati aggiornati.
Aggiornamento da versioni precedenti alla 1.2.13
Nelle versioni precedenti, la configurazione del container non era mappata nel comando di avvio, pertanto il file deve essere copiato dal container in anticipo (ad esempio in un volume creato in precedenza):
docker cp trusted-fiscal-service:/app/Config/fiscalService.config.json fiscal-service-config
Accesso al servizio
Una volta avviato il container, è possibile accedere al servizio all’indirizzo URL seguente:
http://localhost:7678/swagger/index.html
Questo articolo è stato tradotto automaticamente.
Commenti
0 commenti
Accedi per aggiungere un commento.