MacOS Runnerのセットアップ

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

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

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

前提条件

始める前に

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

システムシェルをBashに変更します。

MacOSの新しいバージョンでは、デフォルトシェルとしてZshが搭載されています。Bashに変更する必要があります。

  1. あなたのマシンに接続し、デフォルトのシェルを確認してください:

    echo $SHELL
    
  2. 結果が/bin/bash でない場合は、シェルを変更してください:

    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. Bash環境にrbenvを追加します:

    echo 'if which rbenv > /dev/null; then eval "$(rbenv init -)"; fi' >> ~/.bash_profile
    source ~/.bash_profile
    
  2. Ruby 2.74をインストールし、マシンのグローバル・デフォルトに設定します:

    rbenv install 2.7.4
    rbenv global 2.7.4
    

Xcodeのインストール

Xcodeのインストールと設定を行います。

  1. 以下のいずれかの場所に行き、Xcodeをインストールしてください:

    • Apple App Store。
    • Apple開発者ポータル
    • xcode-install.このプロジェクトは、Appleの様々な依存関係をコマンドラインから簡単にダウンロードできるようにすることを目的としています。
  2. ライセンスに同意し、推奨される追加コンポーネントをインストールしてください。Xcodeを開いてプロンプトに従うか、ターミナルで以下のコマンドを実行することでこれを行うことができます:

    sudo xcodebuild -runFirstLaunch
    
  3. Xcode がビルド中に適切なコマンドラインツールをロードするように、アクティブな開発者ディレクトリを更新してください:

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

プロジェクトランナーを作成し、登録します。

プロジェクト・ランナーを作成し、登録します。

ランナーを作成し、登録します:

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

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

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

ランナーを表示するには

  1. 左側のサイドバーで、「検索」を選択するか、または「移動」を選択して、プロジェクトまたはグループを見つけます。
  2. Settings > CI/CDを選択します。
  3. Runnerを展開します。

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 Runner がプロジェクトをビルドしてくれるはずです。