2026년 국경 간 TestFlight 자동 업로드: 원격 물리 Mac 업로더는 빌드 Runner와 같은 리전에 둘까, App Store Connect 전송 경로에 가깝게 둘까?

2. 배치 매트릭스: Runner 동일 배치 업로더 vs 「ASC 친화」 두 번째 리전

「App Store Connect에 가깝다」는 말은 국가 핀 마법이 아니라 TLS가 안정적이고 패킷 손실이 낮으며 DNS가 예측 가능한 이그레스를 뜻합니다. 이 표로 주 물리 Mac 풀을 고르세요.

2026 기본값: IPA를 만든 머신 옆에 fastlane pilot을 도는 무인 Mac을 두세요. 측정으로 Apple 향 다리만 튀는 게 증명될 때까지요.

3. 증상 매트릭스: 타임아웃형 실패 vs HTTP 429

4. 7단계 롤아웃 런북

1. 세 체크포인트에 타임스탬프—빌드 완료, 업로더 디스크의 아티팩트, 업로드 중 Apple의 첫 성공 HTTP 응답.
2. 일주일 빌드를 플롯·아티팩트 구간이 벽시간의 35–45%를 넘으면 「미국 전용 업로더」 평가를 중단합니다.
3. 네트워크 기준선을 curl -o /dev/null -w '%{time_connect} %{time_starttransfer}\n'로 후보 Mac에서 App Store Connect API 엔드포인트에 대해 잡습니다.
4. 환경 튜닝(5절)을 브랜치 빌드에만 적용하고 비교용 컨트롤 잡은 그대로 둡니다.
5. 아티팩트 구간이 짧은데도 타임아웃이면 다른 ISP 또는 클라우드 온램프의 두 번째 물리 Mac을 두고 동일 IPA를 재생합니다.
6. 429가 보이면 동시 pilot 레인을 절반으로 줄이고 재시도 사이에 30–120 s 난수 지터를 넣습니다.
7. 핀을 문서화—macOS 패치, Xcode 빌드 번호, fastlane Gemfile.lock, 프록시 PAC URL을 내부 위키에 적습니다.

5. 복붙 환경변수·플래그

사용 중인 fastlane 버전 릴리스 노트를 확인한 뒤 CI 시크릿 저장소나 launchd plist에 붙여 넣으세요. 값은 예시이며 IPA 크기에 맞게 조정합니다.

# Spaceship / App Store Connect 클라이언트
export SPACESHIP_TIMEOUT=1200
export FASTLANE_XCODEBUILD_SETTINGS_TIMEOUT=120

# 자세한 CI 로그(공개 아티팩트에는 마스킹)
export FASTLANE_DEBUG=1

# pilot 레인 예시—Fastfile에 맞게 수정
# pilot(
#   skip_waiting_for_build_processing: true,
#   distribute_external: false,
#   api_key_path: "asc_api_key.json"
# )

API 키는 최소 권한 역할과 함께 쓰고, 429가 조직 전체 자동화 급증과 엮이면 제품 라인별 키를 분리하세요. TestFlight 앞단의 공증 업로드도 같은 리전 이그레스 규율을 쓰면 신뢰성 프로그램으로 묶을 수 있습니다.

6. 레이더를 넣거나 하드웨어를 사기 전 트리아지 체크리스트

• 업로더가 빌더가 기록한 IPA와 동일한 SHA256을 보는지 확인합니다.
• 캐너리 Mac에서 HTTP 프록시를 잠시 끕니다. 성공하면 리전 이전 대신 PAC/WPAD를 고칩니다.
• 무인 Mac의 시각 동기(sntp)를 확인합니다. 시계 어긋남은 토큰 갱신 패턴을 깨뜨립니다.
• 디스크를 봅니다. APFS 스냅샷이나 거의 찬 볼륨은 Transporter 임시 디렉터리를 느리게 합니다.
• 429 스파이크를 마케팅 재업로드나 동일 API 신원을 쓰는 서드파티 ASO 도구와 상관시킵니다.
• 분기마다 업그레이드 후 fastlane env 출력을 한 번 캡처합니다.

7. 아키텍처 리뷰에 인용할 수치

• 아티팩트 비중 40%—Runner 동일 배치를 상행 튜닝보다 우선할 실무 임계값.
• Spaceship 1200 s—3 GB+ IPA, 50–100 Mbps 지속 링크의 출발점.
• 30–120 s 지터—장애 후 여러 파이프라인이 동시에 재시작할 때 429 버스트를 줄이는 경험적 값.

8. FAQ

「캘리포니아에서 업로드」가 여전히 기본 답인가요?

아티팩트 타이밍을 정직하게 잰 뒤 Apple 향 다리가 병목일 때만 그렇습니다. 아시아·유럽 팀도 프록시와 MTU만 정상이면 로컬 Mac 풀로 충분히 성공합니다.

Transporter.app은 pilot과 다르게 동작하나요?

전송 제약은 겹칩니다. GUI Transporter는 되는데 pilot만 실패하면 Ruby OpenSSL·프록시 환경변수·fastlane 플러그인을 먼저 비교하고 Apple 탓으로 넘기지 마세요.

모든 CI 잡에 하나의 Apple ID를 써도 되나요?

피하세요—429 위험이 공유 신원에 비례합니다. 서비스별로 범위를 좁힌 App Store Connect API 키와 중앙 순환을 선호하세요.