문제 영역을 먼저 좁힌 후 재현 가능한 정보를 제출하세요

등록 및 온라인 상태

Runner가 올바른 프로젝트 또는 조직에 등록되어 있는지, 태그가 일치하는지, 실행기가 온라인인지 확인하세요. 작업이 계속 대기 중이라면 전체 파이프라인을 바로 다시 실행하지 말고 먼저 태그와 동시 실행 제한을 확인한 다음 Runner 프로세스를 점검하세요.

ps aux | grep -i runner
launchctl list | grep -i runner

서명 환경

빌드 프로세스에서 사용하는 계정, 키체인 검색 경로, 인증서 가시성과 프로비저닝 프로파일 범위가 일치하는지 확인하세요. 로그에는 인증서 이름, 실패 단계와 오류 텍스트만 남기고 제출 전에 비밀번호, 개인 키 내용과 전체 서명 자료를 제거하세요.

security list-keychains
security find-identity -v -p codesigning

캐시 디렉터리

의존성 캐시, 파생 데이터와 최종 산출물을 서로 다른 디렉터리에 두세요. 캐시 적중에 이상이 있으면 먼저 캐시 키와 디렉터리 사용량을 기록한 후 단일 프로젝트만 정리해 비교 기준을 보존하세요.

du -sh "$CACHE_PATH"
df -h
find "$CACHE_PATH" -maxdepth 1 -type d

빌드 대기열

대기 시작, 실제 실행과 종료 시간을 기록해 ‘작업을 할당받지 못함’과 ‘작업은 시작했지만 출력이 오래 없음’을 구분하세요. 전자는 태그, 동시 실행 수와 Runner 상태를, 후자는 스크립트 대기, 네트워크 의존성과 하위 프로세스를 중점적으로 확인합니다.

로그 수집

실패 단계 전후의 로그를 각각 최소 50줄씩 보관하고 명령어 종료 코드, 도구 버전과 프로젝트에서 공개 가능한 최소 재현 매개변수를 함께 첨부하세요. 오류 팝업 스크린샷 한 장만 제출하거나 토큰, 저장소 자격 증명과 업무 데이터가 포함된 전체 로그를 업로드하지 마세요.

xcodebuild -version
sw_vers
uname -m

실패 재시도

첫 실패 후 원본 로그를 먼저 저장한 다음 동일한 커밋과 매개변수로 한 번만 재시도하세요. 재시도에 성공하면 네트워크 요청, 캐시 적중과 실행 시간을 비교하고, 계속 실패하면 단일 명령으로 범위를 좁혀 입력값, 종료 코드와 소요 시간을 기록하세요.