Installer Excubius
Excubius s'exécute sur un seul serveur Linux que vous contrôlez, dans votre abonnement cloud ou votre centre de données. Le programme d'installation interactif vérifie le serveur, pose une courte série de questions, installe les conteneurs et obtient le certificat. Cet article indique ce dont vous avez besoin, ce que le programme d'installation demande et fait, et où trouver chacune des tâches qui suivent.
Avant de commencer
| Élément | Configuration requise |
|---|---|
| Serveur | Rocky Linux 9 ou 10 (ou un autre système de la famille RHEL), x86-64, systemd. Au moins 2 vCPU, 4 Gio de mémoire et 20 Gio d'espace disque libre ; dans Azure, Standard_B2ms (2 vCPU, 8 Gio) est un bon point de départ et peut être redimensionné plus tard. Si votre équipe cloud crée les serveurs, consultez Demander le serveur Azure |
| Accès | Un compte avec sudo sur le serveur, accessible en SSH depuis votre poste de travail |
| Réseau vers les utilisateurs | Ports 80 et 443 libres sur le serveur et ouverts depuis les emplacements où les personnes utiliseront Excubius |
| Sortant | HTTPS vers ghcr.io et docker.io pour télécharger les images, sauf si vous utilisez le package hors connexion |
| Réseau vers ce que vous surveillez | Depuis le serveur, le port SQL de chaque instance, de chaque réplica et de chaque adresse IP d'écouteur (et UDP 1434 pour les instances nommées sans port fixe), ainsi que HTTPS vers les points de terminaison web que vous testez. Rien ne se connecte au collecteur |
| Package d'installation | excubius-installer-<version>.tar.gz, ou le package hors connexion qui contient les images. Les utilisateurs connectés obtiennent les deux depuis Téléchargements |
| Connexion | Une inscription d'application Microsoft Entra ID, un client OAuth Google, ou les deux. Consultez Configurer les fournisseurs de connexion |
| Connexions de surveillance | Des connexions en lecture seule pour ce que vous allez surveiller, par exemple la connexion SQL Server décrite dans Prérequis pour les groupes de disponibilité |
| Certificat | Pour Let's Encrypt, un nom DNS public qui pointe vers le serveur, ou un accès par API à sa zone DNS. Inutile avec votre propre certificat, un certificat auto-signé ou une passerelle qui termine TLS |
Fonctionnement de l'installation
Les contrôles préalables portent sur le système d'exploitation et sa version, l'architecture, systemd et dnf, la mémoire, les processeurs, le disque, la disponibilité des ports 80 et 443, SELinux, l'accès aux registres ou à l'archive des images, et la synchronisation de l'horloge.
Le serveur reçoit le package de la version, un fichier de configuration et les images de conteneur. Il ne reçoit jamais de code source et ne contacte jamais de dépôt de code.
Installer
-
Copiez le package d'installation sur le serveur et décompressez-le :
tar -xzf excubius-installer-0.4.0.tar.gzcd excubius-installer-0.4.0 -
Si vous le souhaitez, exécutez uniquement les contrôles préalables. Ils ne modifient rien :
sudo ./install.sh --check-only -
Exécutez le programme d'installation et répondez à ses questions. Appuyez sur Entrée pour accepter la valeur entre crochets :
sudo ./install.shLe programme d'installation conserve vos réponses, avec leur version, afin qu'une mise à niveau ne pose que les questions nouvelles de cette version.
-
À la fin, ouvrez l'adresse publique qu'il affiche et connectez-vous avec le compte administrateur que vous avez nommé pendant l'installation. Ensuite, configurez la connexion et invitez les personnes qui utiliseront Excubius.
Tout ce que fait le programme d'installation est journalisé dans /var/log/excubius-install.log, sans les secrets.
Les questions du programme d'installation
| Question | Valeur par défaut | Remarques |
|---|---|---|
| Répertoire d'installation | /opt/excubius | N'importe quel chemin absolu |
| Compte de service | excubius | Créé s'il n'existe pas. Il exécute les conteneurs sans privilèges root |
| URL publique | https://monitoring.example.com | L'adresse que les personnes ouvriront. Son hôte est le nom principal du serveur |
| Alias | Aucun | Les autres noms que les personnes peuvent ouvrir, séparés par des espaces, par exemple un alias dans un domaine que vous contrôlez |
| TLS | letsencrypt | letsencrypt (via HTTP), letsencrypt-dns (via DNS), selfsigned, custom (vos fichiers PEM), gateway (TLS se termine en amont) ou later (HTTP simple pour l'instant) |
| Noms dans le certificat | all | Demandé lorsqu'il y a des alias : excluez les noms qu'un certificat ne peut pas couvrir |
| Adresse e-mail pour Let's Encrypt | — | Les deux modes Let's Encrypt |
| Fournisseur DNS et informations d'identification | — | letsencrypt-dns uniquement : l'identifiant dnsapi d'acme.sh, par exemple dns_cf, dns_dreamhost ou dns_azure, et ses variables, saisies une par une sans écho |
| Fichiers du certificat et de la clé | — | custom uniquement : la chaîne PEM, avec le certificat du serveur en premier, et une clé non chiffrée |
| Nom d'utilisateur et mot de passe de l'administrateur | Un nom d'utilisateur suggéré | Le compte de la première connexion, à l'adresse que le programme d'installation affiche à la fin. Le mot de passe compte au moins 12 caractères et il est demandé deux fois |
| Préréglage de base | enterprise | enterprise, databases ou core ; consultez Configurer l'instance |
| Utilisateur et jeton du registre | — | Fournis avec la licence. Non demandés avec le package hors connexion |
| Jeton du bot Slack et canal | — et #alerts | Facultatifs ; vous pouvez les définir plus tard. Consultez Configurer les notifications Slack |
| ID de locataire, ID client et secret Entra ID | — | Facultatifs ; vous pouvez les définir plus tard |
Avec un mode Let's Encrypt, le programme d'installation vérifie ensuite les noms dans le DNS public et, via HTTP, qu'ils pointent vers ce serveur. Si ce n'est pas le cas, il explique les solutions possibles ; il ne s'arrête jamais pour autant.
Le programme d'installation génère une seule fois le mot de passe de la base de données, le secret de signature des sessions, la clé qui chiffre les secrets stockés et le jeton du collecteur, et ne les demande jamais. Une fois que la plateforme a stocké le mot de passe de l'administrateur, les informations d'identification DNS et une clé privée, il les supprime du fichier de configuration.
Pour installer sans questions, transmettez les réponses dans un fichier avec --answers ; consultez la référence du programme d'installation.
Noms et TLS
| Mode | Quand l'utiliser |
|---|---|
| Let's Encrypt, validation HTTP | Le nom se résout publiquement vers le serveur et le port 80 est accessible depuis Internet |
| Let's Encrypt, validation DNS | Le serveur est privé, mais vous pouvez créer des enregistrements DNS via une API |
| Votre propre certificat | Votre organisation émet des certificats |
| Auto-signé | Un laboratoire ou un premier test |
| Passerelle | Un équilibreur de charge ou un proxy inverse placé en amont termine TLS |
| HTTP simple | Un premier test, ou un réseau auquel vous faites entièrement confiance |
Vous pouvez modifier les noms et le certificat plus tard depuis Settings sans réinstaller, et le renouvellement est automatique. Consultez Configurer les noms et TLS.
Mettre à niveau, réinstaller ou désinstaller
| Commande | Ce qu'elle fait |
|---|---|
sudo ./install.sh sur un serveur déjà installé | Propose Upgrade (conserve les données et ne pose que les nouvelles questions), Reinstall, Purge and install fresh ou Cancel |
sudo ./install.sh --uninstall | Effectue une dernière sauvegarde de la base de données, puis supprime les services et les images. Conserve les données, les sauvegardes et la configuration |
sudo ./install.sh --uninstall --purge | Supprime aussi les données, les sauvegardes et le compte de service. Vous demande de taper purge |
Effectuez la mise à niveau pendant une fenêtre de changement. Les services redémarrent pendant quelques secondes et les migrations de la base de données s'exécutent. Lisez les problèmes connus de la version avant de commencer.
--dry-run fonctionne avec chaque commande et affiche seulement ce qui se passerait. Les étapes pour mettre à niveau, revenir à la version précédente, sauvegarder et restaurer se trouvent dans Mettre à niveau, sauvegarder et restaurer, réservé aux utilisateurs connectés.
Surveiller Excubius depuis l'extérieur
Excubius ne doit pas être le seul à se surveiller lui-même. Inscrivez https://<your server>/heartbeat auprès d'un observateur externe, par exemple un test de disponibilité Azure Monitor, Uptime Kuma exécuté ailleurs ou un service de type healthchecks, et configurez-le pour qu'il vous alerte lorsque l'adresse cesse de répondre ok. Si le serveur s'arrête, c'est cet observateur qui vous prévient.
/heartbeat et /healthz répondent en HTTP simple dans tous les modes TLS. /healthz renvoie aussi la version en cours d'exécution.