Dépannage de Pierrr Agent

L'agent reste "offline" dans le dashboard

Consultez les logs : journalctl -u pierrr-agent -f. La cause la plus fréquente est un pare-feu sortant qui bloque le port 443 : vérifiez que la machine joint agents.pierrr.com, ou api.pierrr.com pour un serveur connecté avant la version 0.0.49-beta de Pierrr. Dans la console, le statut Hors ligne s'accompagne du dernier contact sur la carte. Un statut En attente signifie que le jeton d'enrôlement n'a pas encore servi : relancez la commande d'installation.

Heartbeats OK mais aucun déploiement ne part

L'agent a besoin de Docker. Vérifiez avec docker info que le compte qui exécute l'agent peut joindre le démon ; si ça échoue, corrigez ses droits et redémarrez l'unité.

Jeton d'enrôlement invalide ou perdu

Le jeton n'est affiché qu'une seule fois et sert une seule fois. S'il est perdu ou refusé, révoquez l'entrée dans Serveurs, puis utilisez « Connecter un serveur » pour en générer un nouveau et relancer la commande.

Le disque se remplit avec le temps

Après chaque build réussi, l'agent conserve les deux derniers builds de chaque application et supprime les couches orphelines, sans toucher aux images des autres applications. Si le disque reste plein, libérez de la place ou augmentez la réserve. Évitez les commandes de nettoyage global de Docker : elles peuvent supprimer des volumes et donc vos données.

Aucun trafic réseau mesuré

L'onglet Topologie d'un projet indique qu'aucun trafic n'est mesuré tant que l'agent du serveur n'est pas en version 0.53.0-beta ou plus récente. Mettez l'agent à jour depuis la page du serveur.

La mise à jour de l'agent est refusée

Le bouton est grisé et la raison s'affiche au survol : l'agent doit être en ligne, et votre rôle doit permettre la mise à jour (owner ou admin). Si la vérification du binaire échoue, l'opération est abandonnée et l'ancienne version reste en place.

Un build est refusé faute d'espace disque

Avec un plafond en vigueur, un build qui ferait passer le disque sous la réserve est refusé, avec l'espace restant indiqué. Libérez de la place ou baissez la réserve.

Un déploiement s'est interrompu pendant une maintenance

Un déploiement interrompu par une maintenance de la plateforme repart tout seul. Vérifiez son état dans l'historique du projet avant d'en relancer un.

Les commandes sont refusées à cause de l'heure du serveur

L'horloge du serveur s'écarte de plus de dix minutes de l'heure réelle, et l'agent refuse les commandes qu'il reçoit. Vérifiez que la synchronisation de l'heure est active (timedatectl status), corrigez-la, puis relancez l'opération.

Une commande est refusée par la politique du serveur

Le fichier /etc/pierrr-agent/policy.yaml interdit cette commande, ou il est illisible et vaut alors lecture seule. Le journal des commandes, dans l'onglet Journal de la page du serveur, indique la raison. Corrigez le fichier sur la machine : la modification s'applique dès la commande suivante. Voir Sécurité de l'agent.

Les ports 80 ou 443 sont déjà utilisés

Un autre programme, souvent un serveur web déjà installé, occupe le port 80 ou 443 du serveur : l'agent ne peut pas y servir vos domaines, et il nomme les ports concernés dans l'onglet Journal de la page du serveur. Repérez ce programme avec sudo ss -ltnp '( sport = :80 or sport = :443 )', arrêtez-le ou déplacez-le sur un autre port, puis relancez le déploiement.

Un projet demande une mise à jour de l'agent

La base de données d'un projet sur votre serveur est créée par l'agent, qui doit être en version 0.64.0-beta ou plus récente. Tant qu'il est plus ancien, la console le signale sur le projet, avec un bouton vers la page du serveur : mettez l'agent à jour, puis relancez l'opération.