【Jenkins简单自动化部署案例：基于Docker和Harbor的自动化部署流程记录】

摘要

本文记录了作者使用Jenkins时搭建的一个简单自动化部署案例，涵盖Jenkins的Docker化安装、Harbor私有仓库配置、Ansible远程部署等核心步骤。通过一个SpringBoot项目 (RuoYi) 的完整流程演示，从代码提交到镜像构建、推送、滚动更新，逐步实现CI/CD的基础能力。文章重点解决可能遇到的权限问题、证书配置、流水线调试等痛点，并提供可复现的操作命令和排错思路，适合刚接触DevOps工具链的朋友参考。

安装Jenkins

Jenkins-Docker官网

1.创建网络

使用以下命令在 Docker 中创建一个桥接网络：

docker network create jenkins

2.Dockerfile创建Jenkins Docker 镜像

通过执行以下两个步骤来自定义官方的 Jenkins Docker 镜像：

创建一个包含以下内容的 Dockerfile：

FROM jenkins/jenkins:2.504.1-jdk21
USER root
RUN apt-get update && apt-get install -y lsb-release ca-certificates curl && \install -m 0755 -d /etc/apt/keyrings && \curl -fsSL https://download.docker.com/linux/debian/gpg -o /etc/apt/keyrings/docker.asc && \chmod a+r /etc/apt/keyrings/docker.asc && \echo "deb [arch=$(dpkg --print-architecture) signed-by=/etc/apt/keyrings/docker.asc] \https://download.docker.com/linux/debian $(. /etc/os-release && echo \"$VERSION_CODENAME\") stable" \| tee /etc/apt/sources.list.d/docker.list > /dev/null && \apt-get update && apt-get install -y docker-ce-cli && \apt-get clean && rm -rf /var/lib/apt/lists/*
USER jenkins
RUN jenkins-plugin-cli --plugins "blueocean docker-workflow json-path-api"

根据此 Dockerfile 构建一个新的 Docker 镜像，“myjenkins-blueocean:2.504.1-1”：

docker build -t myjenkins-blueocean:2.504.1-1 .

如果您尚未下载官方的 Jenkins Docker 镜像，上述过程会自动为您下载。

使用到对应工具需添加安装步骤, 例: 安装Ansible

FROM myjenkins-blueocean:2.504.1-1
USER root
RUN apt-get update && apt-get install -y ansible \&& git config --global --add safe.directory '*'
# 配置 Git 安全目录(root用户)
#RUN git config --global --add safe.directory '*'USER jenkins

docker build -t myjenkins-ansible .

4.启动容器

使用以下 docker run 命令在 Docker 中以容器形式运行您自己的 myjenkins 镜像：

docker run --name jenkins-blueocean --restart=on-failure --detach \
--user root \
--publish 8080:8080 --publish 50000:50000 \
--volume jenkins-data:/var/jenkins_home \
--volume /var/run/docker.sock:/var/run/docker.sock \
--volume /etc/docker/certs.d:/etc/docker/certs.d:ro \
--volume /etc/ansible/hosts:/etc/ansible/hosts:ro \
--volume ~/.ssh/id_rsa:/root/.ssh/id_rsa \
--volume ~/.ssh/known_hosts:/root/.ssh/known_hosts:ro \
--add-host=harbor.host3:192.168.0.223 \
myjenkins-ansible# 停止并删除旧容器
docker stop jenkins-blueocean
docker rm jenkins-blueocean

• Ansible Inventory --volume /etc/ansible/hosts:/etc/ansible/hosts:ro
• 免密登录
  • --volume ~/.ssh/id_rsa:/root/.ssh/id_rsa
  • --volume ~/.ssh/known_hosts:/root/.ssh/known_hosts:ro
• harbor主机host: --add-host=harbor.host3:192.168.0.223

访问测试

http://192.168.0.220:8080

提示输入密码可查看容器日志获取:docker logs jenkins-blueocean

一：基础环境配置

‌环境架构概览‌

‌节点名称‌	‌角色及配置‌	‌关键组件链接‌	‌功能说明‌
‌host0‌ (内存>2G)	控制节点（Ansible + Jenkins）	Ubuntu 安装 Docker CE + Jenkins	负责 CI/CD 流程调度与任务分发
‌host3‌ (内存>1G)	私有镜像仓库（Harbor v2.13.0）	Harbor v2.13.0 HTTPS 安装指南	存储 Docker 镜像与项目管理
‌host1/host2‌ (内存>2G)	目标服务器（Docker 运行时）	-	运行业务容器集群

---

快速创建虚拟环境: 【Vagrant+VirtualBox创建自动化虚拟环境】

‌节点详细配置
‌

‌1. 控制节点 (host0)

• ‌核心组件

  • ‌Jenkins‌：用于自动化构建、测试与部署
  • ‌Ansible‌：实现批量服务器配置管理

• ‌安装步骤

  参考教程：Ubuntu 部署 Docker CE + Jenkins

‌2. 镜像仓库节点 (host3)

• ‌核心配置‌

  • HTTPS 证书配置
  • 创建项目 ruoyi 用于镜像管理
  • 参考教程：Harbor HTTPS 安装与配置

‌3. 目标服务器 (host1/host2)

• ‌基础环境‌
  • Docker 运行时
  • 开放必要端口（80、3306 等）

4.所有服务器

• 域名映射

echo "192.168.0.223 harbor.host3" | sudo tee -a /etc/hosts

• 确保 Harbor 的证书文件（如 harbor.host3.cert）已存于目标主机

#jenkins挂载目录
docker volume inspect jenkins-docker-certs#确保 Harbor 的证书文件（如 harbor.host3.cert）已存于宿主机的 /etc/docker/certs.d/harbor.host3/ca.crt,,
sudo scp root@harbor.host3:/opt/harbor/certs/ca.crt /etc/docker/certs.d/harbor.host3/#构建时报错需添加为.pem
sudo scp root@harbor.host3:/opt/harbor/certs/ca.crt /var/lib/docker/volumes/jenkins-docker-certs/_data/ca.pem

1.1 配置Docker信任Harbor仓库（所有主机）

# 在host0/host1/host2上执行
sudo tee /etc/docker/daemon.json <<-'EOF'
{"registry-mirrors": ["https://docker.1ms.run","https://docker.mybacc.com","https://dytt.online","https://lispy.org","https://docker.xiaogenban1993.com","https://docker.yomansunter.com","https://aicarbon.xyz","https://666860.xyz","https://docker.zhai.cm","https://a.ussh.net","https://hub.littlediary.cn","https://hub.rat.dev","https://docker.m.daocloud.io"],"insecure-registries": ["https://harbor.host3"]
}
EOFsudo systemctl daemon-reload
sudo systemctl restart docker

1.2 Jenkins添加凭证（host0 Jenkins网页）

1. 访问 http://host0:8080

2. Dashboard -> 系统管理 -> 插件管理-> 选择 Available plugins

   • 安装插件 Ansible plugin, Git Plugin , GitHub API Plugin
     

3. 左侧菜单点击 Manage Jenkins -> Credentials -> System -> Global credentials

   

4. 点击 Add Credentials

   • harbor凭证

     • Kind: Username with password

     • ID: harbor-creds

     • Username: [你的Harbor用户名]

     • Password: [你的Harbor密码]

   • git凭证

     • Kind: Username with password
     • Username: 你的 Gitee 用户名
     • Password: 你的 Gitee 密码或 Token
     • ID: gitee-creds
     • ashboard–>系统管理–>全局工具配置
       • 勾选自动安装 -->保存

1.3 准备Git仓库

部署的项目来自github-RuoYi: yangzongzhuan/RuoYi

可克隆我的Gitee来获取:

git clone https://gitee.com/xbd_zc/rytest.git

将以下文件推送到Git仓库：

tree├── deploy.yml
├── docker-compose.yml
├── Jenkinsfile
├── mysql
│   ├── conf
│   │   └── my.cnf
│   ├── Dockerfile
│   ├── init
│   │   ├── 01-init.sql
│   │   ├── 02-quartz.sql
│   │   └── 03-ry_20250416.sql
│   └── runmysql.sh
└── tomcat9├── conf│   ├── context.xml│   └── server.xml├── Dockerfile├── runtomcat.sh├── tomcat│   └── apache-tomcat-9.0.82.tar.gz└── war└── ruoyi-admin-docker.war

• Dockerfile（tomcat/mysql）
• docker-compose.yml
• Jenkinsfile
• ansible-playbook（deploy.yml）

#初始化项目
git init 
#码云复制的路径，将本地仓库和码 云上的仓库关联起来
git remote add origin https://gitee.com/xx/xx.git
#将远程仓库pull到本地仓库
git pull origin master
#将所有的文件都添加进去，也可以选择使用git add + 文件名 提交具体的某个文件。
git add . 
#‘内容描述’ 提交时的描述
git commit -m "first create" 
#推送到远程仓库（也就是码云上）
git push origin master #配置ssh协议认证
#1生成SSH密钥
ssh-keygen -t ed25519 -C "your_email@qq.com"
按提示生成密钥对（默认路径为 ~/.ssh/id_ed25519 和 ~/.ssh/id_ed25519.pub）34。
cat ~/.ssh/id_ed25519.pub
#2添加公钥到Gitee账户‌
将公钥文件（id_ed25519.pub）内容复制到Gitee的 ‌SSH公钥管理‌ 页面并保存6。#3修改远程仓库协议为SSH‌
检查当前远程地址是否为HTTPS：
git remote -v
若为HTTPS格式，修改为SSH协议地址：
git remote set-url origin git@gitee.com:用户名/仓库名.git
此后push时将自动使用SSH密钥认证，无需输入账号密码

二：流水线配置（host0）

任务步骤

1. 开发人员提交代码到Git仓库
2. Jenkins触发构建任务
3. 构建成功后自动推送镜像到Harbor
4. 触发Ansible Playbook进行滚动部署

2.1 创建Pipeline任务

1. Dashboard -> 新建任务 -> 输入名称 image-builder -> 选择 流水线

2. Pipeline 配置：

   • 流水线

     • Definition 定义: 选择 : Pipeline script from SCM

     • SCM: Git

       • Repository URL: [你的Git仓库地址]

       • Credentials: [选择Git仓库的凭证]

         • 没有可添加

   • Script Path 脚本路径: Jenkinsfile

---

2.2 配置Ansible Inventory

# host0上操作
sudo tee /etc/ansible/hosts <<-'EOF'
[webservers]
host1 ansible_host=192.168.0.221 ansible_user=root
host2 ansible_host=192.168.0.222 ansible_user=root
EOF

2.3 配置SSH免密登录

# host0上操作
ssh-keygen -t rsa
ssh-copy-id root@host1
ssh-copy-id root@host2

2.4 编写Ansible Playbook

harbor拉取镜像后启动容器

# deploy.yml
- hosts: webserverstasks:- name: Login Harborshell: docker login -u {{ harbor_user }} -p {{ harbor_password }} harbor.host3- name: Pull imagesshell: |docker pull harbor.host3/ruoyi/ry-tomcat:{{ build_number }}docker pull harbor.host3/ruoyi/ry-mysql:{{ build_number }}- name: Stop old containersshell: |docker stop ry-tomcat || truedocker stop ry-mysql || truedocker rm ry-tomcat || truedocker rm ry-mysql || true- name: Create app directory with permissionsfile:path: /opt/appstate: directoryowner: rootgroup: rootmode: '0755'- name: Copy docker-compose.ymlcopy:src: "docker-compose.yml"dest: /opt/app/docker-compose.ymlbackup: yes- name: Ensure docker-compose.yml existsstat:path: /opt/app/docker-compose.ymlregister: compose_file- name: Fail if docker-compose.yml does not existfail:msg: "docker-compose.yml not found at /path/to/docker-compose.yml"when: not compose_file.stat.exists- name: Start new containersshell: |export TAG={{ build_number }}docker compose -f /opt/app/docker-compose.yml  downdocker compose -f /opt/app/docker-compose.yml  up -d

2.5 Jenkinsfile内容

pipeline {agent anyenvironment {HARBOR_URL = "harbor.host3"PROJECT_NAME = "ruoyi"// 添加 IMAGE_TAG 定义（使用 BUILD_NUMBER 或自定义值）IMAGE_TAG = "${BUILD_NUMBER}"}stages {// 阶段 1：构建镜像stage('Build Images') {steps {script {docker.withRegistry("https://${HARBOR_URL}", 'harbor-creds') {// 构建 Tomcat 镜像def tomcatImage = docker.build("${HARBOR_URL}/${PROJECT_NAME}/ry-tomcat:${IMAGE_TAG}",'./tomcat9')tomcatImage.push()// 构建 MySQL 镜像def mysqlImage = docker.build("${HARBOR_URL}/${PROJECT_NAME}/ry-mysql:${IMAGE_TAG}",'./mysql')mysqlImage.push()} // 闭合 docker.withRegistry} // 闭合 script} // 闭合 steps} // 闭合 stage('Build Images')// 阶段 2：部署stage('Deploy') {steps {ansiblePlaybook(playbook: 'deploy.yml',         // Ansible Playbook 路径inventory: '/etc/ansible/hosts', // Ansible Inventory 文件extras: '-e ansible_ssh_private_key_file=/root/.ssh/id_rsa',  // 指定私钥路径extraVars: [harbor_user: 'admin',harbor_password: 'Harbor12345',build_number: "${BUILD_NUMBER}"],installation: 'Auto-Install-Ansible'  // 引用全局工具名称)} // 闭合 steps} // 闭合 stage('Deploy')} // 闭合 stages
} // 闭合 pipeline

2.6 执行流水线imag-builder

Dashboard --> image-builder --> 立即构建

• 可在构建的任务重查看日志Console Output

最后成功Console Output应输出一下内容

Started by user xbdzc
Obtained Jenkinsfile from git https://gitee.com/xbd_zc/rytest.git
[Pipeline] Start of Pipeline
[Pipeline] node
Running on Jenkins in /var/jenkins_home/workspace/image-builder
[Pipeline] {
[Pipeline] stage
[Pipeline] { (Declarative: Checkout SCM)
[Pipeline] checkout
The recommended git tool is: git
using credential gitee-creds> git rev-parse --resolve-git-dir /var/jenkins_home/workspace/image-builder/.git # timeout=10
Fetching changes from the remote Git repository> git config remote.origin.url https://gitee.com/xbd_zc/rytest.git # timeout=10
Fetching upstream changes from https://gitee.com/xbd_zc/rytest.git> git --version # timeout=10> git --version # 'git version 2.39.5'
using GIT_ASKPASS to set credentials xbdzc-passwd> git fetch --tags --force --progress -- https://gitee.com/xbd_zc/rytest.git +refs/heads/*:refs/remotes/origin/* # timeout=10> git rev-parse refs/remotes/origin/master^{commit} # timeout=10
Checking out Revision b3d95a777b4fa27956fa864ce008527296196630 (refs/remotes/origin/master)> git config core.sparsecheckout # timeout=10> git checkout -f b3d95a777b4fa27956fa864ce008527296196630 # timeout=10
Commit message: "update compose"> git rev-list --no-walk cd6d562fb8aa4472ecfa32177959752d75f371d8 # timeout=10
[Pipeline] }
[Pipeline] // stage
[Pipeline] withEnv
[Pipeline] {
[Pipeline] withEnv
[Pipeline] {
[Pipeline] stage
[Pipeline] { (Build Images)
[Pipeline] script
[Pipeline] {
[Pipeline] withEnv
[Pipeline] {
[Pipeline] withDockerRegistry
Using the existing docker config file.
Removing blacklisted property: auths
$ docker login -u admin -p ******** https://harbor.host3
WARNING! Using --password via the CLI is insecure. Use --password-stdin.WARNING! Your credentials are stored unencrypted in '/var/jenkins_home/workspace/image-builder@tmp/3425a5d5-afa6-4967-ac2a-891cbc224086/config.json'.
Configure a credential helper to remove this warning. See
https://docs.docker.com/go/credential-store/Login Succeeded
[Pipeline] {
[Pipeline] isUnix
[Pipeline] withEnv
[Pipeline] {
[Pipeline] sh
+ docker build -t harbor.host3/ruoyi/ry-tomcat:39 ./tomcat9
#0 building with "default" instance using docker driver#1 [internal] load build definition from Dockerfile
#1 transferring dockerfile: 773B done
#1 DONE 0.0s#2 [internal] load metadata for docker.io/library/eclipse-temurin:8-jre-jammy
#2 DONE 3.6s#3 [internal] load .dockerignore
#3 transferring context: 2B done
#3 DONE 0.0s#4 [1/6] FROM docker.io/library/eclipse-temurin:8-jre-jammy@sha256:d45584c02ee4da09862673207d57121049b89eb99d2a3415573efc0530a87e61
#4 DONE 0.0s#5 [internal] load build context
#5 transferring context: 89.77MB 0.3s done
#5 DONE 0.3s#6 [3/6] RUN mkdir -p "/opt/tomcat" &&     tar xzvf /tmp/tomcat.tar.gz -C /opt/tomcat --strip-components=1 &&     rm -rf /tmp/tomcat.tar.gz /opt/tomcat/webapps/*
#6 CACHED#7 [4/6] COPY conf/server.xml /opt/tomcat/conf/
#7 CACHED#8 [5/6] COPY conf/context.xml /opt/tomcat/conf/
#8 CACHED#9 [2/6] COPY tomcat/apache-tomcat-9.0.82.tar.gz /tmp/tomcat.tar.gz
#9 CACHED#10 [6/6] COPY war/ruoyi-admin-docker.war /opt/tomcat/webapps/ROOT.war
#10 CACHED#11 exporting to image
#11 exporting layers done
#11 writing image sha256:e1157c41978f859e8f9ca9c631b635c2b694a156a9f127f9efb94904e5dccc9f done
#11 naming to harbor.host3/ruoyi/ry-tomcat:39 done
#11 DONE 0.0s
[Pipeline] }
[Pipeline] // withEnv
[Pipeline] isUnix
[Pipeline] withEnv
[Pipeline] {
[Pipeline] sh
+ docker tag harbor.host3/ruoyi/ry-tomcat:39 harbor.host3/ruoyi/ry-tomcat:39
[Pipeline] }
[Pipeline] // withEnv
[Pipeline] isUnix
[Pipeline] withEnv
[Pipeline] {
[Pipeline] sh
+ docker push harbor.host3/ruoyi/ry-tomcat:39
The push refers to repository [harbor.host3/ruoyi/ry-tomcat]
be3aaabe879b: Preparing
3180fdaa6749: Preparing
b7e66be23a97: Preparing
7700871d37e6: Preparing
abd6fe352750: Preparing
77f2daad0e52: Preparing
b31e18c35f3d: Preparing
735b0864b65b: Preparing
06dd982b4145: Preparing
346f14bf17b9: Preparing
77f2daad0e52: Waiting
b31e18c35f3d: Waiting
735b0864b65b: Waiting
06dd982b4145: Waiting
346f14bf17b9: Waiting
b7e66be23a97: Layer already exists
abd6fe352750: Layer already exists
3180fdaa6749: Layer already exists
7700871d37e6: Layer already exists
b31e18c35f3d: Layer already exists
be3aaabe879b: Layer already exists
77f2daad0e52: Layer already exists
735b0864b65b: Layer already exists
06dd982b4145: Layer already exists
346f14bf17b9: Layer already exists
39: digest: sha256:be702d8f76de44a3da0a1a8f9b3763531f1c82f5ac1b8b0c32c52cec6c5f424c size: 2419
[Pipeline] }
[Pipeline] // withEnv
[Pipeline] isUnix
[Pipeline] withEnv
[Pipeline] {
[Pipeline] sh
+ docker build -t harbor.host3/ruoyi/ry-mysql:39 ./mysql
#0 building with "default" instance using docker driver#1 [internal] load build definition from Dockerfile
#1 transferring dockerfile:
#1 transferring dockerfile: 777B done
#1 DONE 0.2s#2 [internal] load metadata for docker.io/library/mysql:5.7
#2 DONE 2.7s#3 [internal] load .dockerignore
#3 transferring context: 2B done
#3 DONE 0.1s#4 [1/5] FROM docker.io/library/mysql:5.7@sha256:4bc6bc963e6d8443453676cae56536f4b8156d78bae03c0145cbe47c2aad73bb
#4 DONE 0.0s#5 [internal] load build context
#5 transferring context: 74.34kB done
#5 DONE 0.1s#6 [2/5] RUN ln -snf /usr/share/zoneinfo/Asia/Shanghai /etc/localtime && echo Asia/Shanghai > /etc/timezone
#6 CACHED#7 [3/5] COPY conf/my.cnf /etc/mysql/conf.d/
#7 CACHED#8 [4/5] RUN chmod 644 /etc/mysql/conf.d/my.cnf
#8 CACHED#9 [5/5] COPY init/*.sql /docker-entrypoint-initdb.d/
#9 CACHED#10 exporting to image
#10 exporting layers done
#10 writing image sha256:e41ca592aefc8dd1e70ed6926f764d560bbf812e811af16f0a8d854a2fd7010e done
#10 naming to harbor.host3/ruoyi/ry-mysql:39 done
#10 DONE 0.0s
[Pipeline] }
[Pipeline] // withEnv
[Pipeline] isUnix
[Pipeline] withEnv
[Pipeline] {
[Pipeline] sh
+ docker tag harbor.host3/ruoyi/ry-mysql:39 harbor.host3/ruoyi/ry-mysql:39
[Pipeline] }
[Pipeline] // withEnv
[Pipeline] isUnix
[Pipeline] withEnv
[Pipeline] {
[Pipeline] sh
+ docker push harbor.host3/ruoyi/ry-mysql:39
The push refers to repository [harbor.host3/ruoyi/ry-mysql]
f1f76fda4403: Preparing
8664e10de2b4: Preparing
300d02752ddc: Preparing
bf6dd8c03784: Preparing
441e16cac4fe: Preparing
73cb62467b8f: Preparing
337ec6bae222: Preparing
532b66f4569d: Preparing
0d9e9a9ce9e4: Preparing
4555572a6bb2: Preparing
8527ccd6bd85: Preparing
d76a5f910f6b: Preparing
8b2952eb02aa: Preparing
7ff7abf4911b: Preparing
cff044e18624: Preparing
73cb62467b8f: Waiting
337ec6bae222: Waiting
532b66f4569d: Waiting
0d9e9a9ce9e4: Waiting
4555572a6bb2: Waiting
8527ccd6bd85: Waiting
d76a5f910f6b: Waiting
8b2952eb02aa: Waiting
7ff7abf4911b: Waiting
cff044e18624: Waiting
441e16cac4fe: Layer already exists
8664e10de2b4: Layer already exists
300d02752ddc: Layer already exists
bf6dd8c03784: Layer already exists
f1f76fda4403: Layer already exists
73cb62467b8f: Layer already exists
0d9e9a9ce9e4: Layer already exists
337ec6bae222: Layer already exists
532b66f4569d: Layer already exists
4555572a6bb2: Layer already exists
7ff7abf4911b: Layer already exists
8527ccd6bd85: Layer already exists
8b2952eb02aa: Layer already exists
d76a5f910f6b: Layer already exists
cff044e18624: Layer already exists
39: digest: sha256:bdd554f007c7cf0af8a9d320e9b711e4f7a2cc32e1ed49e3ed5a7360881b69bc size: 3448
[Pipeline] }
[Pipeline] // withEnv
[Pipeline] }
[Pipeline] // withDockerRegistry
[Pipeline] }
[Pipeline] // withEnv
[Pipeline] }
[Pipeline] // script
[Pipeline] }
[Pipeline] // stage
[Pipeline] stage
[Pipeline] { (Deploy)
[Pipeline] ansiblePlaybook
[image-builder] $ ansible-playbook deploy.yml -i /etc/ansible/hosts -e ******** -e ******** -e ******** -e ansible_ssh_private_key_file=/root/.ssh/id_rsaPLAY [webservers] **************************************************************TASK [Gathering Facts] *********************************************************
ok: [host1]
ok: [host2]TASK [Login Harbor] ************************************************************
changed: [host1]
changed: [host2]TASK [Pull images] *************************************************************
changed: [host1]
changed: [host2]TASK [Stop old containers] *****************************************************
changed: [host2]
changed: [host1]TASK [Create app directory with permissions] ***********************************
ok: [host2]
ok: [host1]TASK [Copy docker-compose.yml] *************************************************
changed: [host1]
changed: [host2]TASK [Ensure docker-compose.yml exists] ****************************************
ok: [host2]
ok: [host1]TASK [Fail if docker-compose.yml does not exist] *******************************
skipping: [host1]
skipping: [host2]TASK [Start new containers] ****************************************************
changed: [host1]
changed: [host2]PLAY RECAP *********************************************************************
host1                      : ok=8    changed=5    unreachable=0    failed=0    skipped=1    rescued=0    ignored=0   
host2                      : ok=8    changed=5    unreachable=0    failed=0    skipped=1    rescued=0    ignored=0   [Pipeline] }
[Pipeline] // stage
[Pipeline] }
[Pipeline] // withEnv
[Pipeline] }
[Pipeline] // withEnv
[Pipeline] }
[Pipeline] // node
[Pipeline] End of Pipeline
Finished: SUCCESS

---

访问测试

host1登录若依系统

host2-登录若依系统

---

三 常见问题

Jenkins容器内工作目录/var/jenkins_home/workspace/image-builder

排查问题可进入容器测试遇到的问题

docker exec -it jenkins-blueocean bash
cd /var/jenkins_home/workspace/image-builder #此目录下应有从git拉取的文件

---

git连接和权限问题

报错 fatal: not in a git directory 表明 Jenkins 任务执行时 未在 Git 仓库目录中操作，可能由以下原因导致：

1. Jenkins 任务未正确克隆仓库：Git 仓库未成功拉取到工作目录。
2. 权限问题：容器内用户对工作目录无读写权限。
3. Docker 组配置残留影响：之前的 --group-add 参数可能干扰了容器用户组。

# 在宿主机host0执行，确保 Jenkins 数据卷权限正确
docker run --rm -v jenkins-data:/var/jenkins_home alpine \chown -R 1000:1000 /var/jenkins_home
#进入容器执行git命令
docker exec -it jenkins-blueocean bash
cd /var/jenkins_home/workspace/image-builder
git config --global --add safe.directory '*'  # 忽略目录安全警告
git clone https://gitee.com/xbd_zc/rytest.git
# 预期输出：成功克隆仓库

1. Git 安全机制升级：Git 2.35.2+ 引入了 safe.directory 检查，防止在非信任目录执行操作（避免恶意脚本攻击）。

2. 用户权限变化：

   • 旧启动参数中 Jenkins 可能以 jenkins 用户运行（UID=1000），工作目录所有权为 1000:1000。
   • 新参数以 root 用户运行，工作目录所有权可能变为 0:0（root），Git 会认为目录不安全。

3. 安全目录匹配规则：

   • Git 默认只信任与当前用户匹配的目录所有权。
   • 以 root 用户操作非 root 所有的目录时需显式声明安全。

   # 全局信任所有目录
   git config --global --add safe.directory '*'# 或仅信任 Jenkins 工作目录
   git config --global --add safe.directory /var/jenkins_home/workspace/image-builder
   

---

harbor证书问题 ERROR: Could not find credentials matching harbor-creds

在 Jenkins 中添加 Harbor 凭证

Dashboard–>系统管理–>凭据–>系统–>全局凭据 (unrestricted) -->New credentials

1. 点击 Add Credentials。

2. 按以下参数填写：

   字段	值
   Scope范围	Global全局
   Username用户名	你的 Harbor 用户名（如 admin）
   Password密码	你的 Harbor 密码 (如Harbor12345)
   ID	harbor-creds（必须与 Jenkinsfile 中一致）

手动测试(host0)

docker exec -it jenkins-blueocean bash
docker login harbor.host3 -u admin -p Harbor12345

• 成功输出：Login Succeeded。

• 失败处理：可能报错: x509: certificate signed by unknown authority

  • 检查 Harbor 地址是否正确（harbor.host3 是否可解析）。

  • 检查 Docker 是否信任 Harbor 仓库（参考阶段一中的 insecure-registries 配置）。

    #在 host0/host1/host2 上配置 Docker 信任 Harbor 的 CA 证书：
    sudo scp root@harbor.host3:/opt/harbor/certs/ca.crt /etc/docker/certs.d/harbor.host3/
    sudo systemctl restart docker
    # 进入容器检查证书路径,应看到 ca.crt 文件
    docker exec jenkins-blueocean ls -l /etc/docker/certs.d/harbor.host3/
    

---

Jenkins容器无法操作Docker的权限报错

报错 permission denied while trying to connect to the Docker daemon socket 表示 Jenkins 容器内的用户无权访问宿主机的 Docker Socket。根本原因是：

宿主机上的 /var/run/docker.sock 文件权限不足。

#查看Jenkins启动容器命令# 停止并删除旧容器
docker stop jenkins-blueocean
docker rm jenkins-blueoceandocker run --name jenkins-blueocean --restart=on-failure --detach \
--user root \
--publish 8080:8080 --publish 50000:50000 \
--volume jenkins-data:/var/jenkins_home \
--volume /var/run/docker.sock:/var/run/docker.sock \
--volume /etc/docker/certs.d:/etc/docker/certs.d:ro \
--volume /etc/ansible/hosts:/etc/ansible/hosts:ro \
--volume ~/.ssh/id_rsa:/root/.ssh/id_rsa \
--volume ~/.ssh/known_hosts:/root/.ssh/known_hosts:ro \
--add-host=harbor.host3:192.168.0.223 \
myjenkins-ansible

• 使用root测试 : --user root
• 挂载docker.sock文件

Jenkins Ansible和Ansible插件问题

Jenkins Pipeline 中的命令是在 容器内 执行的，因此必须在容器内安装 Ansible。

未安装会报错**No such file or directory**

#启动容器时动态安装
docker exec -it jenkins-blueocean bash
apt-get update && apt-get install -y ansible
exit
缺点：容器重启后需重新安装。固化到镜像（永久生效）
修改 Dockerfile：dockerfile
FROM myjenkins-blueocean:2.504.1-1
USER root
# 配置 Git 安全目录
RUN git config --global --add safe.directory '*'
# 可选：安装其他工具（如 Ansible）
RUN apt-get update && apt-get install -y ansible
USER jenkins  # 切换回原用户（如果基础镜像是非 root）

一、Jenkins Ansible 插件自动安装机制解析

1. 插件能力：
   Ansible 插件本身 不直接安装 Ansible，但允许通过 “Installers” 配置安装逻辑（如执行 Shell 脚本或使用包管理器）。
2. 核心步骤：
   • 在 Jenkins 全局工具中定义 Ansible 安装方式。
   • 在 Pipeline 中指定使用该工具，触发自动安装。

---

二、配置 Ansible 自动安装

步骤1：进入全局工具配置

1. 访问 http://host0:8080/configureTools/。
2. 找到 Ansible 部分，点击 新增 Ansible。

步骤2：配置自动安装器

# 示例配置（根据你的环境调整）
Name: Auto-Install-Ansible  # 自定义名称
Installers:- 选择 "Run shell command"- Command:# 适用于 Debian/Ubuntu 容器apt-get update && apt-get install -y ansible# 或使用 pip 安装# pip3 install ansible-core

步骤3：验证安装路径

• Path to ansible-playbook executable: /usr/bin/ansible-playbook（默认 APT 安装路径）

---

三、修改 Jenkinsfile 触发自动安装

更新部署阶段代码

stage('Deploy') {steps {ansiblePlaybook(playbook: 'deploy.yml',inventory: '/etc/ansible/hosts',extraVars: [harbor_user: 'admin',harbor_password: 'Harbor12345',build_number: "${BUILD_NUMBER}"],installation: 'Auto-Install-Ansible'  // 引用全局工具名称)}
}

Ansible Inventory 管理和 容器内 SSH 连接问题

一、自动管理 Ansible Inventory 文件

方案1：挂载宿主机 Inventory 到容器

# 宿主机 Inventory 路径：/home/user/ansible/hosts
docker run ... \--volume /home/user/ansible/hosts:/etc/ansible/hosts:ro \myjenkins-blueocean:latest

验证：

docker exec jenkins-blueocean cat /etc/ansible/hosts

方案2：动态生成 Inventory 文件

在 Jenkins Pipeline 中动态创建：

stage('Prepare Inventory') {steps {sh '''echo "[webservers]" > inventoryecho "host1 ansible_host=192.168.0.101" >> inventoryecho "host2 ansible_host=192.168.0.102" >> inventory'''}
}
stage('Deploy') {steps {ansiblePlaybook(playbook: 'deploy.yml',inventory: 'inventory',  // 使用动态生成的文件// ...)}
}

---

二、解决 SSH Host Key 验证失败

1. 禁用 Host Key 检查（仅限测试环境）

在 ansible.cfg 或 Playbook 中配置：

# ansible.cfg
[defaults]
host_key_checking = False

或在 Jenkinsfile 中传递参数：

ansiblePlaybook(extras: '-e ansible_ssh_common_args="-o StrictHostKeyChecking=no"'
)

2. 挂载宿主机的 known_hosts 文件

docker run ... \--volume ~/.ssh/known_hosts:/root/.ssh/known_hosts:ro \myjenkins-blueocean:latest

3. 预配置 known_hosts

在容器构建阶段添加目标主机指纹：

FROM myjenkins-blueocean:2.504.1-1
RUN mkdir -p /root/.ssh && \ssh-keyscan host1 host2 >> /root/.ssh/known_hosts

---

三、完整操作流程

步骤1：准备 Inventory 和 SSH 配置

1. 宿主机 Inventory 文件 /home/user/ansible/hosts：

   [webservers]
   host1 ansible_host=192.168.0.101 ansible_user=root
   host2 ansible_host=192.168.0.102 ansible_user=root
   

2. 挂载 Inventory 和 SSH 密钥：

   docker run --name jenkins-ansible \--volume /home/user/ansible/hosts:/etc/ansible/hosts:ro \--volume ~/.ssh/id_rsa:/root/.ssh/id_rsa \--volume ~/.ssh/known_hosts:/root/.ssh/known_hosts:ro \myjenkins-blueocean:latest
   

步骤2：调整 Jenkinsfile

stage('Deploy') {steps {ansiblePlaybook(playbook: 'deploy.yml',inventory: '/etc/ansible/hosts',extras: '-e ansible_ssh_private_key_file=/root/.ssh/id_rsa',  // 指定私钥路径installation: 'Auto-Install-Ansible')}
}

步骤3：验证 SSH 连接

# 在容器内手动测试
docker exec -it jenkins-ansible bash
ansible webservers -m ping
# 预期输出：pong

---

四、关键错误排查

错误：Permission denied (publickey)

• 原因：SSH 私钥权限过宽或路径错误。

• 修复：

  # 容器内执行
  chmod 600 /root/.ssh/id_rsa
  

错误：No such file or directory

• 原因：Inventory 文件路径错误。

• 修复：

  // 确认 inventory 参数路径
  inventory: '/etc/ansible/hosts'
  

---

五、自动化优化建议

1. 使用 Ansible Vault 管理敏感变量：

   ansible-vault encrypt secrets.yml
   

   ansiblePlaybook(extras: '--ask-vault-pass -e @secrets.yml'
   )
   

2. 动态 Inventory 脚本：

   stage('Generate Inventory') {steps {writeFile file: 'inventory', text: """[webservers]${env.HOST1_IP}${env.HOST2_IP}"""}
   }
   

---

可使用 ansible xxx -vvv 调试输出。, 进入容器执行测试

#进入容器
docker exec -it jenkins-blueocean bash
cd /var/jenkins_home/workspace/image-builderansible-playbook deploy.yml -i /etc/ansible/hosts -e harbor_user='admin' -e harbor_password='Harbor12345' -e build_number="36" -e ansible_ssh_private_key_file=/root/.ssh/id_rsa -vvv