GitHub Actions 작업을 원격 맥으로 보내려면 무엇을 설정해야 하나요?

원격 맥에 저장소 또는 조직의 자체 호스팅 실행기를 등록한 다음, 실행기에 기본 라벨과 작업 전용 라벨을 부여합니다. 작업 흐름의 runs-on 항목에서 필요한 라벨을 모두 지정하면 조건에 맞는 실행기가 작업을 받을 수 있습니다. 실행기 등록만으로 빌드가 성공하는 것은 아니므로 Xcode 선택, 의존성 설치, 실제 빌드 명령과 결과물 확인도 별도로 검증해야 합니다.

맥 자체 호스팅 실행기는 어디에서 등록하고 등록 정보는 어떻게 다뤄야 하나요?

저장소 또는 조직의 Actions 설정에서 실행기 추가 안내를 열고, 운영체제에 맞는 설치와 등록 절차를 따릅니다. 등록 토큰은 실행기를 연결할 때 쓰는 단기 정보이므로 소스 코드, 로그, 공개 작업 흐름에 넣지 않습니다. 설정이 끝난 뒤에는 실행기 화면에서 온라인 상태인지 확인하고, 작업이 실제로 해당 맥에 배정되는지 시험합니다.

Xcode 27.2 RC 원격 빌드에 필요한 macOS 버전은 어떻게 확인하나요?

요구되는 macOS 버전은 추측하지 말고 Apple의 Xcode 시스템 요구 사항과 해당 RC의 배포 정보를 함께 확인해야 합니다. 두 자료에 표시된 Xcode 버전과 운영체제 조건이 원격 맥에 설치된 환경과 맞는지 대조합니다. RC가 정식 버전으로 바뀌거나 Apple이 요구 사항을 갱신하면 기존 검수 기록도 다시 확인해야 합니다.

원격 맥에서 빌드가 성공했는지는 어떤 기준으로 판별하나요?

작업이 대기열에서 끝났다는 표시만으로 성공을 판단하지 않습니다. 실행기가 작업을 받았는지, Xcode가 선택한 버전으로 실행됐는지, 빌드 또는 테스트 명령이 정상 종료됐는지, 기대한 결과물이 만들어졌는지를 각각 확인합니다. 정식 서명이나 앱 업로드까지 시험하지 않았다면 그 단계는 성공으로 기록하지 말고, 별도 검증 항목으로 남겨야 합니다.

Xcode 27.2 RC를 GitHub Actions에 연결하는 방법? 2026 원격 맥 튜토리얼

Xcode 27.2 RC를 검증하려면 호환되는 macOS를 실행하는 원격 맥을 GitHub Actions 자체 호스팅 실행기로 등록하고, 작업 흐름에서 라벨로 선택하면 됩니다. 단, Apple의 시스템 요구 사항을 먼저 확인하고 RC 검증 환경과 정식 배포용 서명 자격 증명은 분리해야 합니다.

로컬 맥 없이 아이오에스 앱의 빌드 작업을 자동화하려는 독립 개발자에게 적합합니다.
이미 원격 맥이 있고 수동 빌드를 작업 흐름으로 옮기려는 소규모 팀에도 유용합니다.
Xcode 27.2 RC를 시험하면서 정식 배포 권한을 보호하려는 유지 관리자도 읽어볼 수 있습니다.

마지막 확인: 2026년 10월 26일. Xcode 버전과 운영체제 요구 사항은 Apple의 Xcode 시스템 요구 사항 및 Xcode 배포 기록에서, 실행기 절차는 아래 GitHub 공식 문서에서 다시 확인해야 합니다. RC 상태나 설정 화면이 바뀌면 이 절차도 재검토하세요.

준비 단계: RC 호환성과 검증 범위 비교

먼저 원격 맥에 설치된 macOS가 Xcode 27.2 RC의 요구 사항을 만족하는지 확인합니다. Apple의 시스템 요구 사항 페이지에서 해당 버전 항목을 찾고, 배포 기록의 RC 정보와 대조하세요. 여기서 특정 macOS 버전을 미리 단정하지 않는 이유는 요구 사항이 바뀔 수 있기 때문입니다.

Apple의 Xcode 27.2 RC 배포 기록은 RC 빌드 정보를 확인하는 기준입니다. 설치된 버전은 원격 맥 터미널에서 확인할 수 있습니다.

xcodebuild -version
xcode-select -p
sw_vers

첫 명령은 Xcode 빌드 정보를, 두 번째 명령은 현재 선택된 개발자 도구 경로를, 세 번째 명령은 macOS 정보를 표시합니다. 결과를 기록하고 Apple의 요구 사항과 비교하세요. 명령이 정상 실행돼도 프로젝트 빌드까지 호환된다는 뜻은 아니므로 실제 작업 흐름 검증이 필요합니다.

확인 대상	RC 검증 작업	정식 배포 작업
Xcode와 macOS	Apple의 버전별 요구 사항과 설치 상태 대조	정식 빌드에 쓰는 도구 버전 별도 기록
서명 자격 증명	정식 배포용 비밀 정보 없이 빌드 가능 여부 확인	승인된 작업에만 배포 자격 증명 제공
검증 결과	컴파일, 테스트, 결과물 생성 기록	서명과 업로드를 별도 승인 단계로 관리

이번 검증에서 확인할 범위도 미리 정합니다. 예를 들어 코드 검출과 컴파일만 볼지, 테스트까지 실행할지 결정하세요. RC 확인용 작업이 정식 서명이나 앱 업로드까지 수행하도록 만들 필요는 없습니다.

등록 단계: 자체 호스팅 실행기와 라벨 선택

저장소 또는 조직 설정에서 자체 호스팅 실행기 추가 안내를 열고, macOS에 맞는 설치 및 등록 방법을 확인합니다. GitHub의 자체 호스팅 실행기 등록 안내에 따라 실행기 프로그램을 내려받고 설정합니다.

등록 토큰은 실행기를 GitHub에 연결할 때 사용합니다. 공개 저장소에 올리거나 작업 로그에 출력하지 마세요. 호스트 주소, 계정 정보, 토큰을 예시 파일에 그대로 적는 것도 피해야 합니다. 등록 과정은 저장소 수준과 조직 수준 중 필요한 범위에서 진행하고, 실제 등록 위치에 맞는 작업 흐름을 사용하세요.

등록 후에는 기본 라벨과 직접 지정한 라벨의 역할을 구분합니다. 기본 라벨은 운영체제나 하드웨어 종류에 따른 실행기 선택에 쓰이고, 사용자 지정 라벨은 RC 검증 맥처럼 목적이 분명한 대상을 구별하는 데 유용합니다. GitHub의 실행기 라벨 설정 문서에서 지원되는 설정 방식을 확인하세요.

실행기 선택 방식	장점	주의할 점
기본 라벨만 사용	운영체제와 실행기 종류에 맞춰 단순하게 지정	같은 조건의 실행기가 여럿이면 RC 검증용 맥을 구분하기 어려울 수 있음
기본 라벨과 사용자 지정 라벨 사용	특정 Xcode 검증 환경으로 작업을 명확히 라우팅	라벨을 실행기와 작업 흐름 양쪽에 정확히 설정해야 함
사용자 지정 라벨만 지정	용도를 간단히 표시	운영체제 등 필수 실행 조건을 빠뜨리지 않도록 확인해야 함

라벨 이름은 저장소에서 관리할 수 있는 구체적인 값으로 정합니다. 예시에서는 xcode-27-2-rc를 사용하지만, 해당 라벨이 자동으로 생성되는 것은 아닙니다. 원격 맥 실행기에 직접 설정하고 작업 흐름에도 동일하게 기재해야 합니다.

주의: 원격 데스크톱으로 맥에 접속할 수 있는 상태와 GitHub 실행기가 온라인인 상태는 서로 다릅니다. 둘 다 정상이어야 한다고 가정하지 말고, 실행기 상태 화면과 실제 작업 배정을 각각 확인하세요.

연결 단계: GitHub Actions에서 원격 맥 호출

작업 흐름은 실행기 라벨로 대상 맥을 선택한 뒤 저장소 코드를 받고 Xcode 명령을 실행합니다. GitHub의 작업 실행 위치 선택 안내와 자체 호스팅 실행기 사용 안내를 기준으로 라벨 구성을 맞추세요.

name: ios-rc-check

on:
  workflow_dispatch:

jobs:
  build:
    runs-on: [self-hosted, macOS, ARM64, xcode-27-2-rc]
    steps:
      - name: Check out source
        uses: actions/checkout@v4

      - name: Check selected Xcode
        run: |
          xcodebuild -version
          xcode-select -p

      - name: Build app
        run: |
          xcodebuild \
            -project "APP_PROJECT.xcodeproj" \
            -scheme "APP_SCHEME" \
            -sdk iphonesimulator \
            -configuration Debug \
            build

APP_PROJECT.xcodeproj와 APP_SCHEME은 프로젝트에 맞게 바꿔야 합니다. 프로젝트가 작업 공간을 쓰는 경우에는 실제 파일 형식에 맞춰 빌드 명령을 조정하세요. actions/checkout 버전도 저장소의 정책에 따라 검토합니다. 이 예시는 시뮬레이터 대상 빌드를 위한 틀이며, 서명된 보관 파일 생성이나 앱 업로드를 뜻하지 않습니다.

작업 상태	확인할 증거	성공으로 오해하기 쉬운 상황
작업 흐름 시작	실행 기록에 새 작업이 나타남	작업이 시작됐다고 실행기가 받았다고 볼 수 없음
실행기 배정	작업 로그에 대상 자체 호스팅 실행기가 표시됨	원격 맥에 접속 가능하다는 사실만으로 배정 완료가 아님
Xcode 명령 실행	로그에 도구 버전과 빌드 명령 결과가 남음	명령이 시작된 것만으로 종료 성공이 보장되지 않음
결과물 확인	빌드 결과와 지정한 산출물 위치 확인	컴파일 성공이 서명이나 업로드 성공을 의미하지 않음

실행기 라벨을 작업 흐름에서 찾지 못하면 작업은 대기 상태에 머물 수 있습니다. 그때는 실행기 온라인 여부, 저장소 또는 조직 등록 범위, 라벨 철자와 조합을 확인하세요. GitHub의 실행기 모니터링 및 문제 해결 문서는 상태와 로그를 함께 살펴보는 기준을 제공합니다.

상시 운영 단계: 서비스 시작과 권한 경계 비교

터미널에서 수동으로 실행기를 시작하는 방식은 초기 점검에 편리하지만, 터미널 세션이 끝나거나 맥이 재시작된 뒤에도 작업을 받는다고 보장하지 않습니다. 장기간 사용할 계획이라면 GitHub의 실행기 서비스 설정 안내에 따라 서비스 구성과 시작 상태를 확인합니다.

실행기 디렉터리에서 제공되는 서비스 스크립트를 사용하는 환경이라면 다음과 같이 상태를 점검할 수 있습니다.

./svc.sh status

실제 설치 방식에 따라 서비스 등록과 시작 명령은 달라질 수 있으므로 공식 안내에 맞춰 진행하세요. 맥을 재시작한 뒤에도 실행기가 다시 온라인이 되는지 확인하고, 실행기 상태 페이지에서 새 작업을 받을 수 있는지 검수합니다.

코드 출처와 권한	권장 경계
신뢰할 수 있는 내부 변경	RC 빌드 작업에서 제한된 권한으로 검증
검토되지 않은 외부 기여 코드	서명 정보가 있는 실행기와 분리
정식 배포 승인 작업	별도 작업 흐름에서 필요한 자격 증명만 사용

자체 호스팅 실행기는 맥과 파일 시스템에 접근할 수 있는 환경입니다. 따라서 저장소 코드가 신뢰할 수 있는지, 작업에서 비밀 정보가 노출될 수 있는지 먼저 따져야 합니다. GitHub는 Actions의 안전한 사용 안내에서 자체 호스팅 실행기와 신뢰되지 않은 코드의 위험을 다룹니다. 외부 기여 요청을 처리하는 작업에 정식 서명 자료를 노출하지 말고, RC 검증과 배포 권한을 분리하세요.

검수 단계: 빌드 완료와 배포 완료 구분

처음부터 정식 자격 증명을 넣지 말고 대표 프로젝트를 이용해 코드 검출, Xcode 선택, 빌드 또는 테스트, 로그와 결과물 위치를 차례로 확인합니다. 이 과정에서 실행기 로그에 민감한 값이 출력되지 않는지도 검토하세요. 실패했을 때는 Actions 실행 기록, 실행기 온라인 상태, 맥의 Xcode 경로를 순서대로 확인하면 원인을 좁히기 쉽습니다.

작업 성공은 검증한 범위까지만 기록해야 합니다. 시뮬레이터 빌드만 마쳤다면 테스트나 서명은 검증되지 않은 상태입니다. 앱 업로드까지 완료하지 않았다면 배포 성공으로 표시하지 마세요. 정식 서명 시험이 필요해지면 RC 확인 작업과 분리된 승인 흐름을 마련하고 자격 증명 접근을 제한해야 합니다.

원격 맥을 아직 준비하지 않았다면 먼저 필요한 Xcode와 작업 범위를 정리한 뒤 SFTPMAC의 맥 미니 이용 환경을 살펴볼 수 있습니다. 서울에서 접속할 환경을 비교하려는 경우에는 서울 맥 미니 이용 안내를, 비용 검토가 필요하다면 맥 미니 대여 가격 정보도 확인하세요. 다른 빌드 환경의 약점은 초기 설치와 유지 관리, 작업 간 권한 분리, 맥 하드웨어 확보 비용에 있습니다. 다만 장기간 고정 부하를 처리하거나 물리 장치 연결이 필요한 경우에는 직접 맥을 운영하는 편이 맞을 수 있습니다. 임시 RC 검증이나 지속적인 아이오에스 빌드 환경이 필요하다면, 요구 사항과 작업 범위를 먼저 확인한 뒤 SFTPMAC의 원격 맥 대여를 비교하는 것이 합리적입니다.