【DevOps】Jenkins 集成Docker

[1. 安装 Docker 和 Jenkins](#1. 安装 Docker 和 Jenkins)

[2. 在 Jenkins 中安装 Docker 插件](#2. 在 Jenkins 中安装 Docker 插件)

[3. 配置 Docker 连接](#3. 配置 Docker 连接)

[4. 创建 Jenkins Pipeline](#4. 创建 Jenkins Pipeline)

[5. 示例 Pipeline 脚本](#5. 示例 Pipeline 脚本)

[6. 运行 Jenkins Job](#6. 运行 Jenkins Job)

[7. 扩展功能](#7. 扩展功能)

8、docker配置测试连接的时候报错处理

将 Docker 与 Jenkins 集成可以实现持续集成和持续交付 (CI/CD) 流程的自动化，提高开发效率和软件质量。以下是详细的集成步骤：

1. 安装 Docker 和 Jenkins

Docker 安装: 请根据您的操作系统选择合适的安装方法，并确保 Docker 守护进程正在运行。具体过程可以参考我的博文《【DevOps】Docker安装和使用示例》
Jenkins 安装: 可以选择 war 包方式或使用 Docker 安装 Jenkins。具体可以参考我的博文《DevOps（四）在Ubuntu20.04和CentOS7安装Jenkins》

2. 在 Jenkins 中安装 Docker 插件

进入 Jenkins 管理界面，选择 "Manage Jenkins" -> "Manage Plugins"。
在 "Available" 标签页搜索 "Docker Pipeline" 和 "Docker Commons Plugin" 插件，并进行安装。

3. 配置 Docker 连接

进入 Jenkins 管理界面，选择 "Manage Jenkins" -> "Configure System"。
找到 "Cloud" 部分，点击 "Add a new cloud"，选择 "Docker"。
配置 Docker 主机的 URL（例如：unix:///var/run/docker.sock）。
测试连接是否成功。

可以配置多个 Docker 连接，例如用于开发、测试和生产环境。

4. 创建 Jenkins Pipeline

创建一个新的 Jenkins Job，选择 "Pipeline" 类型。
在 Pipeline 脚本中使用 Docker 插件提供的步骤来构建和运行 Docker 镜像。

5. 示例 Pipeline 脚本

pipeline {
    agent {
        docker {
            image 'maven:3-alpine' 
            args '-v /root/.m2:/root/.m2' 
        }
    }
    stages {
        stage('Build') {
            steps {
                sh 'mvn clean package' 
            }
        }
        stage('Test') {
            steps {
                sh 'mvn test' 
            }
        }
        stage('Deploy') {
            steps {
                sh 'docker build -t my-app . ' 
                sh 'docker run -d -p 8080:8080 my-app' 
            }
        }
    }
}

脚本解释:

agent : 指定 Jenkins Job 运行的环境，这里使用 Docker 镜像 maven:3-alpine。
args: 指定 Docker 容器启动参数，这里将本地 Maven 仓库挂载到容器中。
stages: 定义 Pipeline 的不同阶段，例如构建、测试和部署。
steps: 每个阶段包含具体的执行步骤，例如使用 Maven 构建项目、运行测试和构建 Docker 镜像。

6. 运行 Jenkins Job

保存 Pipeline 脚本并运行 Jenkins Job。
Jenkins 将会自动启动 Docker 容器，并在容器内执行构建、测试和部署步骤。

7. 扩展功能

可以使用 Docker Compose 运行多个容器的应用程序。
可以使用 Kubernetes 插件将应用程序部署到 Kubernetes 集群。
可以使用 Jenkins Shared Libraries 来共享 Pipeline 脚本和代码。

8、docker配置测试连接的时候报错处理

测试连接的时候报错了：java.io.IOException: com.sun.jna.LastErrorException: [13] Permission denied

这个错误通常表示 Jenkins 没有足够的权限访问 Docker 守护进程。要解决这个问题，你可以尝试以下几种方法：

将 Jenkins 用户添加到 docker 组：
- 在终端中执行以下命令，将 Jenkins 用户添加到 docker 组：
```
sudo usermod -aG docker jenkins
```
- 重启 Jenkins 服务，使更改生效：
```
sudo systemctl restart jenkins
```
使用 sudo 运行 Docker 命令：
- 在 Jenkins 系统配置页面（Manage Jenkins -> Configure System），找到 Docker 部分。
- 在 "Docker Host URI" 字段中，将值更改为：unix:///var/run/docker.sock
- 在 "Connect method" 部分，选择 "Connect with SSH"。
- 配置 SSH 的详细信息，如主机名、用户名和认证方式。
- 在 "Prefix Start Command" 字段中，输入 sudo，这将使 Jenkins 以 sudo 权限运行 Docker 命令。
修改 Docker 守护进程的配置：
- 编辑 Docker 守护进程的配置文件（通常位于 /etc/docker/daemon.json），添加以下内容：
```
{
  "group": "jenkins",
  "live-restore": true
}
```
- 重启 Docker 守护进程，使更改生效：
```
sudo systemctl restart docker
```
使用 TCP 连接而不是 Unix 套接字：
- 编辑 Docker 守护进程的配置文件（通常位于 /etc/docker/daemon.json），添加以下内容：
```
{
  "hosts": ["tcp://0.0.0.0:2375"]
}
```
- 重启 Docker 守护进程，使更改生效：
```
sudo systemctl restart docker
```
- 在 Jenkins 的 Docker 配置中，将 "Docker Host URI" 更改为：tcp://localhost:2375

请注意，上述方法可能会根据你的具体环境和安全要求而有所不同。在修改配置之前，请务必了解每个选项的安全隐患。

在进行任何更改后，请确保重启 Jenkins 和 Docker 守护进程，以使更改生效。然后，重新测试 Jenkins 与 Docker 的连接，确保问题已经解决。