Choisissez la connexion, Xcode, CI/CD, le stockage, le réseau ou le renouvellement pour afficher les ressources pertinentes. Vous pouvez aussi rechercher une commande, un symptôme ou un nom d’outil.
Les 6 catégories d’aide sont actuellement affichées.
Raccourcissez les mots-clés ou effacez la catégorie pour rechercher le nom d’une commande. Pour une commande existante, soumettez directement un ticket via la console.
Fiez-vous aux informations affichées dans la page de détails de l’instance de la console. Ne devinez pas l’adresse de l’hôte à partir d’anciens tickets ou de commandes historiques ; après une nouvelle mise à disposition du nœud, recopiez les informations actuelles.
Ouvrez les détails de l’instance dans la console et copiez l’adresse de l’hôte, le nom d’utilisateur SSH, le port et les informations de clé. Vérifiez d’abord que la commande et le nœud sélectionnés correspondent, puis collez la commande dans votre terminal local.
Placez le fichier de clé dans un répertoire contrôlé par l’utilisateur local. Ne l’ajoutez ni à un dépôt Git, ni à un artefact de compilation, ni à une conversation d’équipe. Le nom du fichier est libre, mais le chemin utilisé ensuite doit correspondre.
Dans un terminal local macOS ou Linux, exécutez chmod 600 ~/.ssh/oncemac_key. Si SSH signale que les autorisations de la clé privée sont trop larges, corrigez-les d’abord au lieu de désactiver les contrôles de sécurité.
Exécutez la commande SSH fournie par la console. Lors de la première connexion, vérifiez la source de l’empreinte de l’hôte ; une fois connecté au nœud, exécutez hostname,sw_vers et whoamipour confirmer l’hôte, le système et l’utilisateur actuel.
Ne modifiez qu’une variable à la fois. Vérifiez d’abord la stabilité de la session SSH, lisez ensuite la version de Xcode, puis lancez la compilation avec son bundle de résultats et ses journaux. Vous pourrez ainsi distinguer un problème de connexion, de chaîne d’outils ou de projet.
$ ssh -i ~/.ssh/oncemac_key user@host
Last login: current session
connected: once-node
$ xcodebuild -version
Xcode 16.x
Build version 16x
$ xcode-select -p
/Applications/Xcode.app/Contents/Developer
$ set -o pipefail
$ xcodebuild \
-workspace App.xcworkspace \
-scheme App \
-destination 'generic/platform=iOS' \
-resultBundlePath ./BuildResults.xcresult \
build | tee build.log
** BUILD SUCCEEDED **
$ bundle exec fastlane ios build
[fastlane] resolving dependencies
[fastlane] archive completed
[fastlane] lane finished successfully« Cela fonctionne en local, mais pas sur le nœud » ne suffit généralement pas à identifier la cause. Comparez le même commit, le fichier de verrouillage des dépendances, le scheme, le destination et les variables d’environnement, puis confrontez les sorties des deux côtés.
Exécutez xcodebuild -version, notez la version principale et la Build version. Si le pipeline dépend d’une version précise, affichez-la au début de la tâche au lieu de la vérifier uniquement lors de la configuration initiale.
xcodebuild -version
xcrun --find simctl
swift --versionExécutez xcode-select -p pour vérifier le chemin actuel de Command Line Tools. Si plusieurs versions de Xcode sont utilisées, définissez explicitement DEVELOPER_DIRdans l’environnement de l’exécuteur afin d’éviter que la session interactive et la tâche automatisée utilisent des chemins différents.
xcode-select -p
echo "$DEVELOPER_DIR"
xcrun --sdk iphoneos --show-sdk-pathVérifiez d’abord que le trousseau est accessible et que le nom du certificat correspond aux conditions du provisioning profile, puis contrôlez le Team, le Bundle Identifier et le mode de signature du projet. Pour un ticket, fournissez uniquement l’extrait d’erreur désensibilisé, sans certificat, clé privée ni mot de passe.
security list-keychains
security find-identity -v -p codesigning
xcodebuild -showBuildSettingsAvec set -o pipefail , conservez le véritable état de sortie et utilisez tee pour écrire les journaux. En cas d’échec complexe, générez de préférence un .xcresultet supprimez avant le partage les noms d’utilisateur, chemins, jetons et données métier.
set -o pipefail
xcodebuild build | tee build.log
echo "${PIPESTATUS[0]}"OnceMac fournit des nœuds physiques dédiés et un environnement macOS complet en ligne de commande. Les fonctions propres à chaque plateforme, la compatibilité des plug-ins et la définition des tâches doivent être validées par votre équipe selon son dépôt et ses versions.
runs-on correspondante dans le workflow.whoami,pwd, la version de Xcode et l’espace disque disponible.Reconstruisez de préférence la chaîne d’outils à partir de Git, des fichiers de verrouillage et du Brewfile. Ne migrez que les répertoires de travail et caches réellement nécessaires. Copier tout l’environnement d’un ancien utilisateur transfère aussi les configurations obsolètes, les chemins absolus et les identifiants sensibles.
Utilisez d’abord le mode prévisualisation pour vérifier les éléments qui seront copiés et supprimés, puis lancez la synchronisation réelle. Toute suppression dans le chemin cible doit être confirmée par l’opérateur.
rsync -avhn \
--exclude '.git' \
--exclude 'DerivedData' \
./Project/ user@host:~/Project/Sur le nœud source, notez la branche, le hash du commit et les modifications non validées. Après le clonage sur le nouveau nœud, vérifiez le hash puis restaurez les dépendances ; ne remplacez pas l’historique des versions par une archive compressée.
git status --short
git rev-parse HEAD
git clone repository-url
git checkout commit-hashExaminez la liste avant l’export et supprimez les logiciels devenus inutiles. Après la restauration, vérifiez chaque version de commande : une installation terminée sans erreur ne garantit pas que l’environnement est opérationnel.
brew bundle dump --file Brewfile
brew bundle check --file Brewfile
brew bundle install --file BrewfileLes clés privées SSH, jetons de dépôt, éléments de signature, fichiers de variables d’environnement et clés de service ne doivent pas être copiés en masse avec le répertoire du projet. Après avoir confirmé les droits minimaux du nouveau nœud, reconfigurez-les via le processus sécurisé approuvé par votre équipe.
Traitez ces cinq catégories dans l’ordre suivant : confirmer le symptôme, exécuter la commande minimale, noter le résultat, puis arrêter toute modification inefficace. Ouvrez la catégorie correspondante pour consulter la liste de contrôle.
chmod 600 pour vérifier les autorisations de la clé privée locale et confirmer que le chemin indiqué dans la commande existe.ssh -vvv pour obtenir les détails de la phase de connexion, puis supprimez avant l’envoi du ticket les données personnelles présentes dans l’adresse complète, le nom d’utilisateur et le chemin de clé.set -o pipefail pour conserver le véritable code de sortie, puis exportez .xcresult ou les journaux complets.df -h pour afficher l’espace disponible sur les volumes, puis utilisez du -sh pour localiser l’espace de travail, DerivedData, les archives et les caches de dépendances.uptimeet vérifiez si l’heure de démarrage correspond à l’heure du problème.Pour les commandes existantes, l’état du nœud et les problèmes de renouvellement, privilégiez un ticket via la console. Pour les questions de configuration et d’usage avant commande, envoyez un e-mail. L’adresse de contact externe est uniquement support@oncemac.com.
Indiquez le numéro de commande, le nom de la configuration et la région du nœud ; ne fournissez ni justificatif de paiement ni relevé complet.
Indiquez le fuseau horaire, la première occurrence, la dernière reproduction et si le problème persiste.
Listez les commandes exécutées, le résultat attendu, le résultat réel et le code de sortie ; n’écrivez pas seulement « impossible à utiliser ».
Conservez le contexte de l’erreur et supprimez les clés, jetons, mots de passe, adresses IP complètes, éléments de signature et données métier.
Indiquez les résultats déjà vérifiés concernant le réseau, les versions, les chemins, le disque et les nouvelles tentatives afin d’éviter de répéter des étapes inutiles.
Pour les problèmes de connexion au nœud, de compilation, de facturation, de renouvellement et d’état de commande. Le ticket sera associé au compte connecté pour faciliter la vérification du contexte de l’instance.
Accéder à la consolePrécisez l’usage prévu, le nœud cible, la version de Xcode, le nombre de compilations concurrentes, le stockage nécessaire et la date de mise en service souhaitée.
support@oncemac.comOnceMac propose 3 configurations disponibles et 6 nœuds, avec un fonctionnement normal 365 jours par an. Toutes les commandes sont réglées en dollars américains et gérées depuis la console.