Este artigo descreve como utilizar o TrustedFiscalService como um contentor Docker.

Pré-requisito 

• O suporte ao Docker está disponível desde a versão 1.2.5. 
• Conhecimentos sobre o funcionamento do Docker, nomeadamente sobre os volumes do Docker

Informação

As imagens do Docker (também para a arquitetura ARMx64) estão disponíveis em hub.docker.com.

A imagem pode ser carregada a partir do Docker Hub com o seguinte comando:

docker pull retailforce/trusted-fiscal-service:latest

Para aceder ao serviço REST, é necessário mapear a porta 7678 (ou 7677 para HTTPS) no contentor Docker.

Criação de volumes

Antes de executar o contentor Docker, crie os volumes para garantir que os dados persistam para além do ciclo de vida do contentor:

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

Comando de arranque

O contentor Docker pode então ser iniciado utilizando o seguinte 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

Montagem direta

Recomenda-se, para um melhor manuseamento, ligar diretamente os diretórios de dados utilizando caminhos absolutos:

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

Extração de dados do contentor

Para recuperar ficheiros e registos criados ou utilizados pelo RetailForce a partir do contentor Docker, siga estes passos:

1. Crie um diretório no local da sua escolha:

   mkdir /path/to/your/local/destination/RetailForce_Directory

2. Copie os diretórios:

   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

Atualização a partir de versões anteriores à 1.2.13

Nas versões anteriores, a configuração do contentor não era mapeada no comando de arranque, pelo que o ficheiro deve ser copiado previamente do contentor (por exemplo, para um volume criado anteriormente):

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

Aceder ao serviço

Assim que o contentor estiver em execução, deverá conseguir aceder ao serviço através do seguinte URL:

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

Este artigo foi traduzido automaticamente.