GitLab Runner macOS 격리: 2026 기업 배포 가이드
GitLab Runner macOS 격리의 결론은 명확합니다. 같은 신뢰 영역의 낮은 민감도 빌드는 공유하고, 정식 서명과 배포 작업은 보호된 전용 Mac Runner로 분리해야 합니다. 프로젝트 범위, 태그 라우팅, 자격 증명 분리, 작업 후 정리를 함께 적용할 수 있을 때만 여러 팀의 Mac을 하나의 빌드 풀로 운영하는 편이 안전합니다.
이 글은 여러 iOS 프로젝트를 관리하며 공유 GitLab macOS 빌드 풀을 준비하는 플랫폼팀을 위한 내용입니다. 인증서와 키체인, 배포 자격 증명을 보호해야 하는 보안 담당자와 Mac Runner 구매·임대·혼합 구성을 검토하는 기업 IT 및 조달 담당자도 대상입니다.
먼저 신뢰 영역을 나누고 공유 범위를 결정합니다
macOS Shell executor는 작업을 별도 가상 환경에서 자동으로 분리하지 않습니다. 작업은 Runner 호스트의 운영 체제 권한과 파일 시스템에 직접 영향을 줄 수 있습니다. GitLab도 Shell executor가 Runner 호스트와 네트워크에 높은 보안 위험을 줄 수 있다고 명시합니다. 자세한 경계는 Shell executor의 공식 보안 설명에서 확인할 수 있습니다.
따라서 부서 이름만 보고 공유 여부를 정하면 안 됩니다. 다음 네 가지 기준으로 프로젝트와 작업을 분류해야 합니다.
- 소스 코드가 외부에 노출될 경우의 피해 수준
- 코드를 제출하거나 파이프라인을 실행할 수 있는 주체
- 외부 기여나 검토되지 않은 병합 요청의 허용 여부
- App Store 배포 권한과 정식 서명 자산의 보유 여부
평가 단위는 프로젝트 하나가 아니라 프로젝트, 작업, 자산의 조합이어야 합니다. 예를 들어 같은 프로젝트 안에서도 일반 테스트 작업은 공유 노드에 둘 수 있지만, 정식 서명 작업은 별도 노드로 보내야 할 수 있습니다.
공유 Mac Runner를 허용할 조건
다음 조건을 모두 만족하면 같은 신뢰 영역 안에서 일반 빌드 노드를 공유할 수 있습니다.
- 코드 제출 주체가 검증된 내부 구성원으로 제한됩니다.
- 외부 기여 파이프라인이 공유 노드에 직접 진입하지 않습니다.
- 정식 인증서와 배포용 키체인이 노드에 상시 남지 않습니다.
- 작업 종료 후 소스, 산출물, 임시 자격 증명을 검사할 수 있습니다.
- 실패한 작업이 다음 작업의 파일을 읽을 수 없는지 부정 테스트를 통과합니다.
반대로 신뢰 영역이 다르거나 외부 입력을 받는 작업, 정식 배포 권한을 사용하는 작업은 별도 노드로 보내야 합니다. GitLab Runner의 범위는 공식 Runner 범위 문서에 설명된 프로젝트, 그룹, 인스턴스 단위의 관리 책임과 연결됩니다.
주의: 스크립트 마지막에 삭제 명령을 넣는 것만으로 호스트 수준의 격리가 완성되지는 않습니다. 삭제 권한이 없거나 작업이 중단되면 파일과 자격 증명이 남을 수 있으므로, 잔류 검사와 전용 호스트 여부를 별도 지표로 검수해야 합니다.
실행 범위와 태그로 진입 경로를 제한합니다
GitLab macOS Runner를 여러 프로젝트에 연결할 때는 “누가 실행할 수 있는가”와 “어떤 작업이 들어오는가”를 분리해서 확인해야 합니다.
프로젝트 범위 Runner는 노출 범위가 가장 좁고 해당 프로젝트의 관리 책임이 분명합니다. 그룹 범위 Runner는 같은 관리 영역의 여러 프로젝트에 효율적이지만, 그룹 안의 신뢰 수준이 달라지면 위험이 커집니다. 인스턴스 범위 Runner는 관리가 편리한 대신 진입 가능한 프로젝트가 넓어지므로 민감한 서명 작업에는 신중해야 합니다.
태그는 라우팅 도구이지 호스트 격리 기능이 아닙니다. ios-build, release, sensitive와 같은 태그를 나누더라도 작업이 다른 태그를 악용하거나 Runner 등록 범위가 넓으면 충분한 방어가 되지 않습니다. 태그와 보호된 Runner 설정 문서를 기준으로 다음을 확인해야 합니다.
- 민감한 Runner에는 허용된 태그만 지정합니다.
- 태그가 없는 작업이 민감한 Runner에 들어가지 않도록 설정합니다.
- 보호된 Runner를 보호된 브랜치 또는 배포 태그와 연결합니다.
- 정상 작업이 허용된 노드로 들어가는지 정방향 테스트를 수행합니다.
- 허용되지 않은 프로젝트와 브랜치가 진입하지 못하는지 역방향 테스트를 수행합니다.
태그와 보호된 브랜치가 호스트 격리를 대신할 수 있습니까?
대신할 수 없습니다. 태그와 보호된 브랜치는 작업 라우팅과 파이프라인 조건을 통제하지만, 같은 호스트에 남은 파일, 캐시, 로그인 세션, 임시 키체인까지 자동으로 분리하지는 않습니다. 민감한 배포 작업은 보호된 실행 조건과 전용 Mac Runner를 함께 사용해야 합니다.
인증 토큰도 별도 지표로 봐야 합니다. Runner 인증 토큰, 저장소 접근 자격 증명, Apple 서명 인증서, Provisioning Profile, 키체인, App Store Connect 자격 증명은 같은 권한층에 저장하지 않는 편이 안전합니다. 토큰 노출 위험에 관한 GitLab 공식 안내도 등록 토큰과 실행 권한을 분리해 검토하도록 요구하는 근거로 사용할 수 있습니다.
서명 자산과 작업 환경을 분리해 검수합니다
정식 서명 작업은 일반 컴파일 작업과 다른 보안 등급으로 취급해야 합니다. 일반 빌드 노드에는 정식 배포 인증서와 장기 보관 키체인을 두지 않고, 보호된 파이프라인이 승인된 전용 Runner에서 필요한 자산만 사용하도록 구성합니다.
검수할 항목은 다음과 같습니다.
- CI/CD 변수에 보호 범위와 환경 범위가 정확히 지정되어 있습니다.
- 일반 브랜치 작업에서 배포용 변수를 읽을 수 없습니다.
- 임시 키체인은 작업 시작 시 생성되고 종료 후 삭제됩니다.
- 인증서와 Provisioning Profile의 사용 주체가 기록됩니다.
- Runner 인증 토큰과 저장소 자격 증명의 교체 이력이 남아 있습니다.
- 비인가 작업이 키체인과 서명 변수를 호출하지 못합니다.
GitLab의 CI/CD 변수 보호 기능과 보호된 환경 설정을 함께 검토해야 합니다. 변수에 보호 속성을 부여하는 것은 필요한 조치이지만, 작업이 실행되는 Mac의 파일 시스템과 로그인 세션까지 분리하는 조치는 아닙니다.
Xcode 27을 사용할 계획이라면 Apple의 Xcode 시스템 요구 사항을 기준으로 지원되는 macOS와 칩 조건을 먼저 확인해야 합니다. 특정 Xcode와 프로젝트 의존성 조합이 실제 빌드되는지는 기업의 저장소와 서명 흐름으로 재현해야 하며, 문서만 보고 모든 프로젝트의 호환성을 가정해서는 안 됩니다.
잔류 파일과 복구 상태를 지표로 관리합니다
작업 후 정리 범위는 소스 디렉터리에 한정되지 않습니다. 다음 영역을 각각 점검해야 합니다.
- 저장소 작업 디렉터리와 숨김 파일
- DerivedData와 패키지 의존성 캐시
- 빌드 산출물과 아카이브
- 임시 키체인과 인증서 파일
- 로그, 환경 변수 출력, 실패 작업의 디버그 자료
- SSH 키, 클라우드 자격 증명, 저장소 인증 정보
검수 방식은 “삭제 스크립트가 실행되었는가”가 아니라 “다음 작업이 이전 작업의 흔적을 읽을 수 없는가”여야 합니다. 서로 다른 신뢰 영역의 작업을 연속 실행한 뒤 잔류 스캔을 수행하고, 중단된 작업과 강제 종료된 작업에서도 같은 기준을 적용해야 합니다.
신뢰도가 낮은 작업을 고정 작업 디렉터리에서 실행하는 구성은 피해야 합니다. 작업 후 삭제, 계정 분리, 임시 키체인, 전용 호스트 중 어떤 조합을 사용할지는 위협 수준에 따라 정해야 합니다. 호스트 재설정이 필요한 경우에는 재설정 완료를 확인할 수 있는 기준 파일과 로그를 별도로 남겨야 합니다.
용량과 복구 지표로 격리 수준을 조정합니다
격리를 강화하면 안전성은 높아지지만, 프로젝트 사이에서 공유하던 유휴 용량은 줄어듭니다. 따라서 보안 기준만으로 노드 수를 정하지 말고 다음 지표를 실제 프로젝트 재현으로 수집해야 합니다.
- 작업이 대기열에 머무는 시간
- 프로젝트별 빌드 지속 시간
- 의존성 설치와 캐시 복구에 걸리는 시간
- 실패 후 재시도 횟수
- 정식 배포 창에서 필요한 처리 여유
- 전용 노드 장애 시 대체 노드로 전환되는 시간
고정된 동시 실행 수를 일반화하면 안 됩니다. Xcode 27, 프로젝트 의존성, 캐시 상태, 서명 과정에 따라 적정 용량이 달라지므로 GitLab Runner fleet 구성 가이드의 설계 원칙을 참고하되, 실제 저장소를 재생한 결과로 결정해야 합니다.
권장 구조는 세 가지 풀로 나누어 검토할 수 있습니다.
- 일반 빌드 풀: 같은 신뢰 영역의 낮은 민감도 작업을 처리합니다.
- 민감한 배포 풀: 보호된 파이프라인과 정식 서명 작업만 처리합니다.
- 임시 확장 풀: 출시 일정이나 대규모 회귀 테스트 때만 추가합니다.
전용 Runner 한 대에 모든 배포를 의존하면 장애 시 출시가 멈출 수 있습니다. 반대로 모든 프로젝트를 전용 노드로 나누면 비용과 유휴 용량이 커질 수 있습니다. 대부분의 여러 팀 환경에서는 신뢰 영역별 공유 풀과 정식 배포 전용 풀을 결합한 혼합 구성이 현실적인 출발점입니다.
운영 전에 이 방출 점검표를 통과시킵니다
다음 항목은 구매나 임대 계약보다 먼저 플랫폼팀이 작성해야 하는 검수 기록입니다.
- [ ] 프로젝트를 코드 민감도, 제출 주체, 외부 기여, 배포 권한으로 분류했습니다.
- [ ] 각 작업이 사용할 Runner 범위와 관리 책임을 기록했습니다.
- [ ] Runner 태그, 태그 없는 작업, 보호된 Runner의 동작을 확인했습니다.
- [ ] 보호된 브랜치와 배포 환경이 민감한 작업에만 연결됩니다.
- [ ] 정상 작업의 정방향 라우팅 테스트를 통과했습니다.
- [ ] 비인가 프로젝트와 브랜치의 역방향 진입 테스트를 통과했습니다.
- [ ] 일반 빌드 노드에 정식 서명 자산이 남지 않습니다.
- [ ] 임시 키체인과 CI/CD 변수의 생성·삭제 시점이 기록됩니다.
- [ ] 작업 중단 뒤에도 소스, 캐시, 로그, 인증 정보의 잔류를 검사했습니다.
- [ ] Xcode 27과 실제 프로젝트 의존성을 사용한 재현 빌드를 완료했습니다.
- [ ] 대기열, 실패 재시도, 배포 창, 장애 복구 기록을 수집했습니다.
- [ ] 하나의 전용 Runner 장애에 대한 대체 경로를 검증했습니다.
- [ ] 통과하지 못한 프로젝트는 공유, 격리 강화, 접속 보류 중 하나로 결정했습니다.
이 점검표에서 신뢰 영역과 역방향 진입 테스트가 통과하지 않으면 태그를 추가하는 것으로 해결해서는 안 됩니다. 해당 프로젝트를 별도 Runner로 옮기거나, 입력과 자격 증명을 줄인 뒤 다시 검수해야 합니다.
현재 물리 Mac 구매만으로 운영하면 초기 장비 확보 비용 외에도 교체 주기, 장애 대응, 원격 접속, 예비 장비, 용량 부족 시 추가 구매라는 부담이 생깁니다. 반대로 일반 클라우드 실행 환경은 Apple 서명 흐름과 실제 macOS 도구 체인을 원하는 방식으로 유지하기 어렵고, 공유형 구성은 격리 경계를 직접 확인해야 합니다. 이런 조건에서는 먼저 KuzCloud의 원격 Mac 한 대를 격리된 검증 노드로 사용해 GitLab Runner, Xcode 27, 서명 흐름과 복구 절차를 재현한 뒤, 실제 대기열과 배포 기록을 근거로 공유 빌드 풀과 전용 배포 풀을 확장하는 방식이 더 안전합니다. 원격 접속과 운영 절차는 KuzCloud 콘솔과 KuzCloud 도움말에서 확인할 수 있으며, 장기 구성 전에 KuzCloud 요금 구성을 비교해 임시 검증과 상시 운영을 분리해 판단하는 편이 좋습니다.
KuzCloud로 맥 실행 환경을 안전하게 분리하십시오
프로젝트와 신뢰 수준에 따라 공유형 맥과 전용 맥을 선택해 기업용 실행 환경을 구성할 수 있습니다.
원격 접속이 가능한 맥 자원으로 빌드와 테스트를 진행하며 팀별 작업 범위를 분리할 수 있습니다.