Commencez par vérifier l’état

Identifiez d’abord le problème, puis envoyez des éléments directement exploitables.

Cette procédure couvre l’activation, la connexion, l’ouverture de session, les builds Xcode, les options de stockage, le renouvellement et la libération de votre Mac MiniDebug dans le cloud. Effectuez d’abord les vérifications locales, puis envoyez le contexte de la commande et les journaux anonymisés via un ticket dans la console.

Périmètre de l’assistance

Commencez par identifier la couche concernée.

Un échec de connexion distante, de build ou d’état de commande peut produire des symptômes similaires, mais les points de contrôle diffèrent. Ces six catégories peuvent être signalées via un ticket dans la console.

Commande et état de l’hôte

Vérifiez l’identifiant de commande, la durée, l’état de l’hôte et les informations de livraison. Les nouveaux achats, renouvellements et opérations de gestion de l’hôte s’effectuent dans la console ; l’état réel est celui renvoyé en temps réel par la console.

Nœud et connexion distante

Vérifiez les adresses, ports, itinéraires réseau et sessions distantes pour les cinq nœuds : Singapour, Japon (Tokyo), Corée du Sud (Séoul), Hong Kong et côte Est des États-Unis.

Ouverture de session et autorisations

Vérifiez la première connexion, la mise à jour des identifiants, les clés SSH, les autorisations des sessions graphiques et la portée d’accès du compte. Pour le travail en équipe, utilisez des identifiants individuels traçables.

Environnement de build

Analysez les tâches xcodebuild ou fastlane selon la version de Xcode, les outils en ligne de commande, le cache des dépendances, les éléments de signature, l’espace disque et les journaux de build.

Options de stockage

Vérifiez la capacité choisie, l’état du montage, l’espace disponible et les répertoires de tâches. En cas de manque d’espace, supprimez d’abord les caches régénérables, puis déterminez s’il faut ajuster la configuration.

Renouvellement et libération

Avant de renouveler, vérifiez la période et les options. Avant de libérer l’hôte, sauvegardez le code, les certificats, les modèles, les ressources et les artefacts de build, puis confirmez que les tâches automatisées n’écrivent plus de données.

Parcours de première activation

Validez votre première connexion en cinq étapes.

Ne commencez pas par une ancienne adresse enregistrée. Pour chaque commande, fiez-vous à l’état de l’hôte et aux informations de connexion affichés dans la console.

  1. 01

    Consulter la commande et l’état de l’hôte

    Connectez-vous à la console, ouvrez la commande correspondante, vérifiez le modèle MiniDebug M4 et la configuration M4, 16GB RAM, 256GB SSD, puis notez le nœud sélectionné. Si l’hôte n’est pas encore connectable, ne répétez pas les tentatives de connexion distante.

    Entrée : identifiant de commande
  2. 02

    Obtenir les informations de connexion de cette commande

    Copiez l’adresse cible, le port, le compte et les modes de connexion pris en charge. Conservez l’adresse et le port ensemble ; ne mélangez pas les paramètres SSH avec ceux de VNC ou du partage d’écran.

    Sortie : paramètres de connexion
  3. 03

    Effectuer la première ouverture de session

    Lancez la connexion de préférence depuis un appareil local fiable. Lors de la première connexion SSH, vérifiez l’empreinte de l’hôte ; pour une connexion graphique, confirmez que le nœud correspond à la commande et n’enregistrez pas les identifiants sur un appareil partagé.

    Vérification : identité de l’hôte
  4. 04

    Mettre à jour les identifiants et les accès

    Mettez immédiatement à jour les identifiants initiaux après la connexion ; pour l’automatisation SSH, privilégiez les clés. En équipe, limitez les membres autorisés et évitez le partage durable d’un compte ou l’écriture de mots de passe en clair dans les scripts.

    Action : mettre à jour les identifiants
  5. 05

    Vérifier le réseau et l’environnement de base du build

    Vérifiez l’accès au dépôt de code, la résolution DNS, l’espace disque, le chemin de Xcode et les outils en ligne de commande. Exécutez d’abord une commande de vérification légère, puis téléchargez toutes les dépendances ou lancez un build long.

    Résultat : environnement de base disponible
Orientation du dépannage des builds

Commencez par la première erreur reproductible.

La fin des journaux indique souvent seulement l’arrêt de la tâche. Remontez jusqu’à la première erreur stable, classez le problème dans l’une des six catégories ci-dessous, puis décidez s’il faut modifier le projet ou ouvrir un ticket d’infrastructure.

Signature du code

Distinguer l’identité, la cible et l’étape d’export

  • Vérifiez que la cible de build, le Bundle Identifier et la configuration de signature correspondent.
  • Vérifiez si l’échec survient à l’étape d’export après la réussite de l’archive.
  • Notez la première erreur de signature ainsi que les 20 lignes qui la précèdent et la suivent.

Orientation : L’utilisateur vérifie les paramètres de signature du projet ; si les éléments de signature sont illisibles, vérifiez ensuite les droits des fichiers et le chemin d’injection de l’automatisation.

Certificats et profils de provisioning

Vérifier la validité, la correspondance et les droits de lecture

  • Vérifiez que les fichiers requis se trouvent à l’emplacement réellement utilisé par la tâche.
  • Vérifiez la compatibilité des certificats, profils de provisioning et environnement cible.
  • N’inscrivez jamais de mots de passe, fichiers de certificats originaux ou clés complètes dans un ticket.

Orientation : Vérifiez d’abord la lecture dans une session interactive, puis reproduisez la tâche automatisée et comparez les variables d’environnement et le compte d’exécution.

Version de Xcode

Utiliser la même chaîne d’outils dans l’interface graphique et la ligne de commande

  • Notez la version de Xcode, la version du SDK et la plateforme cible.
  • Exécutez xcode-select -p pour vérifier le chemin actuel.
  • Vérifiez que le processus CI a bien hérité du répertoire développeur attendu.

Orientation : Fixez d’abord la version et le chemin, puis supprimez les données dérivées incompatibles avec la nouvelle version ; ne modifiez pas plusieurs variables à la fois.

Cache des dépendances

Vérifier d’abord le fichier de verrouillage, puis décider s’il faut vider le cache

  • Conservez le fichier de verrouillage des dépendances et notez la version du gestionnaire de paquets.
  • Comparez un build dans un répertoire propre avec un build utilisant le cache.
  • Supprimez uniquement les répertoires régénérables ; ne supprimez pas les fichiers du projet qui n’ont pas été sauvegardés.

Orientation : Un problème de cache doit pouvoir être confirmé par comparaison avec un cache vide ; en cas d’échec de téléchargement réseau, notez séparément la cible, l’heure et le code d’erreur.

Espace disque

Vérifier la capacité totale, l’espace libre et les répertoires volumineux

  • Vérifiez l’espace occupé par le répertoire de travail, les données dérivées, les archives et le cache des dépendances.
  • Vérifiez si les journaux et fichiers temporaires continuent de croître.
  • Avant tout nettoyage, confirmez que les artefacts sont archivés et récupérables depuis un autre emplacement.

Orientation : Supprimez en priorité les caches régénérables ; les besoins de capacité à long terme doivent être vérifiés dans les options de stockage d’une prochaine commande.

Journaux de build

Conserver la commande, l’heure et la première erreur

  • Ajoutez le mode de déclenchement, le répertoire d’exécution et la commande complète anonymisée.
  • Notez l’heure du problème et précisez le fuseau horaire.
  • Indiquez également le résultat attendu, le résultat obtenu et la fréquence de reproduction.

Orientation : Envoyez en priorité des journaux texte, pas uniquement une capture d’écran ; retirez les jetons de dépôt, clés de téléversement, mots de passe et extraits de code source.

Arbre de dépannage de la connexion

Vérifiez dans l’ordre, sans sauter les conditions préalables.

Ces sept étapes forment une chaîne de dépendances. Tant qu’une étape amont n’est pas validée, les réglages du client en aval changent rarement le résultat.

  1. 01

    État de l’hôte

    Vérifiez la commande et l’état de l’hôte dans la console. Si l’état diffère de l’attendu, notez l’identifiant de commande et le résultat affiché, puis ouvrez un ticket.

    Continuer après validation
  2. 02

    Adresse cible

    Copiez exactement l’adresse de connexion de la commande actuelle, éliminez les espaces superflus, les anciennes adresses et toute surcharge locale de hosts, puis vérifiez que vous ne vous connectez pas à une autre commande.

    Cible confirmée
  3. 03

    Port et mode de connexion

    Vérifiez que SSH, VNC ou le partage d’écran utilisent le port et le client correspondants. Consignez séparément les délais d’attente, refus de connexion et échecs d’authentification.

    Consigner le type d’erreur
  4. 04

    Réseau local

    Testez les mêmes paramètres depuis un autre réseau fiable afin de déterminer si la sortie de l’entreprise, le proxy ou le réseau de l’opérateur affecte la connexion. N’exposez pas vos identifiants pendant le test.

    Comparaison réseau terminée
  5. 05

    Règles du pare-feu

    Vérifiez que l’appareil local et le réseau de l’organisation autorisent le trafic sortant vers le port cible. Ne désactivez pas toutes les protections pour dépanner ; validez avec le périmètre minimal.

    Règle de trafic sortant confirmée
  6. 06

    Autorisations du compte

    Distinguez la réussite de la connexion réseau de celle de l’authentification du compte. Vérifiez le nom du compte, les droits de la clé, l’accès graphique et la mise à jour des identifiants.

    Résultat d’authentification clarifié
  7. 07

    Sessions occupées

    Vérifiez les sessions graphiques non terminées, les tâches automatisées en double et l’utilisation des ressources. Quittez d’abord proprement les anciennes sessions, puis effectuez une nouvelle tentative contrôlée.

    Résultat de la nouvelle tentative conservé
Modèle de ticket

Fournissez en une seule fois un contexte suffisamment reproductible.

Les tickets dans la console conviennent aux problèmes liés à une commande existante. Si vous ne pouvez pas vous connecter à la console, utilisez l’unique adresse d’assistance support@minidebug.com et fournissez les informations nécessaires pour vérifier votre compte.

Structure recommandée du ticket Copiez les noms des champs et remplissez-les un par un
Identifiant de commande
Identifiant de commande affiché dans la console ; ne transmettez pas de données de paiement.
Nœud
Singapour, Japon (Tokyo), Corée du Sud (Séoul), Hong Kong ou côte Est des États-Unis.
Heure du problème
Indiquez la date, l’heure et le fuseau horaire, en précisant s’il s’agit d’un premier incident ou d’un problème récurrent.
Étapes de reproduction
Commencez par l’ouverture de la console, l’exécution de la commande ou le lancement du client, puis numérotez les étapes dans l’ordre réel.
Journaux anonymisés
Incluez la première erreur et son contexte, après avoir retiré les mots de passe, jetons, clés privées et informations sensibles du projet.
Attendu et obtenu
Décrivez séparément le résultat attendu, le résultat obtenu et la stabilité de la reproduction.
Commande existante

Utiliser un ticket dans la console

Le ticket conserve le contexte de la commande et convient aux problèmes d’état de l’hôte, de connexion au nœud, d’options, de renouvellement et de libération. Effectuez les vérifications correspondantes avant l’envoi.

Créer un ticket dans la console
Connexion impossible

Envoyer un e-mail à l’assistance

Indiquez le type de problème et l’identifiant de commande dans l’objet, puis utilisez la structure de champs à gauche dans le corps du message. Vous pouvez copier directement l’adresse si elle est longue.

support@minidebug.com
Périmètre de traitement

L’origine du problème détermine la marche à suivre.

À partir des éléments du ticket, nous déterminerons si le problème concerne le nœud physique, l’utilisation de macOS, le code du projet ou une dépendance externe, puis nous indiquerons la prochaine vérification à effectuer.

Traitement par MiniDebug

Problèmes d’infrastructure du nœud

Cela comprend les états d’hôte anormaux affichés dans la console, les informations de connexion ne correspondant pas à la commande, les problèmes d’accessibilité réseau du nœud et une configuration de commande différente de celle sélectionnée.

  • Fournissez l’identifiant de commande, le nœud et l’heure du problème.
  • Joignez les résultats des tests de connexion effectués depuis différents réseaux locaux.
  • Notez l’état affiché dans la console et le type d’erreur du client.
À vérifier par l’utilisateur

Problèmes d’utilisation de macOS

Cela comprend les réglages système, les droits des fichiers, l’environnement Shell, le nettoyage du disque, les paramètres du client distant et les autorisations du compte local.

  • Reproduisez d’abord l’opération dans une session contrôlée.
  • Notez la version du système, le compte d’exécution et le chemin cible.
  • Envoyez le texte de l’erreur, pas uniquement une capture de l’interface.
Traitement côté projet

Code du projet et configuration du build

Cela comprend les erreurs de compilation, échecs de tests, configuration de signature, conflits de versions des dépendances, chemins de scripts, variables d’environnement et logique d’exécution de l’application.

  • Reproduisez la première erreur avec le minimum de modifications.
  • Comparez les différences de chaîne d’outils entre l’environnement local et le Mac dans le cloud.
  • Le responsable du projet modifie le code ou la configuration du pipeline.
Traitement par le service externe

Problèmes liés à des services tiers

Cela comprend les erreurs d’authentification, de limitation de débit ou de serveur renvoyées par l’hébergement de code, les miroirs de dépendances, les dépôts de paquets, les systèmes de notification et les cibles de téléversement.

  • Vérifiez l’état du service cible et les autorisations du compte.
  • Notez le code de réponse, l’heure de la requête et le résultat des nouvelles tentatives.
  • Transmettez au fournisseur concerné les journaux anonymisés.

Préparez le contexte de votre commande avant de passer à l’étape suivante.

Les nouveaux achats, renouvellements et opérations de gestion de l’hôte s’effectuent dans la console ; pour une commande existante, ouvrez en priorité un ticket dans la console. Les paiements sont acceptés uniquement via USDT-TRC20 et Visa / Mastercard / Amex (par Stripe). Toutes les commandes sont réglées en dollars américains (USD) ; la disponibilité effective des moyens de paiement dépend de la réponse de l’interface backend.