Objetivo

Criar um laboratório Protheus reproduzível para estudo e desenvolvimento, usando Docker Compose para organizar License Server, PostgreSQL, DBAccess e AppServer.

O foco do projeto é reduzir setup manual, versionar configuração de ambiente e registrar decisões operacionais que normalmente ficam dispersas durante a montagem de um ambiente Protheus.

Estado atual

  • Ambiente base validado em Docker Compose
  • Serviços license, postgres-iniciado, dbaccess-postgres e appserver documentados
  • Geração automatizada de dbaccess.ini, odbc.ini e odbcinst.ini
  • Setup local automatizado com preservação de arquivos de trabalho
  • Validação de arquivos, variáveis, portas e coerência entre configurações
  • Testes automatizados dos scripts com Docker simulado
  • WebApp e porta TCP do AppServer parametrizados via .env

Decisões de engenharia

  • Manter artefatos Protheus fora do Git, incluindo RPO e arquivos de systemload
  • Versionar apenas modelos, scripts e documentação operacional
  • Gerar a configuração efetiva do DBAccess com dbaccesscfg
  • Usar healthcheck no PostgreSQL antes da inicialização do DBAccess
  • Manter o primeiro lab com escopo controlado, sem REST, CI/CD ou observabilidade

Próximas fases

O roadmap editorial foi organizado em cinco partes:

  1. Ambiente Protheus com Docker — validado e publicado
  2. Organização do projeto e boas práticas com Docker Compose — validado
  3. Automação e configuração local — validado
  4. Dados e manutenção do ambiente — planejado
  5. Validação DevOps e limites do laboratório — planejado

Serviços REST, observabilidade centralizada, pipelines corporativos e integração com fontes AdvPL/TL++ ficam reservados para laboratórios futuros, mantendo este primeiro ambiente simples e estável.