e-SUS PEC em Docker

Estrutura Docker para instalar e atualizar o e-SUS PEC em ambientes de treinamento, produção ou cloud.

Requisitos

• Docker Engine
• Docker Compose

📥 Instalação

Prepare a configuração uma vez:

cp .env.example .env

Revise o .env e escolha o modo de instalação. O Makefile chama o scripts/build.sh, que baixa automaticamente a versão mais recente do PEC quando nenhum JAR é informado.

Treinamento

make training

Produção

make production

Banco externo

Configure a conexão PostgreSQL no .env e execute:

make external

Cloud

cp cloud/.env.example cloud/.env
make cloud

No modo cloud, a porta interna 80 é publicada em HTTP_PORT e a porta 443 em HTTPS_PORT. Em um proxy reverso, use o host Docker e HTTP_PORT.

Para usar uma versão específica, informe o arquivo local ou a URL do JAR:

make training JAR=eSUS-AB-PEC-5.x.x-Linux64.jar

Use o mesmo argumento JAR=<arquivo-ou-url> com production, external, cloud ou restore.

Consulte todos os alvos e variáveis em Comandos make, incluindo o passo a passo para executar a PEC demo com o backup-base sintético do repositório.

Migração de versão

Important

No Linux, a migração do banco pode ter menos verificações do que no instalador para Windows. Toda atualização deve ser testada previamente em um ambiente que possa ser descartado. Antes de atualizar a produção, gere e valide um backup recuperável para garantir o fallback caso a migração falhe ou apresente incompatibilidades.

Fluxo obrigatório:

1. Backup: gere e valide o backup da versão atual.
2. Atualização: execute a migração primeiro em um ambiente de teste.
3. Validação: confirme a inicialização, os dados e os fluxos críticos do PEC.
4. Produção: faça um novo backup e somente então repita a atualização validada.

Para atualizar uma instalação com banco local:

make update-local

Para banco externo, use make update-external.

Restauração de backup

No modo cloud, um backup pode ser restaurado antes da inicialização:

make restore BACKUP=caminho/arquivo.backup

Para restaurar o base.backup da PEC 5.5.22 e criar uma instância de demonstração local, siga Como executar a PEC demo.

Documentação

• Procedimento operacional padrão
• Base de conhecimento operacional
• Opções do pacote Java
• Problemas conhecidos
• Investigação de problemas
• Geração do codebase para análise
• Comandos make
• Como executar a PEC demo

Patrocínio

Agradecimentos à equipe NoHarm pelo apoio ao projeto.