正式なドキュメントは英語版であり、この日本語訳はAI支援翻訳により作成された参考用のものです。日本語訳の一部の内容は人間によるレビューがまだ行われていないため、翻訳のタイミングにより英語版との間に差異が生じることがあります。最新かつ正確な情報については、英語版をご参照ください。

macOS Runnerをセットアップする

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

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

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

前提条件

はじめる前:

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

システムShellをBashに変更する

新しいバージョンのmacOSでは、デフォルトのShellとしてZshが使用されます。ただし、RunnerのShell executorでは、Bash固有の構文と機能を使用するものが多いため、CI/CDスクリプトが正しく実行されるようにBashが必要です。

  1. マシンに接続し、デフォルトのShellを確認します:

    echo $SHELL

  2. 結果が/bin/bashでない場合は、次を実行してShellを変更します:

    chsh -s /bin/bash

  3. パスワードを入力します。

  4. ターミナルを再起動するか、SSHを使用して再接続します。

  5. echo $SHELLをもう一度実行します。結果は/bin/bashになるはずです。

Homebrew、rbenv、GitLab Runnerをインストールする

Runnerがマシンに接続してジョブを実行するには、特定の環境オプションが必要です。

  1. Homebrewパッケージマネージャーをインストールします:

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

  2. RubyバージョンマネージャーであるrbenvとGitLab Runnerをセットアップします:

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

rbenvを設定してRubyをインストールする

rbenvを設定し、Rubyをインストールします。

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

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

  2. Ruby 3.3.xをインストールし、マシン全体のデフォルトとして設定します:

    rbenv install 3.3.4
rbenv global 3.3.4

Xcodeをインストールします

Xcodeをインストールして設定します。

  1. 次のいずれかの場所に移動して、Xcodeをインストールします:

    • Apple App Store。
    • Apple Developer Portal。
    • xcode-install。このプロジェクトは、コマンドラインからさまざまなAppleの依存関係を簡単にダウンロードできるようにすることを目的としています。

  2. ライセンスに同意し、推奨される追加コンポーネントをインストールします。これを行うには、Xcodeを開いてプロンプトに従うか、ターミナルで次のコマンドを実行します:

    sudo xcodebuild -runFirstLaunch

  3. Xcodeがビルド中に適切なコマンドラインツールを読み込むように、アクティブなデベロッパーディレクトリを更新します:

    sudo xcode-select -s /Applications/Xcode.app/Contents/Developer

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

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

Runnerを作成して登録するとき:

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

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

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

Runnerを表示するには:

  1. 上部のバーで、検索または移動先を選択して、プロジェクトまたはグループを見つけます。
  2. 設定 > CI/CDを選択します。
  3. 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は、プロジェクトをビルドする必要があります。