为GitLab项目配置CI/CD持续集成
前提
1.已经安装好了Gitlab服务 2.准备一台linux服务器(示例以CentOS7) 3.这里以安装配置Gitlab-Runner,并且为Gitlab上某一项目配置Runner为例 4.安装的Runner以基于Linux为例,对应的Executor以docker为例 相关说明:Gitlab的CI/CD需要在项目下增加一个.gitlab-ci.yml文件,而该文件中定义的任务(job)是由Gitlab-Runner来调度的, 而真正执行任务是注册Gitlab-Runner时指定的Executor。可以根据项目实际情况,注册多个Gitlab-Runner对应多个Executor,每一个Executor都是独立环境。
准备工作
由于安装过程中,会使用到sudo命令,因此确保sudo命令可以执行。
编辑/etc/sudoers文件,找到
Defaults secure_path = /sbin:/bin:/usr/sbin:/usr/bin
修改为:
Defaults secure_path = /sbin:/bin:/usr/sbin:/usr/bin:/usr/local/bin
开始安装GitLab-Runner (Linux,root用户模式下)
下载gitlab-runner 二进制安装文件
# Linux x86-64 sudo wget -O /usr/local/bin/gitlab-runner https://gitlab-runner-downloads.s3.amazonaws.com/latest/binaries/gitlab-runner-linux-amd64 # Linux x86 sudo wget -O /usr/local/bin/gitlab-runner https://gitlab-runner-downloads.s3.amazonaws.com/latest/binaries/gitlab-runner-linux-386 # Linux arm sudo wget -O /usr/local/bin/gitlab-runner https://gitlab-runner-downloads.s3.amazonaws.com/latest/binaries/gitlab-runner-linux-arm
给gitlab-runner 赋予权限
sudo chmod +x /usr/local/bin/gitlab-runner
官方教程会在这里创建一个gitlab-runner用户,用于后面job的执行,但由于权限问题,导致后续deploy会出现不少问题,这里暂时用root用户
sudo gitlab-runner install --user=root --working-directory=/app/gitlab-runner sudo gitlab-runner start
至此,gitlab-runner 已经安装成功,可执行 gitlab-runner status 查看运行状态
注册Gitlab-Runner
首先,打开你的GitLab-Runner,找到你要配置Gitlab CI/CD 持续集成的项目,如:gitlab-demo
依次打开: gitlab-demo -> setting -> CI/CD -> Runners -> Set up a specific Runner manually 找到以下内容:URL ,Token
回到linux终端(root模式下),执行:
# gitlab-runner register Please enter the gitlab-ci coordinator URL: # 输入上面步骤找到的URL,示例:http://gitlab.alibaba-inc.com/ci Please enter the gitlab-ci token for this runner: # 输入上面步骤找到的Token Please enter the gitlab-ci description for this runner: # 为该gitlab runner自定义一个名称,示例:gitlab-runner-docker-dev (表示该runner是基于docker的executer的dev环境) Please enter the gitlab-ci tags for this runner (comma separated): # 为该gitlab runner定义一组tag,以逗号隔开,表示只有匹配到这些tag,才会用改runner执行job。示例:docker-dev Whether to run untagged builds [true/false]: # true Please enter the executor: docker, parallels, shell, kubernetes, docker-ssh, ssh, virtualbox, docker+machine, docker-ssh+machine: # 为该runner指定一个executor,由于这里用docker作为示例,输入:docker Please enter the default Docker image (e.g. ruby:2.1): # 输入默认的docker镜像,根据项目需要自定义,官方默认为alpine:latest,这里我们的项目是基于maven的java项目,所以输入:maven:3-jdk-8
到这里,Gitlab-Runner已注册完成,但需要重启一下,输入:
gitlab-runner restart
这时,可以在项目中看到该runner已经配置好,且处于运行中(绿色图标)
依次打开: gitlab-demo -> setting -> CI/CD -> Runners -> Set up a specific Runner manually 下面可以看到上面配置的Runner,已在运行中。
配置gitlab-runner环境
由于Gitlab-Runner的Executor在执行每一个job时,是在独立环境中执行的,而我们实际项目中,经常需要配置多个执行job,或者项目是由多个maven项目构成的。 这里就会出现需要共享maven的.m2仓库问题,可以通过为Runner配置映射关系,指定共享目录即可。
编辑GitLab-Runner的配置文件:
vi /etc/gitlab-runner/config.toml
找到上面配置的Runner (gitlab-runner-docker-dev),在配置项volumes添加:"/root/.m2:/root/.m2"和pull_policy = “if-not-present” 修改后如下:
[[runners]] name = "gitlab-runner-docker-dev" url = "https://gitlab.cedarhd.com" token = "10c11056ca68897428370c4e992051" executor = "docker" [runners.docker] tls_verify = false image = "maven:3-jdk-8" privileged = false disable_entrypoint_overwrite = false oom_kill_disable = false disable_cache = false volumes = ["/cache","/home/gitlab-runner-new/.m2:/root/.m2"] pull_policy = "if-not-present" shm_size = 0 [runners.cache] [runners.cache.s3] [runners.cache.gcs]
Gitlab-Runner配置完成,重启:
gitlab-runner restart
至此,基于Linux配置GitLab-Runner已全部完成。
##基于Docker配置GitLab-Runner
默认环境已安装了docker
拉取gitlab-runner镜像
sudo docker pull gitlab/gitlab-runner:latest
启动容器:
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
注册Gitlab-runner,通过以下命令进入注册:
sudo docker exec -it gitlab-runner gitlab-ci-multi-runner register
注册过程,跟上面linux一致。
文章来源: https://blog.csdn.net/joy_cz/article/details/90400025