1. Modèles d’échec
Prérequis flous, mauvaise lecture du modèle de processus, manque d’observabilité — trois familles qui survivent aux versions.
2. Prérequis
| Élément | Conseil | Sinon |
|---|---|---|
| Node | Aligner la doc officielle | Incompatibilités natives |
| Gestionnaire de paquets | Un seul par dépôt | Dérive des lockfiles |
| Chemins | Vérifier les fichiers réellement lus | Config fantôme |
| Clés API | Moindre privilège | Coût/fuite |
3. Intention de l’onboarding
Lier identité, canal, mode d’exécution et workspace. Conserver traces d’erreur complètes avant reset.
4. Premier plan vs démon
Valider en voyant stdout, puis promouvoir avec le même health check ; fixer WorkingDirectory et variables d’environnement.
5. Cinq étapes de fumée
Écoute/santé → message minimal → journaux (auth, quota) → proxy/TLS → version + ID de requête réussie.
6. Ports & journaux
| Symptôme | Vérifier | Action |
|---|---|---|
| Port occupé | lsof | Tuer zombie ou changer le port |
| Démon qui quitte | Journaux service | Repro au premier plan |
| Canal muet | Webhook/pare-feu | curl interne/externe |
| Déconnexions | Veille/throttling | Politique d’énergie, backoff |
Repères :
- Lire les journaux par blocs continus.
- Avant/après upgrade mineur : santé + E2E.
- Mac distant : espace libre et rotation des logs.
7. Hébergement longue durée
Politique de veille, redémarrage après mise à jour macOS, rotation, utilisateur de service cohérent — consigner dans un mini runbook mensuel.
8. Chemins de boot versionnés
Mieux vaut versionner les sorties d’onboarding et les checks de santé que multiplier les tutoriels. Séparer la passerelle sur un Mac distant dédié isole la charge GPU/créative.
MACGPU propose des nœuds Mac distants facturés à l’heure pour stabiliser l’alimentation, le disque et les frontières de ressources.