EXPLOITATION

Serveurs et agent

Ajoutez un serveur distant, ce que fait l’agent, et comment DockBoard synchronise une flotte.

En mode multi-serveur, DockBoard pilote d’autres machines via un petit agent installé sur chacune. Un serveur enregistré peut alors héberger des projets, faire tourner des applications et des bases, et rejoindre un cluster.

La page Serveurs n’existe qu’en mode multi-serveur. En mode Local, tout tourne sur l’hôte DockBoard et la page est masquée.

Ajouter un serveur

01Serveurs → Ajouter un serveur. DockBoard génère une commande d’installation d’une ligne, porteuse d’un jeton à usage unique.
02Connectez-vous en SSH à la machine et collez-la. L’agent s’installe en tant que service.
03Il se reconnecte à DockBoard et le serveur passe à ONLINE. Vous pouvez désormais y déployer.

BASH

curl -fsSL '<api>/api/agent/install.sh?token=…' | sh

L’agent a besoin de Docker sur la machine et d’un accès sortant vers votre instance DockBoard. C’est lui qui appelle — vous n’ouvrez pas de port entrant pour lui.

Mettre à jour l’agent

L’agent est un binaire autonome, pas un dépôt Git : le mettre à jour, c’est relancer son installateur. Ouvrez Serveurs → votre serveur → Commande d’installation et recollez-la en SSH : elle télécharge le dernier binaire et redémarre le service.

Les fonctionnalités arrivent aussi bien dans l’agent que dans le tableau de bord. Si quelque chose de documenté ici n’apparaît pas sur un serveur distant — le réseau de projet est le suspect habituel — mettez l’agent à jour avant de chercher plus loin. Voir dépannage.

Ports à ouvrir

Port	Sens	Pourquoi
`80` et `443`	Entrant	Le trafic public, et le challenge Let’s Encrypt pour les domaines.
`22`	Entrant	Votre propre accès SSH — l’agent ne s’en sert pas.
`25`	Sortant	Uniquement si vous exploitez un serveur mail. Beaucoup d’hébergeurs le bloquent par défaut.

Un cluster ajoute ses propres ports entre les nœuds.

État et suppression

Un serveur affiche ONLINE tant que son agent donne signe de vie. Un agent silencieux — machine éteinte, service arrêté, accès sortant perdu — apparaît hors ligne, et les déploiements qui le visent sont refusés plutôt que mis en file indéfiniment.

Déplacez ses projets ailleurs avant de retirer un serveur — voir déplacer un projet.
Supprimer un serveur encore membre d’un cluster est refusé tant qu’il n’a pas quitté le cluster.
Retirer un serveur de DockBoard n’efface pas la machine. Conteneurs et volumes restent en place.