GNU/LinuxにGitLab Runnerを手動インストールします。

GitLab Runner をインストールするためにdeb/rpm リポジトリを使用できない場合、またはあなたの GNU/Linux OS がサポートされていない場合は、最後の手段として以下のいずれかの方法で手動でインストールすることができます。

Docker Executorを使いたい場合は、GitLab Runnerを使う前にDockerをインストールする必要があります。

GitLab Runnerのよくある問題についてはFAQセクションを読んでください。

deb/rpm パッケージの使用

必要であれば、deb またはrpm パッケージを使ってダウンロードし、インストールすることも可能です。

ダウンロード

お使いのシステムに適したパッケージをダウンロードします：

  1. https://gitlab-runner-downloads.s3.amazonaws.com/latest/index.html で最新のファイル名とオプションを検索してください。
  2. GitLab Runnerのブリーディングエッジリリース用の他のタグ付きリリースをダウンロードするためのドキュメントで説明されているように、バージョンを選択してバイナリをダウンロードします。

例えば、DebianやUbuntuの場合：

# Replace ${arch} with any of the supported architectures, e.g. amd64, arm, arm64
# A full list of architectures can be found here https://gitlab-runner-downloads.s3.amazonaws.com/latest/index.html
curl -LJO "https://gitlab-runner-downloads.s3.amazonaws.com/latest/deb/gitlab-runner_${arch}.deb"

例えば、CentOSやRed Hat Enterprise Linuxの場合：

# Replace ${arch} with any of the supported architectures, e.g. amd64, arm, arm64
# A full list of architectures can be found here https://gitlab-runner-downloads.s3.amazonaws.com/latest/index.html
curl -LJO "https://gitlab-runner-downloads.s3.amazonaws.com/latest/rpm/gitlab-runner_${arch}.rpm"

例えば、RHEL上のFIPS準拠のGitLab Runnerの場合：

# Currently only amd64 is a supported arch
# A full list of architectures can be found here https://gitlab-runner-downloads.s3.amazonaws.com/latest/index.html
curl -LJO "https://gitlab-runner-downloads.s3.amazonaws.com/latest/rpm/gitlab-runner_amd64-fips.rpm"

インストール

  1. お使いのシステムに合ったパッケージを以下の手順でインストールしてください。

    例えば、DebianやUbuntuの場合：

    dpkg -i gitlab-runner_<arch>.deb

    例えば、CentOSやRed Hat Enterprise Linuxの場合：

    rpm -i gitlab-runner_<arch>.rpm

  2. ランナーの登録

アップデート

お使いのシステムの最新パッケージをダウンロードし、以下の手順でアップグレードしてください：

例えば、DebianやUbuntuの場合：

dpkg -i gitlab-runner_<arch>.deb

例えば、CentOSやRed Hat Enterprise Linuxの場合：

rpm -Uvh gitlab-runner_<arch>.rpm

バイナリファイルの使用

必要に応じて、バイナリファイルを使用してダウンロードおよびインストールすることも可能です。

インストール

caution
GitLab Runner 10 では、実行ファイルの名前がgitlab-runner に変更されました。

  1. あなたのシステムにあったバイナリをダウンロードしてください：

    # Linux x86-64
sudo curl -L --output /usr/local/bin/gitlab-runner "https://gitlab-runner-downloads.s3.amazonaws.com/latest/binaries/gitlab-runner-linux-amd64"
   
# Linux x86
sudo curl -L --output /usr/local/bin/gitlab-runner "https://gitlab-runner-downloads.s3.amazonaws.com/latest/binaries/gitlab-runner-linux-386"
   
# Linux arm
sudo curl -L --output /usr/local/bin/gitlab-runner "https://gitlab-runner-downloads.s3.amazonaws.com/latest/binaries/gitlab-runner-linux-arm"
   
# Linux arm64
sudo curl -L --output /usr/local/bin/gitlab-runner "https://gitlab-runner-downloads.s3.amazonaws.com/latest/binaries/gitlab-runner-linux-arm64"
   
# Linux s390x
sudo curl -L --output /usr/local/bin/gitlab-runner "https://gitlab-runner-downloads.s3.amazonaws.com/latest/binaries/gitlab-runner-linux-s390x"
   
# Linux ppc64le
sudo curl -L --output /usr/local/bin/gitlab-runner "https://gitlab-runner-downloads.s3.amazonaws.com/latest/binaries/gitlab-runner-linux-ppc64le"
   
# Linux x86-64 FIPS Compliant
sudo curl -L --output /usr/local/bin/gitlab-runner "https://gitlab-runner-downloads.s3.amazonaws.com/latest/binaries/gitlab-runner-linux-amd64-fips"

    Bleeding Edgeで説明されているように、利用可能なすべてのバージョンのバイナリをダウンロードできます。

  2. 実行権限を与えます：

    sudo chmod +x /usr/local/bin/gitlab-runner

  3. GitLab CI ユーザーを作成します：

    sudo useradd --comment 'GitLab Runner' --create-home gitlab-runner --shell /bin/bash

  4. インストールし、サービスとして実行します：

    sudo gitlab-runner install --user=gitlab-runner --working-directory=/home/gitlab-runner
sudo gitlab-runner start

    rootの$PATH に/usr/local/bin/ があることを確認してください。さもないと、command not found エラーが出るかもしれません。あるいは、/usr/bin/のように、gitlab-runner を別の場所にインストールすることもできます。

  5. ランナーの登録

note
gitlab-runner がインストールされ、サービスとして実行される場合（このページで説明されていること）、root として実行されますが、install コマンドで指定されたユーザーとしてジョブを実行します。つまり、キャッシュやアーティファクトのようなジョブ機能の一部は/usr/local/bin/gitlab-runner コマンドを実行する必要があり、そのためジョブを実行するユーザーは実行ファイルにアクセスできる必要があります。

アップデート

  1. サービスを停止してください（以前と同様に昇格コマンドプロンプトが必要です）：

    sudo gitlab-runner stop

  2. GitLab Runner実行ファイルを置き換えるバイナリをダウンロードします。例えば

    sudo curl -L --output /usr/local/bin/gitlab-runner "https://gitlab-runner-downloads.s3.amazonaws.com/latest/binaries/gitlab-runner-linux-amd64"

    Bleeding Edgeで説明されているように、利用可能なすべてのバージョンのバイナリをダウンロードできます。

  3. 実行権限を与えます：

    sudo chmod +x /usr/local/bin/gitlab-runner

  4. サービスを開始します：

    sudo gitlab-runner start