SPB Git

Repository Public

README.md 23.7 KB 334 lines markdown

1<div align="center">23# 🧭 cluster-skill45**La boîte à outils et la documentation d'exploitation du cluster MacLustr : inventaires, procédures, wrappers de ligne de commande et références du tunnel public.**67![type](https://img.shields.io/badge/type-documentation%20%2B%20outils-0f766e?style=for-the-badge)8![licence](https://img.shields.io/badge/licence-tous%20droits%20r%C3%A9serv%C3%A9s-64748b?style=for-the-badge)9![règle](https://img.shields.io/badge/r%C3%A8gle-remote--first-2563eb?style=for-the-badge)10![site](https://img.shields.io/badge/site%20public-aucun-94a3b8?style=for-the-badge)1112![Markdown](https://img.shields.io/badge/Markdown-docs-000000?style=flat-square&logo=markdown&logoColor=white)13![Bash](https://img.shields.io/badge/Bash-scripts-4EAA25?style=flat-square&logo=gnubash&logoColor=white)14![Python](https://img.shields.io/badge/Python-3-3776AB?style=flat-square&logo=python&logoColor=white)15![JavaScript](https://img.shields.io/badge/JavaScript-JXA%20%2F%20Safari-F7DF1E?style=flat-square&logo=javascript&logoColor=black)16![WireGuard](https://img.shields.io/badge/WireGuard-hub%20%2B%20pairs-88171A?style=flat-square&logo=wireguard&logoColor=white)17![Caddy](https://img.shields.io/badge/Caddy-2%20(TLS%20auto)-1F88C0?style=flat-square&logo=caddy&logoColor=white)18![Ubuntu](https://img.shields.io/badge/Ubuntu-24.04%20(passerelle)-E95420?style=flat-square&logo=ubuntu&logoColor=white)19![macOS](https://img.shields.io/badge/macOS-Apple%20Silicon-000000?style=flat-square&logo=apple&logoColor=white)20![Playwright](https://img.shields.io/badge/Playwright-rendu%20PDF-2EAD33?style=flat-square&logo=playwright&logoColor=white)21![Pandoc](https://img.shields.io/badge/Pandoc%20%2B%20WeasyPrint-inventaires%20PDF-4a5568?style=flat-square)2223[![commits](https://git.spboucher.ai/badge/cluster-skill/commits.svg?style=flat-square)](https://git.spboucher.ai/cluster-skill/commits)24[![dernier commit](https://git.spboucher.ai/badge/cluster-skill/last-commit.svg?style=flat-square)](https://git.spboucher.ai/cluster-skill/commits)25[![activité](https://git.spboucher.ai/badge/cluster-skill/activity.svg?style=flat-square)](https://git.spboucher.ai/cluster-skill/insights)26[![langage](https://git.spboucher.ai/badge/cluster-skill/language.svg?style=flat-square)](https://git.spboucher.ai/cluster-skill)27[![langages](https://git.spboucher.ai/badge/cluster-skill/languages.svg?style=flat-square)](https://git.spboucher.ai/cluster-skill/insights)28[![taille](https://git.spboucher.ai/badge/cluster-skill/size.svg?style=flat-square)](https://git.spboucher.ai/cluster-skill)29[![branches](https://git.spboucher.ai/badge/cluster-skill/branches.svg?style=flat-square)](https://git.spboucher.ai/cluster-skill/branches)30[![tags](https://git.spboucher.ai/badge/cluster-skill/tags.svg?style=flat-square)](https://git.spboucher.ai/cluster-skill/tags)31[![clones](https://git.spboucher.ai/badge/cluster-skill/clones.svg?style=flat-square)](https://git.spboucher.ai/cluster-skill)3233![documents](https://img.shields.io/badge/documents%20Markdown-10-7c3aed?style=flat-square)34![pdf](https://img.shields.io/badge/PDF%20g%C3%A9n%C3%A9r%C3%A9s-4-7c3aed?style=flat-square)35![wrappers](https://img.shields.io/badge/wrappers%20CLI-3-7c3aed?style=flat-square)36![scripts](https://img.shields.io/badge/scripts%20shell-14-7c3aed?style=flat-square)37![tunnel](https://img.shields.io/badge/fichiers%20tunnel-14-7c3aed?style=flat-square)38![ovh](https://img.shields.io/badge/scripts%20ovh--manager-16-7c3aed?style=flat-square)3940![Macs](https://img.shields.io/badge/Macs%20du%20cluster-29-0ea5e9?style=flat-square&logo=apple&logoColor=white)41![cœurs](https://img.shields.io/badge/c%C5%93urs-401-0ea5e9?style=flat-square)42![RAM](https://img.shields.io/badge/RAM-1%20068%20Go-0ea5e9?style=flat-square)43![passerelle](https://img.shields.io/badge/passerelle-M1M32-0ea5e9?style=flat-square)44![tunnel](https://img.shields.io/badge/tunnel%20public-BHS64-0ea5e9?style=flat-square)4546</div>4748---4950## Sommaire5152- [Présentation](#-présentation)53- [Le cluster en un coup d'œil](#-le-cluster-en-un-coup-dœil)54- [Index des documents](#-index-des-documents)55- [Index des outils](#-index-des-outils)56  - [Wrappers de ligne de commande](#wrappers-de-ligne-de-commande)57  - [maclustr-tunnel/](#maclustr-tunnel--références-de-la-passerelle-publique)58  - [operateur/](#operateur--transfert-dun-poste-dopérateur)59  - [ovh-manager/](#ovh-manager--installation-dun-serveur-dédié)60  - [dossier/](#dossier--dossier-technique-pdf)61  - [Autres fichiers](#autres-fichiers)62- [Arborescence](#-arborescence)63- [Utilisation](#-utilisation)64- [Règle remote-first](#-règle-remote-first)65- [Régénérer les PDF](#-régénérer-les-pdf)66- [Variables d'environnement](#-variables-denvironnement)67- [Sécurité et confidentialité](#-sécurité-et-confidentialité)68- [État du dépôt](#-état-du-dépôt)69- [Auteur et licence](#-auteur-et-licence)7071---7273## 📌 Présentation7475`cluster-skill` rassemble tout ce qu'un opérateur doit lire ou lancer pour exploiter **MacLustr**, un cluster de Mac Apple Silicon installé sur un même réseau local :7677- les **documents de référence** — inventaire des machines, procédure standard, fonctionnement du tunnel public, transfert d'un poste d'opérateur ;78- les **wrappers** `mld`, `mlt` et `mlmobile`, qui relaient depuis le poste de l'opérateur les commandes vers la passerelle, le tunnel ou le coordinateur mobile ;79- les **copies de référence** de la configuration de la passerelle publique (Caddy, WireGuard, `tunnelctl`) ;80- des **outils ponctuels** — installation d'un serveur dédié, génération du dossier technique en PDF, release de l'app macOS.8182Le dépôt ne contient ni application ni service : rien n'y tourne. Le dépôt de travail est celui de la passerelle **M1M32** (`~/cluster-skill`) ; les copies sur les postes d'opérateur sont des miroirs en lecture.8384## 🖥 Le cluster en un coup d'œil8586```mermaid87flowchart LR88    OP["Poste de l'opérateur<br/>wrappers mld · mlt · mlmobile"]8990    subgraph LAN["Réseau local MacLustr — 29 Mac, 401 cœurs, 1 068 Go"]91        GW["M1M32 — passerelle<br/>spbgit + mld + cluster-skill"]92        W["Nœuds worker<br/>Mac Studio · Mac mini · MacBook"]93        AG["M4M64a<br/>agentd + coordinateur mobile"]94    end9596    PH["iPhone<br/>nœuds mobiles"]97    T["BHS64 — MacLustr Tunnel<br/>hub WireGuard + Caddy"]98    NET(("Internet"))99100    OP -- "mld (ssh)" --> GW101    OP -- "mlt (ssh)" --> T102    OP -- mlmobile --> AG103    GW -- "rsync / PM2 / heal" --> W104    GW -- tunnelctl --> T105    W -- "wg1 (WireGuard)" --> T106    PH -. "tirent des jobs" .-> AG107    NET -- "https://domaine" --> T108```109110| Rôle | Machine | Ce qu'elle porte |111|---|---|---|112| Passerelle du cluster | **M1M32** | forge git spbgit, orchestrateur `mld`, staging, registre, ce dépôt |113| Nœuds worker | Mac Studio, Mac mini, MacBook Pro / Air | les applications, placées par `mld` selon un score de ressources |114| Télémétrie | **M4M64a** | `maclustr-agentd` (API pour les apps macOS / iOS) et le coordinateur des nœuds mobiles |115| Passerelle publique | **BHS64** | hub WireGuard + Caddy : chaque site public est une route `https://<domaine> → <nœud>:<port>` |116117Totaux tirés de `NODES.md` : **29 Mac, 401 cœurs, 1 068 Go de RAM**, et un serveur Linux dédié pour le tunnel.118119## 📚 Index des documents120121| Document | Lignes | À quoi il sert | Statut |122|---|---:|---|---|123| [`MACLUSTR-PROCEDURE.md`](MACLUSTR-PROCEDURE.md) | 54 | **Procédure standard remote-first** : qui possède quel composant, sur quel nœud le modifier, séquence de modification, rôle de `mld adopt` et de la garde de `mld deploy`, vérifications après toute opération | en vigueur — **à lire en premier** |124| [`NODES.md`](NODES.md) · [`NODES.pdf`](NODES.pdf) | 130 · 3 p. | **Inventaire de travail complet** : nœuds du LAN, numéros de nœud et étiquettes QR, Macs loués retirés, nœuds mobiles, serveurs dédiés, accès et outils. À mettre à jour à chaque ajout ou retrait de machine | en vigueur — document interne (voir [Sécurité](#-sécurité-et-confidentialité)) |125| [`INVENTAIRE-MACLUSTR.md`](INVENTAIRE-MACLUSTR.md) · [`.pdf`](INVENTAIRE-MACLUSTR.pdf) | 177 · 10 p. | **Inventaire présentable**, sans identifiants : matériel et système mesurés, rôle / runtimes / applications par nœud, serveurs dédiés, topologie publique, répartitions par emplacement, modèle et puce, capacité libre, sources et méthode | en vigueur |126| [`MACLUSTR-TUNNEL.md`](MACLUSTR-TUNNEL.md) | 68 | **MacLustr Tunnel** : principe (remplace ngrok), composants, commandes `mlt` / `tunnelctl`, état de la migration, procédure de migration d'un site, points d'attention | en vigueur |127| [`TRANSFERT-OPERATEUR.md`](TRANSFERT-OPERATEUR.md) | 56 | Transférer l'accès au cluster et les connaissances Claude Code sur un autre ordinateur : ce qui constitue la connaissance, prérequis réseau, procédure, cohérence entre deux opérateurs | en vigueur |128| [`KA-REMOTE-DEV.md`](KA-REMOTE-DEV.md) | 66 | Développement direct sur les nœuds pour les projets Groupe Ka : table des projets, serveur git central, flux de travail, statut des copies locales | référence — emplacements à confirmer par `mld status` |129| [`GATEWAY.md`](GATEWAY.md) | 61 | Diffusion d'un projet de **calcul distribué** : un envoi vers le nœud de staging, puis diffusion parallèle sur le LAN (`cluster-gateway.sh`) ; convention d'usage pour les jobs | utilisable pour le calcul, pas pour les apps |130| [`INVENTAIRE-MACS.md`](INVENTAIRE-MACS.md) · [`.pdf`](INVENTAIRE-MACS.pdf) | 118 · 5 p. | Inventaire des Macs par emplacement, incluant les Macs loués hors site | **historique** — les Macs loués ont été retirés le 2026-09-25 |131| [`MACLUSTR-DOSSIER.pdf`](MACLUSTR-DOSSIER.pdf) | 14 p. | **Dossier technique** A4 paysage : couverture, matériel, rôles, serveurs, tunnel, cartes | généré par `dossier/` |132| [`dossier/README.md`](dossier/README.md) | 16 | Comment régénérer le dossier technique | — |133| [`ovh-manager/README.md`](ovh-manager/README.md) | 24 | Comment installer un serveur dédié en pilotant le manager du fournisseur dans Safari | — |134135> **Par où commencer ?** `MACLUSTR-PROCEDURE.md` pour la règle du jeu, `INVENTAIRE-MACLUSTR.md` pour connaître les machines, `MACLUSTR-TUNNEL.md` pour publier un site.136137## 🧰 Index des outils138139### Wrappers de ligne de commande140141Trois scripts courts à la racine, à lancer depuis le poste de l'opérateur.142143| Outil | Lignes | Rôle |144|---|---:|---|145| [`mld`](mld) | 21 | Relaie toute commande `mld` à la passerelle M1M32 par SSH, puis rapatrie une copie du registre (`cluster-registry.json`, ignorée par git). Fournit en plus **`mld stage <dossier-local> <app>`** : rsync d'un dossier local vers le staging de la passerelle, avec exclusions par défaut (`.git`, `node_modules`, `.next`, `.venv`) et prise en charge d'un fichier `.mldignore` |146| [`mlt`](mlt) | 43 | **MacLustr Tunnel** depuis le poste : état des pairs et des routes, raccordement d'un Mac au hub, ajout / redirection / retrait d'une route publique |147| [`mlmobile`](mlmobile) | 5 | Client du coordinateur des nœuds mobiles (iPhone) : délègue au CLI du dépôt `maclustr-mobile` |148149<details open>150<summary><b>Commandes principales</b></summary>151152```bash153# mld — orchestrateur (détail : README du dépôt maclustr-dispatch)154mld scan | mld nodes                  # ressources + runtimes de chaque nœud155mld apps | mld status --live          # manifestes + état réel des apps156mld plan [apps…]                      # plan de placement global157mld stage <dossier-local> <app>       # créer une app : poste → staging de la passerelle158mld deploy <app> [--node X]           # staging → nœud choisi, santé, registre159mld move <app> [--to X]               # migration avec rollback automatique160161# mlt — tunnel public162mlt status                            # pairs WireGuard + routes publiques163mlt peer <alias> [<alias>…]           # raccorde un Mac au hub164mlt add <domaine> <alias>:<port>      # expose https://<domaine> → nœud (TLS automatique)165mlt redirect <domaine> <cible>        # redirection (apex → www)166mlt rm <domaine> | mlt ls | mlt ssh167168# mlmobile — nœuds mobiles169mlmobile nodes | ping | info | fetch URL | run script.js170mlmobile map script.js items.json | fetch-list urls.txt | jobs | job ID171```172173</details>174175### `maclustr-tunnel/` — références de la passerelle publique176177Copies de référence de ce qui tourne sur la passerelle du tunnel. La source de vérité est **la passerelle elle-même** : ces fichiers sont à resynchroniser après toute modification là-bas.178179| Fichier | À quoi il sert |180|---|---|181| [`tunnelctl`](maclustr-tunnel/tunnelctl) | Outil de la passerelle (123 lignes) : `peer add / rm / ls`, `add <domaine> <alias>:<port>… [--no-tls] [--websocket]` (répartition de charge et contrôle de santé s'il y a plusieurs upstreams), `redirect`, `rm`, `ls`, `status`, `json` |182| [`Caddyfile`](maclustr-tunnel/Caddyfile) | Configuration globale de Caddy 2 ; chaque site est un fichier importé, écrit par `tunnelctl` |183| [`errors/down.html`](maclustr-tunnel/errors/down.html) · [`errors/unknown.html`](maclustr-tunnel/errors/unknown.html) | Pages d'erreur MacLustr : nœud injoignable, domaine inconnu |184| [`gateway-setup.sh`](maclustr-tunnel/gateway-setup.sh) | Transforme un Ubuntu 24.04 fraîchement installé en passerelle : hub WireGuard, Caddy, ufw, `tunnelctl`, pages d'erreur |185| [`wg-node-setup.sh`](maclustr-tunnel/wg-node-setup.sh) | Installe WireGuard sur un Mac et le raccorde au hub (LaunchDaemon) ; affiche la clé publique à enregistrer |186| [`wg-forward-setup.sh`](maclustr-tunnel/wg-forward-setup.sh) | Expose sur l'interface WireGuard d'un Mac des services qui n'écoutent qu'en local : un relais `socat` par port, en LaunchDaemon |187| [`ipmap`](maclustr-tunnel/ipmap) | Carte alias → adresse fixe dans le réseau du tunnel |188| [`hub-BHS64.pub`](maclustr-tunnel/hub-BHS64.pub) · [`hub-R9128.pub`](maclustr-tunnel/hub-R9128.pub) | Clés **publiques** WireGuard des hubs (le second hub a été retiré le 2026-10-02) |189| [`migrate-watch.sh`](maclustr-tunnel/migrate-watch.sh) | Surveille une liste de domaines et crée la route dès que le DNS pointe vers la passerelle, puis vérifie en HTTPS |190| [`ngrok-retire.sh`](maclustr-tunnel/ngrok-retire.sh) · [`ngrok-map.txt`](maclustr-tunnel/ngrok-map.txt) · [`sites-ngrok.txt`](maclustr-tunnel/sites-ngrok.txt) | Outils et listes de la migration ngrok → tunnel (**historique**, migration terminée le 2026-09-10) |191192### `operateur/` — transfert d'un poste d'opérateur193194| Script | À quoi il sert |195|---|---|196| [`export-connaissances.sh`](operateur/export-connaissances.sh) | Exporte dans une archive protégée la connaissance Claude Code et l'accès au cluster du poste courant. `--mcp` inclut la configuration des serveurs MCP (qui contient des jetons) ; `--vers-cluster-skill` copie les instructions, la mémoire et les commandes dans `operateur/connaissances/` — jamais les jetons |197| [`installer-operateur.sh`](operateur/installer-operateur.sh) | Installe sur un nouveau Mac l'accès et les connaissances depuis l'archive (ou depuis le clone avec `--depuis-cluster-skill`) ; idempotent, sauvegarde l'existant |198| [`autoriser-operateur.sh`](operateur/autoriser-operateur.sh) | Autorise — ou retire avec `--retirer` — la clé publique d'un opérateur sur tous les nœuds et sur la passerelle du tunnel |199200Mode d'emploi complet : [`TRANSFERT-OPERATEUR.md`](TRANSFERT-OPERATEUR.md).201202### `ovh-manager/` — installation d'un serveur dédié203204Automatisation du manager web du fournisseur par JavaScript injecté dans Safari (JXA). Prérequis : Safari connecté au manager et « Autoriser JavaScript des événements Apple » activé.205206| Fichier | À quoi il sert |207|---|---|208| [`runjs.sh`](ovh-manager/runjs.sh) | Exécute un fichier JS dans l'onglet Safari au premier plan et affiche le résultat |209| `inspect.js` · `net.js` | Lecture de la fiche du serveur et de sa configuration réseau |210| `install.js` · `modal.js` · `os.js` · `next.js` · `step.js` | Parcours de l'assistant d'installation (bouton, liste des systèmes, choix d'Ubuntu Server 24.04, étapes) |211| `fill-bhs128.js` · `fill-bhs128b.js` · `verify.js` · `valider.js` | Remplissage du formulaire (nom d'hôte, clé publique, script de post-installation), vérification, lancement |212| `prog.js` · `wait-bhs128.sh` · `wait-bhs128b.sh` | Suivi de la progression, puis attente du marqueur de fin de post-installation |213| [`postinstall.sh`](ovh-manager/postinstall.sh) | Post-installation commune : clés **publiques** du cluster, paquets de base, fuseau horaire, marqueur |214215### `dossier/` — dossier technique PDF216217| Fichier | À quoi il sert |218|---|---|219| [`build.py`](dossier/build.py) | Génère `cover.html` et `body.html` à partir de `INVENTAIRE-MACLUSTR.md`, `data.json` et `live.json` |220| [`print.mjs`](dossier/print.mjs) | Rendu PDF par Playwright / Chromium (couverture pleine page + corps paginé) |221| `cover.html` · `body.html` · `dossier.css` | Gabarits générés et feuille de style |222| `data.json` · `live.json` | Export de l'inventaire du site vitrine et instantané de son API live |223| `map.png` · `map-eu.png` | Cartes (1540 × 1242) intégrées au dossier |224225### Autres fichiers226227| Fichier | À quoi il sert |228|---|---|229| [`cluster-gateway.sh`](cluster-gateway.sh) | Staging et diffusion d'un projet de calcul : `push`, `stage`, `fanout`, `list`, `where`, `clean` (documenté dans `GATEWAY.md`) |230| [`release-maclustr-macos.sh`](release-maclustr-macos.sh) | Chaîne de release de l'app macOS MacLustr : build, signature, DMG, notarisation sur un nœud, rapatriement (`--install`, `--skip-build`) |231| [`inventaire-maclustr.css`](inventaire-maclustr.css) · [`inventaire.css`](inventaire.css) | Feuilles de style d'impression des inventaires (A4 paysage) |232| [`cluster-deployments.json`](cluster-deployments.json) | **Ancien registre** des déploiements (historique, apps retirées) — remplacé par le registre de `mld` ; ne plus l'alimenter |233| [`.gitignore`](.gitignore) | Exclut la copie locale du registre, les sauvegardes `*.bak`, les journaux de migration et les PDF intermédiaires |234235## 🗂 Arborescence236237```text238cluster-skill/239├── MACLUSTR-PROCEDURE.md        # procédure standard remote-first240├── NODES.md / NODES.pdf         # inventaire de travail241├── INVENTAIRE-MACLUSTR.md/.pdf  # inventaire présentable242├── INVENTAIRE-MACS.md/.pdf      # inventaire par emplacement (historique)243├── MACLUSTR-TUNNEL.md           # tunnel public244├── TRANSFERT-OPERATEUR.md       # transfert d'un poste d'opérateur245├── KA-REMOTE-DEV.md             # développement sur les nœuds (Groupe Ka)246├── GATEWAY.md                   # diffusion de projets de calcul247├── MACLUSTR-DOSSIER.pdf         # dossier technique (14 p.)248├── mld · mlt · mlmobile         # wrappers CLI249├── cluster-gateway.sh           # staging / diffusion de calcul250├── release-maclustr-macos.sh    # release de l'app macOS251├── inventaire*.css              # styles d'impression252├── cluster-deployments.json     # ancien registre (historique)253├── maclustr-tunnel/             # 14 fichiers : tunnelctl, Caddyfile, scripts WireGuard, pages d'erreur254├── operateur/                   # 3 scripts : export, installation, autorisation255├── ovh-manager/                 # 17 fichiers : pilotage du manager en JXA256└── dossier/                     # 10 fichiers : générateur du dossier technique257```258259## 🚀 Utilisation260261```bash262# miroir en lecture sur le poste de l'opérateur263git clone gitsrv:srv/git/cluster-skill.git ~/Desktop/Cluster/cluster-skill264git -C ~/Desktop/Cluster/cluster-skill pull     # avant chaque session265266# les wrappers supposent des alias SSH déjà configurés (passerelle, nœuds, tunnel)267~/Desktop/Cluster/cluster-skill/mld status --live268~/Desktop/Cluster/cluster-skill/mlt status269```270271Prérequis du poste : `ssh`, `rsync`, `python3`, une clé SSH autorisée sur le cluster (voir `operateur/`), et le dépôt `maclustr-mobile` pour `mlmobile`. Plusieurs documents citent d'anciens chemins (`~/Desktop/cluster-skill`) : le chemin courant du miroir est `~/Desktop/Cluster/cluster-skill`.272273## 🧭 Règle remote-first274275Depuis le 2026-10-02, **tout composant MacLustr se modifie sur son nœud propriétaire**, jamais sur le poste de l'opérateur. Résumé du tableau de `MACLUSTR-PROCEDURE.md` :276277| Composant | Nœud propriétaire | Mise en service |278|---|---|---|279| Orchestrateur `mld` | M1M32 `~/maclustr-dispatch` | immédiate |280| `agentd` | M4M64a `~/maclustr-agentd` | relance du service launchd |281| **cluster-skill** (ce dépôt) | M1M32 `~/cluster-skill` | `git pull` sur les postes |282| MacLustr Tunnel | BHS64 | copie de référence `maclustr-tunnel/` à resynchroniser |283| Manifestes et registre `mld` | M1M32 `~/dispatch/` | hors git |284| Applications déployées | le nœud indiqué par `mld status` | build + redémarrage sur le nœud, puis `git push` depuis le nœud |285| Applications Apple (Xcode) | exception : poste de l'opérateur | scripts de release |286287La seule écriture autorisée depuis un poste est l'export `operateur/export-connaissances.sh --vers-cluster-skill`.288289## 🖨 Régénérer les PDF290291```bash292# inventaire présentable (pandoc + WeasyPrint)293pandoc INVENTAIRE-MACLUSTR.md -s --css inventaire-maclustr.css -o /tmp/i.html \294  && cp inventaire-maclustr.css /tmp/ \295  && weasyprint /tmp/i.html INVENTAIRE-MACLUSTR.pdf296297# dossier technique : voir dossier/README.md298#   build.py → cover.html + body.html → print.mjs (Playwright) → fusion (PyMuPDF) → MACLUSTR-DOSSIER.pdf299```300301Mettre à jour `INVENTAIRE-MACLUSTR.md` avant toute régénération qui suit un ajout ou un retrait de machine.302303## ⚙️ Variables d'environnement304305| Variable | Outil | Rôle | Défaut |306|---|---|---|---|307| `MLT_GW` | `mlt` | passerelle visée (équivalent de `-g`) | `BHS64` |308| `MLT_PUB_BHS64` | `mlt` | clé publique WireGuard du hub | contenu de `maclustr-tunnel/hub-BHS64.pub` |309| `MLMOBILE_URL` | `mlmobile` | URL du coordinateur des nœuds mobiles | coordinateur sur M4M64a |310| `PUBLIC_IP` | `tunnelctl` | adresse publique de la passerelle | lue dans `/etc/maclustr-tunnel/public_ip` |311312## 🔒 Sécurité et confidentialité313314- **Ce README ne contient volontairement aucun identifiant ni aucune adresse** : les machines y sont désignées par alias et par rôle.315- Le dépôt, lui, est un **dépôt d'exploitation interne** : plusieurs documents et scripts décrivent le réseau en détail (adressage, numéros de série, identifiants de contrat). Ils sont à traiter comme confidentiels.316- `INVENTAIRE-MACLUSTR.md` / `.pdf` et `MACLUSTR-DOSSIER.pdf` sont les versions **présentables**, rédigées sans identifiants de connexion.317- Les manifestes d'applications et le registre `mld` (qui portent les variables d'environnement des apps) vivent **hors git**, sur la passerelle.318- Les seules clés présentes dans le dépôt sont des clés **publiques** (SSH, WireGuard). Les clés privées WireGuard sont générées sur chaque machine.319- `operateur/export-connaissances.sh` n'exporte jamais les jetons des serveurs MCP vers le dépôt.320- Aucun secret ne doit être ajouté à ce dépôt : un mot de passe se lit à l'exécution depuis un fichier protégé de la passerelle, jamais depuis un fichier suivi.321322## 🗺 État du dépôt323324- Dépôt créé sur spbgit le 2026-10-02 ; dépôt de travail sur M1M32.325- Infrastructure au dernier inventaire : 29 Mac sur le LAN, plus aucun Mac loué (retirés le 2026-09-25), une seule passerelle publique (BHS64) depuis le 2026-10-02.326- Parties historiques conservées pour mémoire : migration ngrok (`maclustr-tunnel/ngrok-*`, `sites-ngrok.txt`), second hub (`hub-R9128.pub`), `INVENTAIRE-MACS.*`, `cluster-deployments.json`, scripts `ovh-manager/` propres à des serveurs retirés.327- Dépôt lié : **maclustr-dispatch** (code de `mld`).328329## 👤 Auteur et licence330331**Simon-Pierre Boucher** — [contact@spboucher.ai](mailto:contact@spboucher.ai) · forge : [git.spboucher.ai](https://git.spboucher.ai)332333Le dépôt ne contient pas de fichier de licence : **tous droits réservés**.334
Files main
Menu

Theme