Checklist de passation de l’environnement de développement

De la commande à votre premier build

Louez un Mac cloud sur une machine physique dédiée et raccordez-y vos dépôts, outils et pipelines existants. Ce guide suit l’ordre des opérations. Si vous disposez déjà d’un dépôt et de scripts de build, prévoyez environ 30 à 60 minutes pour migrer l’environnement, hors transfert de données et téléchargement de Xcode.

Vous avez déjà une instance ? Connectez-vous à la console pour consulter les informations de connexion. Les commandes et sorties ci-dessous sont des exemples. Les adresses et identifiants réels sont ceux indiqués dans la console.

Choisir la configurationRécupérer les identifiantsMigrer l’environnementVérifier le build
Avant de commencer

Commencez par commander, puis notez vos informations de connexion

Au moment de commander, définissez trois éléments : le modèle détermine les ressources disponibles pour la compilation et les tâches parallèles, la région influe sur la latence des connexions à distance et la durée de facturation fixe la période d’utilisation. Les trois modèles sont des machines physiques dédiées, et non des machines virtuelles. Leur disponibilité en temps réel est indiquée dans la console.

01 / Configuration

Choisir le modèle, la région et la durée

ZSH 16 convient pour valider un premier pipeline de build. Pour la compilation parallèle ou un runner actif en continu, envisagez ZSH 24. Pour les expérimentations MLX nécessitant davantage de mémoire unifiée, découvrez ZSH Pro 64. Choisissez ensuite la région en fonction de l’emplacement principal de votre équipe.

À vérifier : modèle, capacité SSD, région et durée de facturation (jour, semaine, mois ou trimestre).

02 / Paiement

Régler en dollars américains

Payez en USDT-TRC20 ou par Visa, Mastercard ou Amex via Stripe. Avant un transfert USDT, vérifiez qu’il s’agit bien du réseau TRC20. Pour les cartes, suivez les étapes de la passerelle indiquée sur la page de paiement.

À vérifier : le résultat du paiement et le statut de la commande dans la console. Les moyens de paiement disponibles dépendent de la réponse du système.

03 / Livraison

Récupérer les identifiants SSH et de partage d’écran

Une fois l’instance livrée, notez dans la console son adresse de connexion, le nom d’utilisateur, les identifiants de première connexion et l’empreinte de l’hôte. Ne stockez pas ces informations dans un dépôt, des journaux de build ou des documents d’équipe accessibles à tous.

À vérifier : la connexion SSH fonctionne et l’interface graphique de macOS s’ouvre.

Ordre de migration

Transférez les données, les outils, puis la CI

Commencez par réussir un build autonome d’un dépôt sur la nouvelle machine, puis connectez les tâches automatisées. En cas d’erreur, vous pourrez ainsi déterminer si elle vient de données manquantes, d’une version d’outil différente ou de la configuration du runner.

01Données

Commencez par migrer le dépôt et les éléments de signature

Transférez le dépôt avec rsync ou clonez-le à nouveau depuis un dépôt distant contrôlé. Transférez séparément les certificats, profils de provisionnement et exportations du trousseau, en les chiffrant. Ne placez pas de clé privée dans un répertoire de synchronisation classique.

  • Vérifiez que la branche du dépôt, les sous-modules et les fichiers Git LFS sont présents.
  • Après l’importation des éléments de signature, vérifiez l’accès au trousseau depuis la session de l’utilisateur qui lance le build.
  • Comparez les variables d’environnement nécessaires au build, sans copier en clair les secrets de votre machine locale.

Durée indicative de vérification manuelle : 10 à 20 minutes, hors transfert des données.

02Outils

Verrouillez les versions avant de restaurer les caches

Installez les dépendances en ligne de commande avec Homebrew et gérez les versions de Xcode requises par le projet avec xcodes. Vérifiez d’abord la cible de xcode-select avant de synchroniser les dépendances nécessaires à fastlane, CocoaPods et SPM.

  • Notez xcodebuild -version ainsi que la version requise par le projet.
  • Lancez la résolution des dépendances sans reprendre les chemins absolus de l’ancienne machine dans le cache.
  • Exécutez un build local pour un seul scheme avant de passer aux tests parallèles.

Durée indicative de vérification manuelle : 10 à 20 minutes, hors téléchargement des logiciels.

03Pipeline

Enregistrez enfin un runner dédié

Intégrez la machine à votre workflow GitHub Actions ou GitLab Runner existant. Suivez les étapes d’enregistrement fournies par le dépôt ou l’organisation afin que les builds s’exécutent sous un compte système dédié.

  • Attribuez au runner des labels permettant d’identifier clairement le modèle et la région.
  • Vérifiez avec les tâches de test Xcode, la signature et le chemin de sortie des artefacts.
  • Limitez le nombre de tâches simultanées et vérifiez qu’aucun fichier temporaire sensible ne subsiste à leur fin.

Durée indicative de vérification manuelle : 10 à 20 minutes, hors première tâche.

Ces durées servent uniquement à planifier les vérifications manuelles ; elles ne garantissent pas les délais de mise à disposition ou de téléchargement. Si le build dépend de nombreux caches, migrez d’abord une configuration reproductible, puis décidez si les fichiers de cache doivent aussi être transférés.

Vérification

Vérifiez l’environnement avec trois séries de commandes

Les exemples ci-dessous sont des sorties de terminal fictives, pas l’adresse, l’empreinte ou le résultat de build réels de votre instance. Remplacez les adresses et le scheme d’exemple par les valeurs de la console et du projet. Lors de la première connexion SSH, comparez impérativement à l’identique l’empreinte de l’hôte affichée dans la console.

zsh — mac@sg-node Sortie d’exemple

Connexion et vérification de l’empreinte

zsh % ssh -o StrictHostKeyChecking=ask mac@203.0.113.10
The authenticity of host '203.0.113.10' can't be established.
Host key verification required before continuing.
Arrêtez-vous à la demande de confirmation. Comparez l’empreinte ED25519 affichée dans le terminal à celle de la console. Si elles diffèrent, interrompez la connexion et ouvrez un ticket d’assistance.

Vérifier le build

zsh % xcodebuild -version
Xcode 16.2
zsh % xcodebuild -scheme App -configuration Release build
** BUILD SUCCEEDED **
Vérifiez d’abord la version de Xcode, puis lancez le build avec le scheme et la configuration propres au projet. La version affichée en exemple ne correspond pas nécessairement à celle préinstallée sur votre instance.

Vérifier le processus de distribution

zsh % fastlane beta
Running lane 'beta'
Archive complete
Upload to TestFlight complete
Avant l’envoi, vérifiez les éléments de signature de l’équipe, les autorisations et la configuration de la lane fastlane. Évitez d’afficher des jetons réels dans les journaux CI.
Interface graphique

Besoin d’un bureau ? Connectez-vous en partage d’écran

SSH convient pour installer des dépendances, récupérer du code et lancer des builds. Pour les réglages Xcode, le simulateur et les outils graphiques, utilisez le partage d’écran de macOS. Consultez dans la console l’adresse et les identifiants de partage d’écran de l’instance, puis connectez-vous depuis l’application de partage d’écran de votre ordinateur.

Lors de votre première session, vérifiez que la résolution et le facteur d’échelle conviennent à votre réseau. Si l’affichage à distance manque de réactivité, réduisez d’abord la résolution et désactivez les animations graphiques superflues, puis comparez la connexion depuis différents réseaux. Utilisez la synchronisation du presse-papiers uniquement pour du texte non sensible. Pour transférer un certificat ou une clé privée, choisissez une méthode chiffrée et contrôlée.

DISPLAY / CONNECTAvant de vous connecter
Adresse et identifiants
Consultez la console de l’instance concernée ; ne réutilisez pas les informations d’une autre instance.
Affichage
Choisissez d’abord une résolution lisible et stable, puis ajustez la qualité en fonction de la bande passante.
Presse-papiers
Ne synchronisez que le texte nécessaire ; transférez les fichiers sensibles par un processus distinct.
Problème de connexion
Vérifiez le statut et l’adresse de l’instance, puis contrôlez votre réseau local et les règles du pare-feu.
Vérifications après livraison

Effectuez les premières étapes de sécurisation

Une connexion réussie ne suffit pas à terminer la passation. Effectuez les quatre vérifications ci-dessous avant d’intégrer l’instance à la CI permanente. L’équipe qui utilise réellement cette machine doit confirmer chaque point ; une simple capture d’écran d’une connexion réussie ne suffit pas.

  1. 01 Remplacez le mot de passe initial Dans macOS, définissez un nouveau mot de passe pour le compte fourni, puis mettez à jour les identifiants dans l’espace sécurisé de l’équipe. Ne collez jamais de mot de passe en clair dans une conversation ou la documentation des variables du pipeline.
  2. 02 Passez aux clés SSH Installez d’abord la clé publique et ouvrez un nouveau terminal pour vérifier que la connexion fonctionne, puis modifiez la politique de connexion par mot de passe. Gardez la session actuelle ouverte pour ne pas perdre l’accès en cas d’erreur de configuration.
  3. 03 Vérifiez le pare-feu Activez le pare-feu de macOS et vérifiez les accès nécessaires au développement et au partage d’écran. Notez les règles actuelles avant toute modification et assurez-vous que la connexion d’administration reste disponible.
  4. 04 Planifiez les mises à jour du système Exécutez régulièrement softwareupdate -l pour rechercher les mises à jour. Avant d’installer une mise à niveau susceptible d’affecter l’environnement de build, sauvegardez vos données et vérifiez la compatibilité de Xcode avec le projet.
Gestion de la location

Vérifiez la durée avant de renouveler et sauvegardez vos données avant la libération

Consultez la page des commandes de la console pour connaître les dates de début et de fin de la période en cours, les factures et l’option de renouvellement. Fiez-vous aux rappels affichés dans la console et aux notifications de service reçues ; ne vous basez pas uniquement sur votre calendrier local. Pour continuer à utiliser l’instance, vérifiez le modèle, la région, la durée et le montant dans la console avant de renouveler.

Avant de terminer votre utilisation, sauvegardez les modifications non poussées du dépôt, les éléments de signature, les artefacts de build et les journaux d’audit nécessaires. Vérifiez depuis un autre appareil que la sauvegarde est accessible, puis demandez la libération dans la console. Après la libération, le disque est effacé et le système réinstallé : ne considérez pas cette opération comme une méthode de sauvegarde.

Pour aller plus loin

Trouvez le guide adapté à votre prochaine étape

Pour approfondir SSH, VNC et la configuration quotidienne de votre environnement de développement, consultez les articles sur la mise en place d’un environnement Mac distant. Pour les paramètres de build, les caches et la configuration du runner, poursuivez avec le guide de compilation Xcode dans le cloud. En cas de problème avec l’instance ou la facturation, contactez l’assistance technique.

Environnement et connexion

Configurer un environnement de développement Mac distant

Découvrez comment gérer les clés SSH, configurer Homebrew, activer le partage d’écran et connecter un éditeur à distance.

Builds et pipelines

Guide complet de compilation Xcode dans le cloud

Approfondissez les versions de Xcode, les caches de build, les commandes de test et la connexion d’un runner self-hosted.

Instance et facturation

Centre d’assistance technique

En cas d’échec de connexion, de problème d’environnement de build ou de question sur un renouvellement, commencez par les étapes de dépannage, puis ouvrez un ticket depuis la console.

Étape suivante / Configurer

Lancez votre premier build

Choisissez un modèle, une région et une durée. Une fois l’instance livrée, suivez cette checklist pour vous connecter, migrer votre environnement et tout vérifier.