O objetivo desse repositório é ser um ponto de partida para criação de ambientes de desenvolvimento Fluig utilizando nossas imagens docker das soluções TOTVS.
- Esse repositório não possui qualquer relação com a TOTVS S/A
- As imagens NÃO devem ser usadas em ambientes de produção
- Utilize apenas como ambiente de desenvolvimento
- Ao utilizar você concorda com os termos da licença MIT
- Habilitar o WSL2
- Instalar o Docker Desktop ou configurar manualmente o docker na distribuição linux do WSL2
- Instalar e configurar as últimas versões do docker e docker compose
- Instalar o Docker Desktop
- Os containers precisam de pelo ao menos 4 GB de RAM para execução sem erros
- Se estiver usando o Docker Desktop, habilite a memória na área de recursos
- VS Code (instalar plugin Docker)
- Node.js
- Azure Data Studio
-
Defina as variáveis de ambiente no arquivo .env. Todas as variáveis disponíveis estão documentadas no docker hub.
-
Mantenha a variável FLUIG_DISABLED com o valor true
-
Criação de uma rede para os containers
docker network create sample-docker-network
- Download das imagens e criação dos containers
docker-compose up
- Acesse a instância do SQL Server. Recomendamos utilizar o Azure Data Studio.
- Servidor: localhost
- Porta: conforme a variável MSSQL_PORT
- Usuário: sa
- Senha: conforme a variável SA_PASSWORD
- Crie o banco de dados do Fluig com o mesmo nome definido na variável FLUIG_DB_ALIAS
CREATE DATABASE [fluig_db] COLLATE Latin1_General_CI_AS;
ALTER DATABASE [fluig_db] SET READ_COMMITTED_SNAPSHOT ON;
- Pare os containers:
docker-compose stop
-
Mude o valor da variável FLUIG_DISABLED para false
-
Inicie novamente os containers:
docker-compose up
- Acesse o Fluig considerando os valores definidos nas variáveis FLUIG_CONTAINER_NAME e FLUIG_PORT. Exemplo: http://mypc-name:7080
-
Se você também for subir nossos containers do Protheus, remova o mssql e o license do docker-compose e configure as variáveis de ambiente para utilizar os mesmos containers do ERP. Nesse caso, crie o banco de dados do Fluig no mesmo container do SQL Server do ambiente Protheus.
-
A TOTVS ainda não possui um plugin oficial do VS Code para o Fluig. Diante disso, recomendamos codificar no VS Code e utilizar o Eclipse para trabalhar com diagramas e fazer deploys no servidor.
-
Por questões de performance, o realtime e o indexer rodam no mesmo container do Fluig
-
Após o primeiro uso, sempre utilize o comando docker-compose up --no-recreate para não reinstalar o fluig a cada inicialização
-
Instale o Node.js e utilize os scripts NPM para subir e parar os containers de forma visual através do VS Code
-
Acesse a página das imagens no Docker Hub para conhecer todas as variáveis de ambiente e scripts disponíveis.
Caso encontre alguma dificuldade ou tenha sugestões de melhorias, não deixe de compartilhar conosco através da seção de issues.