Ubuntu に GitLab-Runner を直接インストールする

2022/04/14

公式ドキュメントは以下です。

- https://docs.gitlab.com/runner/install/

## インストール

### apt でインストール

まずはリポジトリを追加します。

```shell
$ curl -L "https://packages.gitlab.com/install/repositories/runner/gitlab-runner/script.deb.sh" | sudo bash
```

apt でインストールします。

```shell
$ sudo apt-get install gitlab-runner
```

しかし、この方法でインストールしたら結構古いバージョン (11.2.0) がインストールされてしまいました。  
最新のバージョンは 14.9.1 のはずなんですが・・・。

今動かしている GitLab と互換性がなく上手く動かなったので、最終的には次に示すように deb パッケージからインストールしました。

### deb パッケージからインストール

- https://docs.gitlab.com/runner/install/linux-manually.html

ドキュメントだと curl を使うようになっていますが、上手くダウンロードできなかったのと、環境変数 `arch` が空だったので、以下のコマンドでダウンロードしました。

```shell
$ wget "https://gitlab-runner-downloads.s3.amazonaws.com/latest/deb/gitlab-runner_amd64.deb"
```

次のコマンドでインストールします。

```shell
$ dpkg -i gitlab-runner_amd64.deb
```

## GitLab への登録

インストールが完了したら Gitlab-Runner を GitLab に登録します。

- https://docs.gitlab.com/runner/register/index.html#linux

```shell
$ sudo gitlab-runner register
```

対話形式で入力していきます。

まず、GitLab の URL を指定します。

```shell
Please enter the gitlab-ci coordinator URL (e.g. https://gitlab.com/):
http://gitlab.example
```

次にトークンを入力します。  
トークンは GitLab に管理者でログインし、Menu > Admin > Runner で確認できます。

```
Please enter the gitlab-ci token for this runner:
U6YYzWyiQYzzfCdDH1dv
```

ランナーの詳細を入力します。

```shell
Please enter the gitlab-ci description for this runner:
```

ランナーを識別するためのタグを指定します。

```shell
Please enter the gitlab-ci tags for this runner (comma separated):
```

次はオプションなので何も入力せず進みました。

```shell
Enter optional maintenance note for the runner:
```

最後にスクリプトの実行方法を指定します。  
今回はホスト上で直接実行させたかったので、`shell` を指定します。

```
Please enter the executor: virtualbox, docker+machine, docker, docker-ssh, parallels, kubernetes, shell, ssh, docker-ssh+machine:
```

GitLab の Menu > Admin > Runner で登録されたことが確認できます。

へっぽこプログラマーの備忘録