GitHub Actions Xcode 27 러너로 옮기기 전 라벨과 arm64 조건을 점검해보세요

Xcode 27 이미지는 어떤 기준으로 고르나요?

출시 공지에 따르면 이번 이미지는 macOS 27에서 실행되며 Xcode 27 도구와 Apple SDK를 포함해요. Xcode 기반 이미지는 주요 Xcode 버전 하나를 기준으로 묶어요.

러너 라벨을 고를 때는 운영체제 이름만 보지 말고 빌드에 필요한 도구 버전과 CPU 아키텍처를 함께 봐야 해요. arm64는 Apple Silicon의 아키텍처 이름이에요. 기존 Intel 환경에 맞춰 받은 실행 파일은 새 환경에서의 호환성을 따로 확인해야 해요.

기존 macos-latest 잡도 자동으로 바뀌나요?

10월 19일 공식 이미지 목록에서 macos-latest는 macOS 26 arm64를 가리켜요. Xcode 27의 라벨은 별도로 적혀 있어요.

출처는 GitHub runner-images 목록이고 확인일은 2026-10-19예요. latest가 가리키는 이미지는 이후 바뀔 수 있어요.

원하는 도구 버전이 Xcode 27이라면 잡의 runs-on 값을 직접 확인하세요. 미리보기 때부터 xcode-27이나 xcode-27-xlarge를 쓰고 있었다면 정식 출시를 이유로 라벨을 고칠 필요는 없다고 공지에 나와요.

이미지의 기본 Xcode와 SDK는 어디서 확인하나요?

설치 소프트웨어 문서의 Xcode 표에서 버전과 경로를 함께 볼 수 있어요. 확인한 이미지 20261012.0260.1은 Xcode 27.0을 기본값으로 표시하고, 경로는 /Applications/Xcode_27.app이에요. Xcode 27.1과 27.2 beta도 표에 있으니 설치 목록 전체를 기본 선택값으로 읽으면 안 돼요.

SDK 표는 Xcode 버전별로 나뉘어요. 예를 들어 iOS 27.0 SDK는 Xcode 27.0에 연결돼 있어요. 특정 SDK가 필요하면 기본 Xcode가 그 SDK를 제공하는지 확인해야 해요.

정식 이미지도 소프트웨어는 매주 갱신돼요. 라벨 하나로 모든 도구의 세부 버전까지 고정했다고 생각하지 말고, 실행 로그의 환경 정보와 해당 이미지 문서를 함께 남겨 두세요.

기존 빌드에서 무엇을 먼저 비교하나요?

아래 순서는 기존 환경과 새 환경의 차이를 찾기 위한 제안이에요. 러너 라벨을 바꾸기 전에 현재 잡의 환경 출력을 남겨 두면 비교하기 쉬워요.

1. .github/workflows에서 옮길 잡의 runs-on, DEVELOPER_DIR, Xcode 선택 단계를 찾아요. 예전 경로를 고정한 설정이 있는지도 봐요.
2. 빌드 전에 uname -m, xcodebuild -version, xcodebuild -showsdks를 출력해요. 아키텍처·선택된 Xcode·SDK를 로그로 비교할 수 있어요.
3. 외부에서 내려받는 실행 파일과 네이티브 의존성이 arm64 환경을 지원하는지 공급자 문서에서 확인해요. 기존 캐시를 재사용한다면 캐시 키가 아키텍처를 구분하는지도 봐요.
4. 같은 커밋을 기존 환경과 새 환경에서 비교하고, 실패한 단계와 환경 출력을 기록해요. 이 절차는 점검 제안이며 프로젝트별 호환 결과를 보장하지 않아요.

xlarge를 고를 때는 어떤 조건을 더 보나요?

xcode-27-xlarge를 검토한다면 larger runner 문서에서 이용 자격과 과금을 먼저 봐야 해요. 이용 대상은 GitHub Team 또는 Enterprise Cloud 플랜을 쓰는 조직·엔터프라이즈예요. 공개 저장소도 실행 시간에 따라 과금되고 기본 제공 실행 시간은 적용되지 않아요.

라벨의 이름만으로 빌드가 빨라지거나 비용이 줄어든다고 판단할 수는 없어요. 실행 전에 조직에서 쓸 수 있는 러너와 현재 요금 조건을 확인하고, 비교할 잡의 실행 시간을 남겨 두세요. 공식 자료 확인일은 2026-10-19예요.