Installer Pierrr Agent

L'agent est un binaire statique (Linux x86_64 et ARM64) ; le script l'enveloppe dans une unité systemd. À la connexion, il annonce au hub ses cœurs, sa mémoire, son disque et ses capacités.

Prérequis

Un serveur Linux (Ubuntu 22.04+, Debian 11+, Rocky/Alma 8+, openSUSE Leap 15+).
Accès root ou sudo sans mot de passe.
HTTPS sortant (443) vers install.pierrr.com, qui fournit l'agent, et agents.pierrr.com, l'adresse à laquelle il se connecte. Si vous filtrez le trafic sortant, autorisez ces deux adresses. Un serveur connecté avant la version 0.0.49-beta de Pierrr continue de passer par api.pierrr.com : gardez-la aussi autorisée.
Les ports 80 et 443 du serveur libres et ouverts à vos visiteurs, pour servir vos domaines et obtenir leurs certificats. Aucun port n'est à ouvrir pour piloter le serveur.

Installation

Depuis Serveurs, « Connecter un serveur » génère un jeton d'enrôlement à usage unique et la commande d'installation prête à coller, affichée une seule fois. Lancez-la sur la machine : elle est idempotente, donc une ré-exécution met simplement à jour l'agent.

bash

curl -fsSL --proto '=https' https://install.pierrr.com/agent \
  | PIERRR_ENROLLMENT_TOKEN=$AGENT_LICENSE bash -s -- \
    --hub-url https://agents.pierrr.com

Vérification

Confirmez que l'unité systemd tourne et suivez les logs jusqu'au premier heartbeat OK.

bash

sudo systemctl status pierrr-agent
sudo journalctl -u pierrr-agent -f

Limiter les ressources de la machine

L'agent propose des plafonds recommandés (un cœur laissé libre, 60 % de la mémoire, une réserve de disque d'au moins 10 Go ou 10 %) mais ne les applique jamais seul. Sans plafond, rien ne change. Vous pouvez les fixer dès l'installation avec les options --max-cpus, --max-mem (en Mo), --reserve-disk-gb et --max-concurrent-jobs, ce qui rend l'agent raisonnable sur un poste ou un NAS partagé. Avec un plafond, un build qui ferait passer le disque sous la réserve est refusé, avec l'espace restant indiqué.

Variables d'environnement

Chaque réglage de l'agent est facultatif et a une valeur par défaut raisonnable. Pour en changer un, par exemple les dossiers utilisés ou les plafonds de ressources, ajoutez-le dans un override du service de l'agent, puis redémarrez l'unité.

bash

sudo systemctl edit pierrr-agent
# [Service]
# Environment=AGENT_MAX_CPUS=2
# Environment=AGENT_RESERVE_DISK_GB=20

Jusqu'à la version 0.48, ces réglages avaient une ancienne nomenclature. Si votre unité ou votre fichier d'environnement la porte encore, mettez-la à jour.

Suite

Ouvrez votre dashboard Pierrr, page Serveurs. Le nouvel agent apparaît en une trentaine de secondes, en attente puis en ligne. Voir la page Serveurs pour la suite, puis l'onglet Apps pour déployer votre premier workload.

Désinstaller l'agent

La désinstallation retire l'agent, son service, sa configuration et ses journaux. Elle garde vos conteneurs, les fichiers de vos projets, leurs sauvegardes et leurs bases de données : une nouvelle installation sur la même machine les retrouve. Une confirmation vous est demandée ; l'option --yes la donne d'avance, pour un script.

bash

sudo pierrr-agent uninstall

Pour effacer aussi les données de vos projets (bases, fichiers et sauvegardes), définitivement :

bash

sudo pierrr-agent uninstall --purge-data

La commande liste les dossiers, conteneurs et volumes qu'elle va supprimer, puis demande une seconde confirmation, que --yes ne donne jamais. Une désinstallation demandée depuis la console garde toujours les données.

Dans la console, le serveur reste affiché : révoquez-le ou supprimez-le depuis la page Serveurs, ses projets y restent rattachés avec leurs données. Après une réinstallation sur la même machine, la page du nouveau serveur propose de les reprendre.