01 · 데이터 동기화
소스 코드와 필요한 입력만 옮기기
rsync 또는 SFTP로 프로젝트를 전송하세요. DerivedData, 임시 빌드 디렉터리와 다시 생성할 수 있는 캐시는 제외하고, 의존성 잠금 파일, 테스트 리소스와 프로젝트 설정은 유지하세요.
확인 항목:커밋 ID와 주요 파일의 체크섬을 비교하고 작업 디렉터리, 권한과 디스크 여유 공간을 확인하세요. 처음 실행할 때는 미리보기 모드로 차이를 확인하세요.
rsync -azn \
--exclude 'DerivedData/' \
--exclude 'build/' \
./project/ \
"$MAC_HOST:~/work/project/"
미리보기 결과를 확인한 후 n을 제거하세요.MAC_HOST 에는 제공된 SSH 연결 별칭을 사용하세요. 이 예제는 원격에 이미 있는 파일을 삭제하지 않습니다.
02 · 툴체인 재구성
버전을 먼저 맞춘 뒤 인증 정보 가져오기
프로젝트 체크리스트에 따라 Homebrew 의존성, Xcode와 Command Line Tools를 준비하세요. 개발자 디렉터리를 확인한 뒤 안전한 채널로 인증서와 프로비저닝 프로파일을 가져오세요.
확인 항목:로컬 Mac과 노드의 Xcode, Swift 및 의존성 버전을 비교하세요. 릴리스 인증 정보 없이 빌드를 한 번 실행해 기본 환경의 차이부터 확인하세요.
xcode-select -p
xcodebuild -version
swift --version
brew bundle check
brew bundle check 먼저 Homebrew를 설치하고 프로젝트의 Brewfile이 있는 디렉터리에서 실행하세요. 의존성을 확인하는 명령이며 서명 자료를 가져오지는 않습니다.
03 · CI 연결
먼저 직접 실행한 뒤 자동으로 작업 전달
노드에서 프로젝트 명령을 직접 실행해 성공 여부를 확인한 다음, 사용 중인 플랫폼의 안내에 따라 Runner를 등록하고 저장소 접근 권한, 작업 레이블, 작업 디렉터리와 인증 정보 권한을 설정하세요.
확인 항목:테스트 커밋을 한 번 제출해 작업이 대상 노드에서 실행되고 로그를 추적할 수 있으며 산출물을 가져올 수 있는지 확인하세요. 대화형 세션을 종료한 뒤 서비스가 실행되는 방식도 검증하세요.
uname -m
xcodebuild -list
launchctl list
프로젝트 디렉터리에서 빌드 대상을 확인하세요. Runner 등록 및 상시 실행 방식은 플랫폼 버전에 따라 설정해야 합니다. 대화형 세션에서 한 번 실행됐다고 서비스가 준비된 것은 아닙니다.
이전 완료 기준
같은 커밋을 반복 실행할 수 있어야 하고, 의존성과 서명 입력을 추적할 수 있어야 하며, 결과를 노드 밖에 저장하고 인증 정보를 철회할 수 있어야 합니다. 이전 시간은 프로젝트 크기, 네트워크와 도구 다운로드에 따라 달라지며 일률적인 소요 시간을 보장하지 않습니다.