### 配置 Jenkins Pipeline 拉取 GitLab 仓库代码并构建 Docker 镜像 #### 创建 SSH Key 和配置 GitLab 访问权限 为了使 Jenkins 能够访问私有 GitLab 项目，需先生成 SSH 密钥对并将公钥添加至 GitLab 的部署密钥部分。 进入运行 Jenkins 的 Docker 容器内部来生成 SSH 密钥： ```bash docker exec -it jenkins-blueocean bash ssh-keygen -t rsa -b 4096 -C "your_email@example.com" ``` 复制生成的公钥内容，并将其作为新部署键添加到目标 GitLab 项目的设置里[^1]。 #### 设置 Jenkins Global Tool Configuration 前往 Jenkins 系统管理页面下的全局工具配置选项卡，在这里定义所需的 JDK、Maven 或 Gradle 版本以及其他必要的构建工具版本。这一步骤对于后续执行 Maven 或 Gradle 打包命令至关重要[^2]。 #### 编写 Jenkinsfile 实现 CI/CD 流程 在源码库根目录下创建名为 `Jenkinsfile` 的文件用于描述持续集成管道逻辑。下面是一个简单的例子展示如何实现从检出代码直至完成镜像推送的过程： ```groovy pipeline { agent any environment { DOCKER_IMAGE_NAME = 'my-app' GIT_REPO_URL = 'git@gitlab.com:username/repo.git' // 使用SSH URL而非HTTPS BRANCH = 'main' } stages { stage('Checkout') { steps { git branch: "${BRANCH}", url: "${GIT_REPO_URL}" } } stage('Build') { steps { sh './mvnw clean package -DskipTests=true' // 假设使用的是Maven工程 } } stage('Build Docker Image') { steps { script { docker.build("${DOCKER_IMAGE_NAME}:${env.BUILD_NUMBER}") } } } stage('Push Docker Image') { steps { script { withCredentials([usernamePassword(credentialsId: 'dockerhub', passwordVariable: 'PASS', usernameVariable: 'USER')]) { docker.withRegistry("https://index.docker.io/v1/", 'dockerhub') { def customImage = docker.image("${DOCKER_IMAGE_NAME}:${env.BUILD_NUMBER}") customImage.push() } } } } } } } ``` 此脚本会依次执行如下操作：通过 SSH 协议克隆指定分支；调用 Maven 清理打包（跳过单元测试）；利用 Docker CLI 构建应用程序对应的容器映像；最后将该映像上传至 Docker Hub 上面去[^3]。