Parcours de dépannage opérationnel

Identifiez d’abord la couche en cause avant de modifier le nœud.

Chaque location correspond à un nœud physique Apple Silicon dédié. En cas de problème de connexion, vérifiez d’abord l’état dans la console, puis le réseau local, l’authentification, les services système et les processus, au lieu de réinstaller la chaîne d’outils sans informations suffisantes.

5 niveaux de contrôle État, réseau, authentification, services, processus
2 voies d’accès Diagnostic autonome et ticket via la console
Fonctionnement 365 jours Les nœuds restent opérationnels toute l’année
Première connexion

Effectuez quatre vérifications avant de vous connecter

Ne copiez pas l’adresse ni les identifiants depuis une conversation ou un ancien document. L’état du nœud, l’adresse de connexion, les informations du compte et les contrôles d’accès sont ceux renvoyés par la commande actuelle dans la console.

01

Confirmez l’état du nœud

Vérifiez d’abord que le nœud physique associé à la commande est prêt à accepter les connexions. Si l’état est encore mis à jour, conservez l’identifiant de commande et attendez la prochaine indication de la console ; ne créez pas de commandes en double.

  • L’identifiant de commande correspond au modèle choisi
  • La région correspond à l’objectif réel du workflow
  • Les informations de connexion sont affichées au complet
02

Vérifiez l’adresse et le port

Vérifiez caractère par caractère l’adresse de l’hôte et le port, en vous assurant de ne pas avoir copié d’espace, de symbole pleine chasse ou d’informations d’un ancien nœud. Les utilisateurs d’un réseau d’entreprise doivent aussi confirmer que la politique de sortie autorise le port cible.

  • Copiez en priorité les champs de connexion actuels
  • Distinguez le délai d’attente réseau du refus d’authentification
  • Ne collez pas une adresse réelle sur une page publique
03

Confirmez le compte et les identifiants

Utilisez les informations de compte attribuées à la commande et limitez les droits de la clé privée à la lecture par l’utilisateur actuel. Les mots de passe, clés privées et certificats de signature ne doivent pas figurer dans le corps d’un e-mail ordinaire ni dans un dépôt public.

  • Le nom d’utilisateur correspond au nœud cible
  • Les droits du fichier de clé privée respectent les exigences SSH
  • Les anciens identifiants ont été supprimés des variables d’automatisation
04

Choisissez le mode de connexion adapté

Pour les commandes, la synchronisation du code et les tâches automatisées, privilégiez SSH ; pour accéder à l’interface graphique de macOS, utilisez le mode de connexion à distance fourni avec la commande.

  • SSH convient aux scripts, à Git et à l’administration du Runner
  • La connexion graphique convient aux vérifications dans l’interface Xcode
  • Si les deux modes échouent, comparez d’abord les chemins réseau
Connexion SSH

Traitez séparément les délais d’attente, les empreintes et les erreurs d’authentification

Les erreurs SSH surviennent à différentes étapes. Un délai d’attente indique généralement un problème de chemin réseau ; une modification d’empreinte d’hôte exige de vérifier d’abord l’identité du nœud ; en cas d’échec d’authentification, contrôlez le nom d’utilisateur, le format de la clé et les droits du fichier.

Fiche de vérification de connexion Aucun identifiant réel
Préparer la clé

Limitez les droits de lecture de la clé privée

Conservez la clé privée dans un répertoire contrôlé, hors du dépôt du projet. Si ses droits sont trop larges, le client SSH refusera d’utiliser le fichier.

chmod 600 ~/.ssh/mangovm_node
ssh -i ~/.ssh/mangovm_node -p <PORT> <USER>@<HOST>
Première connexion

Vérifiez séparément l’empreinte de l’hôte

Comparez l’empreinte affichée lors de la première connexion avec celle fournie dans la console. Si vous ne pouvez pas la confirmer, interrompez la connexion et envoyez un ticket ; n’ignorez pas l’avertissement.

Maintenir la session

Détachez les tâches longues du terminal local

Les builds, archivages et installations de dépendances doivent être exécutés par un Runner, launchd ou un outil fiable de gestion de session. Ne laissez pas une tâche critique dépendre d’une seule session SSH sur votre ordinateur portable.

Permission denied

Vérifiez successivement le nom d’utilisateur, le chemin de la clé privée, ses droits et la correspondance de la clé avec le nœud actuel. Si le réseau est établi mais l’authentification échoue, il n’est pas nécessaire de redémarrer d’abord le nœud.

Envoyer un ticket avec le résumé d’authentification

Connection timed out

Testez d’abord depuis un autre réseau fiable, puis notez le port cible, la sortie Internet publique du client, ainsi que les heures de début et de fin. Un délai d’attente n’est pas lié au contenu de la clé ; ne changez pas sans cesse de clé pour masquer un problème réseau.

Poursuivre dans l’arbre de diagnostic
Intégration CI/CD

Gardez le Runner actif, sans concurrence illimitée

Un nœud physique fixe convient au maintien de la chaîne d’outils et du cache du projet. La stabilité repose sur une limite de concurrence claire, des répertoires de travail isolés, des journaux traçables et le nettoyage en fin de tâche, pas sur l’empilement de processus en arrière-plan.

Enregistrement

Utilisez une identité Runner dédiée

Créez un Runner distinct pour chaque projet ou organisation et indiquez clairement dans ses étiquettes la puce, la chaîne d’outils et l’usage. Utilisez le jeton d’enregistrement uniquement dans un environnement contrôlé, puis supprimez-le des commandes temporaires et des journaux.

Étiquettes recommandées
macos, arm64, m4
Répertoire de travail
Un chemin distinct par projet
Concurrence

Commencez avec une seule tâche concurrente

Les gros builds Xcode, les tests sur simulateur et les archivages peuvent mobiliser simultanément le processeur, la mémoire et le disque. Commencez avec une seule tâche, observez les pics, puis ajustez progressivement selon les journaux réels.

Stratégie de départ
Un Runner, une tâche concurrente
Critères d’extension
Durée de file et pics de ressources
Éléments sensibles

Protégez les éléments de signature

Les certificats de signature, clés et jetons d’accès doivent être isolés dans des variables contrôlées ou par les droits du système, sans être écrits dans le dépôt, les artefacts de build ou des journaux téléchargeables. Supprimez les fichiers temporaires à la fin de la tâche.

Règle des journaux
Masquer les jetons et chemins sensibles
Règle de sortie
Révoquer les accès temporaires et nettoyer
Traçabilité

Conservez des journaux reproductibles

Notez la version soumise, la version de Xcode, le SDK, le fichier de verrouillage des dépendances, l’heure de début, le code de sortie et les erreurs clés. Dans un ticket, joignez uniquement des extraits expurgés et l’identifiant de la tâche.

Champs minimaux
Version, heure, tâche, code de sortie
Objectif de conservation
Pouvoir reproduire le même build
Administration macOS

Avant une mise à niveau, vérifiez que la chaîne d’outils peut être restaurée

Les nœuds MangoVM fonctionnent normalement 365 jours par an. Vous choisissez d’effectuer les mises à niveau de macOS et des outils de développement pendant un creux d’activité ; avant toute modification, sauvegardez les données, vérifiez la compatibilité et préparez les éléments de retour arrière.

Préparation

Créez une sauvegarde ponctuelle

Exportez au même instant les projets, fichiers de verrouillage des dépendances, configurations de build, journaux clés et données locales à conserver, puis notez l’étendue de la sauvegarde et le résultat de la vérification. La sauvegarde doit être séparée du disque local du nœud.

Validation

Établissez une liste de compatibilité

Vérifiez un à un la version cible de macOS, Xcode, le SDK, le gestionnaire de paquets, le Runner et les scripts du projet. Validez d’abord compilation, tests, archivage et préparation de l’envoi sur des tâches non critiques.

Exécution

Mettez en pause les tâches qui écrivent des données

Empêchez les nouveaux builds d’entrer dans la file et vérifiez qu’aucun archivage, nettoyage du cache ou mise à jour de dépendances n’écrit sur le disque. Notez l’heure de début, l’exécutant et la version avant mise à niveau.

Retour arrière

Définissez d’abord les conditions d’échec

Si un projet essentiel ne compile plus, si le Runner ne peut pas s’enregistrer ou si une dépendance centrale est incompatible, cessez toute modification, conservez les journaux et restaurez les données et la chaîne d’outils selon les étapes prévues.

Éléments de la chaîne d’outils à vérifier avant et après la mise à niveau
Élément contrôlé À relever avant la mise à niveau Validation après la mise à niveau À conserver en cas d’anomalie
Xcode et SDK Version actuelle, cible du projet, chemin des outils en ligne de commande Compilation, tests unitaires, archivage Sortie de version et premier journal d’échec
Gestion des dépendances Fichier de verrouillage, paramètres de miroir, portée du cache Restaurer les dépendances dans un répertoire vierge Fichier de verrouillage et extrait de l’erreur de résolution
Service Runner Étiquettes, concurrence, répertoire de travail, mode de démarrage Revenir automatiquement en ligne et prendre des tâches après redémarrage État du service et code de sortie de la tâche
Données du projet Étendue de la sauvegarde, emplacement d’export, résultat de vérification Lecture par échantillon et test de restauration Chemins manquants et dernière version fonctionnelle
Stockage et interconnexion

Une capacité correcte ne garantit pas l’utilisation du bon chemin

En cas de problème de stockage supplémentaire ou d’interconnexion Thunderbolt 5, vérifiez d’abord les options de la commande, puis la détection par le système, le chemin de montage, les droits des répertoires et la configuration de la tâche. Les prix et périodes sont ceux indiqués officiellement sur la page des offres.

État de l’option

Vérifiez que la commande comprend l’option souhaitée, que la période de facturation correspond et que la console a renvoyé la configuration associée. Ne vous fiez pas uniquement à un ancien chemin dans le script du projet.

  • Notez l’identifiant de commande et le nom de l’option
  • Confirmez la correspondance entre le nœud actuel et la commande
  • Conservez le résumé d’état renvoyé par la console

Montage et autorisations

Vérifiez que le système détecte le volume cible et que l’utilisateur du build dispose des droits de lecture et d’écriture nécessaires sur le répertoire de travail. N’ouvrez pas des droits excessifs sur tout le disque pour contourner le problème d’un seul répertoire.

  • Vérifiez le nom du volume et le chemin de montage réel
  • Contrôlez le compte système utilisé par le Runner
  • Confirmez que le chemin reste valide après redémarrage

Interconnexion Thunderbolt 5

Vérifiez chaque option interconnectée, le câblage et l’affectation des tâches. Validez d’abord les lectures-écritures ou la coopération entre nœuds avec une seule tâche reproductible, puis relancez la file groupée.

  • Notez les identifiants de commande concernés
  • Clarifiez le lien entre tâche principale et tâches associées
  • Conservez l’étape en échec et le résultat de la détection système

Vérifiez d’abord l’option officielle avant de signaler l’anomalie

La page des offres indique les tarifs à la journée, à la semaine, au mois et au trimestre pour +1TB SSD, +2TB SSD et l’interconnexion Thunderbolt 5. Pour une question de facturation, fournissez aussi l’identifiant de commande et la période choisie.

Voir les options et les tarifs
Arbre de diagnostic

Ne validez qu’une couche à la fois et consignez le résultat

Sauter une couche préalable mélange les symptômes. Suivez l’ordre ci-dessous et notez à chaque étape l’heure, le résultat et les modifications ; ne passez à la suivante qu’après validation de la précédente.

  1. 01

    L’état de la console autorise-t-il la connexion ?

    Vérifiez l’état du nœud, l’identifiant de commande, la région et l’exhaustivité des informations de connexion. Si les informations sont encore mises à jour, interrompez les tentatives d’authentification locales et consignez l’état actuel.

    Critère de réussite : état normal, adresse et champs d’accès complets.
  2. 02

    Le réseau local atteint-il le port cible ?

    Effectuez un nouveau test depuis un autre réseau fiable afin d’écarter les différences de chemin dues à la sortie d’entreprise, au pare-feu, au proxy ou au VPN local. Notez le réseau testé et l’heure.

    Critère de réussite : le port cible accepte la connexion, sans nouveau délai d’attente.
  3. 03

    Les informations d’authentification correspondent-elles au nœud actuel ?

    Vérifiez le nom d’utilisateur, le chemin de la clé, les droits du fichier et l’empreinte de l’hôte. Ne réutilisez pas directement les entrées known_hosts d’un ancien nœud ni les variables d’automatisation pour une nouvelle commande.

    Critère de réussite : identité de l’hôte confirmée, authentification réussie.
  4. 04

    Les services système sont-ils dans l’état attendu ?

    Vérifiez SSH, le Runner, l’agent de build et les services requis par le projet. Notez l’état des services, le dernier code de sortie et la dernière modification de configuration ; ne redémarrez pas en boucle sans journal.

    Critère de réussite : le service cible fonctionne et son mode de démarrage est identifié.
  5. 05

    Les processus de tâche sont-ils bloqués par les ressources ou la configuration ?

    Vérifiez la file de concurrence, l’espace disque, les droits du répertoire de travail, le verrouillage des dépendances et le délai d’expiration. Consignez séparément la première étape échouée et les erreurs en cascade.

    Critère de réussite : la tâche minimale s’exécute de façon reproductible et son code de sortie est explicable.
Parcours d’escalade de l’assistance

Des problèmes différents exigent des ensembles minimaux d’informations différents

Plus les informations correspondent à la couche en cause, plus l’équipe d’assistance peut reproduire le problème facilement. Tous les canaux n’acceptent que les informations nécessaires ; demandez d’abord au support comment transmettre les éléments sensibles en toute sécurité.

Demande générale

Évaluation de la configuration, de la période et du workflow

Indiquez la tâche visée, le niveau de concurrence, la région préférée, la durée prévue et les besoins de stockage. Pour une commande existante, fournissez son identifiant, sans envoyer d’identifiants de connexion.

Concerne
Choix du modèle, options, période, explication de la facturation
À préparer
Charge de travail, concurrence, région, identifiant de commande
Voir l’orientation des demandes
Nœud inaccessible

Envoyez en priorité un ticket via la console

Fournissez l’identifiant de commande, la région, le mode de connexion, l’heure, le réseau client, le résumé de l’erreur et les résultats des cinq premiers niveaux de l’arbre de diagnostic. N’écrivez pas seulement « impossible de se connecter ».

Concerne
Délai d’attente, anomalie d’authentification, service hors ligne
À préparer
Période, étapes de reproduction, journaux expurgés
Envoyer un ticket pour nœud inaccessible
Incident de sécurité des données

Limitez d’abord l’impact, puis signalez l’étendue

Arrêtez les tâches suspectes, révoquez les accès temporaires potentiellement exposés et conservez les journaux et la chronologie. Indiquez l’identifiant de commande, le mode de détection, l’étendue de l’impact et les mesures prises ; n’envoyez pas de clé encore utilisable.

Concerne
Accès inhabituel, exposition d’informations sensibles, processus suspect
À préparer
Chronologie, description de l’impact, mesures d’isolement
Voir les principes de protection des données

Préparez l’identifiant de commande et la période concernée avant de commencer.

Besoin d’un nouveau nœud ? Lancez directement la commande. Si une commande existante présente un problème, envoyez depuis la console un ticket contenant les étapes de reproduction et des journaux expurgés.