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インストール方法を参照してください。

ランナーのインストール

重要:GitLab Runner 10より前のバージョンを使っている、またはアップグレードしている場合は、新しいバージョンへのアップグレード方法をお読みください。 GitLab Runner 10より前のバージョンをインストールしたい場合は、古いドキュメントをご覧ください。

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_SKELtrue に設定してください。これにより、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に従ってください。