Guide 2026 Mac distant : Miroirs Homebrew, npm, CocoaPods et reprise après coup

Le choix du miroir dépend de la localisation du nœud et de la stabilité CI. Tableau récapitulatif pour Homebrew, npm et CocoaPods :

Règle : Europe/US → miroirs officiels ; Chine → Tsinghua, USTC, npmmirror ; transfrontalier → proxy HTTP avec cache.

1. Homebrew — Miroir (ex. Tsinghua) :

# Miroir bouteilles (formulaires)
export HOMEBREW_BOTTLE_DOMAIN="https://mirrors.tuna.tsinghua.edu.cn/homebrew-bottles"

# Ou pour le dépôt Git principal (clone/update)
export HOMEBREW_BREW_GIT_REMOTE="https://mirrors.tuna.tsinghua.edu.cn/git/homebrew/brew.git"
export HOMEBREW_CORE_GIT_REMOTE="https://mirrors.tuna.tsinghua.edu.cn/git/homebrew/homebrew-core.git"

# Puis mise à jour
brew update

2. npm — Registry et options CI :

# Miroir (ex. npmmirror pour l’Asie)
npm config set registry https://registry.npmmirror.com

# Timeout et reprise (réduire les échecs réseau)
npm config set fetch-retries 5
npm config set fetch-retry-mintimeout 20000
npm config set fetch-retry-maxtimeout 120000

# En CI : install reproductible
npm ci

3. CocoaPods — CDN par défaut (Pod 1.8+). En CI : cache ~/Library/Caches/CocoaPods et Pods ; pod install --repo-update avec parcimonie.

pod install --repo-update   # rarement en CI ; préférer cache Pods + ~/Library/Caches/CocoaPods

Étapes recommandées :

• Git : utiliser git clone --depth 1 ou git fetch --depth pour limiter la taille ; en cas d’échec, relancer git fetch (reprise native).
• npm : conserver node_modules (ou le cache npm) entre les jobs CI ; utiliser npm ci avec un package-lock.json à jour.
• CocoaPods : mettre en cache ~/Library/Caches/CocoaPods et le répertoire Pods (ou au moins les archives) ; éviter --repo-update à chaque run si les specs sont déjà en cache.
• Homebrew : mettre en cache $(brew --cache) en CI pour réutiliser les bouteilles déjà téléchargées.

Paramètres CI : npm config set prefer-offline true ; en script CI, pod install sans --repo-update si le cache est présent.

Runners dans une autre région que les dépôts : utiliser un proxy HTTP avec cache (cache npm/PyPI interne). Sur le Mac distant, définir HTTP_PROXY / HTTPS_PROXY. Vérifier certificats et timeouts (npm, Git, curl). Homebrew : miroir interne des bouteilles pour éviter les blocages.

• 1

  « brew update » lent ou en échec. Miroir proche (Tsinghua, USTC) ; en CI, cache $(brew --cache) et repo Git Homebrew.

• 2

  « npm install » timeout en CI. Augmenter fetch-retry-maxtimeout, registry miroir (npmmirror), cache npm ou node_modules entre jobs.

• 3

  « pod install » refait tout. Cache ~/Library/Caches/CocoaPods et le dossier Pods. N’utilisez --repo-update que lorsque les specs doivent être rafraîchies.

• 4

  Erreurs SSL ou certificats. Vérifiez npm config get ca, git config --global http.sslVerify et les variables d’environnement proxy. En environnement d’entreprise, un proxy peut remplacer les certificats.

Sur Mac, Homebrew, npm et CocoaPods sont des outils de premier plan avec support natif des miroirs et une excellente intégration terminal (bash/zsh, SSH). La reprise après coup et le cache (Git, npm, CocoaPods, Homebrew) sont bien documentés et homogènes. Pour la CI iOS/macOS, les runners Mac sont indispensables ; la configuration des miroirs et du cache y est simple.

Sous Windows, la pull de dépendances pour du code ciblant iOS/macOS nécessite souvent WSL ou des runners Mac dédiés ; les miroirs (notamment Homebrew, CocoaPods) et les stratégies de cache sont moins standardisés. L’expérience terminal et le comportement des scripts (paths, droits) diffèrent. En résumé : pour du tirage de code et de dépendances à grande échelle (notamment CI), le Mac distant offre de meilleures garanties de vitesse, de stabilité et de reproductibilité que Windows pour ces écosystèmes.