Ejecuta Human Plugin en tu infraestructura

Un contenedor y una base de datos PostgreSQL en tu red, y ya estás conectado a Unico.

Markdown

Requisitos

Requisito	Detalle
Runtime de contenedores	Docker, Docker Compose o Kubernetes. La imagen se construye para linux/amd64 y linux/arm64 y se ejecuta sin privilegios de root
PostgreSQL	Versión 16 o posterior. Una base de datos usada solo por Human Plugin, accesible con usuario y contraseña. SSL es obligatorio por defecto
HTTPS de salida	Hacia Unico. Consulta Red y seguridad
Entrada	Puerto 8080, HTTP plano, solo desde tu back-end
Secretos	Tu clave de acceso y la contraseña de la base de datos

Requisitos de hardware

El mínimo para ejecutar Human Plugin con hasta 1.500 transacciones por minuto, con selfies de hasta 800 KB.

Human Plugin

Recurso	Mínimo
CPU	1 vCPU por réplica
Memoria	1 GB por réplica

Para más volumen, añade una réplica por cada 1.500 transacciones por minuto. También sugerimos ejecutar más de una réplica, para que Human Plugin siga disponible mientras una se reinicia.

PostgreSQL

Recurso	Mínimo
Versión	16
CPU	2 vCPU
Memoria	4 GB
Disco	SSD

Para estimar el espacio en disco, calcula unos 1,7 KB por proceso × procesos por día × los días que conserves, más un 30 %.

Red

HTTPS de salida (puerto 443) hacia Unico. Consulta Red y seguridad.

La imagen

Human Plugin se publica como pkg.unico.run/human-plugin-api:latest. Ejecuta siempre la etiqueta latest, que es la versión actual. Descárgala con las credenciales del registry (usuario y token) que te entrega Unico. Consulta Requisitos previos y acceso.

Orden del despliegue

1. Crea la base de datos dedicada y un rol para Human Plugin.
2. Define la configuración, con los secretos de tu almacén de secretos.
3. Inicia el contenedor con Docker Compose o Kubernetes, con un tiempo de espera de parada de al menos 60 segundos.
4. Espera a que GET /health/ready responda 200 antes de enrutar tráfico. Consulta Salud y monitoreo.
5. Restringe el acceso a tu back-end. Consulta Red y seguridad.
6. Ejecuta contra él la solicitud de creación del Quickstart.

Qué ocurre al iniciar

Human Plugin descarga el catálogo de atributos, se conecta a PostgreSQL y prepara sus tablas, y luego abre el puerto. Se detiene con un error, antes de escuchar, cuando:

• falta una configuración obligatoria o no es válida;
• no se puede descargar el catálogo de atributos;
• PostgreSQL no es accesible, o el rol no puede crear tablas.

El log indica el motivo. Consulta Solución de problemas.

Varias instancias

Human Plugin no guarda estado de solicitudes en memoria, por lo que varios contenedores pueden compartir una misma base de datos. Los contenedores que inician al mismo tiempo se coordinan a través de la base de datos, así que puedes desplegar réplicas de forma conjunta.

Antes de pasar a producción

• Mantén el tiempo de espera de parada en 60 segundos o más.
• Enruta tráfico a un contenedor solo después de que /health/ready responda 200.
• Nunca expongas Human Plugin fuera de tu red privada.
• Respalda la base de datos: contiene tu inteligencia. Consulta Operación.