가이드
Cirrus Runners에서 전용 Mac mini로 이전하기
Cirrus Runners는 신규 고객을 받지 않으며 기존 계약도 끝나 가고 있습니다. macOS GitHub Actions 작업을 전용 Mac mini로 옮기세요. 네이티브로, 또는 같은 Tart 이미지로.
60분, 2026-09-15 업데이트
2026년 4월 Cirrus Labs는 OpenAI 합류를 발표했습니다. Cirrus CI는 2026년 6월 1일에 작업 실행을 중단했습니다. Cirrus Runners는 신규 고객을 받지 않으며, 기존 고객은 현재 계약이 끝날 때까지만 지원받습니다.
macOS GitHub Actions 작업이 Cirrus Runners에서 실행되고 있다면 그 날짜 전에 옮길 곳이 필요합니다. 이 가이드는 전용 Mac mini로 옮기는 두 가지 방법과 그중 하나를 고르는 방법을 보여 줍니다.
두 가지 이전 방법
경로 A, 네이티브 Runner. GitHub Actions Runner가 macOS에서 직접 실행됩니다. 가장 간단한 구성이며, 빌드가 가장 빠르고 캐시가 작업 사이에 따뜻하게 유지됩니다.
경로 B, Tart 가상 머신. 지금 쓰는 것과 같은 Cirrus macOS 이미지를 자신의 Mac에서 Tart 안에서 실행합니다. Cirrus에서와 똑같이 모든 작업이 깨끗한 머신에서 시작합니다.
Path A, native runner
Fastest, and you install Xcode yourself.
Path B, Tart virtual machines
Nothing changes in the workflow except the label.
| 네이티브 Runner | Tart VM | |
|---|---|---|
| 설정 시간 | 약 30분 | 약 1시간 |
| Cirrus와 같은 환경 | 아니요, Xcode를 직접 설치 | 예, 같은 이미지 |
| 작업마다 깨끗한 머신 | No | 예 |
| 작업 간 캐시 유지 | 예 | 아니요, 이미지에 포함하지 않는 한 |
| Mac당 동시 작업 수 | Runner당 1개 | 최대 2개 (Apple 라이선스 제한) |
팀이 저장소를 소유하고 속도를 원한다면 A를 고르세요. 모든 빌드가 알려진 깨끗한 상태에서 시작해야 하거나, 워크플로에서 라벨 외에는 아무것도 바꾸고 싶지 않다면 B를 고르세요.
시작하기 전에
현재 워크플로가 쓰는 것을 정리하세요. Cirrus 이미지를 가리키는 runs-on 줄을 찾으세요. 예:
runs-on: ghcr.io/cirruslabs/macos-runner:sonomamacOS 버전, Xcode 버전, 작업 시작 시 설치하는 모든 것을 기록하세요. 어느 경로든 이 목록이 필요합니다.
경로 A: 네이티브 Runner
이 페이지 하단에 링크된 가이드 “Mac mini에서 GitHub Actions 셀프 호스팅 Runner 운영”을 따르세요. Xcode, Runner 등록, 서비스로 실행하는 방법을 다룹니다.
Runner에 macduty-m4처럼 그 Runner를 설명하는 라벨을 붙이세요. 그다음 각 워크플로에서 한 줄을 바꾸세요:
# before
runs-on: ghcr.io/cirruslabs/macos-runner:sonoma
# after
runs-on: [self-hosted, macOS, ARM64, macduty-m4]Cirrus가 아직 작동하는 동안 새 Runner에서 워크플로 하나를 실행하세요. 통과하면 나머지를 옮기세요.
경로 B: 같은 이미지를 Tart에서
1. Mac에 Tart 설치
brew install cirruslabs/cli/tart2. Cirrus 이미지 가져오기
지금 실행하는 것과 가장 가까운 이미지를 고르세요. Cirrus는 Xcode가 포함된 이미지와 포함되지 않은 이미지를 배포합니다:
tart clone ghcr.io/cirruslabs/macos-sequoia-xcode:latest ci-base첫 pull은 용량이 커서 50 GB를 넘는 경우가 많으니 시간을 넉넉히 잡으세요.
3. VM 시작 후 로그인
tart run --no-graphics ci-base &
ssh admin@$(tart ip ci-base)Cirrus 이미지에는 기본 관리자 계정이 있습니다. 다른 작업을 하기 전에 그 암호부터 바꾸세요.
4. VM 안에서 Runner 등록
VM 안에서 경로 A와 같은 방법으로 GitHub Actions Runner를 등록하되, 한 가지가 다릅니다: --ephemeral을 추가해 Runner가 작업 하나만 받고 멈추게 하세요.
./config.sh --url https://github.com/<owner>/<repo> --token <token> --ephemeral --labels tart-sequoia
./run.sh5. 작업마다 새 VM
Mac 자체에서는 작은 루프가 이미지의 깨끗한 복사본을 복제하고, 그 안에서 작업 하나를 실행한 뒤 삭제합니다:
while true; do
tart clone ci-base job
tart run --no-graphics job &
# wait for the job to finish, then:
tart stop job
tart delete job
done실제로는 VM마다 새 등록 토큰도 받아 오는 스크립트가 필요합니다. 같은 팀이 만든 Orchard 같은 도구가 더 큰 구성에서 이를 처리합니다.
Apple 라이선스는 Mac 한 대에서 동시에 실행되는 macOS 가상 머신을 최대 2개까지 허용합니다. 더 많은 작업을 병렬로 돌리려면 Mac을 추가하세요.
이전 후
- 빌드 시간을 확인하세요. 전용 M4 이상에서 대부분의 팀은 Cirrus만큼 빠른 빌드를 경험하며, 캐시가 따뜻하면 더 빠릅니다.
- 기존 워크플로는 일주일간 보관하세요. 새 Runner가 릴리스를 한 번 완전히 거칠 때까지 Cirrus runs-on 줄의 사본을 브랜치에 남겨 두세요.
- 비공개 저장소만. 셀프 호스팅 Runner는 공개 포크의 작업을 받지 않아야 합니다.
전용 Mac mini를 쓰는 이유
- 매월 정액. 분 단위 과금이 없고, 계약이 끝날 때 다시 협상할 것도 없습니다.
- 모든 세대. M1부터 M6까지 나란히 쓸 수 있어, 사용자가 가진 칩에서 테스트할 수 있습니다.
- 오직 고객만의 Mac. 대기열도, 이웃도 없고, 하드웨어에서 다른 사람의 작업이 돌지 않습니다.
- EU에서 GDPR에 따라 호스팅됩니다.
MacDuty는 M1부터 M6까지의 Mac mini를 랙에 두고 있으며, macOS가 설치되어 몇 분 안에 준비됩니다. SSH 키는 고객 영역에서 추가하세요.
오늘 재고 있음
지금 랙에 있는 Mac입니다. 하나를 골라 구성을 확인하고, 계정은 주문할 때 만드세요.
랙 확인 중
나만의 Mac mini
구성을 고르세요. 재고가 없으면 이메일을 남겨 주세요. 랙에 설치되는 날 연락드립니다.
연 단위: 월 단위 결제보다 최소 19% 저렴
다음