插件安装

gitlab-plugin

添加认证

添加认证的操作，分为两个部分，一个是在 Gitlab 上完成，一个是在 Jenkins 上完成。

Gitlab 认证配置

在 Gitlab 中，使用管理员账号，生成 Access Token。

将生成的 token 拷贝。注意：token 只会展示一次，关闭页面后，就无法再拷贝。

Jenkins 认证配置

使用管理员账号，进入系统管理 -> 系统配置/Configuration System，找到 Gitlab 。

点击添加认证按钮，将 Gitlab 处复制来的 Access Token 粘贴到指定位置。

添加成功后，在 Gitlab 选项处进行配置，并测试连接。连接成功即添加完成，保存退出，即可。

创建 Jenkins 流水线

创建 Jenkins 流水线，选择 pipeline 风格。（这里仅说明 pipeline 风格流水线如何配置）

Jenkins 返回构建信息

Jenkinsfile样例

pipeline {
  agent any

  // 添加 gitlab 名称
  // 填写 Jenkins 后台配置的 Gitlab 选项中的 Connection name。此处填写上一章节填写的名称。 
  options {
    gitLabConnection('Gitlab')
  }

  parameters{
    gitParameter branch:
            '',
            branchFilter:'origin/{.*}',
            defaultValue:'<branch>',   
            name:'BRANCH',
            quickFilterEnabled: true,
            selectedValue: 'DEFAULT',
            sortMode: 'NONE',
            tagFilter: '*',
            type:'PT_BRANCH_TAG'   
    }

  stages {
    stage('Checkout') {
            steps {
                // 更新 Gitlab 中的流水线状态
                updateGitlabCommitStatus name: 'build', state: 'pending'
                // 更新代码
                checkout([$class: 'GitSCM',
                    branches: [[ name:"${BRANCH}" ]],
                    doGenerateSubmoduleConfinurations: false,
                    extensions: [],
                    //gitTool: 'Gitlab',
                    submoduleCig: [],
                    userRemoteConfigs: [[
                        url: "<gitlab_repo_url>",
                        credentialsId: '<gitlab&Jenkins_token>',
                    ]]
                ])
            }
    }
    stage('build') {
      steps {
        // 更新 Gitlab 中的流水线状态
        updateGitlabCommitStatus name: 'build', state: 'running'
        hogehoge
      }
    }
  }

  // 返回构建结果到 Gitlab 上
  post {
    success {
      updateGitlabCommitStatus name: 'build', state: 'success'
    }
    failure {
      updateGitlabCommitStatus name: 'build', state: 'failed'
    }
  }
}