Em Desenvolvimento
Esta documentação ainda está em desenvolvimento. Agradecemos sua paciência!
Pular para o conteúdo principal
Versão: 03.008.000 🚧 (em desenvolvimento)

Configuração via arquivo .env

A partir da versão 03.008.000, a configuração que muda por instalação é centralizada em um único arquivo .env, na pasta do pacote de instalação. Esse .env é compartilhado pelos três componentes do ambiente — toolkit, Content App e Portal.

Em resumo

Você não edita mais o alfresco-global.properties nem espalha valores pelo docker-compose.yml. Você edita o .env.

Como funciona​

  • O .env é a fonte da verdade dos valores de configuração da instalação (banco, hosts, e-mail, chaves htf.*, tokens de integração, código de instalação, etc.).
  • Ao subir, o run.sh escreve os valores do .env no alfresco-global.properties (que vai versionado vazio, como modelo) e injeta as variáveis de ambiente nos containers.
  • O alfresco-global.properties versionado passa a conter apenas a infraestrutura interna fixa (driver do banco, nomes internos de serviço, mensageria, agendamentos) e as chaves que o Java lê, vazias — preenchidas a partir do .env.

Subindo o ambiente​

cp .env.example .env     # primeira vez: copie o modelo
# edite o .env com os valores da sua instalação
./run.sh start           # sobe o ambiente

Para conferir os valores aplicados ao alfresco-global.properties:

./run.sh sync

O comando sync é idempotente: se o valor já corresponde ao do .env, nada muda.

aviso

Após alterar qualquer valor no .env, é necessário subir novamente (ou reiniciar) os serviços para aplicar.

Cuidados ao preencher o .env​

  • Não envolva os valores em aspas. O valor é literal até o fim da linha. Caracteres como @, :, /, espaços e acentos não precisam de escape (ex.: MAIL_PASSWORD=ab@c123def).
  • Evite o caractere $ nas variáveis usadas pelo Docker Compose (como DB_PASSWORD, DB_USERNAME, DB_NAME, INSTALLATION_CODE, PORTAL_JWT_SECRET, PUBLIC_BASE_URL, SOLR_SHARED_SECRET, HOST_IP).
  • A DB_PASSWORD é usada na URL de conexão do Portal — evite os caracteres @ : / ? # nessa senha, pois quebram a URL.
  • Integrações que você não usa (token vazio): deixe a variável vazia no .env.
Pré-requisito de imagem

Esta versão lê várias chaves htf.* a partir do ambiente. Use as imagens prestobr/toolkit-* desta versão em diante. Uma imagem de versão anterior combinada com o modelo novo faria essas chaves virem vazias.