• 前提条件
• ランナーのインストール
  • APTピン留め
• ランナーの更新
• パッケージの手動ダウンロード
• 無効skel
• GitLab Runner 10 へのアップグレード

GitLab公式リポジトリを使ってGitLab Runnerをインストールします。

Debian、Ubuntu、Mint、RHEL、Fedora、CentOS で現在サポートされているバージョンのパッケージを提供しています。

前提条件

Dockerexecutorを使用したい場合は、Runnerを使用する前にDockerをインストールしてください。 ディストリビューションのDockerインストール方法を参照してください。

ランナーのインストール

Runnerをインストールするには：

1. GitLabの公式リポジトリを追加します：

   # For Debian/Ubuntu/Mint
   curl -L https://packages.gitlab.com/install/repositories/runner/gitlab-runner/script.deb.sh | sudo bash
   
   # For RHEL/CentOS/Fedora
   curl -L https://packages.gitlab.com/install/repositories/runner/gitlab-runner/script.rpm.sh | sudo bash
   

   注意:Debian ユーザはAPT pinningを使ってください。

2. GitLab Runnerの最新バージョンをインストールするか、特定のバージョンをインストールする場合は次のステップに進んでください：

   注意:Debian buster ユーザは、No such file or directoryジョブの失敗を防ぐためにskel を無効にしてください。

   # For Debian/Ubuntu/Mint
   sudo apt-get install gitlab-runner
   
   # For RHEL/CentOS/Fedora
   sudo yum install gitlab-runner
   

3. GitLab Runnerの特定のバージョンをインストールするには：

   # for DEB based systems
   apt-cache madison gitlab-runner
   sudo apt-get install gitlab-runner=10.0.0
   
   # for RPM based systems
   yum list gitlab-runner --showduplicates | sort -r
   sudo yum install gitlab-runner-10.0.0-1
   

4. ランナーの登録

上記のステップを完了すると、Runnerが起動し、プロジェクトで使用できる状態になります！

GitLab Runnerのよくある問題を説明したFAQセクションを必ずお読みください。

APTピン留め

Debian Stretch ではgitlab-ci-multi-runner というネイティブパッケージが利用できます。 デフォルトでは、公式リポジトリからgitlab-runnerをインストールする場合、そちらの パッケージの方が優先度が高くなります。

私たちのパッケージを使用したい場合は、手動でパッケージのソースを設定する必要があります。 最良の方法は、ピン留め設定ファイルを追加することです。

この場合、次のRunnerパッケージのアップデートは、手動であろうと自動的であろうと、同じソースを使用して行われます：

cat <<EOF | sudo tee /etc/apt/preferences.d/pin-gitlab-runner.pref
Explanation: Prefer GitLab provided packages over the Debian native ones
Package: gitlab-runner
Pin: origin packages.gitlab.com
Pin-Priority: 1001
EOF

ランナーの更新

実行するだけで最新バージョンがインストールされます：

# For Debian/Ubuntu/Mint
sudo apt-get update
sudo apt-get install gitlab-runner

# For RHEL/CentOS/Fedora
sudo yum update
sudo yum install gitlab-runner

パッケージの手動ダウンロード

必要に応じて、手動でパッケージをダウンロードしてインストールすることができます。

無効skel

GitLab 12.10 で導入されました。

デフォルトのスケルトン (skel) ディレクトリがGitLab Runner にとってイシューとなり、ジョブの実行に失敗することがあります。 GitLab Runner をインストールする際は、パッケージをインストールする前に環境変数GITLAB_RUNNER_DISABLE_SKEL をtrue に設定してください。これにより、skelの内部ファイルがない$HOME ディレクトリが作成されます：

使用例：

# For Debian/Ubuntu/Mint
export GITLAB_RUNNER_DISABLE_SKEL=true; sudo -E apt-get install gitlab-runner

# For RHEL/CentOS/Fedora
export GITLAB_RUNNER_DISABLE_SKEL=true; sudo -E yum install gitlab-runner

GitLab Runner 10 へのアップグレード

GitLab Runnerを10.0より前のバージョンからアップグレードするには：

1. 古いリポジトリを削除します：

   # For Debian/Ubuntu/Mint
   sudo rm /etc/apt/sources.list.d/runner_gitlab-ci-multi-runner.list
   
   # For RHEL/CentOS/Fedora
   sudo rm /etc/yum.repos.d/runner_gitlab-ci-multi-runner.repo
   

2. Runnerを登録せず、新しいリポジトリを使用してインストールする場合は、同じ手順に従ってください。

3. RHEL/CentOS/Fedora の場合は実行してください：

   sudo /usr/share/gitlab-runner/post-install
   

   重要：上記のコマンドを実行しないと、サービスファイルが残りません。 詳しくはイシュー#2786に従ってください。