pipeline 配置agent docker

原创

mob649e81680b4f 2023-12-18 09:33:06 ©著作权

文章标签 Docker docker Jenkins 文章分类 Docker 云计算

©著作权归作者所有：来自51CTO博客作者mob649e81680b4f的原创作品，请联系作者获取转载授权，否则将追究法律责任

什么是Pipeline

[Pipeline]( 是 Jenkins 中一个功能强大且灵活的插件，它允许我们将持续集成和持续交付的流程定义为代码。利用Pipeline，我们可以通过将构建、测试和发布过程分解为多个步骤，并将这些步骤组合在一起，以实现一种高度可视化和可配置的方式运行和监视软件交付流程。

Agent 概述

在Pipeline中，Agent是指用于执行我们的构建流程的执行环境。Agent可以是Jenkins主服务器上的一个节点，也可以是通过SSH连接到远程服务器的节点。而在本文中，我们将介绍如何在Pipeline中配置使用Docker作为Agent，以提供可靠且可扩展的构建环境。

Docker 镜像

在配置Docker Agent之前，我们需要首先准备一个Docker镜像。Docker镜像是构建和运行Docker容器的基础。我们可以通过创建一个包含所需软件和依赖的镜像来定义我们的构建环境。

下面是一个简单的Dockerfile示例，它定义了一个基于Ubuntu 20.04的镜像，并安装了Java和Maven：

FROM ubuntu:20.04

RUN apt-get update && apt-get install -y openjdk-11-jdk maven

CMD ["bash"]

该Dockerfile首先基于Ubuntu 20.04创建一个新的镜像，然后使用apt-get命令安装了Java和Maven。最后，CMD ["bash"]命令指定了容器启动时要运行的默认命令。

Pipeline 配置

接下来，我们将通过Pipeline配置使用上述Docker镜像作为Agent。在Jenkins中，我们可以通过在Jenkinsfile中定义Pipeline来实现。

首先，我们需要在Jenkins中安装Pipeline插件。然后，在我们的代码仓库中创建一个名为Jenkinsfile的文件，并将以下内容添加到该文件中：

pipeline {
    agent {
        docker {
            image 'my-docker-image:latest'
            args '-v /var/run/docker.sock:/var/run/docker.sock'
        }
    }
    stages {
        stage('Build') {
            steps {
                sh 'mvn clean install'
            }
        }
        stage('Test') {
            steps {
                sh 'mvn test'
            }
        }
        stage('Deploy') {
            steps {
                sh 'mvn deploy'
            }
        }
    }
}

上述Pipeline中的agent块指定了使用Docker作为Agent，并使用my-docker-image:latest作为Docker镜像。还可以通过args参数传递额外的Docker参数，例如-v /var/run/docker.sock:/var/run/docker.sock用于在Docker容器中访问宿主机的Docker守护进程。

接下来，我们定义了三个阶段Build、Test和Deploy，每个阶段包含了要执行的步骤。在这个例子中，我们使用了sh命令来执行Maven命令来构建、测试和部署我们的项目。

类图

下面是一个简单的类图，展示了Pipeline中Agent配置的相关类：

classDiagram
    class Jenkinsfile {
        +agent
        +stages
    }
    class Agent {
        +docker
    }
    class Docker {
        -image
        -args
    }
    class Stage {
        +steps
    }
    class Step {
        +sh
    }

    Jenkinsfile -- Agent : has
    Agent -- Docker : has
    Docker -- Stage : has
    Stage -- Step : has