Remote
Gérer les machines distantes définies dans infra/remotes/*.yaml.
Ne lire le fichier référencé que lorsqu'il est déclenché.
Garde
remotes.enabled doit être true dans bridge-config.yaml. Sinon : informer et quitter.
Arguments
| Argument | Effet | Défaut |
|---|---|---|
(aucun) | Tableau de bord de tous les distants | — |
{hôte} | Vue détaillée d'un distant | — |
health {hôte} | Vérification de santé SSH | — |
logs {hôte} {service} | Afficher les logs récents | — |
restart {hôte} {service} | Redémarrer un service | — |
sync {hôte} | Synchroniser les fichiers de configuration | — |
wake {hôte} | Wake-on-LAN | — |
connect {hôte} | Ouvrir une session SSH / RDP | — |
shutdown {hôte} | Éteindre (nécessite [y]) | — |
reboot {hôte} | Redémarrer la machine (nécessite [y]) | — |
Arbre de décision
L'utilisateur veut...
├── Aperçu / tableau de bord des distants → Lire references/workflow.md (§ Dashboard)
├── Vue détaillée d'une machine → Lire references/workflow.md (§ Dashboard, hôte unique)
├── Réveiller / allumer une machine → Lire references/fleet.md (§ Étape 3 WoL)
├── Connexion via SSH / RDP → Lire references/fleet.md (§ Étape 4 Connexion)
├── Redémarrer ou éteindre → Lire references/fleet.md (§ Étape 5)
├── Vérifier l'accessibilité / en ligne ? → Lire references/fleet.md (§ Étape 2)
├── Mettre à jour l'inventaire après un changement → Lire references/fleet.md (§ Étape 6)
├── Vérification de santé d'une machine → Lire references/workflow.md (§ Vérification de santé)
├── Voir les logs d'un service → Lire references/workflow.md (§ Logs)
├── Redémarrer un service → Lire references/workflow.md (§ Redémarrage)
├── Synchroniser la configuration vers un distant → Lire references/workflow.md (§ Synchronisation)
├── Déployer des services vers un distant → Lire references/workflow.md (§ Déploiement)
├── Identifier "mon PC" / intention uniquement → Lire references/fleet.md (§ Étape 1 + Routage appris)
└── Questions sur les distants → Répondre depuis CLAUDE.md § Remotes
Carte de référence
| Fichier | Possède |
|---|---|
references/fleet.md | Inventaire, WoL, connexion, arrêt, accessibilité, routage "mon PC" |
references/workflow.md | Tableau de bord des services, santé, logs, redémarrage, synchronisation, déploiement |
Règles strictes (non négociables)
- Tailscale d'abord, LAN en secours — le LAN échoue sur VPN ou réseaux étrangers
- Aucune opération destructive (arrêt, redémarrage, formatage) sans
[y]par action - Ne jamais stocker d'identifiants dans
infra/remotes/*.yaml— uniquement des URI KeyVault / 1Password - Respecter
wake_on_lan.enabled: false— ne jamais forcer le réveil d'une machine qui a refusé - Lire
infra/remotes/{cible}.yamlavant toute opération — pas de devinette