Sua chave de acesso e a conexão com seu banco de dados. Um valor ausente ou inválido impede a inicialização.
O Human Plugin lê sua configuração do ambiente uma única vez, na inicialização. Alterar um valor exige reiniciar o container.
Referência rápida
O .env mínimo para um banco de dados que usa os valores padrão abaixo:
HUMAN_API_ACCESS_KEY=<your access key>
POSTGRES_ADDRESS_HOST=<database host>
POSTGRES_PASSWORD=<database password>
Chave de acesso
| Variável | Obrigatória | Observações |
|---|---|---|
HUMAN_API_ACCESS_KEY | Sim | Sua chave de acesso. Ela conecta a instalação à Unico e identifica sua conta. Sem espaços em branco nem caracteres de controle. Nunca é registrada em log |
A chave de acesso é um segredo. Mantenha-a no seu cofre de segredos e injete-a no container em tempo de execução.
Conexão com o banco de dados
| Variável | Obrigatória | Padrão | Observações |
|---|---|---|---|
POSTGRES_ADDRESS_HOST | Sim | Nome do host ou endereço IP do seu servidor PostgreSQL | |
POSTGRES_PASSWORD | Sim | Sem espaços em branco, aspas simples, barras invertidas nem caracteres de controle. O Human Plugin se recusa a iniciar se houver algum, sem registrar o valor em log | |
POSTGRES_ADDRESS_PORT | Não | 5432 | |
POSTGRES_USER | Não | postgres | Use um role dedicado ao Human Plugin |
POSTGRES_DATABASE | Não | human_plugin | Use um banco de dados dedicado ao Human Plugin |
POSTGRES_SSL_MODE | Não | require | Use disable somente quando o PostgreSQL rodar no mesmo host ou como sidecar |
O banco de dados deve ser usado exclusivamente pelo Human Plugin. O role precisa de permissão para criar tabelas nele: o Human Plugin cria e atualiza as próprias tabelas na inicialização, antes de aceitar requisições.
A senha é um segredo. Mantenha-a no seu cofre de segredos, como faz com a chave de acesso.
Todo o resto
A imagem define todos os demais valores. Não defina outras variáveis a menos que a Unico peça: elas não fazem parte da configuração suportada.
Exemplo
docker run -d --name human-plugin --stop-timeout 60 -p 127.0.0.1:8080:8080 \
-e HUMAN_API_ACCESS_KEY \
-e POSTGRES_ADDRESS_HOST=db.internal \
-e POSTGRES_USER=human_plugin \
-e POSTGRES_PASSWORD \
pkg.unico.run/human-plugin-api:latest
-e NOME sem valor repassa a variável do seu shell, de modo que os segredos não aparecem na linha de comando.