Operación

Cómo operar Human Plugin día a día.

Markdown

Actualizaciones

Ejecuta la imagen latest y actualiza cuando Unico anuncie una versión:

• Docker Compose: docker compose pull && docker compose up -d.
• Kubernetes: kubectl -n human-plugin rollout restart deployment/human-plugin, con imagePullPolicy: Always.

Una nueva versión prepara las tablas que necesita al iniciar, antes de aceptar tráfico, por lo que no hace falta ningún paso manual en la base de datos. Haz una copia de seguridad de la base de datos antes de actualizar producción y, después, verifica /health/ready y una solicitud de creación real.

Rotación de credenciales

Clave de acceso. Unico emite la nueva clave con una ventana de superposición. Actualiza HUMAN_API_ACCESS_KEY en tu .env o Secret, reinicia Human Plugin (docker compose up -d --force-recreate, o kubectl -n human-plugin rollout restart deployment/human-plugin), confirma que una creación funciona y luego pide a Unico que revoque la clave anterior.

Credenciales del registry. Unico emite un token nuevo mientras el anterior sigue funcionando. Vuelve a iniciar sesión con el token nuevo (o recrea el pull secret de Kubernetes), haz un pull para confirmar y luego pide a Unico que revoque el token anterior. Los contenedores en ejecución no se ven afectados.

Contraseña de la base de datos. Cámbiala en PostgreSQL y en POSTGRES_PASSWORD, y luego reinicia Human Plugin.

Apagado

Al recibir SIGTERM, Human Plugin deja de aceptar conexiones y espera hasta 55 segundos a que terminen las solicitudes en curso, porque una creación puede tardar hasta 30 segundos y después guardar su resultado. Configura el tiempo de espera de parada en al menos 60 segundos. Una creación interrumpida se marca como fallida en una lectura posterior.

Escalado

Human Plugin no guarda estado de solicitudes en memoria, por lo que varios contenedores pueden compartir una misma base de datos. Añade una réplica por cada 1.500 transacciones por minuto y aumenta el max_connections de PostgreSQL a 25 × el número de réplicas + 10. Consulta Requisitos de hardware.

El catálogo de atributos

Human Plugin descarga el catálogo de atributos una vez al iniciar. Una nueva versión del catálogo llega a un contenedor en su siguiente reinicio. Reiniciar los contenedores de uno en uno mantiene el servicio disponible.

Copias de seguridad

Tu base de datos contiene la inteligencia a partir de la cual se calcula data.ndocs. Respáldala con tus propias herramientas y prueba las restauraciones. Perder la base de datos implica perder la inteligencia, y no se puede reconstruir.