GitLab Runnerのインストール

GitLab Runnerをインフラにインストールすることができます。

GitLab RunnerはオープンソースでGoで書かれています。単一のバイナリとして実行でき、言語固有の要件はありません。

GitLab RunnerはDockerコンテナ内で実行したり、Kubernetesクラスターにデプロイすることもできます。

GitLab RunnerはGNU/Linux、MacOS、FreeBSD、Windowsにインストールして使用することができます。インストールできます:

  • コンテナに。
  • 手動でバイナリをダウンロードすることで
  • rpm/debパッケージのリポジトリを使用する方法。

GitLab Runnerが公式にサポートしているバイナリは以下のアーキテクチャで利用可能です:

  • x86、AMD64、ARM64、ARM、s390x、ppc64le

公式パッケージは以下のLinuxディストリビューションで利用可能です:

  • CentOS、Debian、Ubuntu、RHEL、Fedora、Mint、Oracle、Amazon

GitLab Runnerは以下のオペレーションシステムを公式にサポートしています。公式にサポートされていない別のオペレーティングシステムを使いたい場合は、Goバイナリをコンパイルできる必要があります。

  • Linux、Windows、MacOS、FreeBSD
note
セキュリティとパフォーマンスの理由から、GitLabインスタンスをホストするマシンとは別のマシンにGitLab Runnerをインストールする必要があります。

様々なインストール方法についての情報は以下をご覧ください。また、GitLabでプロジェクトのSettings > CI / CDに行き、Runnersセクションを展開し、Show runner installation instructionsをクリックすることでインストール手順を見ることができます。

GitLab Runnerをインストールしたら、個々のRunnerをGitLabインスタンスに登録する必要があります。このインスタンスは自分で管理することもできますし、GitLab.comを使うこともできます。

GitLab RunnerはGitLabで定義されたCI/CDジョブを実行します。

システム要件

GitLab Runnerのシステム要件は様々で、それぞれのユースケースに固有の多くの変数に依存します。GitLab Runnerインスタンスは、これらの変数を考慮して個別にサイズを設定し、必要に応じて増減させることができます。これらの変数には以下が含まれます:

  • 予想されること
    • CI ジョブの CPU 負荷。
    • CIジョブのメモリ使用量
  • 数:
    • CIジョブの同時実行数。
    • 開発中のプロジェクト。
    • 開発者は並行して作業する予定です。

詳細については、SaaS でLinux (x86-64) を利用できるマシンの種類をご覧ください。

FIPS準拠のGitLab Runner

GitLab Runner 14.7 では、FIPS 140-12 準拠の GitLab Runner バイナリを提供しています。Red Hat Goコンパイラでビルドされたこのバイナリは、標準ライブラリの暗号化ルーチンをバイパスし、代わりにFIPS 140-2で検証された暗号化ライブラリを呼び出します。

GitLab Runner 15.10 では、GitLab Runner FIPS イメージを作成するベースとしてUBI-8 minimalを使用しています。

note
Red Hat Enterprise Linux(RHEL) ディストリビューションのみがサポートされています。

FIPS準拠のGitLab Runnerバイナリは、以下のアーキテクチャ向けに提供されています:

  • AMD64

同じアーキテクチャのDockerイメージとRPMパッケージも提供されています。

RHELにおけるFIPS準拠のGitLab Runner

RHEL で FIPS バージョンの GitLab Runner を使用する場合は、FIPS モードを有効にする必要があります。

他のシステムとアーキテクチャにおける FIPS 準拠の GitLab Runner

他のアーキテクチャやディストリビューションの追加については、このイシューを参照してください。

リポジトリ

バイナリ

コンテナ

オートスケール