为GitLab项目配置CI/CD持续集成

# 为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一致。