Aller au contenu

Volet Administrateur

Ce volet s'adresse à la personne qui installe et maintient les systèmes : machines, paquets, services, réseau. Il suppose une aisance avec Linux, systemd et le gestionnaire de paquets de votre distribution.

Ce volet ne traite pas…

…de la logique d'automatisation ni des écrans. Écrire du D.L.S, mapper les I/O et dessiner les synoptiques relèvent du volet Technicien. Piloter son habitat au quotidien relève du volet Utilisateur.

Ce que vous allez faire

flowchart TD
    A[Préparer les machines] --> B[Ajouter les dépôts de paquets]
    B --> C[Installer les agents]
    C --> D[Enrôler chaque agent sur le domaine]
    D --> E[Ajuster la configuration locale]
    E --> F[Démarrer et vérifier]
    F --> G[Exploiter : journaux, supervision, mises à jour]

Parcours recommandé

Étape Page Objectif
0 Pré-requis Vérifier matériel, OS, réseau et droits
1 Choisir son hébergement Cloud du projet ou socle auto-hébergé
2 Dépôts de paquets Déclarer les dépôts APT ou DNF
3 Installation et services Installer les paquets et activer les unités systemd
4 Enrôlement sur le domaine Relier l'agent au domaine et à l'API
5 Configuration et précédence Savoir où poser un paramètre et qui l'emporte
6 Paramètres communs Référence exhaustive des clés
7 Catalogue des agents Spécificités de chaque classe d'agent
8 Exploitation Journaux, supervision, mises à jour, sauvegarde

Vous utilisez le Cloud du projet ?

Si vous ne souhaitez pas héberger l'API vous-même, sautez directement l'étape 1 et le chapitre Le socle : api.abls-habitat.fr est déjà en place et vos agents s'y enrôlent sans configuration supplémentaire.

Les objets que vous manipulez

Objet Identifiant Où il est défini
Domaine domain_uuid + domain_secret Créé depuis la Console
Serveur server_uuid Généré automatiquement au premier démarrage d'un agent
Agent agent_classe + agent_tech_id Choisi par vous, déclaré dans la Console
Service abls-agent-<classe>@<tech_id>.service Fourni par le paquet
Configuration /etc/abls/abls-agent*.conf Fichiers JSON, voir configuration

Les trois règles à retenir

  1. Le domain_secret est une donnée confidentielle. Il donne un accès complet au domaine. Il ne doit jamais apparaître dans un dépôt Git, un ticket ou une capture d'écran.
  2. Un agent_tech_id est obligatoire et unique. Sans lui, l'agent refuse de démarrer. Il apparaît dans le nom du service, du fichier de configuration et des topics MQTT.
  3. La ligne de commande l'emporte sur tout le reste. En cas de comportement inattendu, relisez la page sur la précédence avant de chercher ailleurs.