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容器时间与宿主机不一致/宿主机时间不同步校验问题

    Docker容器时间与宿主机不一致/宿主机时间不同步校验问题

    在Docker容器中,若未单独配置localtime,可能导致时间与宿主机不一致,例如UTC与CST(东八区)相差8小时,解决方法包括在启动时通过docker run添加时间参数,使用Dockerfile设置,或通过docker-compose配置,对于已运行的容器
    2024-10-10
  • ubuntu如何查看docker容器占用的磁盘空间

    ubuntu如何查看docker容器占用的磁盘空间

    这篇文章主要介绍了ubuntu如何查看docker容器占用的磁盘空间问题,具有很好的参考价值,希望对大家有所帮助。如有错误或未考虑完全的地方,望不吝赐教
    2023-05-05
  • Docker安装Jenkins并部署Maven项目详细教程

    Docker安装Jenkins并部署Maven项目详细教程

    这篇文章主要给大家介绍了关于Docker安装Jenkins并部署Maven项目的相关资料,持续集成、持续交付不仅可以提示开发效率,还可以节省很多测试和运维的成本,需要的朋友可以参考下
    2023-12-12
  • 详解docker部署Jenkins新手使用教程

    详解docker部署Jenkins新手使用教程

    这篇文章主要介绍了详解docker部署Jenkins新手使用教程,文中通过示例代码介绍的非常详细,对大家的学习或者工作具有一定的参考学习价值,需要的朋友们下面随着小编来一起学习学习吧
    2020-10-10
  • docker中镜像映射和端口映射的实现步骤

    docker中镜像映射和端口映射的实现步骤

    本文介绍了在Docker中进行镜像映射和端口映射,文中通过示例代码介绍的非常详细,对大家的学习或者工作具有一定的参考学习价值,需要的朋友们下面随着小编来一起学习学习吧
    2024-11-11
  • docker 移除掉运行不正常的container操作

    docker 移除掉运行不正常的container操作

    这篇文章主要介绍了docker 移除掉运行不正常的container操作,具有很好的参考价值,希望对大家有所帮助。一起跟随小编过来看看吧
    2021-03-03
  • Docker-swarm快速搭建redis集群的方法步骤

    Docker-swarm快速搭建redis集群的方法步骤

    本文主要介绍了Docker-swarm快速搭建redis集群的方法步骤,文中通过示例代码介绍的非常详细,对大家的学习或者工作具有一定的参考学习价值,需要的朋友们下面随着小编来一起学习学习吧
    2022-05-05
  • linux和docker下mysql安装方式

    linux和docker下mysql安装方式

    本文详细介绍了在Linux系统中通过命令行安装MySQL的步骤,包括编辑yum源、下载并启动MySQL服务、登录和修改密码等操作,同时,文中也提供了在Docker环境下安装MySQL的流程,涵盖了拉取MySQL镜像、查看运行状态及登录MySQL的方法
    2024-09-09
  • 基于Dockerfile创建zabbix监控体系代码实例

    基于Dockerfile创建zabbix监控体系代码实例

    这篇文章主要介绍了基于Dockerfile创建zabbix监控体系代码实例,文中通过示例代码介绍的非常详细,对大家的学习或者工作具有一定的参考学习价值,需要的朋友可以参考下
    2020-05-05
  • Docker使用Prune命令清理none镜像

    Docker使用Prune命令清理none镜像

    本文主要介绍了Docker使用Prune命令清理none镜像,文中通过示例代码介绍的非常详细,具有一定的参考价值,感兴趣的小伙伴们可以参考一下
    2021-10-10

最新评论