macOSランナーのセットアップ

macOSランナー上でCI/CDジョブを実行するには、次の手順を順番に実行します。

完了すると、GitLab RunnerがmacOSマシン上で実行され、個々のランナーがジョブを処理できるようになります。

システムShellをBashに変更します。
Homebrew、rbenv、およびGitLab Runnerをインストールします。
rbenvを設定し、Rubyをインストールします。
Xcodeをインストールします。
Runnerを登録します。
CI/CDを設定します。

前提要件

はじめる前:

macOSの最新バージョンをインストールします。このガイドは11.4で開発されました。
ターミナルまたはSSHでマシンにアクセスできることを確認してください。

システムShellをBashに変更します

macOSの新しいバージョンには、デフォルトのShellとしてZshが付属しています。Bashに変更する必要があります。

マシンに接続し、デフォルトのShellを確認します:
```
echo $SHELL
```
結果が/bin/bashでない場合は、次を実行してShellを変更します:
```
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をインストールします。

rbenvをBash環境に追加します:

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
```

プロジェクトRunnerを作成して登録する

ここでプロジェクトRunnerを作成して登録します。

ランナーを作成して登録するとき:

GitLabで、タグmacosを追加して、macOSジョブがこのmacOSマシンで実行されるようにします。
コマンドラインで、executorとしてshellを選択します。

ランナーを登録すると、コマンドラインに成功メッセージが表示されます:

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

ランナーを表示するには:

左側のサイドバーで、検索または移動先を選択して、プロジェクトまたはグループを見つけます。
設定 > 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ランナーがプロジェクトをビルドするはずです。