Connexion
Session SSH ou VNC impossible à établir
Pour les délais de connexion, changements d’empreinte hôte, identifiants refusés, interruptions de session graphique ou anomalies après reconnexion.
Voir le diagnostic de connexion
Centre d’assistance
Localisez d’abord le problème, puis agissez
Cette page regroupe les problèmes de connexion, système, réseau, stockage, compilation et compte de RunnerVPS Mac dans le cloud. Recherchez d’abord votre symptôme, puis suivez le parcours de diagnostic étape par étape afin d’éviter les essais répétés avec plusieurs variables modifiées à la fois.
Version de la documentation 2026.09 couvrant 5 nœuds disponibles
ASSISTANCE RUNNER
Rapport de diagnostic de connexion
Vérification séquentielle
A
Confirmer l’état de l’appareil
Vérifiez l’identifiant, la région et l’état d’accès actuel de l’appareil
Départ
B
Distinguer les voies d’accès
Testez séparément les connexions SSH et graphiques
Orientation
C
Rassembler des éléments reproductibles
Notez l’heure, l’erreur, l’environnement réseau et les journaux anonymisés
Transmission
- Principe de traitement
- Ne modifier qu’une variable à la fois
- Contacter l’assistance
- Associer l’appareil avant d’envoyer un ticket
Catégories de problèmes
Associer chaque symptôme à son point de contrôle
Les six catégories sont affichées simultanément : inutile de changer de filtre. Chaque carte indique les symptômes les plus courants, les vérifications prioritaires et l’emplacement correspondant sur cette page.
Système
La version de la chaîne d’outils a changé
Pour une mauvaise sélection Xcode, un chemin d’outils en ligne de commande modifié, une incompatibilité après mise à jour système ou des variables d’environnement invalides.
Voir les méthodes de maintenance
Réseau
Échec d’extraction, d’envoi ou de redirection de port
Pour une extraction Git interrompue, un transfert SFTP échoué, un tunnel SSH inaccessible, une résolution DNS anormale ou des restrictions du réseau local.
Voir les conseils de transfert
Stockage
Le cache de compilation remplit le disque local
Pour une croissance continue de DerivedData, des archives, du cache de dépendances ou des journaux entraînant un échec de compilation, une exportation interrompue ou une baisse de vitesse d’écriture.
Vérifier l’espace disque
Compilation
Échec de signature, d’archivage ou d’automatisation
Pour des certificats et fichiers de signature incompatibles, un environnement runner différent, un cache de dépendances pollué ou une archive non générée.
Voir la maintenance de compilation
Compte
Vérifier une commande ou un appareil
Lorsque l’état de location, l’identifiant de l’appareil, la commande, l’adresse e-mail de notification ou l’objet associé au ticket doit être confirmé.
Ouvrir la console
Diagnostic de connexion
Réduire le périmètre de la panne dans le même ordre
Ne réinitialisez pas simultanément les identifiants, ne changez pas de réseau et ne modifiez pas les paramètres système. Conservez d’abord l’erreur d’origine et effectuez une seule vérification à la fois pour comparer les résultats.
01
État du nœud
Dans la console, vérifiez l’identifiant, la région, la période de location et l’état d’accès de l’appareil. Confirmez qu’il s’agit bien de l’appareil cible et notez l’heure de chaque changement d’état.
02
Identifiants d’accès
Vérifiez le nom d’utilisateur, le chemin de la clé privée SSH et les permissions du fichier. Ne collez jamais de clé privée, de mot de passe ou d’identifiants de connexion complets dans un e-mail, une conversation ou un journal ordinaire.
03
Canal SSH
Vérifiez d’abord l’empreinte de l’hôte, puis utilisez la sortie détaillée pour localiser l’étape en échec. Distinguez DNS, établissement TCP, négociation de clé et authentification utilisateur au lieu de conclure à partir d’un simple « échec de connexion ».
04
Session graphique
Si SSH fonctionne mais que VNC présente un problème, vérifiez l’adresse du client, l’état de la session et la résolution. Après une coupure, attendez la libération de la session initiale avant de vous reconnecter au même appareil.
05
Pare-feu système
Vérifiez que les processus nécessaires à l’accès distant fonctionnent toujours et que les ports concernés sont bien en écoute. Enregistrez la configuration actuelle avant de modifier les règles afin de pouvoir revenir en arrière.
06
Réseau local
Ne changez de réseau local qu’en dernier recours pour comparer les résultats. Désactivez temporairement les proxies ou VPN susceptibles de modifier le routage, puis comparez réseau professionnel, réseau domestique et partage de connexion mobile.
Bureau distant
Rendre la session graphique récupérable et transmissible
VNC convient aux tâches nécessitant Xcode, des outils de prévisualisation et des applications graphiques. Vérifiez d’abord que le canal SSH fonctionne afin de conserver une voie de contrôle en ligne de commande si la session graphique échoue.
Préparer un client VNC contrôlé
Installez le client depuis une source fiable et enregistrez le nom de l’appareil plutôt que de partager des identifiants complets. Lors de la première connexion, vérifiez la région et l’identifiant de l’appareil, puis les paramètres de chiffrement et de disposition du clavier.
- Enregistrer séparément le nom de l’appareil et l’adresse d’accès
- Chaque membre de l’équipe utilise son propre accès contrôlé
- Privilégier une connexion via un réseau contrôlé ou un tunnel SSH
Ajuster d’abord la résolution, puis évaluer la fluidité
L’affichage distant dépend de la résolution, de la profondeur des couleurs et du réseau local. Réduisez d’abord la surface d’affichage pour comparer, sans changer simultanément de client, de réseau et de paramètres d’affichage.
- Commencer par une résolution basse pour vérifier la réactivité des entrées
- Éviter d’évaluer l’affichage pendant le transfert de fichiers volumineux
- Noter le dernier changement de réglage avant l’apparition du problème
Verrouiller la session, sans forcer l’arrêt des processus
Lors d’une courte absence, verrouillez la session graphique au lieu de fermer une application qui exécute encore une compilation. Après reconnexion, vérifiez d’abord l’état de la tâche initiale avant de relancer un outil.
- Enregistrer le projet et les modifications non validées avant de partir
- Ne pas relancer immédiatement une tâche parce que l’affichage est figé
- Révoquer rapidement les accès d’un membre qui quitte l’équipe
Environnement de compilation
Stabiliser la chaîne d’outils, puis nettoyer les données régénérables
Les compilations continues supportent mal les changements d’environnement non documentés entre les tâches. Inscrivez la sélection des versions, les éléments de signature et le nettoyage du cache dans le guide d’exploitation de l’équipe.
Figer Xcode et les outils en ligne de commande
Consignez la version Xcode dans la configuration du projet et le script d’initialisation du runner, puis vérifiez le répertoire développeur avant chaque tâche. Après une modification du système ou de Xcode, exécutez un test minimal avant de relancer le pipeline complet.
Séparer certificats, fichiers de signature et dépôt de code
Les certificats, fichiers de signature, jetons et variables d’environnement doivent être injectés par le processus de gestion des secrets de votre équipe. Ne validez pas de justificatifs longue durée dans Git et ne transférez pas comme pièce jointe ordinaire un journal contenant des champs sensibles.
Nettoyer le cache selon son origine
Identifiez d’abord l’espace occupé par DerivedData, le cache de dépendances, les archives, les données de simulateur ou les ressources du projet. Supprimez en priorité les données régénérables et conservez les artefacts à récupérer ainsi que l’état nécessaire à l’analyse.
Liste de contrôle de l’environnement
Avant d’exécuter une tâche
- Xcode
- Version conforme aux contraintes du projet
- Répertoire développeur
- Pointant vers la chaîne d’outils cible
- Éléments de signature
- Injectés temporairement pour la tâche
- Espace disque
- Incluant cache, archives et exportations
- Test minimal
- Vérifier d’abord extraction, compilation et génération de l’artefact
Une modification à la fois
Écrire le résultat dans le journal de compilation
Réseau et fichiers
Vérifier séparément le canal de connexion et le canal de fichiers
Commencez par un petit fichier pour vérifier le chemin et les permissions, puis transférez le dépôt, les ressources ou les artefacts complets. En cas d’échec, notez le sens du transfert, la taille, l’heure et l’étape précise.
Ne rediriger que les ports nécessaires
Précisez le port local, l’adresse cible et l’usage afin d’éviter une écoute trop large. Après création du tunnel, vérifiez séparément SSH et le service redirigé pour distinguer un problème d’authentification d’un problème applicatif.
Vérifier d’abord les permissions du répertoire
Utilisez un répertoire de projet dédié pour recevoir les fichiers, envoyez d’abord un petit échantillon et vérifiez les permissions de lecture et d’écriture. Une fois le gros fichier terminé, contrôlez sa taille ou sa somme de contrôle ; ne vous fiez pas uniquement à la barre de progression du client.
Limiter la portée des identifiants du dépôt
Utilisez pour l’automatisation des identifiants disposant du minimum de permissions, limités aux dépôts nécessaires. En cas d’échec, vérifiez séparément DNS, accessibilité distante, empreinte hôte, permissions des identifiants et adresse du dépôt.
Nettoyer les fichiers sources après le retour
Ajoutez à l’artefact l’identifiant de tâche, la version et les informations de vérification. Une fois sa réception complète confirmée côté cible, supprimez les fichiers intermédiaires du nœud afin d’éviter une nouvelle compilation impossible à comparer au résultat initial.
Articles pratiques
Des procédures aux stratégies d’équipe
Les articles ci-dessous sont classés par date décroissante et couvrent les mises à niveau système, la sécurité des connexions, le choix des services, l’audiovisuel, les compilations Unity iOS et les observations sur les tâches de développement M4.
Les articles pratiques sont en cours de préparation
Avant la publication complète des articles, utilisez les listes de contrôle de diagnostic de connexion, de maintenance système, de transfert réseau et d’environnement de compilation présentes sur cette page.
Assistance humaine
Recevoir un ticket prêt à être diagnostiqué
Pour les problèmes techniques, envoyez de préférence un ticket via la console afin de l’associer à l’appareil et à la commande concernés. Si vous ne pouvez pas vous connecter, envoyez un e-mail à support@runnervps.com ; n’y joignez toutefois ni mot de passe, ni clé privée, ni justificatif de paiement complet.
Identifiant de l’appareil
Nom de l’appareil affiché dans la console ; n’envoyez pas le mot de passe d’accès
Région
Singapour, Japon (Tokyo), Corée du Sud (Séoul), Hong Kong ou côte Est des États-Unis
Heure du problème
Inclure le fuseau horaire et indiquer la période de la dernière opération normale
Étapes de reproduction
Décrire les commandes, actions et résultats réels dans l’ordre d’exécution
Journaux anonymisés
Supprimer jetons, clés, mots de passe, identifiants de dépôt et données personnelles
Besoin d’un M4 dédié pour reproduire un problème ?
Runner M4 et Runner M4 Plus sont des machines physiques dédiées, non des machines virtuelles. Ils sont disponibles à la location à la journée, à la semaine, au mois ou au trimestre. La disponibilité réelle est celle indiquée en temps réel dans la console.