Swift 6의 strict concurrency는 로컬 Xcode에서는 통과하지만 CI에서만 흔들리면 팀 신뢰를 깎아 냅니다. 원인은 종종 비즈니스 로직이 아니라 빌드 설정 불일치, DerivedData 경합, 시뮬레이터 지정 차이, 경고를 게이트로 두지 않는 운용입니다. 본문은 플랫폼 담당자를 위해 일곱 가지 통증으로 전형 실패를 먼저 나열하고, 비교표로 실행 환경 선택지를 정리한 뒤, 여섯 단계 Runbook과 인수인계 관점을 한데 묶습니다. 함께 읽을 글: SwiftPM·CocoaPods와 DerivedData, 재현 가능한 빌드 지문, 셀프호스티드 러너와 캐시 분리입니다.
동시성 진단은 타이밍에 민감해 환경이 조금만 달라도 실패가 흩어집니다. 다음 일곱 항목은 전용 노드나 프로필 고정을 검토하는 트리거입니다.
로컬과 CI의 Swift·Xcode 조합이 다릅니다:swift --version과 xcodebuild -version을 로그에 남기지 않으면 Sendable 진단 유무부터 어긋납니다.
strict 수준 검사를 릴리스 직전에만 켭니다:일상 빌드는 관대하고 본방만 엄격하면 차분이 한꺼번에 터져 롤백 판단이 늦어집니다.
병렬 xcodebuild가 같은 DerivedData를 공유합니다:경합으로 증분 컴파일이 깨지고 동시성 오류와 무관한 클린 요구가 늘어납니다.
경고를 허용한 채 CI를 녹색으로 둡니다:SWIFT_STRICT_CONCURRENCY를 올린 뒤에야 치명적으로 드러나는 패턴이 남습니다.
액터 경계를 고려하지 않고 UI 테스트와 단위 테스트를 한 작업에 섞습니다:시뮬레이터 부하와 빌드 플래그가 간섭해 플레이크 원인을 오인합니다.
xcode-select나 TOOLCHAINS 전제가 Runbook에 없습니다:누군가 GUI에서 Xcode만 바꿔도 야간 작업 컴파일러가 달라집니다.
Linux에서만 swift build하고 iOS 타깃 엄격 진단을 미룹니다:서버 타깃과 UIKit 타깃의 진단 집합이 달라 문제를 뒤로 미룹니다.
공통 원인은 CI 입구에서 컴파일러 사실을 고정하지 않는 것입니다. 전용 원격 Mac은 SSH로 그 사실을 인프라처럼 고정하기 쉽습니다.
목표는 매번 같은 진단 집합을 얻는 것입니다. 병렬 작업 수와 캐시 정책이 바뀔수록 엄격 모드 결과가 흔들립니다.
| 관점 | Xcode Cloud | 호스팅형 macOS Runner | 전용 원격 Mac(SSH) |
|---|---|---|---|
| 도구체인 고정 | 관리형 업데이트에 쉽게 맞춥니다 | 이미지 태그 의존, 이웃 테넌트로 변동 가능 | xcode-select와 디스크 레이아웃을 계약화하기 쉽습니다 |
| 동시성 진단 재현성 | 워크플로 설계에 따라 높습니다 | 공유 캐시와 CPU 경합으로 흔들리기 쉽습니다 | DerivedData를 작업 단위로 분리하기 쉽습니다 |
| xcodebuild 자유도 | 커스텀에 제한이 있을 수 있습니다 | 러너 관리자 정책에 따릅니다 | -destination, -derivedDataPath 고정이 쉽습니다 |
| 전형적 실패 | 큐·쿼터, 비동기 단계 경계 | 클린 환경에서만 재현되는 누락 | 절전·디스크 고갈 같은 운용 누락 |
| 적합 팀 | App Store 인접 표준화 | 짧은 스모크 대량 실행 | monorepo와 엄격 게이트 장시간 운용 |
「엄격 동시성은 코드 이야기처럼 보이지만, CI에서는 컴파일러와 캐시의 물리 배치 이야기이기도 합니다.」
비용·대역 가정을 맞추려면 임대 SLA와 과금도 함께 읽고 노드에 무엇을 기대하는지 재무와 공유합니다.
각 단계는 로그에 증적을 남기는 것이 목적입니다. 브랜치 보호 규칙과 함께 입구에서 실패시킵니다.
채택 Xcode를 문서화하고 xcode-select -p를 기록합니다:여러 버전이 공존하면 CI 사용자별 전환 절차를 고정합니다.
입구에서 xcodebuild -version, xcodebuild -showsdks, swift --version을 항상 출력합니다:기대값과 다르면 즉시 중단합니다.
빌드 설정에서 SWIFT_STRICT_CONCURRENCY를 저장소 전반에 맞춥니다:모듈 단계 상향이면 매트릭스를 티켓에 남깁니다.
xcodebuild에 고정 -scheme, -destination, 작업별 -derivedDataPath를 전달합니다:필요하면 -clonedSourcePackagesDirPath도 분리합니다.
테스트 층을 나눕니다:단위는 가벼운 destination, UI·성능은 별 슬롯. 병렬 상한을 노드 계약에 적습니다.
인수인계 체크리스트에 서명합니다:로그 조각, 채택 컴파일러 버전, 엄격 수준, 클린 재현 절차를 첨부하고 릴리스 오너가 확인합니다.
#!/usr/bin/env bash set -euo pipefail xcodebuild -version xcodebuild -showsdks swift --version export DERIVED_DATA="$(pwd)/.derivedData/$CI_JOB_ID" xcodebuild -scheme "App" \ -destination 'platform=iOS Simulator,name=iPhone 16' \ -derivedDataPath "$DERIVED_DATA" \ build
팁:서드파티에 관대 모드가 남으면 자체 코드부터 complete로 옮기는 로드맵을 README에 적고 게이트를 단계화합니다.
야간 배치와 주간 대화형 세션을 같은 사용자로 섞지 않으면 도구체인 전환 실수가 줄어듭니다.
모듈별 병렬성 검사는 프로젝트 설정과 컴파일러 플래그 조합으로 결정됩니다. 타깃마다 기대치가 다르면 매트릭스를 표로 공개해 리뷰 때 차이를 드러냅니다.
주의:용어와 기본값 세부는 사용 중인 Xcode·Swift 릴리스 노트를 따르며, 이 글은 운영 틀만 다룹니다.
MainActor 경계와 데이터 레이스 경고는 시뮬레이터 부하·빌드 병렬성에도 잘 드러나므로 성능 테스트와 기능 테스트 로그를 분리합니다.
다음을 충족하면 첫 롤아웃을 완료로 봅니다.
xcodebuild -version과 swift --version을 아티팩트 저장소에 보관했습니다.SWIFT_STRICT_CONCURRENCY가 표로 문서화되었고 미설정 타깃이 없습니다.-derivedDataPath가 작업 ID 등 고유 키에 묶였습니다.공유 러너만으로는 도구체인과 디스크 경합을 동시에 누르기 어렵고, Swift 6 엄격 게이트는 플레이크처럼 보이기 쉽습니다. NodeMini 전용 Mac Mini 클라우드 대여는 SSH로 프로필을 고정하고 빌드를 장기 서비스로 운용하려는 전제에 맞습니다. 사양과 요금은 Mac Mini 대여 요금 안내에서 확인하고, 접속과 인수인계는 헬프 센터에서 진행합니다.
운용이 안정되면 엄격 모드 위반 추이를 주간으로 집계해 서드파티 추종 계획과 연결합니다.
진단이 컴파일러 버전과 캐시 배치에 크게 의존하므로, 점유 노드에서 레이아웃을 고정하는 편이 재현성이 좋습니다. 요금 비교는 Mac Mini 대여 요금 안내를 참고합니다.
scheme, destination, derivedDataPath를 고정하고 빌드 설정에서 strict concurrency 수준을 맞춥니다. 세부 절차는 헬프 센터를 봅니다.
Xcode 빌드 번호, xcode-select, 필요 시 TOOLCHAINS, 작업 선두에서 실행하는 명령 열을 Runbook에 적습니다. 플랜 확인은 Mac Mini 대여 요금 안내에서 합니다.