Première utilisation · Guide pratique

Louez un Mac cloud et obtenez votre premier artefact de build.

Ce guide s’adresse aux développeurs qui souhaitent utiliser un Mac dédié pour Xcode ou une CI macOS. Choisissez votre configuration et votre région, récupérez vos informations de connexion, vérifiez les outils, puis lancez un build reproductible.

Les commandes et résultats affichés sont des exemples et ne signifient pas que votre projet est déjà configuré. Les paramètres de connexion, l’état de la machine et l’avancement de la livraison sont ceux indiqués dans la console.

Checklist du premier build 01 / 04

Vérifiez ces quatre points avant de confier le projet à un nœud distant.

Machine
Choisissez un Mac dédié M4 ou M4 Pro
Région
Vérifiez les régions actuellement disponibles
Connexion
Connectez-vous avec les informations fournies dans la console
Build
Notez la version des outils et le chemin des artefacts

Checklist indicative · La commande et la console font foi

Parcours de mise en service · Démonstration

Quatre étapes jusqu’à la première connexion.

Le temps indiqué sert uniquement à illustrer la durée d’une démonstration, et non un délai de livraison. Consultez le statut de la commande et de la machine dans la console pour connaître l’avancement réel et vérifier si les informations de connexion sont disponibles.

Environ 4 minutesDurée totale des opérations présentées, hors attente de livraison

  1. 01

    Choisir un modèle et une région

    Choisissez une configuration disponible selon les besoins en mémoire et en stockage du projet, puis une région adaptée à l’emplacement de l’équipe et à ses fuseaux horaires. Vérifiez la couverture avant de commander.

    Environ 1 min pour l’exemple
  2. 02

    Passer commande

    Vérifiez la durée de location et les options, puis validez la commande. La disponibilité et les moyens de paiement proposés sont ceux affichés en temps réel dans la console.

    Environ 1 min pour l’exemple
  3. 03

    Récupérer les informations de connexion

    Attendez que la machine soit indiquée comme prête. Dans la console, récupérez l’adresse, le compte et les instructions de connexion associés à cette instance. Ne réutilisez pas les identifiants des exemples publics.

    Environ 1 min pour l’exemple
  4. 04

    Se connecter et vérifier l’environnement

    Connectez-vous et vérifiez le compte utilisé, l’espace disque et la version de la chaîne d’outils Xcode. En cas d’écart, arrêtez les tâches automatisées et consignez les résultats.

    Environ 1 min pour l’exemple
Connexion et commandes · Exemples anonymisés

Connectez-vous au nœud, puis vérifiez un build.

SSH convient pour récupérer le code, lancer un build et consulter les journaux. Pour utiliser l’interface graphique de Xcode, suivez les instructions de connexion au bureau à distance fournies pour votre instance.

À remplacer avant exécution

  • Adresse et compte : L’adresse de l’exemple ne permet pas de se connecter. Utilisez uniquement les paramètres fournis dans la console pour votre instance.
  • Projet et Scheme : Remplacez le fichier de projet et le Scheme par les noms réels du dépôt, puis vérifiez la plateforme cible.
  • Critères de réussite : Vérifiez le code de sortie, les journaux de build et les fichiers générés. La sortie de l’exemple ne correspond pas à l’exécution de votre projet.
Voir le guide de connexion SSH et au bureau à distance →
Du local au cloud

Migrez un processus reproductible, pas seulement les fichiers du projet.

Mac local → Mac cloud : assurez-vous d’abord que le code source et les dépendances sont accessibles, vérifiez la chaîne d’outils, puis dirigez les tâches CI vers le nouveau nœud d’exécution.

01 / Données

Transférer le projet et les fichiers nécessaires

Privilégiez la récupération du code depuis le dépôt et identifiez les fichiers de configuration et ressources de build non suivis. Faites l’inventaire des éléments sensibles avant le transfert afin de ne pas inclure d’identifiants dans le dépôt ou les journaux.

Vérification : Les fichiers du projet attendus sont présents dans le répertoire cloud et les droits d’accès aux fichiers sensibles ont été vérifiés.

02 / Environnement

Vérifier Xcode et les dépendances

Notez les versions de Xcode, des outils en ligne de commande et des dépendances gérées par un gestionnaire de paquets en local. Résolvez à nouveau les dépendances dans le cloud et vérifiez les exigences minimales du projet en matière de système et d’architecture.

Vérification : Le même Scheme lance un build en ligne de commande et les différences de version sont consignées.

03 / Automatisation

Configurer un runner CI

Attribuez au nouveau nœud une identité Runner et des tags de job dédiés. Lancez d’abord une tâche de validation ne nécessitant aucun identifiant de publication, puis vérifiez les autorisations requises pour le packaging.

Vérification : Les tâches de test s’exécutent sur le nœud prévu et leurs journaux comme leurs artefacts sont traçables.

Compilation Xcode dans le cloud

Établissez une référence vérifiable pour votre premier build.

Commencez par effectuer un build complet manuellement et conservez les versions, la commande et les messages d’erreur. Décidez ensuite si vous souhaitez automatiser la tâche. Les besoins en signature et en dépendances varient selon les projets.

01

Récupérer le projet

Récupérez le dépôt par la méthode approuvée par votre équipe et vérifiez le commit cible, les sous-modules et les fichiers de verrouillage. Exécutez d’abord git status pour éviter d’évaluer le build à partir de modifications non identifiées.

02

Protéger les éléments de signature

Définissez qui gère les certificats, les profils de provisionnement et les clés nécessaires, et qui peut y accéder. Ne placez pas de clé privée dans un dépôt public et ne copiez pas d’identifiants complets dans un ticket de dépannage.

03

Lancer le build

Vérifiez d’abord xcodebuild -version ainsi que le Scheme du projet, puis lancez la commande de build réellement utilisée par le projet. Notez le code de sortie et la première erreur pertinente au lieu de ne conserver que la fin des journaux.

04

Récupérer les artefacts

Vérifiez les fichiers générés, leur taille et leur chemin, puis archivez-les ou transférez-les selon le processus de l’équipe. Un message de réussite ne remplace pas la vérification des fichiers et de leur signature.

Intégration CI/CD

Validez le Runner avant d’activer le packaging automatisé.

Pour configurer un runner macOS GitLab CI, installez-le et enregistrez-le sur le nœud, associez-le à un projet autorisé et utilisez des tags de job pour contrôler où les tâches s’exécutent. La méthode d’enregistrement, le périmètre d’accès et les paramètres de concurrence doivent respecter les règles CI de votre équipe.

Le premier job de validation peut simplement afficher les versions du système et de Xcode. Cela confirme que la tâche a atteint le nœud Apple Silicon prévu, mais ne garantit pas que la signature, le téléchargement des dépendances ou la publication fonctionnent.

Vérifications des accès avant le packaging

  • Identité du Runner : Vérifiez le périmètre d’enregistrement, le compte d’exécution et les tags de job afin que les tâches ne soient pas prises en charge par un autre nœud.
  • Accès au projet : Vérifiez que le compte d’exécution peut accéder au dépôt, aux sous-modules et aux dépendances privées.
  • Accès aux éléments de signature : Fournissez les éléments nécessaires uniquement aux tâches de packaging concernées et vérifiez que les journaux n’affichent aucune donnée sensible.
  • Destination des artefacts : Définissez le répertoire d’archivage, les droits de lecture et les responsabilités de nettoyage avant de lancer un packaging complet.

fastlane peut s’intégrer au processus de packaging existant, mais ne remplace pas les vérifications propres au projet sur les accès, la signature et les versions.

Commandes et facturation

Vérifiez séparément les conditions de location et les tâches à exécuter.

Avant de commander, choisissez le modèle, la région et la durée de location (jour, semaine, mois ou trimestre), puis déterminez si vous avez besoin d’une extension SSD ou de la mise en parallèle Thunderbolt 5. Chaque option est facturée séparément ; la commande confirmée fait foi pour le choix final et le montant.

Paiement uniquement par USDT-TRC20 ou Visa / Mastercard / Amex (via Stripe), en dollars américains (USD). Les moyens disponibles dépendent de ceux indiqués par la console.

Vous avez déjà une commande ?

Dans la console, vérifiez la référence de commande, la durée de location, la région, les options et le statut de la machine. Pour toute question de facturation concernant une commande existante, connectez-vous et ouvrez un ticket en indiquant sa référence et les points à vérifier. N’envoyez pas d’informations de paiement dans un message public.

Ouvrir la console
Diagnostic

Repérez d’abord l’étape qui a échoué.

Avant de contacter l’équipe, notez l’heure de l’incident, la référence de commande associée à l’instance, l’opération effectuée et le message d’erreur anonymisé. N’envoyez ni mot de passe, ni clé privée, ni certificat de signature, ni document de projet non expurgé.

Connexion impossible

Vérifiez d’abord dans la console le statut de la machine, son adresse et le compte utilisé, puis contrôlez votre réseau local et le mode de connexion. Notez la commande, le type d’erreur et l’heure de l’incident ; masquez les identifiants.

Échec du build

Notez la version du commit, celle de Xcode, le Scheme, la commande complète et la première erreur pertinente. Identifiez s’il s’agit de la récupération des dépendances, de la compilation, de la signature ou de l’exportation. Ne fournissez pas uniquement la dernière ligne indiquant l’échec du build.

Espace disque insuffisant

Vérifiez l’espace occupé par le projet, le cache de build et les artefacts. Déterminez d’abord avec l’équipe quels fichiers peuvent être supprimés en toute sécurité. Joignez un relevé anonymisé de l’espace utilisé et le chemin en erreur, sans supprimer par mégarde des artefacts à archiver.

Problème d’autorisation

Vérifiez le compte d’exécution, la propriété des fichiers et les droits d’accès au dépôt ou aux éléments de signature. Notez le chemin concerné et le message d’erreur ; n’élargissez pas les droits sur tous les fichiers pour contourner le problème.

Prêt à vous lancer ?

Choisissez une région et définissez un environnement d’exécution clair pour votre prochain build.

Comparez les trois configurations et les durées de location, puis vérifiez les disponibilités en temps réel dans la console. Après connexion, commencez par un build de validation reproductible.