使用gitlab-runner本地驗證.gitlab-ci.yml

背景

在gitlab上配置新項目的CI的時候，需要編寫項目的 .gitlab-ci.yml 文件。

每次修改 .gitlab-ci.yml 文件之后都要執行git push讓GitLab去構建來驗證當前的CI腳本是否能正確構建，甚是麻煩，同時增加了很多無營養的Git提交。

若我們能夠在修改完.gitlab-ci.yml 文件之后本地先試跑一下驗證其正確性，改到滿意再Push修改，豈不樂哉？

安裝 gitlab-runner

下面我將以在一個Centos7機器為例簡述如何部署gitlab-runner，其他平台請參考GitLab官方文檔 :

1. 添加yum源：

curl -L https://packages.gitlab.com/install/repositories/runner/gitlab-ci-multi-runner/script.rpm.sh | sudo bash

2. 安裝gitlab-ci-multi-runner:

sudo yum install gitlab-ci-multi-runner

注冊項目

1. 在GitLab網頁端進入你要驗證的代碼項目，左側依次選擇 Settings -> CI/CD -> Runners ，點擊expand 可以看到URL和token的信息
2. 執行 gitlab-runner register，會有交互式界面提示你依次輸入URL，token， tags， runner等，主要是URL和token要填寫正確，runner填shell即可，其他的默認直接敲回車
3. 注冊完成刷新網頁你會看到你的runner已經成功注冊上去了

本地驗證

1. 拉取對應項目的倉庫代碼，切換到所需分支
2. 進入項目根目錄（也就是有 .git 的目錄）
3. 執行命令進行驗證：gitlab-runner exec docker build-xxx
4. gitlab-runner exec 相關參數如下：

[$]> gitlab-runner exec --help
NAME:
gitlab-runner exec - execute a build locally

USAGE:
gitlab-runner exec command [command options] [arguments...]

COMMANDS:
ssh use ssh executor
virtualbox use virtualbox executor
docker use docker executor
docker-ssh use docker-ssh executor
parallels use parallels executor
shell use shell executor
help, h Shows a list of commands or help for one command

OPTIONS:
--help, -h show help