Connexion et builds

Commencez par figer les informations du contexte,
puis résolvez le problème de Mac dans le cloud.

Ce guide pratique couvre la première connexion, les sessions VNC, les builds Xcode et les problèmes de commande. Vérifiez méthodiquement le réseau local, l’état du nœud, les informations de connexion, le client et les journaux de tâche, sans vous fier à des tentatives répétées imprécises.

Louer un Mac mini Voir le guide de connexion au bureau
Nœuds disponibles
6 régions
Configurations disponibles
2 modèles physiques
Informations clés
Région, heure, texte de l’erreur
CASE ROUTING / BAMINI

Registre de triage

À soumettre
01 / CONTEXTE Commande et nœud Confirmez le modèle, la région et l’état actuel du nœud
02 / ACCÈS Connexion et identifiants Vérifiez l’adresse, le nom du compte et la version du client
03 / ÉLÉMENTS Journaux et horaires Conservez le texte complet de l’erreur et l’heure de l’échec
04 / ORIENTATION Auto-diagnostic ou ticket Les problèmes reproductibles passent par la procédure de ticket de la console
Ne soumettez pas de mot de passe, de code de récupération ni de clé privée STATUS / READY
Choisir un problème

Choisissez la catégorie la plus proche de votre situation

Les six accès sont visibles en même temps. Le choix d’un accès vous mène uniquement aux vérifications correspondantes, sans masquer les autres guides.

Connexion

Impossible d’établir une session de bureau

Commencez par vérifier le réseau local, l’adresse cible, la version du client et les sessions déjà utilisées.

Dépanner la connexion Identifiants

Les informations de connexion sont inutilisables

Vérifiez que l’adresse, le nom du compte et les identifiants correspondent à la même commande, sans espaces copiés en trop.

Vérifier le premier accès Performances

L’affichage, la saisie ou la tâche ralentit

Notez séparément la latence réseau, les réglages d’affichage du bureau et les ressources utilisées par la tâche, sans tirer une conclusion unique.

Voir l’ordre des vérifications Commande

Commande ou facture à vérifier

Préparez le numéro de commande, la période de facturation, le montant en dollars et le résultat du paiement avant de créer un ticket dans la console.

Voir la procédure d’assistance Stockage

Le stockage supplémentaire ne fonctionne pas comme prévu

Notez l’option choisie, ce que le système reconnaît, le chemin de montage et l’heure de la première apparition du problème.

Préparer les informations de la demande Build

Échec d’une tâche Xcode ou runner

Conservez la version, le label, le répertoire de travail, les journaux complets et les étapes minimales de reproduction.

Dépanner le build
Premier accès

De la disponibilité du nœud à la vérification complète du bureau

Chaque étape possède un résultat de confirmation précis. Si l’étape précédente échoue, conservez d’abord les informations du contexte et ne modifiez pas plusieurs variables à la fois.

Vérifier l’état du nœud

Connectez-vous à la console, ouvrez la commande correspondante, vérifiez que le nœud est disponible pour la connexion et confirmez que la région correspond à celle choisie lors de l’achat.

  • Numéro de commande correct
  • Modèle et région correspondants
  • Nœud disponible

Récupérer les informations de connexion

Copiez séparément l’adresse du serveur, le nom du compte et les identifiants de connexion. Ne regroupez pas les champs et ne les diffusez pas dans des documents publics ou des conversations.

  • Aucun espace superflu dans l’adresse
  • Champ du nom de compte séparé
  • Identifiants associés à la commande actuelle

Établir une session VNC

Dans un client VNC fiable, saisissez l’adresse cible et le nom du compte. Établissez d’abord la session avec la qualité d’image par défaut, puis ajustez la résolution et la qualité des couleurs selon votre réseau.

  • Version du client prise en charge
  • Réseau local autorisant la connexion
  • Texte complet de l’erreur conservé

Effectuer la vérification initiale du bureau

Une fois dans l’interface graphique macOS, vérifiez que la saisie au clavier, le zoom de l’affichage, l’ouverture du terminal et l’accès au répertoire du projet fonctionnent avant de synchroniser le projet ou de lancer le runner.

  • Saisie et affichage fonctionnels
  • Commandes du terminal exécutables
  • Répertoire du projet accessible en lecture et écriture
Ordre de dépannage de la connexion

Ne vérifiez qu’une seule couche de connexion à la fois

Déterminez d’abord si le problème vient du réseau local, des informations cibles, des identifiants, du client ou d’une session existante. Notez chaque résultat : c’est plus efficace que de se reconnecter sans cesse.

Tableau de vérification étape par étape des problèmes de connexion VNC
Ordre Élément vérifié Action Informations à noter Critère de réussite
01 Réseau local Passez à un réseau connu comme stable et vérifiez que le pare-feu ou le proxy ne bloque pas la connexion VNC. Type de réseau, utilisation d’un proxy, heure de l’échec Adresse cible accessible depuis le même réseau
02 Adresse cible Recopiez l’adresse du serveur depuis la commande actuelle ; n’utilisez ni ancienne capture d’écran ni adresse enregistrée pour une autre commande. Numéro de commande, région du nœud, source du champ d’adresse Adresse correspondant à l’enregistrement du nœud actuel
03 Identifiants de connexion Vérifiez séparément le nom du compte et les identifiants, et contrôlez la présence éventuelle d’espaces ou de retours à la ligne avant et après le contenu copié. Texte de l’erreur, sans soumettre le mot de passe réel Le client ne renvoie plus d’erreur d’authentification
04 Version du client Notez le nom et la version du client ainsi que les réglages d’affichage ; si nécessaire, effectuez une vérification croisée avec un autre client fiable. Version du client, version du système d’exploitation, réglages de qualité d’image Session stable avec les mêmes informations
05 État de la session Vérifiez qu’aucune session n’est déjà utilisée, que l’affichage n’est pas figé et que le client ne conserve pas une connexion devenue invalide. Opération avant la déconnexion, comportement à la reconnexion, durée de la session Reconnexion possible après fermeture de l’ancienne session
Dissociez les éléments de performance

La latence de saisie, le rafraîchissement lent de l’affichage et la durée d’un build sont trois indicateurs différents. Notez séparément les conditions réseau, les réglages de qualité VNC et les journaux de tâche, sans attribuer tous les symptômes aux performances du nœud.

Dépannage des tâches de build

Distinguez la configuration du projet de l’environnement du nœud

Enregistrez d’abord le contexte de l’échec, puis créez une reproduction minimale. Les six éléments ci-dessous doivent provenir de la même tâche échouée ; ne mélangez pas des journaux de moments différents.

BUILD / VERSION

Versions de Xcode et des outils

Notez la version complète de Xcode, le résultat du choix des outils en ligne de commande et la commande de build réellement utilisée par la tâche.

Point à déterminer Le même projet échoue-t-il de façon reproductible avec une version fixe ?
BUILD / LOG

Journaux complets du projet

Conservez le contexte avant et après l’étape échouée, au lieu de ne capturer que la dernière ligne d’erreur.

Point à déterminer L’erreur vient-elle des dépendances, de la compilation, des tests, de l’exportation ou des scripts ?
BUILD / TIME

Heure de l’échec

Notez le fuseau horaire, l’heure de début, l’heure de l’échec et la durée de la tâche afin de les comparer aux données du nœud.

Point à déterminer Le problème apparaît-il à une étape précise ou après une durée fixe ?
RUNNER / LABEL

Label et répertoire du runner

Vérifiez que le workflow correspond au label attendu et notez le répertoire de travail, le répertoire de cache et le compte d’exécution.

Point à déterminer La tâche est-elle routée vers le bon runner self-hosted ?
REPRO / STEPS

Étapes minimales de reproduction

Supprimez les scripts et tâches parallèles sans rapport, puis reproduisez la même erreur avec le moins de commandes possible.

Point à déterminer L’échec dépend-il de la configuration actuelle du projet, du cache ou des variables d’environnement ?
COMPARE / RESULT

Résultat comparatif

Refaites le test sur le même nœud avec un répertoire de travail propre, ou exécutez une petite démonstration avec la même chaîne d’outils.

Point à déterminer Si la démonstration minimale échoue aussi, soumettez alors un ticket concernant l’environnement du nœud.
Indice de configuration du projet

Seules certaines branches, dépendances, caches ou certains scripts échouent ; une démonstration propre fonctionne.

Indice d’environnement du nœud

Plusieurs projets indépendants échouent lors des mêmes étapes d’outils et la démonstration minimale reproduit l’échec de manière stable.

Petit glossaire

Conservez le même sens technique dans les tickets

Des termes précis réduisent les allers-retours causés par l’emploi indifférencié de « machine », « instance » et « serveur ».

Nœud physique
Mac mini physique qui héberge macOS et les tâches de développement. L’état du nœud, la région et les informations de connexion sont associés à une commande précise.
Machine physique dédiée
Chaque commande correspond à des ressources matérielles dédiées, sans partager le même environnement de système d’exploitation avec d’autres clients.
Machine non virtuelle
L’environnement macOS est fourni sur du matériel physique, et non comme une instance virtuelle découpée depuis un hôte partagé.
VNC
Méthode de connexion permettant d’afficher et de contrôler un bureau graphique distant. La qualité d’image, le zoom et la latence de saisie dépendent du réseau local et des réglages du client.
Self-hosted runner
Exécuteur de tâches automatisées déployé sur le Mac dans le cloud loué, puis enregistré et administré par votre équipe.
Période de facturation
Période quotidienne, hebdomadaire, mensuelle ou trimestrielle choisie pour la commande. Lors de la vérification de la facture, indiquez aussi le modèle et les options supplémentaires.
Région du nœud
Région de service où se trouve l’appareil. BAMini propose 6 nœuds : Singapour, Tokyo au Japon, Séoul en Corée du Sud, Hong Kong, l’est des États-Unis et l’ouest des États-Unis.
Connexion Thunderbolt 5 en parallèle
Capacité de connexion supplémentaire choisie pour chaque appareil. Pour toute demande à ce sujet, indiquez le nombre d’appareils concernés et la topologie de connexion.
Préparer l’envoi de la demande

Permettre à l’assistance de reproduire et de vérifier le problème

Une demande exploitable doit inclure le contexte de la commande, l’heure, l’erreur complète et les étapes déjà tentées. Les identifiants sensibles ne font pas partie des éléments de diagnostic.

SUPPORT REQUEST / REQUIRED FIELDS

Liste des informations du problème

7 éléments
01 Numéro de commande

Il sert à retrouver la commande ; n’indiquez pas uniquement le nom du modèle.

02 Région du nœud

Indiquez Singapour, Tokyo au Japon, Séoul en Corée du Sud, Hong Kong, l’est des États-Unis ou l’ouest des États-Unis.

03 Modèle disponible

Indiquez BookAMini M4 Core ou BookAMini M4 Plus.

04 Heure de l’incident

Indiquez la date, l’heure et le fuseau horaire afin de faire le lien avec les données du nœud.

05 Texte complet de l’erreur

Copiez le texte original en conservant le code d’erreur et le contexte ; ne vous contentez pas d’écrire « inutilisable ».

06 Étapes déjà tentées

Énumérez-les dans l’ordre d’exécution et indiquez le résultat de chaque étape.

07 Reproductibilité

Précisez si le problème survient à chaque fois, occasionnellement ou uniquement avec certains projets et réseaux.

Passer à l’assistance humaine

Si l’auto-diagnostic ne suffit pas, créez un ticket dans la console

Pour les problèmes liés à une commande existante, privilégiez le ticket dans la console afin d’associer la commande, le nœud et les informations complémentaires ; si vous ne pouvez pas vous connecter à la console, utilisez l’adresse e-mail d’assistance.

01 / RÉCEPTION

Soumettre le problème et son contexte

Créez un ticket dans la console, sélectionnez la commande correspondante et joignez la région, le modèle, l’heure, le texte de l’erreur, les extraits de journaux et les étapes de reproduction.

02 / CATÉGORIE

Distinguer connexion, environnement et facturation

L’assistance détermine le périmètre du problème à partir des éléments fournis. Si les informations sont insuffisantes, le ticket indiquera précisément les champs à compléter.

03 / COMPLÉMENT

Répondre dans le ticket d’origine

Lorsque vous ajoutez de nouveaux journaux, indiquez la nouvelle heure de l’incident et les conditions du test. Ne créez pas plusieurs tickets pour un même problème.

04 / TRAITEMENT

Consulter la conclusion et la suite

Consultez dans la console l’avancement, les actions recommandées et les résultats à vérifier. Après validation, confirmez dans l’enregistrement d’origine si le service est rétabli.

TICKET

Problème de commande ou de nœud existant

Ouvrez la console pour créer un ticket et associez la commande correspondante.

Ouvrir la console
E-MAIL

Impossible de se connecter à la console

Écrivez depuis l’adresse e-mail du compte et indiquez le numéro de commande ainsi que le problème rencontré lors de la connexion.

support@bookamini.com
Prêt à lancer le build

Choisissez parmi 6 nœuds et deux modèles physiques dédiés.

BookAMini M4 Core et BookAMini M4 Plus sont des machines physiques dédiées Mac dans le cloud, non virtuelles. Les commandes sont facturées en dollars ; la disponibilité affichée par la console fait foi en temps réel.

Louer un Mac mini Voir les configurations et les prix