Fiscal Flow Client - Docker

1. Requisitos

Sistema operacionalLinux
Arquiteturas disponíveisarm32, arm64, amd64
Forma de instalação/atualizaçãolinha de comando e docker-compose.yml
Dockerversão mínima 20.10.22, build 3a2c30b
Fiscal Flow Clientmaior ou igual a 2.7.0.0
Exposição na WEBRecomendamos o uso do CLIENT somente LOCAL. Não expor acesso ao cliente na WEB.

2. Instalação e atualização

O Client em Docker, pode ser utilizado de duas formas. Container Individual e Container Replicável.

2.1. Container Individual
  • Container individual: possui todas as funcionalidades padrão do Client, não sendo escalável
  • Banco de dados: SQlite ou SQLServer


Exemplo de utilização:

2.1.1. Instalação

  • Baixar o docker-compose.yml:


  • Realizar o login no ACR (Azure Container Registry):

docker login -u <usuario> -p <token> acrfflowclient.azurecr.io

<usuario> é o usuário disponibilizado para acesso ao ACR;
<token> é o token disponibilizado para acesso ao ACR;

Para obter usuário e token, deve ser criada uma solicitação ao suporte, informando cliente e motivo.
Qualquer informação adicional, será solicitada posteriormente.

  • Para executar o comando de inicialização, na pasta onde está localizado o arquivo docker-compose.yml, executar o comando:
FFC_VERSION=<acr-image-tag> docker compose up -d

<acr-image-tag> é a versão do Client que irá ser executada. Ex: 2.7.0.0

2.1.2. Atualização

  • Baixar o docker-compose.yml:


  • Executar o comando para derrubar o container

FFC_VERSION=0 docker compose down

  • Realizar o login no ACR (Azure Container Registry):

docker login -u <usuario> -p <token> acrfflowclient.azurecr.io

<usuario> é o usuário disponibilizado para acesso ao ACR;
<token> é o token disponibilizado para acesso ao ACR;

Para obter usuário e token, deve ser criada uma solicitação ao suporte, informando cliente e motivo.
Qualquer informação adicional, será solicitada posteriormente.


  • Para executar o comando de inicialização, na pasta onde está localizado o arquivo docker-compose.yml, executar o comando:
FFC_VERSION=<acr-image-tag> docker compose up -d

<acr-image-tag> é a versão do Client que irá ser executada. Ex: 2.7.0.0

 

2.2. Container Replicável
  • Container principal pré-definido: executor das tarefas em segundo plano.
  • Containers replicáveis: possuem as demais funcionalidades do Client, sem a execução de tarefas em segundo plano, que será de responsabilidade do container principal.
  • Banco de dados: somente SQL Server


Exemplo de utilização:


2.2.1. Instalação


  • Realizar o login no ACR (Azure Container Registry):

docker login -u <usuario> -p <token> acrfflowclient.azurecr.io

<usuario> é o usuário disponibilizado para acesso ao ACR;
<token> é o token disponibilizado para acesso ao ACR;

Para obter usuário e token, deve ser criada uma solicitação ao suporte, informando cliente e motivo.
Qualquer informação adicional, será solicitada posteriormente.


  • Para executar o comando de inicialização, na pasta onde está localizado o arquivo docker-compose.yml, executar o comando:
FFC_VERSION=<acr-image-tag> FFC_SCALE=<replicas> FFC_PORT_RANGE=<port-range> docker compose up -d

<acr-image-tag> é a versão do Client que irá ser executada. Ex: 2.7.0.0

<replicas> é a quantidade de containers replicados além do container principal. Ex: 5

<port-range> é o range de portas que serão utilizadas nas réplicas, sendo assim necessitando ser um range de portas maior ou igual à quantidade de réplicas. Ex: 30001-30005


  • Acessar o endereço https://localhost:8089 e realizar as configurações do Client através do container principal. Aguardar em torno de 1 min para os demais containers obterem as mesmas configurações automaticamente.

 

2.2.2. Atualização


  • Executar o comando para derrubar os containers
FFC_VERSION=0 FFC_SCALE=0 FFC_PORT_RANGE=0 docker compose down

  • Realizar o login no ACR (Azure Container Registry):

docker login -u <usuario> -p <token> acrfflowclient.azurecr.io

<usuario> é o usuário disponibilizado para acesso ao ACR;
<token> é o token disponibilizado para acesso ao ACR;

Para obter usuário e token, deve ser criada uma solicitação ao suporte, informando cliente e motivo.
Qualquer informação adicional, será solicitada posteriormente.


  • Para executar o comando de inicialização, na pasta onde está localizado o arquivo docker-compose.yml, executar o comando:
FFC_VERSION=<acr-image-tag> FFC_SCALE=<replicas> FFC_PORT_RANGE=<port-range> docker compose up -d

<acr-image-tag> é a versão do Client que irá ser executada. Ex: 2.7.0.0

<replicas> é a quantidade de containers replicados além do container principal. Ex: 5

<port-range> é o range de portas que serão utilizadas nas réplicas, sendo assim necessitando ser um range de portas maior ou igual à quantidade de réplicas. Ex: 30001-30005

 

 

  • Sem rótulos