Assistance technique

Commencez le diagnostic là où le problème apparaît

Vérifiez méthodiquement le statut de la commande, la connexion, les outils de développement et les informations de facturation. Si le problème persiste, joignez l’identifiant de commande, les horaires et des journaux anonymisés à un ticket dans la console afin d’éviter les échanges inutiles.

Parcours d’assistance prêt 5 catégories de problèmes
Commencez par vérifier Statut de la commande et nœud cible Singapour, Japon (Tokyo), Corée du Sud (Séoul), Hong Kong
Vérifiez ensuite Réseau local, adresse, identifiants et chaîne d’outils Conservez les commandes, les erreurs originales et l’heure de survenue
Toujours indisponible Soumettez le contexte anonymisé N’envoyez ni mot de passe, ni clé privée, ni justificatif de paiement complet
Point de départ 5 parcours d’assistance
Nœuds en service Fonctionnement continu 365 jours par an
Canal de contact Ticket ou e-mail d’assistance
Point d’accès au diagnostic

Choisissez d’abord le parcours correspondant au problème

Un même symptôme peut provenir de plusieurs niveaux. Déterminez d’abord s’il concerne la commande, la connexion, l’environnement, la facturation ou la sécurité, puis recueillez les informations requises pour ce niveau.

Commande et livraison

Pour les paiements effectués dont le statut n’est pas encore actualisé, les informations de livraison incomplètes ou les divergences concernant le nœud ou la durée de location.

Comprendre le statut de la commande

Connexion à distance

Pour un écran VNC vide, un délai d’attente SSH, des identifiants refusés, une modification de l’empreinte de l’hôte ou une reconnexion temporairement impossible après un redémarrage.

Effectuer les vérifications de connexion

Environnement de développement

Pour une version Xcode incorrecte, un chemin d’outils en ligne de commande erroné, des éléments de signature invisibles, une commande Homebrew manquante ou des droits insuffisants pour le runner.

Vérifier l’environnement de build

Facturation et renouvellement

Pour vérifier la durée, le modèle de base, le nœud, l’ajout de SSD ou la mise en parallèle Thunderbolt 5, et confirmer les éléments à payer avant le renouvellement.

Consulter la FAQ de facturation

Incident de sécurité

Pour une activité suspecte sur le compte, un accès non autorisé ou une exposition de secrets. Limitez d’abord l’accès et faites tourner les identifiants concernés, puis conservez les traces nécessaires sous forme anonymisée.

Envoyer un rapport de sécurité
Statut de la commande

Le statut détermine la prochaine vérification

Après avoir ouvert la console, notez l’identifiant de commande, le statut actuel, le nœud choisi et la date d’expiration de la location. Ne déduisez pas l’état de la machine à partir des seuls messages du client distant.

  1. 01

    En attente de confirmation

    Les informations de commande ou le résultat du paiement sont en cours de vérification. Vérifiez que le modèle, la durée, le nœud, les options et le montant total dû en USD correspondent à votre demande.

    Champs clés : identifiant de commande, mode de paiement, date de création
  2. 02

    Configuration en cours

    Le nœud physique est en cours de configuration pour la commande. À ce stade, l’adresse de connexion ou les identifiants peuvent ne pas être affichés intégralement ; évitez de réessayer avec une ancienne adresse.

    Champs clés : nœud cible, état de la configuration, dernière évolution du statut
  3. 03

    Prêt à se connecter

    Les informations de connexion ont été générées. Utilisez l’adresse, les instructions de compte et le mode de connexion actuellement affichés dans la console, puis vérifiez que le client cible le bon nœud.

    Champs clés : adresse de connexion, nœud, date d’expiration
  4. 04

    Location terminée

    La période de location actuelle est terminée et les anciennes informations de connexion ne correspondent plus à un service actif. Transférez vos données avant l’expiration ; pour la suite, reportez-vous à la nouvelle fiche dans la console.

    Champs clés : début et fin de la location, dernier relevé de transfert
Catalogue des nœuds et résultats en temps réel ZoomMini M4 Core et ZoomMini M4 Plus proposent quatre nœuds : Singapour, Japon (Tokyo), Corée du Sud (Séoul) et Hong Kong. La disponibilité effective et le résultat de la commande sont déterminés par la réponse en temps réel de la console.
Dépannage de la connexion

De l’accessibilité réseau au rétablissement de la session

Effectuer les vérifications dans l’ordre évite d’attribuer à tort un problème de réseau local à la machine. À chaque étape, conservez l’heure, l’adresse cible et le message d’erreur original.

connection-check.sh
$ ping -c 4 <host>
4 packets transmitted, 4 received

$ ssh -vvv user@<host>
debug1: Connecting to <host>
debug1: Server host key verified

$ nc -vz <host> <port>
Connection succeeded
VNC et affichage

L’adresse est accessible, mais aucun affichage

Vérifiez que le statut dans la console indique « prêt à se connecter » et que le client utilise l’adresse actuelle et les identifiants attribués. Fermez l’ancienne session, reconnectez-vous, puis réduisez la résolution, la qualité des couleurs et les effets d’animation pour écarter l’hypothèse d’un réseau instable.

Voir les méthodes de connexion à distance
Récupération après redémarrage

Connexion temporairement impossible après un redémarrage

Attendez que le système termine son démarrage, puis actualisez l’état de l’appareil dans la console. Relisez l’adresse de connexion, supprimez l’ancienne session enregistrée par le client et testez séparément VNC et SSH afin de distinguer un problème d’interface graphique d’un problème réseau.

Voir l’état de l’appareil
01

Vérifier l’accessibilité réseau

Passez à un réseau local connu pour être stable et notez l’adresse cible, le port et le résultat du délai d’attente. Ne vous basez pas uniquement sur l’accès à d’autres sites depuis le navigateur.

02

Vérifier les identifiants du compte

Vérifiez que le nom d’utilisateur, le mot de passe ou la clé SSH provient des instructions de la commande actuelle. Assurez-vous qu’aucun espace n’a été copié et n’envoyez pas plusieurs fois de suite des identifiants erronés.

03

Gérer la modification de l’empreinte SSH

Vérifiez d’abord dans la console si l’adresse cible a changé. Après confirmation, supprimez uniquement l’entrée correspondante dans known_hosts ; ne videz pas tout le fichier.

04

Distinguer le client du problème de nœud

Effectuez un nouveau test depuis un autre appareil de confiance ou avec un autre mode de connexion. Si SSH fonctionne mais pas VNC, notez en priorité la version du client graphique et le comportement de la session.

Environnement de build

Vérifiez les dépendances de la chaîne d’outils dans l’ordre

Commencez par vérifier le Xcode effectivement sélectionné par le système, puis contrôlez la signature, le gestionnaire de paquets et les droits du runner. Ignorer les vérifications préalables prive les erreurs suivantes de contexte.

  1. 01

    Vérifier la version de Xcode et le chemin sélectionné

    Exécutez xcodebuild -version et xcode-select -p, puis vérifiez que la version requise par le projet correspond au répertoire développeur actuel.

  2. 02

    Vérifier les outils en ligne de commande

    Exécutez clang --version et swift --version. Si l’un des outils est absent ou si sa version ne correspond pas, corrigez d’abord le chemin Xcode sélectionné, puis recommencez le test.

  3. 03

    Vérifier les certificats et profils de provisioning

    Vérifiez que l’utilisateur du build peut lire les éléments de signature requis, puis contrôlez la validité des certificats, l’identifiant du profil et la configuration du projet. Dans les journaux, conservez uniquement les noms et le type d’erreur, jamais les secrets.

  4. 04

    Vérifier le chemin Homebrew

    Dans un environnement Apple Silicon, vérifiez généralement que /opt/homebrew/bin figure dans le PATH du shell non interactif et que l’environnement de démarrage du runner correspond à celui du terminal.

  5. 05

    Vérifier les droits minimaux du runner

    Vérifiez que le self-hosted runner dispose des droits nécessaires sur le répertoire de travail, le cache et les artefacts de build. N’élargissez pas les droits de tout le système pour masquer le problème d’un seul chemin.

toolchain-check
$ xcodebuild -version
Xcode <required-version>
Build version <build-version>

$ xcode-select -p
/Applications/Xcode.app/Contents/Developer

$ command -v brew
/opt/homebrew/bin/brew

$ test -w "$RUNNER_WORKDIR"
$ echo $?
0

$ xcodebuild -scheme App build
** BUILD SUCCEEDED **
Ne jugez pas la réussite à la seule dernière ligne Vérifiez également le code de sortie, le chemin réel des artefacts, le rapport de tests et les étapes de signature. Un cache utilisé ne signifie pas que le build a réussi, et un runner en ligne ne garantit pas l’accès au répertoire de travail.
Petit glossaire

La signification précise de huit termes fréquents

Ces termes décrivent respectivement la propriété du matériel, les modes de connexion, le rôle de l’automatisation et les limites de la commande. Employer le vocabulaire approprié dans votre demande réduit les ambiguïtés du diagnostic.

Nœud physique
Équipement matériel Apple Silicon exécutant réellement les charges macOS ; c’est la ressource de base associée à l’adresse de connexion et à l’état d’exécution de la commande.
Dédié
Chaque commande active correspond à une machine physique dédiée ; le calcul, la mémoire et le stockage local ne sont pas partagés avec les sessions d’autres clients.
Sans virtualisation
La charge de travail s’exécute directement sur le Mac mini physique associé à la commande, et non sur une instance virtuelle découpée depuis un hôte partagé.
VNC
Protocole d’affichage à distance permettant d’accéder à l’interface graphique de macOS, adapté aux opérations avec fenêtres, aux tests d’interface et à la configuration visuelle.
SSH
Mode de connexion chiffré destiné aux opérations en ligne de commande, à l’automatisation, au transfert de fichiers et au diagnostic, particulièrement adapté à l’intégration continue et aux workflows scriptés.
self-hosted runner
Exécuteur automatisé déployé sur un Mac dans le cloud dédié, dont l’équipe configure elle-même les droits et la chaîne d’outils pour recevoir et exécuter les tâches du pipeline.
Période de location
Intervalle de service défini par la commande, sélectionnable à la journée, à la semaine, au mois ou au trimestre. Les informations de connexion, le renouvellement et le transfert des données doivent se référer à cet intervalle.
Nœud
Région de service où se trouve l’appareil. Le catalogue actuel comprend Singapour, Japon (Tokyo), Corée du Sud (Séoul) et Hong Kong, soit quatre nœuds.
FAQ de facturation

Vérifiez la structure de la facture avant le renouvellement

La facture doit distinguer le modèle de base, la durée, le nœud et les options. La disponibilité effective de la passerelle de paiement dépend de la réponse de la console.

Comment les tarifs sont-ils calculés à la journée, à la semaine, au mois et au trimestre ?

La commande est facturée selon l’unique période choisie lors de la souscription ; les différentes périodes ne sont pas combinées. Avant le renouvellement, confirmez à nouveau le modèle, la durée, le nœud, les dates de début et de fin et le montant total dû.

Comment le SSD et la mise en parallèle Thunderbolt 5 sont-ils indiqués ?

+1TB SSD, +2TB SSD et la mise en parallèle Thunderbolt 5 sont affichés séparément selon la période choisie et ne doivent pas être intégrés au nom du modèle de base. La mise en parallèle Thunderbolt 5 est calculée par appareil ; vérifiez donc aussi le nombre d’appareils associés.

Quelle devise et quels modes de paiement sont acceptés ?

Toutes les commandes sont réglées en dollars américains (USD). Seuls USDT-TRC20 et Visa / Mastercard / Amex (via Stripe) sont acceptés ; la passerelle réellement disponible est indiquée en temps réel dans la console.

Quels champs faut-il vérifier avant un renouvellement ?

Vérifiez successivement l’identifiant de commande, le modèle de base, la période choisie, le nœud cible, les options SSD, le nombre de connexions Thunderbolt 5, le sous-total en USD, le montant total dû et la nouvelle date de fin de location. En cas de divergence, soumettez un ticket avant le paiement.

Que fournir si le statut ne change pas après le paiement ?

Fournissez l’identifiant de commande, le mode de paiement, l’heure du paiement, le statut actuel dans la console et les informations de référence de transaction anonymisées. N’envoyez jamais le numéro complet de carte, un justificatif de paiement complet ni le mot de passe d’un compte.

Checklist du ticket

Soumettez les informations qui permettent un diagnostic direct

Un ticket efficace doit répondre aux questions « quelle commande, quel nœud, quand, comment reproduire et quel résultat ? ». Anonymisez les informations sensibles au préalable.

Contexte requis

Organisez le corps du ticket dans l’ordre suivant

  1. 01
    Identifiant de commande et nœud

    Indiquez l’identifiant de commande affiché dans la console et le nœud cible : Singapour, Japon (Tokyo), Corée du Sud (Séoul) ou Hong Kong.

  2. 02
    Heure de survenue du problème

    Indiquez l’heure du premier incident et de la dernière reproduction, avec le fuseau horaire, et précisez si le problème est continu ou intermittent.

  3. 03
    Étapes de reproduction et résultat attendu

    Décrivez chaque étape depuis l’accès à la console ou l’exécution de la commande, puis indiquez séparément le résultat réel et le résultat attendu.

  4. 04
    Environnement et mode de connexion

    Précisez le système local, la version du client, VNC ou SSH, les versions de macOS et Xcode, ainsi que l’utilisation éventuelle d’un réseau proxy.

  5. 05
    Journaux anonymisés

    Conservez les codes d’erreur, commandes, codes de sortie et le contexte nécessaire ; remplacez les éléments sensibles des noms d’utilisateur, adresses, jetons, chemins de dépôt et références de paiement.

Ne pas envoyer

Les informations secrètes ne servent pas au diagnostic

N’envoyez ni mot de passe, ni clé privée, ni code de récupération, ni jeton de dépôt, ni secret de signature, ni justificatif de paiement complet, ni données client non anonymisées. Si un secret semble exposé, faites-le tourner immédiatement.

Voir les limites de protection des données
Canal de soumission

Utilisez un ticket dans la console pour conserver le contexte

Pour les commandes existantes, soumettez de préférence un ticket depuis la console afin de l’associer au statut de la commande. Si vous ne pouvez pas vous connecter, écrivez à support@zoommini.com en indiquant la catégorie du problème dans l’objet.

Créer un ticket dans la console
Prêt à soumettre

Ajoutez le contexte de la commande pour commencer le diagnostic avec des informations exploitables

Le délai de traitement dépend de la complexité du problème et des vérifications nécessaires. Après l’envoi, consultez l’état de la demande dans la console ; si vous ne pouvez pas vous connecter, utilisez l’adresse d’assistance.