Commencez par la connexion

Suivez les étapes de connexion,
puis fiabilisez votre workflow.

Ce guide présente les étapes d’utilisation d’un Mac mini physique dédié, dans l’ordre où vous en aurez besoin. Vérifiez d’abord les informations de livraison, connectez-vous au système, configurez vos outils, puis organisez vos builds, vos sauvegardes et votre renouvellement. Inutile de tout lire d’un coup : recherchez simplement l’étape qui vous concerne.

Louer un Mac cloud Ouvrir la console

Vous avez déjà une instance ? Consultez les informations de livraison et l’état de la commande dans la console. Besoin d’aide ? Connectez-vous et ouvrez un ticket. Ne collez jamais de mot de passe, de clé privée ou de fichier de signature dans un espace public.

Connectez-vous, puis configurez

Les quatre vérifications à faire lors de la première connexion

Chaque étape a un résultat attendu. Vérifiez d’abord la configuration dans une session interactive, puis transmettez-la à vos tâches automatisées.

01Vérifier la livraison

Première connexion après réception des identifiants

Faites correspondre la commande, la machine et les informations de connexion. Vérifiez d’abord une machine pour éviter de saisir l’adresse d’un autre nœud dans votre client.

Afficher les étapes
  1. Connectez-vous à la console et ouvrez la fiche de l’instance associée à votre commande. Vérifiez le modèle, le nœud, la durée de location et l’état de livraison actuel.
  2. Enregistrez l’adresse de connexion, le nom d’utilisateur et le port réellement attribué. Fiez-vous aux informations de la console, sans les reconstituer à partir de courriels transférés ou de messages.
  3. Après votre première connexion, changez le mot de passe de connexion, puis exécutez sw_vers pour vérifier la version du système. Exécutez ensuite df -h pour vérifier l’espace disque disponible.
  4. Notez les répertoires du projet et des artefacts, ainsi que la personne responsable. Pour une utilisation en équipe, ne stockez pas directement les identifiants dans le dépôt de code.

C’est prêt lorsque :vous pouvez vous reconnecter, les informations système correspondent à la commande et vous savez où sont enregistrés les résultats de build. Si le paiement est terminé mais que vous n’avez pas encore reçu vos identifiants, ouvrez un ticket depuis la commande au lieu d’en créer une autre.

02Accès à distance

Configurer le partage d’écran et une clé publique SSH

L’interface graphique convient à la configuration initiale et au débogage interactif. SSH est adapté à l’exécution de commandes, au transfert de fichiers et à l’automatisation.

Afficher les étapes
  1. Connectez-vous au partage d’écran à l’aide des informations de livraison. Dans les réglages système, vérifiez « Général → Partage » et autorisez uniquement les comptes qui en ont besoin.
  2. Pour utiliser la ligne de commande, vérifiez que « Connexion à distance » est activée. Générez une clé SSH locale ou choisissez-en une existante, puis ne transmettez que la clé publique à la machine distante.
  3. Ajoutez la clé publique au fichier ~/.ssh/authorized_keysde l’utilisateur cible. Réglez les permissions du répertoire sur 700et celles du fichier sur 600.
  4. Gardez la session actuelle ouverte, puis vérifiez la connexion par clé publique dans un autre terminal avant de modifier les méthodes d’authentification. Conservez toujours la clé privée en local ou dans le gestionnaire de clés de votre équipe.

C’est prêt lorsque :vous pouvez vous connecter à la session graphique et vous authentifier par clé publique SSH dans une nouvelle session. Vérifiez le port et les réglages du pare-feu à partir des informations de livraison réelles.

Consulter les instructions de connexion par système
03Vérifier les outils

Installer et vérifier les outils en ligne de commande Xcode

Vérifiez d’abord que l’environnement actuel répond aux exigences du projet. Ne lancez pas une mise à niveau simplement parce que Xcode est déjà installé.

Afficher les étapes
  1. Exécutez xcodebuild -version et xcode-select -p pour vérifier la version et le chemin des outils de développement.
  2. Si les outils en ligne de commande sont absents, exécutez xcode-select --install. Pour compiler l’ensemble du projet, il faut une version de Xcode adaptée ; les outils en ligne de commande ne remplacent pas tous les SDK.
  3. Si plusieurs versions de Xcode sont installées, utilisez DEVELOPER_DIR pour définir le répertoire des outils de développement d’une seule tâche, ou utilisez xcode-select pour modifier la sélection système.
  4. Acceptez la licence des outils et installez les composants requis au premier lancement, puis compilez et testez un petit projet.

C’est prêt lorsque :la version de Xcode est la même dans le terminal et les journaux CI, et le SDK cible est disponible. Inscrivez la version dans la configuration du projet ou l’environnement de démarrage du runner pour ne pas dépendre de la mémoire des opérateurs.

04Automatisation

Enregistrer un runner auto-hébergé sur un Mac mini server

Faites d’abord fonctionner un build manuel, puis confiez les tâches au runner. Pour les commandes d’enregistrement, référez-vous à l’interface de votre plateforme CI.

Afficher les étapes
  1. Créez un compte et un répertoire dédiés au build, puis téléchargez dans les paramètres du projet CI un package de runner compatible avec macOS et Apple Silicon.
  2. Enregistrez le runner avec un jeton à durée de vie courte. Précisez le système, la puce, le nœud et l’usage dans les tags. Ne stockez pas de jeton d’accès à longue durée dans le dépôt.
  3. Lancez d’abord une tâche minimale au premier plan et vérifiez PATH, le chemin de Xcode, l’accès au trousseau et l’envoi des artefacts.
  4. Après avoir vérifié les autorisations nécessaires à l’exécution sans surveillance, configurez le service en suivant les instructions de la plateforme CI. Vérifiez séparément les exigences de session des tâches qui utilisent l’interface graphique.

C’est prêt lorsque :une modification de test déclenche une tâche, les journaux permettent d’identifier l’instance et les artefacts sont stockés ailleurs que sur la machine. Une machine dédiée n’autorise pas un nombre illimité de tâches simultanées : commencez par les exécuter en série, puis ajustez leur parallélisme selon l’usage de la mémoire et du disque.

Intégrez la reproductibilité à votre processus

Builds, signature et cache

Pour les projets Unity, Flutter ou natifs, conservez les versions des outils, les fichiers de verrouillage des dépendances et les commandes de build. Gérez séparément les éléments de signature et les caches régénérables.

Workflow de build Unity iOS dans le cloud

Séparez l’export du projet Unity et l’Archive Xcode en deux étapes vérifiables indépendamment. En cas d’échec, vous pourrez ainsi repérer précisément l’étape en cause.

Afficher les étapes
  1. Verrouillez la version de l’éditeur Unity, les dépendances des packages et les modules de prise en charge du build iOS. Vérifiez d’abord les exigences de licence du projet pour ne pas confondre un problème d’autorisation avec une panne de la machine.
  2. Synchronisez le projet, puis exportez le projet Xcode. Séparez le répertoire généré des sources et conservez les journaux d’export ainsi que l’identifiant du commit.
  3. Installez les dépendances natives requises par le projet et vérifiez le scheme, le type d’appareil cible, le Bundle Identifier et la configuration de signature.
  4. Lancez l’Archive et vérifiez les artefacts exportés avant de les envoyer via le processus de distribution habituel de votre équipe. Une compilation réussie ne signifie pas que la distribution est terminée.

À conserver :l’identifiant du commit, les versions des outils, les journaux d’export et d’Archive, ainsi que la somme de contrôle des artefacts. Avant de relancer un build après un échec, corrigez la première erreur au lieu de ne consulter que le message générique affiché à la fin du journal.

Migrer les certificats et profils Xcode

La signature d’un build nécessite un certificat, la clé privée correspondante et un profil valide. Copier le fichier de certificat seul ne suffit généralement pas.

Afficher les étapes
  1. Récupérez les éléments de signature avec leur clé privée depuis un emplacement contrôlé par votre équipe, puis transférez-les de manière chiffrée. Transmettez le mot de passe d’export par un autre canal sécurisé.
  2. Importez-les dans un trousseau accessible au compte de build et vérifiez la date d’expiration du certificat ainsi que l’association avec la clé privée. Exécutez security find-identity -v -p codesigning pour vérifier les identités de signature disponibles.
  3. Importez le profil associé à l’application cible, à l’équipe et au mode de distribution. Vérifiez le Bundle Identifier, la date d’expiration et les capacités requises.
  4. Testez la signature avec le même compte et le même mode d’exécution que le runner. Vérifiez qu’une tâche sans surveillance ne reste pas bloquée par une demande d’autorisation.

Sécurité :ne faites jamais apparaître le mot de passe d’export, une clé privée ou un fichier de signature complet dans les journaux. Lors du renouvellement ou de la révocation des éléments de signature, mettez aussi à jour la configuration du build. Avant la fin de la location, supprimez les données sensibles de la machine et conservez une copie de sécurité dans l’environnement de votre équipe.

Déplacer le cache de build vers le SSD supplémentaire

+1TB SSD est adapté au stockage centralisé des caches régénérables et des artefacts intermédiaires. Vérifiez d’abord le chemin de montage réel avant de modifier vos scripts de build.

Afficher les étapes
  1. Exécutez df -h pour vérifier le point de montage et l’espace disponible sur le SSD supplémentaire. Créez un répertoire distinct pour chaque projet afin que plusieurs tâches ne partagent pas le même cache modifiable.
  2. Dirigez DerivedData de Xcode vers un répertoire de cache dédié. Pour Unity Library, séparez les caches par projet, version de l’éditeur et état des dépendances.
  3. Séparez les caches, les archives et les packages exportés dans trois répertoires. Une fois les artefacts transférés par SFTP ou vers le stockage de l’équipe, supprimez-les selon votre politique de conservation.
  4. Après un redémarrage ou une reconnexion, vérifiez que le volume est toujours monté. Si le chemin est indisponible, faites échouer clairement la tâche au lieu de basculer silencieusement sur le disque système jusqu’à saturation.

Évaluer l’espace nécessaire :estimez séparément l’espace requis pour la copie de travail, les dépendances, les caches, les tâches parallèles et les artefacts. Le SSD supplémentaire est effacé avec la machine lors de sa restitution : il ne constitue pas un disque de sauvegarde accessible après la location.

Vérifiez d’abord la capacité, puis mesurez les performances

Préparer l’inférence locale avec la configuration 24GB

GNU Studio M4 : M4 · 24GB RAM · 512GB SSD. La taille des fichiers du modèle ne correspond pas à la mémoire totale nécessaire à l’inférence. La quantification, la longueur du contexte et le nombre de requêtes simultanées changent aussi les besoins.

Créer un environnement MLX reproductible

Commencez par charger un petit modèle et vérifier ses résultats, puis ajustez le contexte ou le parallélisme. Ne soumettez pas d’emblée la charge maximale au processus de service.

Afficher les étapes
  1. Vérifiez la compatibilité des dépendances avec la version actuelle de macOS, Python et Apple Silicon. Créez un environnement virtuel distinct pour chaque expérience.
  2. Installez les dépendances requises par le projet, notez leurs versions et conservez le fichier de verrouillage. Fixez la version du modèle et le format de quantification pour vous assurer que les deux essais utilisent les mêmes poids.
  3. Chargez d’abord le modèle avec une seule requête et un contexte court. Notez la mémoire du processus, la pression mémoire et l’évolution de l’espace d’échange, puis augmentez progressivement la longueur des entrées.
  4. Pour comparer les résultats, gardez les mêmes prompts, la même longueur de génération et les mêmes conditions de préchauffage. Consignez séparément le premier chargement et les générations suivantes.

C’est prêt lorsque :vous pouvez charger le modèle et générer un résultat de manière reproductible avec la même configuration. Avant d’augmenter le parallélisme, observez les ressources utilisées : ne déduisez pas le nombre de requêtes prises en charge de la seule taille du fichier sur disque.

Planifier le stockage des modèles et le budget disque

Stockez les poids du modèle, le cache de téléchargement, les copies converties et les sorties d’expérience dans des répertoires distincts. Garder plusieurs versions quantifiées augmente l’espace disque utilisé.

Afficher les étapes
  1. Avant le téléchargement, vérifiez la taille réelle des fichiers dans le dépôt du modèle. Le budget disque doit inclure au minimum les fichiers d’origine, les sorties quantifiées ou converties, les fichiers temporaires de téléchargement et les journaux d’exécution.
  2. Séparez les répertoires des modèles et des environnements Python. Si vous utilisez le SSD supplémentaire, indiquez explicitement le chemin du cache des modèles dans la configuration de démarrage.
  3. Utilisez du -sh pour vérifier l’espace occupé par un répertoire, et df -h pour vérifier l’espace disponible sur le volume correspondant. Ces deux commandes répondent à des questions différentes.
  4. Prévoyez de l’espace temporaire pour les téléchargements et conversions qui échouent. Avant de supprimer un ancien modèle, vérifiez qu’aucune tâche en cours n’utilise encore son répertoire.

À retenir :+1TB ou +2TB SSD augmente l’espace de stockage, pas la mémoire unifiée. Avant de restituer la machine, exportez la configuration des expériences, les résultats et les poids à conserver. Ne laissez pas votre seule copie sur l’instance.

Ajoutez la date d’échéance à votre planning

Renouvellement, changement de formule et paiement

Fiez-vous à la période de facturation, à la date d’échéance et à l’état du paiement affichés sur la commande dans la console. L’instance fonctionne normalement 365 jours par an ; prévoyez tout de même du temps pour les sauvegardes et la migration.

Vérifier le renouvellement et l’échéance

Choisissez une durée de location à la journée, à la semaine, au mois ou au trimestre. Le lancement d’un paiement ne signifie pas que le renouvellement est terminé.

Afficher les étapes
  1. Ouvrez la commande correspondante dans la console et vérifiez l’instance et sa date d’échéance. Assurez-vous que la durée restante couvre les builds ou les expériences en cours.
  2. Choisissez la période et vérifiez le montant à partir des options de renouvellement proposées dans la console. Si aucune action n’est disponible pour la commande en cours, ouvrez un ticket pour savoir comment procéder.
  3. Après le paiement, vérifiez l’état de la commande et la nouvelle date d’échéance. Si elle n’a pas été mise à jour, conservez le numéro de commande et le justificatif de paiement, puis faites une demande par ticket.
  4. Si vous prévoyez de mettre fin à la location, arrêtez d’abord les nouvelles tâches, exportez les artefacts et la configuration, puis vérifiez que les copies enregistrées en local ou dans le stockage de l’équipe s’ouvrent correctement.

À noter :ne partez pas du principe qu’un renouvellement automatique est activé ou qu’un délai de grâce fixe s’applique après l’échéance. Les données sont effacées à la restitution de la machine, y compris sur le SSD supplémentaire. Transférez les données importantes avant la fin de la location.

Changer de formule et ajouter des options

Évaluez séparément les besoins en mémoire et en stockage. Avant de changer de modèle, prévoyez la migration des données et de l’environnement de build.

Afficher les étapes
  1. Notez la pression mémoire, l’espace disque disponible et les erreurs liées à la charge actuelle. Un cache volumineux ne signifie pas forcément qu’il faut davantage de mémoire.
  2. Pour changer de formule, indiquez dans un ticket depuis la console le numéro de commande, la formule souhaitée et vos besoins de migration. Confirmez d’abord la marche à suivre et le tarif.
  3. Pour ajouter un SSD +1TB, un SSD +2TB ou une connexion en parallèle Thunderbolt 5, vérifiez les options et les tarifs affichés dans la console. Pour une connexion en parallèle, précisez le nombre de machines, les logiciels utilisés et le mode d’échange des données.
  4. Après tout changement de configuration, vérifiez à nouveau les points de montage, les permissions, les tags du runner et le routage des tâches avant de reprendre les tâches en production.

À retenir :Le stockage supplémentaire n’augmente pas la mémoire. Une connexion en parallèle Thunderbolt 5 ne fusionne pas automatiquement la mémoire des machines et ne garantit pas que les tâches seront réparties automatiquement par tous les logiciels.

Comparer les tarifs des deux modèles et des options

Finaliser le paiement et vérifier sa réception

Nous acceptons uniquement USDT-TRC20 et les cartes Visa, Mastercard et Amex via Stripe. Tous les paiements sont réglés en dollars américains (USD).

Afficher les étapes
  1. Dans la commande, vérifiez le modèle, le nœud, la durée, les options et le montant dû. Les moyens de paiement effectivement disponibles sont ceux renvoyés par la passerelle.
  2. Pour payer en USDT-TRC20, suivez uniquement le réseau, les informations de réception et le montant indiqués sur la page de paiement actuelle. Ne réutilisez pas une adresse figurant sur une ancienne capture d’écran.
  3. Pour payer par carte, suivez le processus de paiement Stripe et effectuez la vérification de la carte, puis revenez dans la console pour vérifier l’état de la commande.
  4. Si le paiement n’est pas confirmé, notez l’heure du paiement, le numéro de commande et l’identifiant de transaction, puis ouvrez un ticket pour vérification. Évitez de payer à nouveau sans en connaître la raison.

Justificatif à fournir :Pour un paiement on-chain, fournissez le hash de transaction ; pour un paiement par carte, le reçu de paiement. N’envoyez jamais le numéro complet de la carte, le cryptogramme, un mot de passe ou une clé privée.

Obtenir un relevé et demander des documents comptables

Commencez par retrouver le paiement à partir de la commande concernée, puis précisez les documents dont vous avez besoin. La vérification sera plus simple qu’avec une simple capture d’écran du débit.

Afficher les étapes
  1. Dans les factures et l’historique des commandes de la console, retrouvez le paiement correspondant et vérifiez le montant, la devise, la période et le numéro de commande.
  2. Enregistrez le relevé ou le reçu de paiement disponible. Si vous avez besoin d’une facture ou d’autres documents comptables, précisez dans un ticket de la console leur usage et les champs requis.
  3. Avant de transmettre les informations nécessaires, comme le nom de facturation, vérifiez leur orthographe. Évitez de joindre des données personnelles sans rapport avec la demande.
  4. Notre équipe vérifiera le type de document, les modalités d’émission et la suite donnée à votre demande. Un reçu de passerelle de paiement ne constitue pas nécessairement une facture adaptée à tous les usages.

Pour toute demande ne concernant pas une commande :contactez-nous par e-mail à support@gnumac.com. Pour une question de facturation liée à une commande, privilégiez un ticket afin de conserver l’historique complet du traitement.

Consignez chaque étape de votre workflow

À lire aussi : des étapes pratiques aux projets concrets

Ces guides courts vous aident à trouver la prochaine étape. Retrouvez les projets pratiques et les notes techniques sur le blog ; les nouveaux articles apparaissent dans la liste.

Voir la liste des articles techniques
Conservez les éléments utiles et procédez par étapes

Problème de connexion ou alerte disque ? Vérifiez d’abord ces trois points

Déterminez d’abord s’il s’agit d’un réseau inaccessible, d’un échec d’authentification ou d’une erreur applicative. Notez le message d’erreur d’origine, l’heure et les actions déjà effectuées pour éviter de modifier plusieurs fois la configuration.

Impossible de se connecter au partage d’écran

Une adresse inaccessible, une authentification refusée et un écran noir après la connexion sont trois problèmes différents. Ne redémarrez pas l’instance à répétition sans en avoir identifié la cause.

Afficher les étapes de dépannage
  1. Vérifiez à nouveau l’adresse, le port et le nom d’utilisateur dans la console. Assurez-vous que votre client n’utilise pas une ancienne configuration d’une autre instance.
  2. Vérifiez que votre réseau local autorise les connexions sortantes. Vous pouvez réessayer sur un autre réseau autorisé pour déterminer si une règle locale est en cause.
  3. Si SSH fonctionne, vérifiez les réglages du partage d’écran et les utilisateurs autorisés. Si aucune des deux méthodes ne fonctionne, notez les erreurs respectives et ouvrez un ticket.
  4. Si la connexion est établie mais que l’image pose problème, réduisez la résolution et la qualité, puis indiquez le nom et la version du client et joignez une capture d’écran.

À joindre au ticket :le numéro de commande, l’heure de l’erreur et le fuseau horaire, le client utilisé, le message d’erreur exact et la possibilité ou non de se connecter par SSH. Masquez les identifiants sur les captures d’écran.

Délai dépassé ou échec d’authentification SSH

Un délai dépassé est souvent lié à l’adresse, au port ou au chemin réseau. En cas d’échec d’authentification, vérifiez d’abord le nom d’utilisateur, la clé publique et les permissions.

Afficher les étapes de dépannage
  1. Connectez-vous au port réellement indiqué dans les informations de livraison ; ne supposez pas qu’il s’agit du port standard. Exécutez ssh -vv pour déterminer si l’échec se produit lors de la connexion, de la négociation ou de l’authentification.
  2. En cas de délai dépassé, vérifiez les restrictions locales sur les connexions sortantes et l’état de l’instance. Si la connexion est refusée, vérifiez que le service de connexion à distance est activé.
  3. Si le message Permission denied s’affiche, vérifiez l’utilisateur cible, le contenu de la clé publique et les permissions des fichiers, puis assurez-vous que la bonne clé privée est sélectionnée en local.
  4. Si l’empreinte de l’hôte a changé, vérifiez dans la console si la machine a été réinstallée ou remplacée. Une fois la cause confirmée, mettez à jour l’entrée locale au lieu d’ignorer l’alerte de sécurité.

À joindre au ticket :la commande de connexion expurgée, les dernières lignes de l’erreur, l’heure et le fuseau horaire. N’envoyez ni clé privée ni mot de passe.

Alerte d’espace disque

Arrêtez d’abord les tâches qui continuent d’écrire, puis identifiez ce qui occupe l’espace. Ne supprimez pas directement des répertoires système ni des fichiers utilisés par d’autres tâches.

Afficher les étapes de dépannage
  1. Exécutez df -h pour repérer le volume saturé et distinguer le disque système du SSD supplémentaire. Ne vous fiez pas uniquement à la capacité totale affichée dans le Finder.
  2. Utilisez du -sh pour vérifier l’espace occupé par le projet, les caches de build, les téléchargements de modèles et les répertoires d’artefacts. Vérifiez si une tâche est encore en cours d’écriture.
  3. Transférez d’abord les artefacts à conserver, puis supprimez les caches régénérables et les fichiers temporaires des téléchargements échoués. Vérifiez également que la rotation des journaux fonctionne correctement.
  4. Après le nettoyage, vérifiez à nouveau l’espace disponible et relancez une seule tâche pour surveiller la croissance des fichiers. Si le manque d’espace persiste, envisagez un SSD supplémentaire au lieu de supprimer sans cesse les mêmes données nécessaires.

À joindre au ticket :le numéro de commande, la sortie indiquant la capacité du volume concerné, les répertoires les plus volumineux et les changements récents dans les tâches. N’envoyez pas la liste complète des répertoires si elle révèle des noms de fichiers sensibles.

Avant d’ouvrir un ticket, préparez un compte rendu reproductible

  • Contexte :numéro de commande, instance, nœud, date et heure du problème, avec le fuseau horaire.
  • Symptômes :résultat attendu et résultat obtenu ; problème survenu une seule fois ou à chaque tentative.
  • Éléments utiles :étapes minimales pour reproduire le problème, journaux expurgés et vérifications déjà effectuées.

Pour un problème lié à une commande, ouvrez un ticket depuis la console. Pour obtenir des conseils avant achat ou si vous ne pouvez pas accéder à votre compte, contactez-nous par e-mail à support@gnumac.com. Ne transmettez aucun mot de passe, aucune clé privée, aucun numéro complet de carte bancaire ni aucun élément de signature.

Se connecter et ouvrir un ticket Consulter les informations de contact

Une fois le processus défini, lancez votre location.

Choisissez le modèle, le nœud et la durée de location, puis préparez la configuration de votre projet et vos sauvegardes. Pour un problème concernant une instance existante, poursuivez directement depuis la commande dans la console.

Louer un Mac cloud Accéder à la console