Guides de dépannage par tâche

Du message d'erreur au contrôle concret.

Identifiez les problèmes d'activation, de connexion, d'outils, de stockage et de facturation. Chaque parcours indique l'ordre des vérifications, les commandes de validation et les informations de diagnostic à conserver, pour les nœuds physiques Apple Silicon dédiés HireAMac.

Schéma d'un réseau de connexion composé de cinq nœuds Mac dans le cloud
FLUX DE DIAGNOSTIC PRÊT
01 Définir le périmètre du problème Connexion / build / stockage / facturation
02 Consigner les résultats des vérifications Nœud, heure, commandes et journaux expurgés
03 Effectuer un nouveau test à variable unique Ne modifier qu'une condition à la fois
Recherche rapide

Saisissez un message d'erreur, une commande ou un champ de facturation.

Recherchez notamment délai de connexion, identifiants, Xcode, Swift, CI Runner, SSD ou cycle de commande. La recherche filtre uniquement les guides de cette page et n'envoie rien.

Première utilisation

Réalisez votre premier build en quatre contrôles.

Vérifiez d'abord le nœud et les conditions d'accès, puis le système et les outils de build. Ne modifiez pas simultanément les identifiants, le client et les outils tant que la connexion n'est pas stable.

  1. 01

    Vérifier les informations du nœud dans le portail

    Ouvrez les détails de l'instance liée à la commande et notez le modèle, la région, l'adresse de connexion et l'état de la session. Les trois configurations proposées sont HireAMac M4 S (M4, 16GB, 256GB), HireAMac M4 M (M4, 24GB, 512GB) et HireAMac M4 Pro L (M4 Pro, 64GB, 2TB). Les régions sont Singapour, Japon (Tokyo), Corée du Sud (Séoul), Hong Kong ou États-Unis (côte Est).

    • L'identifiant de commande correspond aux détails de l'instance.
    • Utilisez l'adresse de l'instance actuelle, pas celle d'une ancienne commande.
    • Pour une demande d'assistance, notez uniquement les champs nécessaires et ne copiez pas les clés d'accès.
  2. 02

    Configurer et vérifier séparément les identifiants d'accès

    Utilisez la méthode fournie dans le portail pour définir des identifiants robustes, puis conservez-les dans un gestionnaire de mots de passe ou un coffre de secrets contrôlé. Lors de la première connexion, vérifiez uniquement l'accès avant d'importer un projet, d'installer des dépendances ou de lancer une tâche longue. En équipe, accordez le minimum de droits requis et révoquez rapidement les accès lors du départ d'un membre.

  3. 03

    Vérifier macOS et l'environnement en ligne de commande

    Après avoir ouvert normalement le bureau graphique, exécutez les commandes en lecture seule suivantes dans le terminal. Conservez leur sortie texte ; inutile de capturer un bureau affichant des chemins sensibles ou des identifiants.

    sw_vers
    uname -m
    xcode-select -p
    xcrun swift --version
    xcodebuild -version

    L’architecture attendue correspond à Apple Silicon, soit arm64. Si xcode-select -p ne renvoie pas un répertoire de développement valide, configurez d'abord le chemin des outils en ligne de commande avant de poursuivre la validation du build.

  4. 04

    Lancer une tâche de build minimale et jetable

    Choisissez un petit projet sans identifiants de production, résolvez d'abord les dépendances, puis lancez un build propre. Vérifiez le code de sortie, le répertoire des artefacts, l'espace disque restant et le journal de build. Une fois cette tâche réussie, migrez les grands dépôts, caches et automatisations afin de distinguer les problèmes d'environnement des problèmes du projet.

    df -h /
    xcodebuild -project Sample.xcodeproj -scheme Sample -showBuildSettings
    xcodebuild -project Sample.xcodeproj -scheme Sample clean build
Critères de réussite : Les informations du nœud sont vérifiées, les identifiants fonctionnent, les versions du système et des outils sont lisibles et le build minimal renvoie un résultat clair. En cas d'échec, arrêtez-vous à ce niveau et ne modifiez pas simultanément la configuration suivante.
Diagnostic de connexion

Vérifiez dans l'ordre le réseau, le nœud, les identifiants, la session et le client.

L'ordre compte. Prouvez d'abord que la liaison est accessible, puis examinez l'authentification et l'affichage du client afin de ne pas confondre une panne réseau avec une erreur d'identifiants.

01

Réseau local

Vérifiez l'absence de règles de proxy, de pare-feu d'entreprise ou de restrictions liées à un hotspot. Refaites le test sur le réseau actuel puis sur un autre réseau fiable, en notant si un seul chemin échoue.

Point de contrôle Résolution DNS, accessibilité du routage, règles de port, pertes de paquets
02

Nœud cible

Retournez dans le portail pour vérifier l'adresse, la région et l'état de l'instance ; n'utilisez pas une adresse conservée par une ancienne session. Les équipes réparties doivent confirmer qu'elles se connectent au même nœud physique associé à la commande.

Point de contrôle Identifiant de commande, région du nœud, adresse de connexion, heure de mise à jour de l'état
03

Identifiants d'accès

Vérifiez le nom d'utilisateur, les droits du fichier de clé et la dernière rotation des identifiants. En cas d'échec d'authentification, n'essayez pas successivement plusieurs identifiants inconnus : confirmez d'abord l'unique source fiable.

Point de contrôle Nom d'utilisateur, droits de la clé, version des identifiants, texte de l'erreur d'authentification
04

État de la session

Vérifiez qu'aucune session plein écran, aucun bureau distant ouvert ni aucune tâche automatisée n'est encore actif. Avant de recréer une session, quittez proprement l'ancienne connexion ; n'interrompez pas directement un processus qui écrit des données.

Point de contrôle Sessions existantes, processus actifs, verrouillage du bureau, heure de la dernière déconnexion
05

Paramètres du client

Vérifiez la version du client, la résolution, les couleurs et la politique du presse-papiers. Si le terminal est accessible mais que le bureau graphique présente un problème, limitez généralement la recherche à la session ou au client.

Point de contrôle Version du client, affichage, méthode de saisie, politique de transfert de fichiers
Liste de diagnostic à copier

Remplissez tous ces champs avant d'envoyer une demande d'assistance.

L'heure doit inclure le fuseau horaire. Ne conservez dans les journaux que les lignes nécessaires autour de l'erreur et remplacez les noms d'utilisateur, chemins privés, jetons, clés et secrets du projet.

Type de problème :
Identifiant de commande :
Modèle :
Région du nœud :
Date, heure et fuseau :
Type de réseau local :
Mode de connexion et version du client :
Message d'erreur original :
Première occurrence ou problème reproductible :
Vérifications effectuées :
Extrait de journal expurgé :
Outils de développement

Vérifiez séparément l'installation, les chemins, les versions et l'exécution des tâches.

La présence d'un outil ne garantit pas qu'une tâche fonctionne. Notez le chemin de l'exécutable, la version réelle, le répertoire de développement sélectionné et le code de sortie d'une tâche minimale.

Xcode et répertoire de développement

Lisez d'abord la version de Xcode et le répertoire de développement actuel, puis utilisez xcrun pour vérifier la résolution des outils. Après avoir changé de version, rouvrez le terminal et exécutez le build avec le même utilisateur, afin d'éviter que les sessions interactives et automatisées utilisent des chemins différents.

xcodebuild -version
xcode-select -p
xcrun --find xcodebuild
xcrun simctl list runtimes

Swift et outils en ligne de commande

Vérifiez séparément le compilateur Swift, l'architecture système et les outils de build de base. Si le terminal interactif réussit mais que la tâche automatisée échoue, comparez leur PATH, répertoire de travail, identité utilisateur et variables d'environnement au lieu de réinstaller immédiatement les outils.

xcrun swift --version
clang --version
uname -m
pwd
printf '%s\n' "$PATH"

Fichiers de certificats et données sensibles

Transmettez les certificats via un chemin contrôlé, limitez les droits du fichier et vérifiez leur usage et leur validité avant importation. Lors du diagnostic, notez uniquement le nom, l'usage, les droits et le résultat de contrôle ; n'envoyez jamais de mots de passe, clés privées ni jetons valides dans des captures, journaux de build ou pièces jointes.

ls -l /path/to/certificate
file /path/to/certificate
security find-identity -v -p codesigning

Vérifier l'état du CI Runner

Quelle que soit la plateforme de dépôt, vérifiez l'utilisateur du processus Runner, le répertoire de travail, l'espace disque, le chemin des outils et le code de sortie. Lancez d'abord une tâche de contrôle sans accès aux ressources de production, puis branchez le pipeline complet. Le journal d'échec doit indiquer l'étape et le résultat de la commande.

whoami
pwd
df -h /
xcode-select -p
xcodebuild -version
xcrun swift --version

L'état des outils doit répondre à cinq questions

  • Où sont-ils installés : Les chemins des exécutables et du répertoire de développement sont clairs.
  • Quelles versions sont exécutées : Les versions de Xcode, Swift et des outils en ligne de commande sont consignées.
  • Qui les exécute : L'utilisateur interactif et celui du processus automatisé sont distingués.
  • Depuis où sont-ils exécutés : Le répertoire de travail, les fichiers du projet et le répertoire de sortie sont identifiables.
  • Comment évaluer le résultat : Le code de sortie, l'emplacement des artefacts et le journal d'erreur sont vérifiables.
Stockage et données

Choisissez la capacité selon le jeu de travail maximal, pas seulement la taille du dépôt.

Évaluez l'espace occupé simultanément par le code source, les caches de dépendances, les fichiers intermédiaires, les archives, les données de test et les copies exportées, en conservant une marge pour le nettoyage.

SSD de base

Capacité de base incluse selon le modèle

HireAMac M4 S
256GB
HireAMac M4 M
512GB
HireAMac M4 Pro L
2TB

Convient aux flux dont la capacité est prévisible, les dépendances retéléchargeables et les artefacts exportables rapidement. Les simulateurs, archives et caches peuvent dépasser largement le code source : dimensionnez selon le pic, pas selon l'occupation initiale.

+1TB SSD

Pour les builds continus et les caches multi-branches

Par jour
$2.9
Par semaine
$7.7
Par mois
$14.3
Par trimestre
$38.9

Convient au travail parallèle sur plusieurs branches, à la conservation des caches de dépendances ou à des artefacts en croissance continue. Avant la commande, vérifiez que la capacité couvre le jeu de travail et les copies exportées simultanément.

+2TB SSD

Pour les grands jeux de données et les tâches parallèles

Par jour
$5.8
Par semaine
$15.4
Par mois
$28.6
Par trimestre
$77.8

Convient aux données expérimentales volumineuses, aux grands projets multiples ou aux tâches conservant de nombreux artefacts intermédiaires. L'extension de capacité ne remplace pas une stratégie de sauvegarde : exportez et vérifiez les données importantes avant la fin de la location.

ENTRÉE

Téléverser

Téléversez d'abord l'ensemble minimal exécutable, vérifiez les droits, l'intégrité et l'arborescence, puis envoyez les ressources volumineuses par lots. N'intégrez pas de clés dans une archive du dépôt ou un paquet de données générique.

DÉPLACER

Migrer

Notez les chemins source et cible, le nombre de fichiers et le résultat de contrôle. Pendant la migration, mettez en pause les tâches qui réécrivent le même répertoire afin d'éviter des états divergents.

NETTOYER

Nettoyer

Supprimez en priorité les caches et artefacts temporaires régénérables. Vérifiez avant nettoyage qu'aucune tâche active n'utilise le répertoire cible et consignez la portée de la suppression ainsi que l'espace libéré.

EXPORTER

Exporter

Avant la fin de la location, exportez le code source, la configuration, les artefacts et les journaux nécessaires, puis vérifiez le nombre de fichiers ou les sommes de contrôle. Vérifiez que la copie externe s'ouvre avant de traiter les données restantes sur le nœud.

df -h /
du -sh ~/Projects
du -sh ~/Library/Developer/Xcode/DerivedData
find ~/Projects -type f | wc -l
Index des questions de facturation

Commencez par le cycle, puis vérifiez le modèle, le nœud et les options.

Toutes les commandes sont facturées en dollars américains (USD). Les passerelles réellement disponibles sont celles affichées en temps réel dans le portail ; les paiements acceptés sont USDT-TRC20 et Visa / Mastercard / Amex (via Stripe).

Tarifs journaliers, hebdomadaires, mensuels et trimestriels des trois modèles
Modèle Configuration Par jour Par semaine Par mois Par trimestre
HireAMac M4 S M4 / 16GB / 256GB $20.9 $56.4 $104.4 $284
HireAMac M4 M M4 / 24GB / 512GB $41.2 $111.2 $205.9 $560
HireAMac M4 Pro L M4 Pro / 64GB / 2TB $59.9 $161.8 $299.6 $814.9
Tarifs des extensions de stockage et des connexions Thunderbolt 5 parallèles
Option Par jour Par semaine Par mois Par trimestre
+1TB SSD $2.9 $7.7 $14.3 $38.9
+2TB SSD $5.8 $15.4 $28.6 $77.8
Connexion Thunderbolt 5 parallèle (par machine) $1.3 $3.6 $6.7 $18.2
JOUR

Commande à la journée

Idéale pour les builds ponctuels, la reproduction d'incidents et les validations courtes. Vérifiez dans la commande le nombre de jours, le tarif journalier du modèle, celui des options et les champs du nœud.

SEMAINE

Commande à la semaine

Idéale pour un sprint de version ou des tests continus. La facture doit afficher le tarif hebdomadaire du modèle et les options de stockage ou de connexion facturées à la semaine.

MOIS

Commande au mois

Idéale pour le développement quotidien et un flux CI stable. Vérifiez les limites du cycle mensuel, le tarif mensuel du modèle, le nœud et le coût mensuel de chaque option.

TRIMESTRE

Commande au trimestre

Idéale pour les tâches continues aux besoins stables. Vérifiez que le tarif du modèle, celui des options et le cycle de commande utilisent la même période.

Dans quel ordre vérifier le montant de la facture ?
Confirmez d'abord le modèle et le cycle de facturation, puis le nœud, l'extension de stockage et le nombre de connexions Thunderbolt 5 parallèles. Vérifiez enfin les champs de règlement en dollars (USD) et le résultat du paiement. Ne mélangez pas les tarifs de périodes différentes.
Quels moyens de paiement sont acceptés ?
Seuls USDT-TRC20 et Visa / Mastercard / Amex (via Stripe) sont acceptés ; toutes les commandes sont réglées en dollars (USD). Les passerelles disponibles sont celles affichées en temps réel dans le portail.
Comment confirmer la combinaison nœud-modèle ?
Les trois modèles sont disponibles à Singapour, au Japon (Tokyo), en Corée du Sud (Séoul), à Hong Kong ou dans l'Est des États-Unis. La disponibilité réelle au moment de la commande est celle affichée en temps réel dans le portail.
Fiche de préparation pour l'assistance

Permettez à l'assistance de reproduire directement le problème.

Vous pouvez créer un ticket depuis le portail ou écrire à support@hireamac.com. N'envoyez jamais de clés d'accès, mots de passe, jetons valides ni données de projet non expurgées.

Nœud et modèle

Indiquez Singapour, Japon (Tokyo), Corée du Sud (Séoul), Hong Kong ou États-Unis (côte Est), ainsi que le nom exact du modèle HireAMac proposé.

Identifiant de commande et heure de l'incident

Indiquez l'identifiant de commande du portail. L'heure doit comprendre la date, l'heure et le fuseau ; pour un problème continu, précisez le début et la fin.

Étapes minimales de reproduction

Partez d'un état connu comme fonctionnel et listez chaque action, entrée, résultat attendu et résultat obtenu. Précisez si le problème survient à chaque fois.

Journaux expurgés et actions déjà tentées

Conservez le texte original de l'erreur, le code de sortie et le contexte nécessaire. Remplacez les noms d'utilisateur, chemins privés, clés, jetons, certificats et données métier.

Étape suivante

Problème identifié ? Retournez à votre flux de travail.

Pour un nouveau nœud, comparez les trois configurations et les quatre durées de location. Pour une instance existante, connectez-vous au portail et envoyez un ticket incluant les résultats du diagnostic.