macOS 러너 설정

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

작업이 끝나면 GitLab Runner가 macOS 머신에서 실행되고 개별 러너가 작업을 처리할 준비가 됩니다.

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

전제 조건

시작하기 전에:

최신 버전의 macOS를 설치합니다. 이 가이드는 11.4에서 개발되었습니다.
머신에 터미널 또는 SSH 접근이 가능해야 합니다.

시스템 셸을 Bash로 변경하기

최신 버전의 macOS는 기본 셸로 Zsh를 제공합니다.

이를 Bash로 변경해야 합니다.

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

Homebrew, rbenv 및 GitLab 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 Developer Portal
- xcode-install. 이 프로젝트는 다양한 Apple 종속성을 명령 줄에서 더 쉽게 다운로드할 수 있도록 도와줍니다.
라이선스에 동의하고 권장하는 추가 구성 요소를 설치합니다. Xcode를 열고 안내에 따라 진행하거나 다음 터미널 명령을 실행하여 수행할 수 있습니다:
```
sudo xcodebuild -runFirstLaunch
```
Xcode가 빌드 중에 적절한 명령 줄 도구를 로드할 수 있도록 활성 개발자 디렉토리를 업데이트합니다:
```
sudo xcode-select -s /Applications/Xcode.app/Contents/Developer
```

프로젝트 러너 생성 및 등록

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

러너를 생성하고 등록하면:

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

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

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

러너를 보려면:

왼쪽 사이드바에서 Search or go to를 선택하고 프로젝트 또는 그룹을 찾습니다.
Settings > CI/CD를 선택합니다.
Runners를 확장합니다.

CI/CD 구성

GitLab 프로젝트에서 CI/CD를 구성하고 빌드를 시작하세요. 이 샘플 .gitlab-ci.yml 파일을 사용할 수 있습니다.

태그는 러너를 등록할 때 사용한 태그와 일치해야 합니다.

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 러너가 프로젝트를 빌드해야 합니다.