Commencer par vérifier en ligne de commande

Établissez d’abord une connexion SSH fiable, puis ouvrez une session graphique à distance si nécessaire

Ce guide rassemble la vérification de l’adresse du nœud, l’authentification de l’empreinte de l’hôte, les opérations graphiques dans Xcode, le transfert de code, l’optimisation réseau et la fermeture sécurisée en un parcours clair. Utilisez SSH en priorité pour les tâches en ligne de commande et ouvrez une session à distance uniquement lorsque vous avez besoin de l’interface graphique complète de macOS.

2 principaux modes d’accès
6 vérifications de première connexion
1 parcours de dépannage séquencé
Louer un Mac dans le cloud maintenant Consulter le centre d’aide
Plaque de connexion Parcours de session
Appareil local Vérification SSH Nœud physique
Tâches en ligne de commandeSSH
Opérations graphiques XcodeSession à distance
Code et artefactsGit / SFTP
Choisir le mode de connexion

Choisissez le canal selon la tâche au lieu de tout faire par défaut dans une session graphique

SSH consomme moins de données et convient aux compilations, journaux, dépendances et tâches automatisées. L’accès graphique à distance sert à utiliser l’interface Xcode, observer le simulateur et effectuer les réglages qui exigent le bureau.

Canal prioritaire

Ligne de commande SSH

Utilisez-le pour les opérations Git, l’installation des dépendances, l’exécution de scripts, la consultation des journaux, les compilations de test et les tâches CI. Vérifiez d’abord l’adresse du nœud, les identifiants et l’état de l’hôte via SSH avant de configurer les autres modes d’accès.

  • Adapté aux compilations longues et aux scripts automatisés
  • La déconnexion de l’interface graphique ne modifie pas les tâches exécutées en arrière-plan
  • Facilite la copie des commandes, l’enregistrement des journaux et la reproduction des erreurs
À établir selon les besoins

Session graphique à distance

Utilisez-la pour l’interface graphique Xcode, la vérification des réglages du projet, l’observation du simulateur et les applications de bureau. En cas de fluctuations réseau, réduisez d’abord la résolution, la fréquence d’images et la qualité des couleurs ; ne créez pas sans cesse de nouvelles sessions.

  • Adaptée aux opérations nécessitant une souris et un bureau complet
  • Vérifiez avant la connexion qu’aucune session existante n’est encore utilisée
  • À la fin, déconnectez-vous explicitement et supprimez la configuration temporaire locale
Première connexion SSH

Vérifiez l’adresse, le nom d’utilisateur, les permissions de la clé et l’empreinte de l’hôte point par point

Les informations de connexion doivent être consultées dans les détails de l’instance correspondante à la commande. N’utilisez pas une adresse de nœud ou des identifiants provenant d’une conversation, d’une ancienne capture d’écran ou d’un texte transféré. Lorsqu’une empreinte d’hôte s’affiche à la première connexion, comparez-la d’abord à celle des détails de l’instance et n’acceptez la connexion qu’en cas de correspondance exacte.

01

Lire les informations de connexion

Vérifiez la région du nœud, l’adresse, le port SSH, le nom d’utilisateur et le type de clé ; confirmez que ces champs correspondent à la même commande et au même nœud physique.

02

Limiter les permissions de la clé

La clé privée ne doit être lisible que par l’utilisateur local actuel. Si le client signale des permissions trop larges, corrigez d’abord les permissions du fichier, puis relancez la connexion.

03

Vérifier l’empreinte de l’hôte

Comparez caractère par caractère le type d’algorithme et la valeur de l’empreinte. En cas de différence, arrêtez la connexion et ne contournez pas l’avertissement en supprimant l’ancien enregistrement.

04

Effectuer les vérifications initiales

Après la connexion, vérifiez le nom d’hôte, l’utilisateur actuel, la version du système, l’espace disque disponible et le chemin Xcode avant d’installer les dépendances.

Exemple d’exécution de commandes

Vérifiez d’abord la connexion, puis lancez les contrôles de compilation et de publication

Les adresses, noms d’utilisateur, chemins et noms de projets ci-dessous sont des valeurs fictives non exécutables. Remplacez-les par les champs des détails de l’instance dans la console et ceux de votre projet.

Journal de vérification de connexion OpsVM · Exemple
SSH → BUILD → RELEASE 
$ ssh -i /path/to/private_key -p <port> <user>@<node-address>
The authenticity of host cannot be established.
ED25519 key fingerprint is <fingerprint-to-verify>.
Continue connecting only after verification: yes

<user>@<host> % hostname
<instance-hostname>

<user>@<host> % xcodebuild test \
  -workspace <project-workspace> \
  -scheme <test-scheme> \
  -destination 'platform=macOS'
Test Suite '<test-suite>' passed
Executed <test-count> tests, with 0 failures

<user>@<host> % bundle exec fastlane <workflow-name>
[fastlane] Checking project configuration
[fastlane] Running tests
[fastlane] Exporting artifact
[fastlane] Finished without reported errors
SSH Continuez uniquement si l’empreinte correspond aux détails de l’instance.
xcodebuild Commencez par un plan de test à périmètre contrôlé, puis élargissez la tâche.
Fastlane Conservez des journaux anonymisés afin de pouvoir reproduire l’étape de l’échec.
Accès graphique à distance

Établissez une session unique avec des paramètres explicites et préservez la marge nécessaire pour votre réseau

Les noms des champs varient selon le client graphique, mais la logique reste la même : l’adresse et le port proviennent des détails de l’instance, tandis que la résolution et la qualité d’image dépendent du réseau local. Activez le presse-papiers et le partage de fichiers uniquement au strict nécessaire.

  1. 01

    Vérifier d’abord le nœud et l’état de la session

    Dans la console, vérifiez que l’instance cible fonctionne normalement et qu’aucune session graphique existante ne l’utilise encore. Si plusieurs personnes suivent le même flux de travail, définissez d’abord les modalités de passation de session afin d’éviter les déconnexions mutuelles.

  2. 02

    Saisir l’adresse, le port et les informations d’authentification

    Copiez chaque paramètre de connexion depuis les détails de l’instance. Ne conservez pas de clés, mots de passe ou informations de récupération dans des notes publiques, des dépôts publics, des captures de tickets ou des répertoires synchronisés non chiffrés.

  3. 03

    Commencer avec une résolution et une qualité moyennes

    Pour la première connexion, utilisez un seul écran, une résolution de 1920×1080 ou inférieure et une qualité de couleur moyenne. Après avoir vérifié la stabilité des commandes et de l’affichage, augmentez progressivement les paramètres ; n’activez pas simultanément une résolution, une fréquence d’images et une profondeur de couleur élevées.

  4. 04

    Limiter le presse-papiers et le partage de répertoires

    N’activez le presse-papiers texte qu’en cas de besoin réel. Limitez le mappage des répertoires à un dossier d’échange dédié ; ne partagez pas directement le répertoire utilisateur local, celui des clés ou un chemin contenant des éléments de signature.

  5. 05

    Configurer le verrouillage et la déconnexion

    Vérifiez si la déconnexion du client conserve la tâche, verrouille le bureau ou ferme la session. Une fois le travail terminé, utilisez la procédure de sortie explicite ; ne fermez pas simplement la fenêtre du client en supposant que la session est terminée.

Transfert de fichiers et de code

Le code passe par le contrôle de version, les fichiers modifiés par synchronisation incrémentielle ; vérifiez les archives avant de les extraire

Lors du choix du mode de transfert, tenez compte de la traçabilité, des mises à jour incrémentielles, des permissions de fichiers et de l’exposition des informations sensibles. N’utilisez pas de lien de téléchargement public pour transférer temporairement du code privé ou des éléments de compilation.

Git

Récupérer du code et des configurations traçables

Convient au code du dépôt, aux fichiers de verrouillage des dépendances et aux configurations révisables. Vérifiez d’abord l’URL distante et la branche, puis récupérez les données ; configurez les identifiants privés par un moyen contrôlé, sans les inscrire dans le dépôt.

  • Vérifier d’abord le dépôt distant et la branche actuelle
  • Verrouiller les versions des dépendances et conserver les fichiers de verrouillage
  • Ne pas réintégrer les artefacts de compilation dans le dépôt source
SFTP

Synchroniser les données, journaux et artefacts

Convient au téléversement incrémentiel de ressources, au téléchargement de journaux anonymisés et au rapatriement d’artefacts de compilation. Limitez le répertoire distant cible, puis vérifiez le propriétaire, les permissions, la taille et la date de modification après le transfert.

  • Utiliser un répertoire d’échange dédié
  • Vérifier l’intégrité après le transfert de fichiers volumineux
  • Supprimer les copies devenues inutiles à la fin de la tâche
Vérification des archives

Comparer les condensats des paquets de données fixes

Convient aux ressources, caches ou archives livrés une seule fois. L’émetteur génère un condensat, puis le nœud le recalcule et compare les valeurs caractère par caractère ; n’extrayez l’archive et ne poursuivez le traitement qu’en cas de correspondance.

  • Consigner la taille et le condensat du fichier avant l’envoi
  • Extraire dans un répertoire isolé et vérifier d’abord le contenu
  • Refuser les scripts et fichiers binaires d’origine inconnue
Optimisation de la stabilité

Réduisez d’abord la charge d’affichage, puis déterminez s’il s’agit d’un problème réseau ou client

Une résolution, une fréquence d’images et une qualité de couleur élevées augmentent simultanément la pression sur le réseau. Modifiez un seul paramètre à la fois et conservez une comparaison avant/après afin de ne pas masquer la cause réelle par plusieurs changements.

Ajuster les paramètres de la session graphique à distance selon les performances réseau
Symptôme Première étape Deuxième étape Méthode de vérification
Latence de la souris Réduire la résolution Réduire la fréquence d’images Déplacer une fenêtre et vérifier la synchronisation des commandes
Redessin fréquent de l’écran Réduire la qualité des couleurs Désactiver les effets de bureau animés Faire défiler un fichier de code et observer la zone redessinée
Déconnexions intermittentes de la session Passer à une connexion filaire ou à un Wi-Fi stable Suspendre les autres tâches à fort trafic Maintenir une session SSH pour observer la continuité de la connexion
Les commandes répondent, mais l’affichage est figé Attendre la fin du rendu en cours Rétablir la session existante Éviter de créer plusieurs sessions graphiques parallèles
Priorité A Support de connexion

Privilégiez une connexion filaire ; en Wi-Fi, maintenez un signal stable et évitez les transferts continus à fort volume.

Priorité B Paramètres d’affichage

Ajustez successivement la résolution, la fréquence d’images et la qualité des couleurs ; ne modifiez qu’un paramètre à la fois et notez le résultat.

Priorité C Répartition des tâches

Gardez les compilations, journaux et traitements de fichiers dans SSH ; la session graphique doit rester réservée aux opérations qui l’exigent.

Dépannage de la connexion

Identifiez le problème dans l’ordre réseau, identité, session, affichage ; ne sautez aucune condition préalable

Après chaque étape, effectuez un nouveau test et conservez le texte complet de l’erreur, l’heure, la région du nœud et la version du client. Ne soumettez pas uniquement « impossible de se connecter » ou une seule capture recadrée.

Délai d’expiration de la connexion : que vérifier en premier

Vérifiez d’abord que le réseau local fonctionne, puis confirmez que l’adresse et le port du nœud proviennent des détails de l’instance actuelle. Vérifiez ensuite si le pare-feu local, les règles du réseau d’entreprise ou le VPN bloquent la connexion. Si SSH et la session graphique expirent tous deux, examinez en priorité le chemin réseau et l’état du nœud ; ne réinstallez pas sans cesse le client graphique.

Changement d’empreinte de l’hôte : pourquoi ne pas l’ignorer

Un changement d’empreinte peut provenir d’une adresse incorrecte, d’une connexion à un autre nœud ou d’une modification des informations de l’instance. Arrêtez la connexion, revérifiez dans la console l’adresse et l’empreinte actuelles, puis confirmez l’identifiant de commande et la région du nœud. Ne mettez à jour l’enregistrement local qu’après avoir confirmé l’origine de la nouvelle empreinte.

Échec d’authentification : distinguer le nom d’utilisateur, la clé et les permissions

Vérifiez d’abord que la casse du nom d’utilisateur correspond aux détails de l’instance, puis que le client charge bien la clé cible et non un ancien fichier portant le même nom. Contrôlez les permissions, le format et le chemin du fichier de clé ; si un agent ou un outil de gestion des clés est activé, vérifiez également qu’il n’a pas remplacé les éléments d’authentification attendus. N’essayez pas en boucle des identifiants provenant de sources inconnues.

Écran noir dans la session graphique : dans quel ordre vérifier

Maintenez d’abord la connexion SSH et confirmez que le système répond toujours ; vérifiez ensuite l’existence d’une session graphique, le niveau des paramètres d’affichage et la compatibilité du client avec le mode de connexion actuel. Après avoir réduit à un seul écran et à une résolution plus basse, reconnectez-vous à la session existante. Si SSH fonctionne mais que l’affichage reste indisponible, notez la version du client et l’heure de la session avant d’ouvrir un ticket.

Conflit de session : éviter les perturbations entre utilisateurs

L’équipe doit définir le responsable de la session actuelle et l’heure de passation. Vérifiez les sessions existantes avant de vous connecter et utilisez l’action de déconnexion ou de fermeture de session du client à la fin ; ne créez pas de force une nouvelle session pour contourner une session occupée. Pour conserver une compilation en arrière-plan, placez-la dans un flux de commandes persistant plutôt que de dépendre d’une fenêtre graphique ouverte.

Fournir les informations de dépannage

Un ticket doit contenir au moins cinq catégories d’informations

Identifiant de commande, région du nœud, heure du problème, étapes complètes de reproduction et journaux anonymisés. Pour une session graphique, ajoutez le nom et la version du client, la résolution et le type de réseau.

Ouvrir la console pour envoyer un ticket
Fermeture sécurisée

Terminer une session ne consiste pas seulement à fermer la fenêtre : traitez également les traces de connexion et les accès temporaires

Une fois la tâche terminée, fermez successivement la session graphique, arrêtez les écouteurs devenus inutiles, vérifiez l’exposition des identifiants et supprimez les fichiers d’échange temporaires locaux et présents sur le nœud.

Enregistrer le travail et fermer la session graphique à distance
Vérifier si la compilation en arrière-plan doit continuer
Fermer les ports transférés et les tunnels inutilisés
Supprimer la configuration de connexion temporaire locale et les fichiers d’échange
Supprimer les archives temporaires et les copies de journaux anonymisés du nœud
Vérifier les permissions et le répertoire des fichiers de clés
En cas de fuite, renouveler immédiatement les identifiants concernés
Consigner les étapes de récupération et les modifications apportées à l’environnement
Gestion des identifiants

En cas de doute sur une fuite, considérez l’identifiant comme compromis

Si des identifiants ont figuré dans un dépôt public, une capture partagée, un répertoire de téléchargement public ou des journaux non contrôlés, cessez immédiatement de les utiliser et procédez à leur renouvellement. Supprimer les copies publiques ne remplace pas le renouvellement, car le contenu peut déjà avoir été mis en cache ou copié.

Gestion des ports

Les accès créés temporairement doivent disparaître avec la tâche

Vérifiez les tunnels SSH, les redirections de ports, les processus en arrière-plan du client et les proxys locaux. Ne conservez que les accès ayant encore un usage clairement défini et consignez leur responsable, leur objectif et leurs conditions de fermeture.

Documentation de l’environnement

Conservez les informations reproductibles et retirez les éléments sensibles

Conservez la version du système, le chemin Xcode, les fichiers de verrouillage des dépendances, les commandes de compilation et le résumé des erreurs ; retirez les clés privées, mots de passe de compte, codes de récupération, archives d’échange temporaires et journaux non anonymisés.

Prêt à accéder à un nœud physique dédié

Choisissez d’abord la configuration et le nœud pour terminer le déploiement ; si vous préparez encore votre chaîne d’outils, poursuivez avec le guide du premier déploiement ou consultez le centre d’aide pour résoudre un problème précis.

Déployer un Mac dans le cloud maintenant Lire le guide de démarrage Poursuivre le dépannage de la connexion