【DevOps】Jenkins 集成Docker

发布于:2024-05-06 ⋅ 阅读:(25) ⋅ 点赞:(0)

目录

1. 安装 Docker 和 Jenkins

2. 在 Jenkins 中安装 Docker 插件

3. 配置 Docker 连接

4. 创建 Jenkins Pipeline

5. 示例 Pipeline 脚本

6. 运行 Jenkins Job

7. 扩展功能

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


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

1. 安装 Docker 和 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 的连接,确保问题已经解决。