dockerExecute 函数和docker.build的区别解析

 更新时间:2024年12月19日 15:04:33   作者:Rhys..  
dockerExecute 通常是一个自定义的函数或者由特定的 Jenkins 库(如 piper-lib)提供,用于在 Docker 容器中执行特定的命令,这篇文章主要介绍了dockerExecute 函数和docker.build的区别,需要的朋友可以参考下

一、dockerExecute介绍

dockerExecute 通常是一个自定义的函数或者由特定的 Jenkins 库(如 piper-lib)提供,用于在 Docker 容器中执行特定的命令。这类函数可以帮助在构建或测试阶段管理 Docker 容器的生命周期,确保步骤在容器内运行。它的作用是启动一个 Docker 容器,并在该容器中执行提供的命令.

1、使用场景:

  • 执行需要隔离环境的任务:当你需要在指定的 Docker 容器中运行特定的命令,例如运行测试脚本、构建项目等。
  • 保证环境一致性:确保在一个隔离的、标准化的 Docker 容器中运行任务,从而消除环境差异带来的问题。
  • 动态设置:允许对容器的配置进行更细粒度的控制,如动态设置环境变量、挂载卷等。

2、dockerexecute方法的使用介绍

因为我的测试背景正好是 公司内部的 Docker 镜像存储库中的有一个现成的专用于测试的镜像;所以我直接在这个pipline脚本中去运用了这个方法,给大家看个例子顺便讲解一下:

stage('test') {
    node {
        dockerExecute(script: this,
        dockerImage: "your-docker-image",
        dockerName: 'your-docker-name'{
// 在 Docker 容器内部执行以下命令
                    sh '''
                        //例如安装依赖,设置环境变量,执行关键脚本等等
                        python main.py
                        '''
}

3、dockerExecute 接受的参数解释:

  • script: this:
    • this 传递给 script 参数。它通常用于在 dockerExecute 函数内部引用当前脚本或上下文。
  • dockerImage: "your-docker-image",
    • 指定 Docker 镜像的名称。这个镜像往往包含了你所需要的环境(例如特定版本的 Python 及相关工具和依赖)。
  • dockerName: 'your-docker-name'
    • 设置 Docker 容器的名称。这有助于在 Jenkins 日志和其他地方识别运行的容器。

作用总结

  • 在指定的 Docker 镜像基础上启动一个 Docker 容器。
  • 参数 script: this 引用当前脚本上下文。
  • 参数 dockerImage 指定要使用的 Docker 镜像。
  • 参数 dockerName 为启动的容器命名。

二、docker.build介绍

docker.build 是 Jenkins 的 Docker 插件提供的一个方法,用于构建 Docker 镜像。它会读取当前目录下的 Dockerfile 并构建一个新的 Docker 镜像,有助于将你的应用和所有的依赖封装到一个标准的镜像中。

1、使用场景:

  • 构建新的 Docker 镜像:当你需要基于 Dockerfile 构建一个新的 Docker 镜像时使用。
  • 版本控制和部署:将应用打包成 Docker 镜像,作为 CI/CD 流程的一部分提交到 Docker Registry 或用于部署。

2、结合使用

  • 典型的工作流可能涉及先用 docker.build 构建镜像,然后用该镜像运行某些任务,如测试套件。

3、定义场景

  • 假设你有一个 Python 项目,你想要构建并在 Docker 容器中运行测试。
  • 你需要在项目根目录下创建一个Jenkinsfile和一个dockerfile

(1)dockerfile示例:

# 使用已有基础镜像
FROM your-docker-image
# 设置工作目录
WORKDIR /web-test
# 安装系统依赖包括 chromedriver 和 google-chrome
RUN apt-get update && apt-get install -y \
    xvfb \
    x11-utils \
    libgl1-mesa-glx \
    wget \
    unzip \
    curl \
    gnupg \
    && apt-get clean \
    && rm -rf /var/lib/apt/lists/*
# 安装 chromedriver
RUN wget -O /tmp/chromedriver.zip https://chromedriver.storage.googleapis.com/113.0.5672.63/chromedriver_linux64.zip \
    && unzip /tmp/chromedriver.zip -d /usr/local/bin/ \
    && rm /tmp/chromedriver.zip
# 下载并安装 google-chrome
RUN wget -O /tmp/google-chrome.deb https://dl.google.com/linux/direct/google-chrome-stable_current_amd64.deb \
    && apt-get update && apt-get install -y --no-install-recommends /tmp/google-chrome.deb \
    && rm /tmp/google-chrome.deb
# 将 requirements.txt 复制到工作目录
COPY requirements.txt .
# 安装 Python 依赖
RUN pip install --no-cache-dir -r requirements.txt
# 将项目文件复制到工作目录
COPY . .
# 设置环境变量
ENV DISPLAY=:99
# 启动 Xvfb 并运行应用
CMD Xvfb :99 -screen 0 1920x1080x24 & python PANA/GenerateReport.py

(2)Jenkinsfile示例:

@Library(["piper-lib", "piper-lib-os"]) _
pipeline {
    agent any
    stages {
        stage('checkout') {
            steps {
                checkout scm
            }
        }
        stage('build-image') {
            steps {
                script {
                    // 使用当前目录下的 Dockerfile 构建新的 Docker 镜像
                    docker.build('my-repo/my-python-app:latest', '-f Dockerfile .')
                }
            }
        }
        stage('test') {
            steps {
                script {
                    dockerExecute(script: this,
                    dockerImage: "my-repo/my-python-app:latest",
                    dockerName: 'python') {
                        sh '''
                            set -e
                            # 设置 DISPLAY 环境变量
                            export DISPLAY=:99
                            # 启动 Xvfb 并在后台运行
                            Xvfb :99 -screen 0 1920x1080x24 &
                            # 等待 Xvfb 完全启动
                            sleep 5
                            # 打印 Python 版本信息
                            python --version
                            # 升级 pip
                            python -m pip install --upgrade pip
                            # 切换到工作目录
                            cd $WORKSPACE
                            # 安装 Python 依赖
                            python -m pip install -r requirements.txt
                            # 运行 Python 脚本
                            python PANA/GenerateReport.py
                            # 可选:确保完成后停止 Xvfb
                            killall Xvfb
                        '''
                    }
                }
            }
        }
    }
    post {
        always {
            echo 'Cleaning up...'
            // 放置任何清理步骤
        }
        success {
            echo 'Pipeline succeeded'
        }
        failure {
            echo 'Pipeline failed'
        }
    }
}

三、关键区别

1、构建与运行

  • docker.build: 用于构建 Docker 镜像,基于项目内的 Dockerfile。
  • dockerExecute: 用于在构建好的 Docker 镜像基础上运行命令。

2、具体用途

  • docker.build: 主要用于 CI 流程中的构建步骤,确保应用代码和依赖打包在一个镜像中。
  • dockerExecute: 用于在特定的 Docker 镜像中执行任务,适合用于测试、执行脚本等需要隔离环境的步骤。

到此这篇关于dockerExecute 函数和docker.build的区别的文章就介绍到这了,更多相关dockerExecute 函数和docker.build内容请搜索脚本之家以前的文章或继续浏览下面的相关文章希望大家以后多多支持脚本之家!

相关文章

  • Docker compose搭建ELK服务基本使用

    Docker compose搭建ELK服务基本使用

    这篇文章主要为大家介绍了Docker compose搭建ELK服务基本使用,有需要的朋友可以借鉴参考下,希望能够有所帮助,祝大家多多进步,早日升职加薪
    2023-03-03
  • 详解使用Docker进行Redis主从复制实践

    详解使用Docker进行Redis主从复制实践

    这篇文章主要介绍了详解使用Docker进行Redis主从复制实践,文中通过示例代码介绍的非常详细,对大家的学习或者工作具有一定的参考学习价值,需要的朋友们下面随着小编来一起学习学习吧
    2021-04-04
  • docker下载运行java项目的实现步骤

    docker下载运行java项目的实现步骤

    本文主要介绍了docker下载运行java项目的实现步骤,文中通过示例代码介绍的非常详细,对大家的学习或者工作具有一定的参考学习价值,需要的朋友们下面随着小编来一起学习学习吧
    2025-12-12
  • Docker 部署宝塔面板 Nginx 反向代理 502 踩坑实战指南

    Docker 部署宝塔面板 Nginx 反向代理 502 踩坑实战指南

    该文主要讨论了使用Docker部署宝塔面板时遇到的Nginx反向代理问题,错误在于将127.0.0.1作为宿主机端口,导致容器找不到服务;正确的做法是使用host.docker.internal,它可以访问到宿主机,喜欢的朋友跟随小编一起看看吧
    2026-03-03
  • 如何删除docker-register镜像及none无效镜像详解

    如何删除docker-register镜像及none无效镜像详解

    这篇文章主要给大家介绍了关于如何删除docker-register镜像及none无效镜像的相关资料,文中通过示例代码介绍的非常详细,对大家的学习或者工作具有一定的参考学习价值,需要的朋友们下面随着小编来一起学习学习吧。
    2017-09-09
  • Docker设置mysql不区分大小写问题

    Docker设置mysql不区分大小写问题

    这篇文章主要介绍了Docker设置mysql不区分大小写问题,具有很好的参考价值,希望对大家有所帮助,如有错误或未考虑完全的地方,望不吝赐教
    2024-01-01
  • Docker Windows最新版(4.17.x)修改镜像存储路径的详细步骤

    Docker Windows最新版(4.17.x)修改镜像存储路径的详细步骤

    这篇文章主要介绍了Docker WIndows最新版(4.17.x)修改镜像存储路径的步骤,本文给大家介绍的非常详细,对大家的学习或工作具有一定的参考借鉴价值,需要的朋友可以参考下
    2023-03-03
  • Docker可视化工具Portainer详解

    Docker可视化工具Portainer详解

    这篇文章主要介绍了Docker可视化工具Portainer使用及说明,具有很好的参考价值,希望对大家有所帮助,如有错误或未考虑完全的地方,望不吝赐教
    2026-06-06
  • Docker Compose实现秒级扩容的方法步骤

    Docker Compose实现秒级扩容的方法步骤

    本文主要介绍了Docker Compose实现秒级扩容的方法步骤,文中通过示例代码介绍的非常详细,对大家的学习或者工作具有一定的参考学习价值,需要的朋友们下面随着小编来一起学习学习吧
    2026-04-04
  • docker安装geoserver的方法步骤

    docker安装geoserver的方法步骤

    GeoServer是OGC Web服务器规范的J2EE实现,利用GeoServer可以方便地发布地图数据,本文主要介绍了docker安装geoserver的方法步骤,感兴趣的可以了解一下
    2024-08-08

最新评论