macOS Runner 설정

요약

macOS Runner에서 CI/CD 작업을 실행하려면 다음 단계를 순서대로 완료하세요. 완료하면 GitLab Runner가 macOS 기기에서 실행되고 개별 Runner가 작업을 처리할 준비가 됩니다. 최신 버전의 macOS는 기본 셸로 Zsh를 사용합니다.

macOS Runner에서 CI/CD 작업을 실행하려면 다음 단계를 순서대로 완료하세요.

완료하면 GitLab Runner가 macOS 기기에서 실행되고 개별 Runner가 작업을 처리할 준비가 됩니다.

시스템 셸을 Bash로 변경합니다.
Homebrew, rbenv 및 GitLab Runner를 설치합니다.
rbenv를 구성하고 Ruby를 설치합니다.
Xcode를 설치합니다.
Runner를 등록합니다.
CI/CD를 구성합니다.

사전 요구 사항#

시작하기 전에:

최신 버전의 macOS를 설치합니다. 이 가이드는 11.4에서 개발되었습니다.
기기에 대한 터미널 또는 SSH 액세스가 있는지 확인합니다.

시스템 셸을 Bash로 변경#

최신 버전의 macOS는 기본 셸로 Zsh를 사용합니다. 그러나 Runner의 셸 실행기는 많은 CI/CD 스크립트가 Bash 특유의 구문과 기능을 사용하므로 올바르게 실행되도록 Bash를 요구합니다.

기기에 연결하고 기본 셸을 확인합니다:
```
echo $SHELL
```
결과가 /bin/bash가 아닌 경우 다음을 실행하여 셸을 변경합니다:
```
chsh -s /bin/bash
```
패스워드를 입력합니다.
터미널을 재시작하거나 SSH를 사용하여 다시 연결합니다.
echo $SHELL을 다시 실행합니다. 결과가 /bin/bash여야 합니다.

Homebrew, rbenv 및 GitLab Runner 설치#

Runner가 기기에 연결하고 작업을 실행하기 위해 특정 환경 옵션이 필요합니다.

Homebrew 패키지 매니저를 설치합니다:

/bin/bash -c "$(curl "https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh")"

Ruby 버전 매니저인 rbenv와 GitLab Runner를 설정합니다:

brew install rbenv gitlab-runner
brew services start gitlab-runner

rbenv 구성 및 Ruby 설치#

이제 rbenv를 구성하고 Ruby를 설치합니다.

Bash 환경에 rbenv를 추가합니다:

echo 'if which rbenv > /dev/null; then eval "$(rbenv init -)"; fi' >> ~/.bash_profile
source ~/.bash_profile

Ruby 3.3.x를 설치하고 기기의 전역 기본값으로 설정합니다:
```
rbenv install 3.3.4
rbenv global 3.3.4
```

Xcode 설치#

이제 Xcode를 설치하고 구성합니다.

다음 위치 중 하나로 이동하여 Xcode를 설치합니다:
- Apple App Store.
- Apple 개발자 포털.
- xcode-install. 이 프로젝트는 명령줄에서 다양한 Apple 종속성을 더 쉽게 다운로드할 수 있도록 합니다.
라이선스에 동의하고 권장 추가 구성 요소를 설치합니다. Xcode를 열고 안내에 따르거나 터미널에서 다음 명령을 실행하면 됩니다:
```
sudo xcodebuild -runFirstLaunch
```
빌드 중 Xcode가 올바른 명령줄 도구를 로드하도록 활성 개발자 디렉터리를 업데이트합니다:
```
sudo xcode-select -s /Applications/Xcode.app/Contents/Developer
```

프로젝트 Runner 생성 및 등록#

이제 프로젝트 Runner를 생성하고 등록합니다.

Runner를 생성하고 등록할 때:

GitLab에서 macOS 작업이 이 macOS 기기에서 실행되도록 macos 태그를 추가합니다.
명령줄에서 실행기로 shell을 선택합니다.

Runner를 등록한 후 명령줄에 성공 메시지가 표시됩니다:

Runner registered successfully. Feel free to start it, but if it's running already the config should be automatically reloaded!

Runner를 보려면:

상단 바에서 검색 또는 이동을 선택하고 프로젝트 또는 그룹을 찾습니다.
설정 > CI/CD를 선택합니다.
Runner를 확장합니다.

CI/CD 구성#

GitLab 프로젝트에서 CI/CD를 구성하고 빌드를 시작합니다. 이 샘플 .gitlab-ci.yml 파일을 사용할 수 있습니다. 태그가 Runner를 등록할 때 사용한 태그와 일치하는지 확인하세요.

stages:
  - build
  - test

variables:
  LANG: "en_US.UTF-8"

before_script:
  - gem install bundler
  - bundle install
  - gem install cocoapods
  - pod install

build:
  stage: build
  script:
    - bundle exec fastlane build
  tags:
    - macos

test:
  stage: test
  script:
    - bundle exec fastlane test
  tags:
    - macos

이제 macOS Runner가 프로젝트를 빌드해야 합니다.