Exploitation

Faire fonctionner Human Plugin au quotidien.

Markdown

Mises à jour

Exécutez l'image latest et mettez à jour lorsque Unico annonce une version :

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

Une nouvelle version prépare au démarrage les tables dont elle a besoin, avant d'accepter du trafic : aucune étape manuelle sur la base de données n'est nécessaire. Faites une sauvegarde de la base avant de mettre à jour la production, puis vérifiez /health/ready et une vraie requête de création.

Rotation des identifiants

Clé d'accès. Unico émet la nouvelle clé avec une fenêtre de chevauchement. Mettez à jour HUMAN_API_ACCESS_KEY dans votre .env ou votre Secret, redémarrez Human Plugin (docker compose up -d --force-recreate, ou kubectl -n human-plugin rollout restart deployment/human-plugin), vérifiez qu'une création réussit, puis demandez à Unico de révoquer l'ancienne clé.

Identifiants du registry. Unico émet un nouveau token alors que l'ancien fonctionne encore. Reconnectez-vous avec le nouveau token (ou recréez le pull secret Kubernetes), faites un pull pour confirmer, puis demandez à Unico de révoquer l'ancien token. Les conteneurs en cours d'exécution ne sont pas affectés.

Mot de passe de la base de données. Changez-le dans PostgreSQL et dans POSTGRES_PASSWORD, puis redémarrez Human Plugin.

Arrêt

À réception de SIGTERM, Human Plugin cesse d'accepter des connexions et attend jusqu'à 55 secondes les requêtes en cours, car une création peut durer jusqu'à 30 secondes puis enregistrer son résultat. Définissez le délai d'arrêt à au moins 60 secondes. Une création interrompue est considérée comme échouée lors d'une lecture ultérieure.

Mise à l'échelle

Human Plugin ne conserve aucun état de requête en mémoire : plusieurs conteneurs peuvent donc partager une même base de données. Ajoutez une réplique pour chaque tranche de 1 500 transactions par minute, et portez le max_connections de PostgreSQL à 25 × le nombre de répliques + 10. Voir Exigences matérielles.

Le catalogue d'attributs

Human Plugin télécharge le catalogue d'attributs une fois au démarrage. Une nouvelle version du catalogue parvient à un conteneur à son prochain redémarrage. Redémarrer les conteneurs un par un maintient le service disponible.

Sauvegardes

Votre base de données contient l'intelligence à partir de laquelle data.ndocs est calculé. Sauvegardez-la avec vos propres outils et testez les restaurations. Perdre la base de données fait perdre l'intelligence, et elle ne peut pas être reconstruite.