FAQ Pierrr Agent

Que deviennent mes données si je désinstalle l'agent ?

Elles restent sur votre serveur. sudo pierrr-agent uninstall arrête et retire l'agent, son service, sa configuration et ses journaux, mais 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. Pour tout effacer, sudo pierrr-agent uninstall --purge-data liste ce qui sera supprimé, puis demande une seconde confirmation, que l'option --yes ne donne jamais. Le serveur reste affiché dans la console : révoquez-le ou supprimez-le depuis la page Serveurs, ses projets y restent rattachés. Détails sur la page Installer l'agent.

L'agent se met-il à jour tout seul ?

Non : l'agent ne se met jamais à jour seul. Vous déclenchez chaque mise à jour depuis la page du serveur, et une barre de progression suit chaque étape (téléchargement, vérification, installation, redémarrage). Le binaire est vérifié avant d'être remplacé. Vos conteneurs continuent de tourner pendant l'opération. L'équipe Pierrr ne peut lancer une mise à jour de votre serveur que si vous l'y autorisez, avec le réglage « Mises à jour par l'équipe Pierrr » de la page du serveur, désactivé par défaut.

Comment la licence est-elle vérifiée ?

Chaque serveur consomme un siège de licence, ou est créé avec un code (voucher) sans siège. Le jeton d'enrôlement est à usage unique et lie l'agent à son serveur.

Puis-je partager une clé de licence entre deux agents ?

Non : chaque jeton d'enrôlement ne sert qu'une fois, pour un seul serveur. Générez-en un par machine, et achetez des sièges supplémentaires pour des serveurs supplémentaires.

Que se passe-t-il si l'agent perd le contact avec le hub ?

L'agent ne s'arrête pas et réessaie en continu, et vos applications continuent de tourner. Tant que le lien est coupé, aucune commande ne lui parvient, et Pierrr n'en garde aucune en attente pour la lui envoyer plus tard : relancez l'opération une fois le serveur de nouveau en ligne.

Puis-je installer l'agent sur une machine partagée ?

Oui : fixez des plafonds de processeur, de mémoire et une réserve de disque, voir la page d'installation. Sans plafond, le comportement est inchangé.

Pourquoi le trafic réseau n'apparaît-il pas ?

Il faut un agent en version 0.53.0-beta ou plus récente. Mettez-le à jour depuis la page du serveur ; jusque-là, l'onglet Topologie du projet indique qu'aucun trafic n'est mesuré.

La connexion entre Pierrr et mon serveur est-elle sûre ?

Oui. L'agent ouvre lui-même une connexion chiffrée vers Pierrr, et depuis la version 0.62.0-beta il refuse toute commande que Pierrr n'a pas signée. Vous pouvez aussi limiter ce que Pierrr a le droit de faire sur votre serveur, dans un fichier qui vous appartient. Détails sur la page Sécurité de l'agent.

Quelles adresses autoriser si je filtre le trafic sortant ?

Le HTTPS sortant (port 443) vers deux adresses : install.pierrr.com, qui fournit l'installeur, et agents.pierrr.com, à laquelle l'agent se connecte et d'où il reçoit ses mises à jour. Un serveur connecté avant la version 0.0.49-beta de Pierrr passe par api.pierrr.com : gardez-la autorisée. Une fois le serveur passé sur agents.pierrr.com depuis sa page dans la console, api.pierrr.com ne lui sert plus. Aucun port entrant n'est à ouvrir.

Qu'est-ce qui reste sur mon serveur, et qu'est-ce qui passe par Pierrr ?

Sur votre serveur : votre code, récupéré et compilé sur place, l'image construite (jamais envoyée chez Pierrr), vos applications et leurs volumes, leur cache, leurs fichiers, la base de données de chaque projet, les journaux de vos applications et vos sauvegardes (une sauvegarde téléchargée depuis la console passe par Pierrr sans y être conservée, et chiffrée pour votre clé publique si vous l'avez ajoutée). Vos visiteurs s'y connectent directement. Ce qui passe par Pierrr, pour piloter : les commandes envoyées à l'agent et leur résultat, l'état et les métriques du serveur et des conteneurs que Pierrr gère (le reste de la machine n'est pas remonté), les journaux de build, le résultat des vérifications d'avant construction (sans le contenu d'aucun fichier, lu sur le serveur), la description de vos projets (noms, domaines, ports, branches), vos variables d'environnement et les accès de vos applications à leur base, conservés chiffrés et envoyés au serveur chiffrés pour une clé que lui seul détient. Le compte d'administration des bases reste sur le serveur. Les journaux de vos applications ne sont lus qu'à la demande, sans être conservés. Les analyses de sécurité, conteneurs et code, tournent sur votre serveur : seul leur rapport remonte à Pierrr, sans extrait de votre code ni la valeur d'un secret trouvé dans un dépôt, et même réduit à l'identifiant et à la gravité de chaque constat si vous activez les analyses en résumé seul. Vos images restent sur le serveur, sauf si vous choisissez de les publier dans votre propre registre. Vous pouvez couper les relevés de santé depuis la page du serveur, et limiter ce que Pierrr peut y faire avec une politique locale. Les sites WordPress fonctionnent aussi sur votre serveur, avec leur base créée sur la machine. Le panneau et l'import de base de données passent par l'agent : l'import est restauré sur la machine, et les pages du panneau transitent par Pierrr sans y être conservées, les identifiants de la base restant sur le serveur. Vos applications y envoient aussi leurs e-mails par Pierrr, via l'agent, sans port ouvert. L'assistant de la console ne lit ni les journaux, ni la santé détaillée, ni les variables d'un projet hébergé sur votre serveur.

Puis-je reprendre mes projets après une réinstallation ?

Oui, sur la même machine. Désinstallez ou révoquez l'ancien agent, installez le nouveau, puis ouvrez sa page dans la console : un encart « Même machine que » propose de reprendre les projets encore rattachés à l'ancien agent. Leurs bases et leurs fichiers, gardés à la désinstallation, sont retrouvés sur place, puis chaque projet est remis en route. Une base introuvable est signalée et n'est jamais recréée vide : restaurez alors une sauvegarde. Il faut que le nouvel agent soit en ligne et que votre rôle permette de gérer les serveurs.

Pourquoi l'agent a-t-il besoin des ports 80 et 443 ?

C'est par eux que vos visiteurs atteignent vos sites : l'agent y sert vos domaines en HTTPS sur le 443, et utilise le 80 pour obtenir et renouveler leurs certificats, puis rediriger vers HTTPS. Ces deux ports doivent donc être libres et ouverts à vos visiteurs. Si un autre programme, un serveur web déjà installé par exemple, les occupe, l'agent le dit au lieu d'échouer sans explication : arrêtez ou déplacez ce programme, puis relancez. Aucun port n'est à ouvrir pour piloter le serveur : l'agent se connecte lui-même à Pierrr.

Où est la base de données d'un projet hébergé sur mon serveur ?

Sur ce serveur. L'agent la crée à la création du projet et la garde sur la machine, sans l'ouvrir sur Internet : seules les applications du projet y accèdent. Pierrr ne conserve, chiffré, que ce qu'il faut pour la brancher à vos applications, et elle ne compte pas dans votre quota de stockage. Un projet sur votre serveur n'utilise jamais une base hébergée par Pierrr, et il ne peut pas partir sur un autre serveur tant qu'il a sa base, sauf vers un agent réinstallé sur la même machine. Sauvegardes, restaurations et extensions passent par l'agent, qui doit être en version 0.64.0-beta ou plus récente : la console le signale sinon. Le panneau d'administration et l'import d'un fichier SQL passent aussi par l'agent, en version 0.71.0-beta ou plus récente. Une montée de version majeure de la base se lance depuis la page du serveur : elle n'est jamais automatique, et la version précédente revient en cas d'échec.

Le cache et les volumes sont-ils payants sur mon serveur ?

Non. Pour un projet sur votre serveur, le cache et les volumes sont inclus, sans achat d'option ni quota : ajoutez-les depuis le projet. Ils ne suivent pas le projet s'il quitte ce serveur. Le stockage objet reste une option payante.

Mes sauvegardes sont-elles chiffrées ? Qui peut les ouvrir ?

Ajoutez votre clé publique de chiffrement depuis l'onglet Sauvegardes de la page du serveur dans la console : chaque sauvegarde qui quitte le serveur, téléchargée depuis la console ou copiée hors site, est chiffrée pour cette clé sur le serveur, et seule votre clé privée l'ouvre. Pierrr ne garde que son empreinte, jamais la clé privée, qui reste sur votre ordinateur : une clé privée collée par erreur est refusée. L'archive gardée sur le serveur reste lisible par l'agent, pour que la restauration depuis la console fonctionne toujours. Une archive téléchargée arrive chiffrée : ouvrez-la avec votre clé privée et votre outil de chiffrement habituel. Sans clé, le téléchargement reste possible : l'archive passe alors par Pierrr sans y être conservée, et la console vous invite à ajouter une clé.

Comment copier mes sauvegardes hors de mon serveur ?

Configurez la destination sur le serveur lui-même : sudo pierrr-agent backups set-remote, vers un disque, un partage monté ou un stockage objet (sudo pierrr-agent backups set-remote --help détaille les options) ; un secret éventuel est demandé à l'invite. Les identifiants restent sur le serveur et ne sont jamais envoyés à Pierrr. Après chaque sauvegarde, l'agent y copie l'archive, chiffrée pour votre clé : sans clé configurée, rien n'est copié. Les sauvegardes expirées sont aussi retirées de la destination, et l'onglet Sauvegardes du projet indique pour chacune si la copie a réussi. sudo pierrr-agent backups status affiche la clé et la destination, sudo pierrr-agent backups unset-remote arrête la copie.