Introduction

自宅に保持しているNASで動かしているGitLabを使ってCIをしたいと考えており、そのためにまず、Windowsでビルドする環境を作る。

How to

1. GitLab Runner for Windows の入手

下記からWindowsのバイナリをダウンロード。

docs.gitlab.com
Install GitLab Runner on Windows | GitLab
https://docs.gitlab.com/runner/install/windows.html
GitLab product documentation.

ローカルの適当なディレクトリにダウンロード。
ここでは、D:\Tools\GitLab Runner\gitlab-runner-windows-amd64.exe とする。

2. インストール

サービスとして登録する必要があるため、管理者権限でコマンドプロンプトを起動し、先のダウンロードディレクトリに移動。
移動後、下記のコマンドに適切な値を入力して実行。

1
2
3
4
5
> cd "D:\Tools\GitLab Runner"
> gitlab-runner-windows-amd64.exe install  --user <hostname>\<username> --password <password>
Runtime platform                                    arch=amd64 os=windows pid=8016 revision=775dd39d version=13.8.0
> gitlab-runner-windows-amd64.exe start
Runtime platform                                    arch=amd64 os=windows pid=10568 revision=775dd39d version=13.8.0

起動が成功すると、サービスとしてGitLab Runnerが実行中になる。

GitLab Runner

3. Runnerの登録

次に、GitLabに、ビルドを担当するRunnerの居場所を登録します。
管理者ユーザでGitLabにログインし、管理者画面からRunnersタブを表示します。

GitLab Runner

トークンが表示されているのでメモしておきます。
メモしたトークンを使って、下記のコマンドで登録を実行します。

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
> cd "D:\Tools\GitLab Runner"
>gitlab-runner-windows-amd64.exe register
Runtime platform                                    arch=amd64 os=windows pid=8492 revision=775dd39d version=13.8.0
Enter the GitLab instance URL (for example, https://gitlab.com/):
<gitlabのurl>
Enter the registration token:
<token>
Enter a description for the runner:
[XXXXX]: <description>
Enter tags for the runner (comma-separated):
<tag1>,<tag2>
Registering runner... succeeded                     runner=tNstyzzW
Enter an executor: docker-windows, parallels, shell, ssh, docker+machine, kubernetes, custom, docker, docker-ssh, virtualbox, docker-ssh+machine:
shell
Runner registered successfully. Feel free to start it, but if it's running already the config should be automatically reloaded!

実行完了後、GitLab側にRunnerとして登録されていることを確認できます。

GitLab Runner