使用 Gitlab Docker Runner 注册

作为一个程序员，经常需要进行代码构建和测试。而 Gitlab Docker Runner 可以帮助我们在 Docker 容器中运行我们的代码构建和测试任务，省去了设置和维护多个构建服务器的麻烦。

步骤一：安装 Docker

首先需要安装 Docker，可以在 官方 Docker 网站下载并安装适合自己操作系统的 Docker Desktop 版本。

步骤二：创建 Gitlab 的 Access Token

需要拥有管理员权限或是项目权限，才能够在 Gitlab 上创建 Runner，步骤如下：

1. 登陆 Gitlab 管理员帐号（或是项目负责人帐号）
2. 进入 Settings > CI / CD 页面
3. 点击 "Set up CI / CD" 按钮后，会跳转到页面，依据提示进行向导式设置即可。

在 "Runners settings" 下可以创建 Access Token。

步骤三：在 Docker 容器注册 Runner

1. 在终端中输入以下命令，创建 Runner 容器，并将 Access Token 和项目 URL 作为参数：

sudo docker run -d --name gitlab-runner --restart always \
  -v /srv/gitlab-runner/config:/etc/gitlab-runner \
  -v /var/run/docker.sock:/var/run/docker.sock \
  gitlab/gitlab-runner:latest

sudo docker run --rm -t -i -v /srv/gitlab-runner/config:/etc/gitlab-runner gitlab/gitlab-runner register \
  --non-interactive \
  --executor "docker" \
  --docker-image alpine:3 \
  --url "https://gitlab.example.com/" \
  --registration-token "token" \
  --description "docker-runner" \
  --tag-list "docker,aws" \
  --run-untagged="true" \
  --locked="false"

2. 依据终端提示，输入 Gitlab 用户名和 Access Token 以及 Runner 的描述信息等参数。

完成后会提示注册成功。

步骤四：创建 .gitlab-ci.yml 文件

在 Gitlab 项目根目录下创建 .gitlab-ci.yml 文件，并配置我们需要的 Runner。

样例：

image: maven:3-jdk-8

stages:
  - build
  - test
  - deploy

build-job:
  stage: build
  script:
    - mvn clean package

test-job:
  stage: test
  script:
    - mvn test

deploy-job:
  stage: deploy
  script:
    - echo "Deploying"

完成以上操作之后，Gitlab CI/CD 就可以通过配置的 Runner 进行项目的自动构建、测试、部署等操作了。

参考文献：

• GitLab Runner 中文文档
• GitLab Runner 官方文档