-
01
Vérifier les informations du nœud Le numéro de commande, l’adresse du nœud, le port et le nom du compte doivent correspondre au même hôte.Base
-
02
Vérifier le chemin réseau Refaites le test après avoir changé de réseau afin de distinguer un problème de sortie locale d’un problème du nœud cible.Réseau
-
03
Vérifier les informations d’accès Vérifiez la date de mise à jour des identifiants, la clé SSH et l’empreinte de l’hôte.Identité
-
04
Vérifier la session macOS Vérifiez que la session graphique, l’écran verrouillé et les tâches en arrière-plan fonctionnent toujours.Session
-
05
Écarter les différences entre clients Notez la version du client, les paramètres d’affichage, le proxy et le texte exact de l’erreur.Local
Identifiez d’abord le problème, puis adressez-le au bon interlocuteur
Cette page couvre la livraison, la connexion distante, SSH, Xcode, CI/CD, le stockage et la facturation des Mac dans le cloud. Effectuez d’abord les cinq vérifications de base : vous saurez généralement en un seul cycle si le problème vient du réseau local, des informations d’accès, de la session macOS ou de l’environnement de build.
Si l’intervention d’un ingénieur est nécessaire, joignez au ticket de la console le numéro de commande, le nœud cible, l’heure du problème, des captures d’écran et les étapes déjà effectuées. Ne transmettez jamais de mot de passe, de clé privée ou d’identifiant de récupération.
- 7 catégories
- Points d’accès
- 5 étapes
- Diagnostic de base
- 2 moyens
- Canaux de contact
Sept points d’entrée pour éviter de commencer au mauvais endroit
Choisissez le point d’entrée qui correspond le mieux à la situation. Chaque carte indique la première vérification et les preuves à conserver, sans masquer les autres catégories de problèmes.
Commande envoyée, mais informations d’accès non confirmées
Vérifiez d’abord l’état de la commande, le modèle choisi et le nœud cible, puis confirmez que la console a généré l’adresse du nœud, le port, le nom du compte et les instructions de connexion.
- Notez le numéro de commande et l’heure d’envoi
- Vérifiez que le nœud choisi correspond à la commande
- Ne recréez pas plusieurs fois la même commande
Interface graphique inaccessible, écran noir ou déconnexions fréquentes
Vérifiez d’abord l’adresse et le port du nœud, puis refaites le test depuis un autre réseau. Conservez le nom et la version du client, les paramètres d’affichage et une capture complète de l’erreur.
- Vérifiez que la session n’est pas bloquée sur l’écran verrouillé
- Réduisez la résolution d’affichage et recommencez le test
- Vérifiez le proxy local et les règles du pare-feu
Clé refusée, empreinte modifiée ou délai de connexion dépassé
Vérifiez séparément les permissions de la clé privée locale, le contenu de la clé publique, le compte cible, le port et l’empreinte de l’hôte. Ne collez pas la clé privée dans un ticket ou un e-mail.
- Conservez le texte exact de l’erreur avec son horodatage
- Vérifiez que la clé publique n’a pas été altérée par un retour à la ligne
- Après remplacement de la clé, conservez d’abord l’ancienne session
Versions incompatibles, build échoué ou cache anormal
Notez les versions de macOS, Xcode, du commit du projet et des dépendances. Effectuez d’abord une vérification de l’environnement sans modifier le code, puis décidez s’il faut nettoyer le cache.
- Conservez le premier journal d’échec réel
- Distinguez les erreurs d’environnement des erreurs de code
- Notez l’espace occupé par les caches avant tout nettoyage
Runner hors ligne, tâche bloquée ou répertoire de travail différent
Vérifiez le processus du runner, sa portée d’enregistrement, le répertoire de travail, les tâches concurrentes et la sortie réseau. Lancez d’abord une tâche de test minimale avant de rétablir le pipeline complet.
- Notez l’identifiant de la tâche échouée
- Vérifiez la dernière heure de connexion du runner
- Vérifiez que le cache n’a pas saturé le disque
Espace disque en baisse, cache trop volumineux ou échec d’écriture
Commencez par mesurer l’espace par répertoire et distinguez fichiers du projet, caches de dépendances, artefacts de build, journaux et fichiers temporaires. Ne supprimez pas directement les répertoires système d’origine inconnue.
- Notez l’espace disponible et les répertoires anormaux
- Vérifiez les fichiers journaux qui augmentent continuellement
- Après nettoyage, relancez le build minimal
Vérification de la période, du nœud, des options ou du paiement
Vérifiez ligne par ligne sur la facture en dollars le modèle, la durée, le nœud, l’extension de stockage et le nombre de connexions Thunderbolt 5 parallèles, puis contrôlez l’historique du moyen de paiement.
- Confirmez la période journalière, hebdomadaire, mensuelle ou trimestrielle
- Vérifiez la quantité et le prix unitaire des options
- Joignez le numéro de commande, sans transmettre de clé de paiement
Les journaux de build, le texte exact des erreurs, la version du client, l’espace disque et l’heure du problème réduisent fortement les échanges de clarification. Pour les identifiants, décrivez uniquement leur état et n’envoyez ni mot de passe, ni clé privée, ni identifiant de récupération.
Transformez « impossible de se connecter » en cinq étapes vérifiables
Notez le résultat après chaque étape. Ne changez pas simultanément de réseau, de clé et de client : sinon, même après résolution, la cause réelle restera inconnue.
Panneau de diagnostic rapide
-
01
Informations du nœudSortie : fiche du nœud
Dans la console, vérifiez le numéro de commande, le code du nœud, son adresse, le port et le nom du compte. Lors d’un copier-coller, contrôlez les espaces au début et à la fin ; ne saisissez pas ces données de mémoire.
-
02
Accessibilité du réseauSortie : comparaison réseau
Notez le réseau actuel, le proxy et l’environnement de sortie, puis testez séparément le réseau initial et un autre réseau fiable. Si un seul réseau échoue, vérifiez en priorité les restrictions de sortie locales.
-
03
État des identifiantsSortie : description de l’état
Vérifiez que les identifiants temporaires ont été mis à jour, que la clé publique SSH est complète et que les permissions de la clé privée sont correctes. Comparez aussi l’empreinte de l’hôte avec le premier relevé.
-
04
État de la session macOSSortie : périmètre de la session
Déterminez si l’hôte entier est inaccessible ou si seule la session graphique ne répond plus. Si SSH fonctionne encore, vérifiez d’abord la session, l’écran verrouillé et les processus concernés.
-
05
Paramètres du client localSortie : comparaison client
Notez le nom et la version du client, la résolution, les réglages colorimétriques, le proxy et le texte exact de l’erreur. Lors d’un nouveau test avec un autre client compatible, gardez les autres conditions identiques.
Un seul maillon est identifié
Par exemple, un seul réseau local échoue, seule une ancienne clé est refusée ou un seul client présente un problème d’affichage. Ne modifiez qu’une variable à la fois, puis vérifiez à nouveau.
Le problème se reproduit sur plusieurs réseaux et clients
Regroupez les résultats des cinq vérifications, l’heure du problème et les captures d’erreur dans un même ticket. Les ingénieurs pourront poursuivre directement l’examen du nœud et de la session à partir de ces preuves.
Unifiez les objets pour ne pas confondre protocole, session et hôte
Ces termes apparaissent dans les informations de livraison, les instructions de connexion et les réponses aux tickets. Utilisez autant que possible le terme approprié pour décrire votre problème.
- Mac dans le cloud
- Environnement macOS accessible par réseau, utilisable pour les builds Xcode, les tests automatisés, les scripts et l’inférence de modèles locaux. Le terme décrit le mode d’utilisation et n’implique pas la virtualisation.
- Nœud physique
- Hôte Apple Silicon qui exécute réellement la commande et son emplacement réseau. Les informations du nœud comprennent généralement l’adresse, le port et le code de région.
- Dédié
- Une location active correspond à un hôte physique dédié ; ses ressources de calcul ne sont pas partagées avec d’autres locataires.
- Non virtualisé
- L’objet livré est une machine physique dédiée, et non une instance virtuelle découpée depuis un hôte partagé. Lors du dépannage, distinguez l’état de l’hôte de celui de la session distante.
- VNC
- Protocole de bureau distant utilisé pour accéder à l’interface graphique de macOS. Il convient à l’utilisation de Xcode, aux outils graphiques et à la vérification de la session de bureau.
- SSH
- Méthode de connexion sécurisée pour l’accès en ligne de commande, l’exécution de scripts, la gestion de fichiers et l’administration CI/CD. Vérifiez l’adresse, le port, le compte, la clé et l’empreinte de l’hôte.
- self-hosted runner
- Exécuteur d’intégration continue déployé sur l’hôte loué. L’équipe configure elle-même la portée du projet, le répertoire de travail, le nombre de tâches parallèles et la stratégie de cache.
- Reprendre une session
- Revenir à la session macOS existante après une déconnexion du bureau distant. Cela restaure la session graphique, sans redémarrer l’hôte ni recréer l’environnement de build.
Traitez séparément la première connexion, le remplacement de clé et les problèmes d’affichage
Développez l’entrée correspondant à la situation et suivez les étapes dans l’ordre. Ne changez qu’une condition à la fois, puis testez avant de poursuivre.
Que faut-il vérifier en premier si la première connexion distante échoue ?
Recopiez dans la console l’adresse du nœud, le port et le nom du compte, puis confirmez qu’ils proviennent de la même commande. Vérifiez ensuite si votre réseau local utilise un proxy, limite certains ports ou applique des règles de pare-feu supplémentaires.
- Notez le nom et la version du client ainsi que le texte complet de l’erreur.
- Vérifiez qu’aucun espace superflu ne figure dans les champs et respectez la casse du nom du compte.
- Testez depuis un autre réseau fiable, sans changer simultanément les identifiants.
- Si SSH fonctionne mais pas l’interface graphique, indiquez clairement cette différence dans le ticket.
Pourquoi l’ancienne connexion échoue-t-elle encore après la mise à jour des identifiants temporaires ?
Quittez complètement le client qui conserve les anciens identifiants, puis établissez une nouvelle connexion. Certains clients mettent en cache le nom du compte ou les informations d’authentification ; modifier uniquement le champ du mot de passe ne suffit pas toujours à effacer l’ancien enregistrement.
Après avoir vérifié les nouveaux identifiants, supprimez l’ancien enregistrement. N’affichez pas le mot de passe dans un ticket, une capture ou un e-mail ; indiquez seulement l’heure de mise à jour, le compte utilisé et le type d’erreur.
Comment remplacer une clé SSH sans perdre l’accès ?
Gardez la session SSH actuelle ouverte, puis ajoutez et vérifiez la nouvelle clé publique. Ouvrez une seconde connexion depuis un autre terminal ; une fois la nouvelle clé validée, supprimez l’ancienne clé publique.
- Générez une clé distincte pour cet hôte et ne réutilisez pas un fichier de clé d’origine inconnue.
- Vérifiez que la clé publique tient sur une seule ligne et qu’elle est complète, sans retour à la ligne ni troncature lors du copier-coller.
- Vérifiez les permissions de la clé privée locale et le compte cible.
- Conservez l’empreinte de l’hôte ; si elle change de façon inattendue, interrompez la connexion et ouvrez un ticket pour vérification.
Que faire si VNC affiche un écran noir, une image déformée ou une forte latence de saisie ?
Vérifiez d’abord si SSH fonctionne encore. Si la connexion en ligne de commande est normale, le problème vient probablement de la session graphique ou des paramètres d’affichage du client, et non d’un nœud physique entièrement hors ligne.
Réduisez la résolution et la qualité des couleurs du client, désactivez le proxy local et retestez. Notez si le problème apparaît uniquement en plein écran, avec zoom ou en mode multi-écrans. Ne forcez pas l’arrêt de plusieurs processus système à la suite.
Comment obtenir un résultat reproductible lorsque la latence semble élevée ?
Notez le type de réseau local, le nœud cible, la plage horaire, le protocole utilisé et la version du client. Effectuez les mêmes étapes sur le réseau initial et sur un autre réseau fiable, en conservant la résolution, le proxy et la charge de travail identiques.
Ne vous contentez pas de conclure « c’est très lent ». Précisez dans le ticket si le ralentissement concerne la réponse aux saisies, le rafraîchissement de l’écran, le transfert de fichiers ou l’affichage des commandes, et s’il se reproduit continuellement.
Stabilisez l’environnement avant d’analyser Xcode, le runner et le disque
L’objectif du dépannage n’est pas de vider immédiatement tous les caches, mais d’identifier la couche qui a changé et de conserver une trace reproductible.
Vérifier les versions de Xcode et macOS
Notez la version complète de Xcode, le chemin des outils en ligne de commande, la version de macOS et le commit du projet. Si l’équipe utilise une base de référence, comparez-la d’abord au dernier build réussi.
xcodebuild -version
xcode-select -p
sw_vers
Définir le périmètre de l’environnement de signature
Vérifiez les liens entre les réglages du projet, les fichiers de certificats, les profils de provisioning et les scripts de build. Vous pouvez joindre une capture d’erreur dont les champs sensibles sont masqués, mais ne téléversez ni clé privée de signature ni mot de passe.
- Conservez le texte exact de la première erreur de signature
- Notez la target en échec et la configuration de build
- Distinguez les erreurs du script local des erreurs de configuration du projet
Nettoyer le cache avec des preuves
Notez d’abord l’espace occupé par DerivedData, les caches de dépendances et le répertoire de travail, puis ne nettoyez que les répertoires liés au projet en échec. Après le nettoyage, exécutez un build minimal pour éviter que des tâches parallèles n’écrasent le résultat.
du -sh ~/Library/Developer/Xcode/DerivedData
df -h
Reconnecter le runner CI
Vérifiez le processus du runner, sa portée d’enregistrement, son répertoire de travail et sa dernière heure de connexion. Utilisez une tâche de test minimale, sans publication, pour valider le réseau, les permissions et l’environnement d’exécution.
- Notez l’identifiant et l’heure de la tâche échouée
- Vérifiez qu’aucun même exécuteur n’est enregistré plusieurs fois
- Vérifiez le propriétaire du répertoire de travail et l’espace restant
Identifier l’origine de la croissance du disque
Mesurez séparément les fichiers du projet, les dépendances, les artefacts de build, les journaux et les fichiers temporaires. Si l’espace continue de diminuer, notez le répertoire qui augmente et l’intervalle d’observation, puis ouvrez un ticket.
df -h
du -sh ~/Library/Developer/*
du -sh ~/Library/Caches/*
Conservez d’abord les journaux, les versions, l’espace disque et l’identifiant de la tâche échouée. Vider tous les caches ou écraser la configuration peut faire disparaître temporairement le problème, tout en supprimant les éléments nécessaires au diagnostic.
Vérifiez ligne par ligne la période, la configuration, le nœud et les options
Toutes les commandes sont facturées et réglées en dollars américains. Les moyens de paiement réellement disponibles sont ceux affichés en temps réel par la console.
Commencer par confirmer la période de location
La période peut être journalière, hebdomadaire, mensuelle ou trimestrielle. N’utilisez pas le tarif journalier pour déduire le prix d’une autre période : la commande doit suivre le prix catalogue du modèle sélectionné.
Vérifier uniquement deux moyens de paiement
Les paiements acceptés sont USDT-TRC20 et Visa / Mastercard / Amex (via Stripe). Le ticket doit uniquement mentionner le numéro de commande et un identifiant non sensible de la transaction.
Vérifier chaque élément de la facture
Confirmez le modèle, la durée, le nœud cible, le type de stockage supplémentaire et le nombre de connexions Thunderbolt 5 parallèles. La disponibilité affichée en temps réel par la console fait foi.
| Option supplémentaire | Par jour | Par semaine | Par mois | Par trimestre |
|---|---|---|---|---|
| +1TB SSD | $2.6 | $7.1 | $13.2 | $35.9 |
| +2TB SSD | $5.2 | $14.2 | $26.4 | $71.8 |
| Connexions Thunderbolt 5 parallèles (par machine) | $2 | $5.3 | $9.9 | $26.9 |
Indiquez le numéro de commande, le modèle, la période de location, le nœud cible, le nom et la quantité des options, ainsi qu’un identifiant de transaction non sensible. N’envoyez jamais le numéro complet d’une carte bancaire, de code de vérification, de clé privée de portefeuille ou de mot de passe.
Donnez au support technique les informations nécessaires pour commencer immédiatement
Pour un problème concernant un nœud utilisé, ouvrez de préférence un ticket depuis la console. Si vous ne pouvez pas vous connecter à la console, écrivez à support@officevps.com.
Un ticket complet doit contenir six éléments
Copiez le numéro complet depuis la console ; indiquez toujours ce numéro, et non seulement le nom du modèle ou la ville du nœud.
Indiquez le nœud réel de la commande parmi Singapour, Japon (Tokyo), Corée du Sud (Séoul), Hong Kong, Est des États-Unis ou Ouest des États-Unis.
Précisez l’heure locale et le fuseau horaire, et indiquez si le problème est continu ou intermittent.
Conservez le texte exact et son contexte, en masquant les identifiants de compte, clés privées, éléments de signature et autres informations sensibles.
Énumérez dans l’ordre les réseaux testés, les clients, les commandes et le résultat de chaque étape. Évitez d’écrire seulement « tout a été essayé ».
Précisez si vous souhaitez rétablir la connexion, vérifier une facture, reconnecter le runner ou identifier un échec de build précis.
Ticket dans la console
Adapté aux problèmes de nœud, de connexion, de build, de stockage et de facturation. Le contexte de la commande reste associé au ticket dans le même compte.
Adresse e-mail du support
Dans votre e-mail, indiquez l’adresse du compte, le numéro de commande et un résumé du problème. N’ajoutez ni mot de passe, ni clé privée, ni identifiant de récupération.
Si la documentation ne suffit pas, avancez selon l’état du ticket
L’état du ticket indique le responsable actuel et la prochaine action. Répondez dans le ticket existant pour ajouter des éléments ; ne créez pas plusieurs tickets pour un même problème.
Éléments placés dans la file
Vérifiez que le numéro de commande, le nœud, l’heure, les erreurs et les étapes déjà effectuées sont complets. Ajoutez les informations manquantes dans le ticket existant.
Vérification par l’équipe technique
L’équipe peut contrôler la connectivité du nœud, l’état de la session, les données de livraison ou le détail de la facturation. Évitez de modifier l’environnement pendant cette phase afin de ne pas introduire de nouvelles variables.
Davantage d’éléments reproductibles sont nécessaires
Ajoutez les journaux, captures, comparaisons réseau ou versions de client demandés dans le ticket. Envoyez uniquement les extraits pertinents et continuez à masquer les champs sensibles.
Vérifier le rétablissement et consigner le résultat
Effectuez un nouveau test avec le flux de travail habituel, puis notez la cause réelle, les étapes efficaces et les versions de l’environnement afin de conserver une base de référence pour l’équipe.
Choisissez une machine physique dédiée et déployez votre environnement de build sur le nœud adapté
Trois configurations Apple Silicon couvrent les builds légers, le développement quotidien, la CI parallèle et l’inférence de modèles locaux. Les seuls moyens de paiement acceptés sont USDT-TRC20 et Visa / Mastercard / Amex (via Stripe), avec une facturation exclusive en dollars américains (USD).