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に変更する必要があります。
-
あなたのマシンに接続し、デフォルトのシェルを確認してください:
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 2.74をインストールし、マシンのグローバル・デフォルトに設定します:
rbenv install 2.7.4 rbenv global 2.7.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
プロジェクトランナーを作成し、登録します。
プロジェクト・ランナーを作成し、登録します。
ランナーを作成し、登録します:
- 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!
ランナーを表示するには
- 左側のサイドバーで、「検索」を選択するか、または「移動」を選択して、プロジェクトまたはグループを見つけます。
- Settings > CI/CDを選択します。
- 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 がプロジェクトをビルドしてくれるはずです。