Guide de dépannage technique

Un problème sur votre Mac cloud ? Commencez par réduire le périmètre

Cette page couvre la première connexion, l’utilisation de macOS, les builds Xcode, l’inférence MLX, l’extension du stockage et les commandes. Effectuez d’abord les vérifications adaptées, puis transmettez l’identifiant de commande, l’heure et des journaux expurgés pour éviter les vérifications répétitives.

Périmètre d’assistance
6 catégories
Configurations disponibles
3 modèles
Nœuds de service
4 nœuds
Routage du diagnostic Identifiez d’abord le niveau, puis réunissez les preuves
Ticket possible
A
Avant la connexion

Vérifiez l’état de livraison, le nœud, les informations de connexion et le réseau local.

Accès
B
Pendant la tâche

Écartez successivement les problèmes de version, dépendances, disque, mémoire et journaux.

Exécution
C
Avant l’envoi

Conservez la chronologie et les étapes de reproduction, puis retirez les mots de passe, clés privées et données sensibles.

Éléments probants
Éléments conseillés ID de commande + modèle + nœud + heure + journaux expurgés
Vérification avant commande

Clarifiez l’usage, la configuration et les conditions de connexion

Si la commande n’est pas encore créée, effectuez ces six vérifications. Plus les besoins et les limites de ressources sont clairs, plus il est facile de choisir parmi les trois configurations disponibles et d’éviter de confondre stockage, réseau ou durée de location avec une panne matérielle.

Catalogue des nœuds

Singapour, Japon (Tokyo), Corée du Sud (Séoul) et Hong Kong proposent les trois modèles. La disponibilité réelle est indiquée en temps réel dans la console.

Liste de préparation 6 / 6 éléments
  • Usage définiBuild, tests, intégration continue ou inférence MLX
  • Modèle choisiM4 16GB, M4 24GB ou M4 Pro 64GB
  • Nœud choisiSelon le fuseau horaire de l’équipe et le chemin de transfert des données
  • Cycle de facturation confirméVérifiez la commande à la journée, à la semaine, au mois ou au trimestre
  • Besoin de stockage confirméDistinguez système, projet, cache des dépendances et fichiers de modèles
  • Environnement de connexion prêtLe réseau local autorise les connexions nécessaires et reste stable
Première connexion

En cas d’échec, commencez par l’état de livraison au lieu de modifier sans cesse le mot de passe

Les problèmes lors de l’accès initial au Mac cloud concernent généralement l’état de la commande, les informations de connexion, le réseau local ou la saisie. Suivez l’ordre ci-dessous et ne modifiez qu’une variable à la fois.

  1. 01

    Vérifiez que la commande est connectable

    Connectez-vous à la console pour consulter la commande actuelle. Si elle est encore en cours de traitement, attendez la mise à jour de son état ; n’utilisez pas une ancienne capture ni les informations d’une autre commande.

    Commande
  2. 02

    Lisez les informations champ par champ

    Vérifiez que le nœud, l’adresse de l’hôte, le mode de connexion et le compte appartiennent à la même commande. Lors du collage, contrôlez les espaces au début et à la fin ; n’inscrivez jamais de véritables identifiants dans un chat, un nom de capture ou un dépôt public.

    Informations
  3. 03

    Écartez les restrictions du réseau local

    Vérifiez que le réseau local, le pare-feu ou le proxy ne bloque pas la connexion. Vous pouvez effectuer un test comparatif sur un autre réseau fiable, mais ne changez pas simultanément de compte, de client et de réseau.

    Réseau
  4. 04

    Revérifiez la saisie du compte

    Distinguez majuscules, minuscules et caractères similaires, puis vérifiez la disposition du clavier. Si le problème est reproductible, notez uniquement son type et l’heure, jamais le mot de passe en clair.

    Saisie
Tâches de build

Erreur de build Xcode : vérifiez de la chaîne d’outils aux journaux

Commencez par confirmer l’environnement qui exécute réellement le build, puis examinez les dépendances et la signature. Vider tous les caches ou changer plusieurs fois de version Xcode rend le problème initial plus difficile à reproduire.

  1. 1

    Verrouillez la version de Xcode

    Notez le chemin, la version de Xcode sélectionnée et les exigences du projet. Vérifiez que les tâches en ligne de commande et l’interface graphique utilisent la même chaîne d’outils.

  2. 2

    Vérifiez les fichiers de signature

    Confirmez que les fichiers requis sont injectés par le processus interne de gestion des secrets de l’équipe, avec un chemin et des droits corrects. Ne copiez pas leur contenu dans la demande d’assistance.

  3. 3

    Réduisez le périmètre du cache des dépendances

    Déterminez d’abord si l’échec survient au téléchargement, à l’analyse, à la compilation ou à l’édition de liens. Nettoyez uniquement le cache concerné et conservez les journaux avant et après.

  4. 4

    Vérifiez l’espace disque

    Examinez séparément l’espace occupé par le projet, les artefacts de build, les archives et le cache des dépendances. En cas de manque d’espace, exportez d’abord les artefacts nécessaires puis supprimez ce qui peut être recréé.

  5. 5

    Extrayez un journal minimal

    Conservez les lignes nécessaires avant et après la première erreur, la commande exécutée et le code de sortie. Retirez les jetons, noms d’utilisateur, adresses de dépôts internes et informations de signature.

Inférence MLX

Vérifiez d’abord le chargement du modèle, puis testez la concurrence du service

Pour l’inférence MLX, distinguez le format du modèle, la mémoire unifiée, l’écoute du service et la pression des requêtes. Établissez d’abord une base reproductible avec une seule requête, puis augmentez progressivement la concurrence afin de séparer échec de chargement et saturation du service.

FORMAT
Format du modèle

Vérifiez l’intégrité des fichiers du modèle et la cohérence de la conversion, puis notez le framework et sa version.

À vérifier d’abord
MEMORY
Utilisation de la mémoire unifiée

Relevez les valeurs avant et après le chargement, puis après la première requête ; ne vous fiez pas uniquement au pic instantané.

À mesurer ensuite
LISTEN
Adresse d’écoute du service

Vérifiez que la portée d’écoute et le port correspondent à la conception d’accès, puis activez les contrôles nécessaires.

Vérifier l’accès
LOAD
Concurrence des requêtes

Commencez par une seule requête, fixez l’entrée, augmentez progressivement la concurrence et notez la latence ainsi que le type d’échec.

Test progressif
LOG
Journaux de chargement du modèle

Conservez la version, les paramètres de démarrage et le contexte de l’erreur ; supprimez les entrées métier et les chemins sensibles.

Conserver les preuves
Extension du stockage

Planifiez la capacité par rôle des données ; ne faites pas du nœud votre unique sauvegarde

Le système, les sources du projet, le cache des dépendances, les artefacts de build et les poids du modèle ont des cycles de vie différents. Regroupez-les d’abord, puis décidez s’il faut ajouter du stockage.

01 / SOURCE

Projet et configuration

Conservez les fichiers source et la configuration d’automatisation dans les processus de versionnage et de sauvegarde de l’équipe. La copie de travail sur le Mac cloud ne doit pas être la seule version.

02 / CACHE

Dépendances et cache de build

Le cache accélère les tâches répétitives, mais ses limites de nettoyage doivent être définies. Pour diagnostiquer un problème de disque, commencez par mesurer chaque répertoire ; ne supprimez pas tout directement.

03 / MODEL

Modèles et fichiers de données

Notez l’origine, le format, la version et l’espace occupé par chaque modèle. Avant d’envoyer de gros fichiers, vérifiez le chemin du nœud et prévoyez le temps nécessaire à leur export avant la fin de la location.

04 / OUTPUT

Archives et artefacts

Nommez les archives de build, rapports de test et sorties d’inférence par lot de tâches. Après validation, exportez les éléments à conserver vers un stockage contrôlé par l’équipe.

Commande et renouvellement

Fiez-vous à la page actuelle de la console pour les informations de commande

Après connexion, consultez la durée actuelle, les options de renouvellement disponibles, le modèle choisi et les informations du nœud. Les nœuds fonctionnent normalement toute l’année, 365 jours sur 365 ; l’état réel de la commande et les options disponibles sont ceux renvoyés en temps réel par la console.

Pour créer une commande, choisissez une configuration parmi les trois disponibles, puis sélectionnez un nœud à Singapour, au Japon (Tokyo), en Corée du Sud (Séoul) ou à Hong Kong. Toutes les combinaisons du catalogue peuvent être commandées ; la disponibilité réelle est indiquée par la console.

Champs à vérifier CURRENT
Durée
Date de début, date de fin et période actuelle
Renouvellement
Périodes de renouvellement disponibles pour la commande actuelle
Configuration
Puce, mémoire, stockage et options supplémentaires
Nœud
Région de service associée à la commande actuelle
Envoyer une demande d’assistance

Donnez à votre première demande les éléments nécessaires au diagnostic

La demande doit préciser la commande, la machine, le nœud, l’heure, la méthode de reproduction et le contenu des journaux. Écrire seulement « impossible de se connecter » ou « échec du build » ne suffit généralement pas pour identifier la cause.

REQ-01

Identifiant de commande

Indiquez l’identifiant de commande affiché dans la console ; ne le remplacez pas par un nom personnalisé de machine.

REQ-02

Modèle et nœud

Indiquez VMCache M4 16, VMCache M4 24 ou VMCache M4 Pro 64, ainsi que le nœud correspondant.

REQ-03

Heure de l’incident

Précisez le fuseau horaire et indiquez si le problème est continu, intermittent ou s’il ne s’est produit qu’une fois.

REQ-04

Étapes de reproduction

Depuis un état connu comme fonctionnel, listez progressivement les actions, le type d’entrée, le résultat attendu et le résultat réel.

REQ-05

Périmètre de l’impact

Indiquez si l’impact concerne une tâche, un projet ou toutes les tâches, et mentionnez les éléments qui fonctionnent normalement à titre de comparaison.

REQ-06

Journaux expurgés

Conservez le contexte de l’erreur, la version et le code de sortie ; retirez les mots de passe, clés privées, jetons et données métier.

Deux moyens de contact

Pour une commande existante, connectez-vous en priorité à la console pour ouvrir un ticket. Si vous ne pouvez pas y accéder ou si votre demande concerne l’avant-vente, écrivez à support@vmcache.com.

Ouvrir un ticket d’assistance
Étape suivante

Effectuez les vérifications, puis transmettez les preuves à l’équipe d’assistance

Si vous avez besoin de nouvelles ressources, comparez les trois configurations. Pour un problème sur une commande existante, ouvrez un ticket avec l’identifiant de commande, le nœud, l’heure, les étapes de reproduction et les journaux expurgés.