Loading

使用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
  1. 安装gitlab-ci-multi-runner:
sudo yum install gitlab-ci-multi-runner

注册项目

  1. GitLab网页端进入你要验证的代码项目,左侧依次选择 Settings -> CI/CD -> Runners ,点击expand 可以看到URLtoken的信息
  2. 执行 gitlab-runner register,会有交互式界面提示你依次输入URLtokentagsrunner等,主要是URLtoken要填写正确,runnershell即可,其他的默认直接敲回车
  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
posted @ 2020-12-20 16:18  Suiyek  阅读(2391)  评论(0编辑  收藏  举报