GitLab公式リポジトリを使ってGitLab Runnerをインストールします。
Debian、Ubuntu、Mint、RHEL、Fedora、CentOS で現在サポートされているバージョンのパッケージを提供しています。
ディストリビューション | バージョン | 使用終了日 |
---|---|---|
Debian | jessie | 2020年6月 |
Debian | stretch | 約2022年 |
Debian | buster | |
Ubuntu | キセニアル | 2021年4月 |
Ubuntu | bionic | 2023年4月 |
Ubuntu | focal | 2025年4月 |
Mint | sarah | 約2021年 |
Mint | serena | 約2021年 |
Mint | sonya | 約2021年 |
RHEL/CentOS | 6 | 2020年11月 |
RHEL/CentOS | 7 | 2024年6月 |
RHEL/CentOS | 8 | 2029年5月 |
Fedora | 30 | 2020年6月頃 |
前提条件
Dockerexecutorを使用したい場合は、Runnerを使用する前にDockerをインストールしてください。 ディストリビューションのDockerインストール方法を参照してください。
ランナーのインストール
Runnerをインストールするには:
-
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を使ってください。 -
GitLab Runnerの最新バージョンをインストールするか、特定のバージョンをインストールする場合は次のステップに進んでください:
# For Debian/Ubuntu/Mint sudo apt-get install gitlab-runner # For RHEL/CentOS/Fedora sudo yum install gitlab-runner
-
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
上記のステップを完了すると、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より前のバージョンからアップグレードするには:
-
古いリポジトリを削除します:
# 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
-
Runnerを登録せず、新しいリポジトリを使用してインストールする場合は、同じ手順に従ってください。
-
RHEL/CentOS/Fedora の場合は実行してください:
sudo /usr/share/gitlab-runner/post-install
重要:上記のコマンドを実行しないと、サービスファイルが残りません。 詳しくはイシュー#2786に従ってください。