gitlab-runner服务注册及任务捕获原理

BlackHole1 commented 5 years ago

环境搭建

可以参考https://docs.gitlab.com/runner/development/README.html 来进行搭建，这里需要注意的是，go version最好为go1.8.7，高版本的go version，可能会安装失败。

参数注册

gitlab-runner在注册runner时，需要用到registry、install、start这三个命令。而其实install和start只是服务注册的

在main.go文件的入口处，其调用了common.GetCommands()

而这个函数是为了注册参数的，其核心代码为：

Name为我们要注册的参数，Action为调用参数后调用的方法。

在注册方法时，只需要使用RegisterCommand2(参数名, 说明, 动作函数类)即可。

registry

在commands/registry.go里有一个init函数，注册了registry

newRegisterCommand函数肯定返回了Execute函数，也就是触发registry的动作函数。

这里返回了一个RegisterCommand类，而这个类下实现了Execute方法。

其中s.askRunner()就是我们输入命令后，出现的各种询问，如：gitlab-ci URL、token、description、tags。

在askRunner函数里，当你输入完成后，有一步校验的操作，检验你输入的只是否真的可以连接到gitlab-ci上。

这些都没什么好说的。在askRunner函数后，还askExecutor、askExecutorOptions函数。这两个函数的作用是询问你要选择哪种执行者，也就是我们见到的Please enter the executor: docker+machine, docker, docker-ssh, shell, docker-ssh+machine, kubernetes, parallels, ssh, virtualbox:

当你全部输入完成后，会把你输入值，保存在~/.gitlab-runner/config.toml文件里。

其实到这步的时候，整个gitlab-ci就已经配置好了，install、start的作用下面再说

install/start

当你注册完成后，再使用install进行安装时，其实安装的是gitlab-ci服务。

我们看下commands/service.go文件的内容：

可以看到其他的参数基本都是在这里进行注册，其他的我们暂时不看，专注看下install、start

其中这两个参数的行为都是RunServiceControl函数，这个函数的代码也十分简单

其中install比较特别，单独调用了runServiceInstall函数，这个函数的作用就是为了检查config.toml以及当前用户的代码，没啥好说的，最后也调用了service.Control(s, c.Command.Name)方法。这个方法是github.com/ayufan/golang-kardianos-service库，这个库是一个注册服务的库，也就说当你使用gitlab-runner install的时候，其实是在注册服务，服务的作用是保证gitlab-runner一直在后台运行以及开机运行。

当服务注册好后，再通过gitlab-runner start打开服务（这里其实可以集成到install里，但是不知道为什么gitlab官网没有这么做）

当我们调用service.Control(s, 'start')时，其实会执行s.Start()方法，而这个方法其实就是开启服务的，而打开服务时，也需要一个命令行，因为要告诉系统我执行的什么的命令是服务。其代码为：