GitHub Actions macos-14 러너 종료 대응

GitHub Actions의 macos-14 러너 이미지는 2026년 11월 2일에 종료됩니다(종료 공지, 2026년 10월 1일), 워크플로에 runs-on: macos-14가 남아 있으면 그 뒤로 잡이 시작되지 않습니다

해당되는 라벨

• macos-14
• macos-14-large
• macos-14-xlarge

저장소에서 아래 명령으로 남은 곳을 찾습니다

grep -rn "macos-14" .github/workflows

종료 전 일시 중단 일정

종료를 알리려고 아래 시간 동안 macOS 14 잡이 일부러 실패합니다(공지 원문, UTC 기준, 한국 시간은 9시간 더합니다)

공지에는 종료가 다가오면 macOS 14 용량을 줄일 수 있어 대기가 길어질 수 있다고도 적혀 있습니다

무엇으로 바꾸나

공지가 안내하는 GitHub 호스티드 라벨은 macos-latest(macos-26), macos-15, macos-latest-xlarge, macos-15-xlarge입니다

jobs:
  build:
    runs-on: macos-15   # 이전: macos-14
    steps:
      - uses: actions/checkout@v4
      - run: xcodebuild -version

라벨을 바꿀 때 Xcode 버전도 같이 확인합니다, 이미지마다 들어 있는 Xcode가 다르고 xcode-select나 DEVELOPER_DIR로 고정한 경로가 새 이미지에 없으면 첫 단계에서 실패합니다, 이미지별 Xcode 목록은 actions/runner-images 저장소에 있습니다

XenoCI로 옮기는 경우

같은 기회에 macOS 잡을 XenoCI로 옮길 수도 있습니다, runs-on 한 줄을 xenoci-macos로 바꾸고 나머지 단계는 그대로 둡니다

jobs:
  build:
    runs-on: xenoci-macos   # 이전: macos-14
    timeout-minutes: 60
    env:
      DEVELOPER_DIR: /Applications/Xcode_26.6.app/Contents/Developer
    steps:
      - uses: actions/checkout@v4
      - run: xcodebuild -version

• XenoCI 러너의 macOS는 GitHub 이미지 일정과 따로 갱신합니다, 들어 있는 Xcode는 러너 개요에 있고 잡마다 DEVELOPER_DIR로 고릅니다
• maxim-lobanov/setup-xcode로 26.3처럼 러너에 없는 마이너 버전을 고정했다면 실패하니 GitHub Actions 호환 표를 확인합니다
• 콘솔 GitHub Actions → 마이그레이션 마법사는 runs-on: macos-* 잡을 찾아 xenoci-macos로 바꾸는 PR을 만들어 줍니다, 병합하기 전에는 아무것도 바뀌지 않습니다

빌드 시간 비교는 GitHub Actions 비교 측정 방법, 요금은 요금제에 있습니다

내 저장소에 바로 적용

관련 문서

• 빠른 시작
• GitHub Actions 호환 표
• iOS CI 빌드가 느릴 때 GitHub Actions에서 줄이는 방법
• 요금제