Tu clave de acceso y la conexión con tu base de datos. Un valor ausente o no válido detiene el arranque.
Human Plugin lee su configuración del entorno una sola vez, al arrancar. Cambiar un valor requiere reiniciar el contenedor.
Referencia rápida
El .env mínimo para una base de datos que usa los valores predeterminados de abajo:
HUMAN_API_ACCESS_KEY=<your access key>
POSTGRES_ADDRESS_HOST=<database host>
POSTGRES_PASSWORD=<database password>
Clave de acceso
| Variable | Obligatoria | Notas |
|---|---|---|
HUMAN_API_ACCESS_KEY | Sí | Tu clave de acceso. Conecta la instalación con Unico e identifica tu cuenta. Sin espacios en blanco ni caracteres de control. Nunca se registra en los logs |
La clave de acceso es un secreto. Guárdala en tu almacén de secretos e inyéctala en el contenedor en tiempo de ejecución.
Conexión con la base de datos
| Variable | Obligatoria | Valor predeterminado | Notas |
|---|---|---|---|
POSTGRES_ADDRESS_HOST | Sí | Nombre de host o dirección IP de tu servidor PostgreSQL | |
POSTGRES_PASSWORD | Sí | Sin espacios en blanco, comillas simples, barras invertidas ni caracteres de control. Human Plugin se niega a arrancar si el valor contiene alguno, sin registrar el valor | |
POSTGRES_ADDRESS_PORT | No | 5432 | |
POSTGRES_USER | No | postgres | Usa un rol dedicado a Human Plugin |
POSTGRES_DATABASE | No | human_plugin | Usa una base de datos dedicada a Human Plugin |
POSTGRES_SSL_MODE | No | require | Usa disable solo cuando PostgreSQL se ejecuta en el mismo host o como sidecar |
La base de datos debe ser usada únicamente por Human Plugin. El rol necesita permiso para crear tablas en ella: Human Plugin crea y actualiza sus propias tablas al arrancar, antes de aceptar solicitudes.
La contraseña es un secreto. Guárdala en tu almacén de secretos, igual que la clave de acceso.
Todo lo demás
La imagen define todos los demás valores. No definas otras variables a menos que Unico te lo pida: no forman parte de la configuración soportada.
Ejemplo
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 NAME sin valor pasa la variable desde tu shell, de modo que los secretos no aparecen en la línea de comandos.