ppiper/node-browsers

Node Browsers Docker镜像文档

一、镜像概述与主要用途

本镜像是专为SAP开发项目的持续交付（CD）流水线设计的Docker镜像，优化用于Jenkins平台的https://github.com/SAP/jenkins-library。其核心用途是通过封装执行流水线步骤所需的工具和环境，简化CD工具链配置，支持在Jenkins流水线中对Web应用进行端到端测试。

二、核心功能与特性

• 环境封装：集成Node.js运行环境与Web浏览器，提供端到端测试所需的完整依赖栈。
• 版本支持：默认标签包含Node.js 10（为兼容approuter），通过node12标签支持Node.js 12版本。
• 流水线优化：针对Jenkins流水线和Piper项目深度适配，确保与SAP开发流程的兼容性。
• 环境一致性：通过容器化方式消除测试环境差异，保障流水线步骤的可重复性。

三、使用场景与适用范围

• Jenkins流水线测试：作为Jenkins流水线的执行环境，运行Web应用的端到端测试用例。
• SAP项目适配：适用于SAP开发项目中基于Piper项目的持续交付流程，尤其适合需要Node.js环境的Web应用测试场景。
• 本地测试验证：支持本地构建和运行，用于测试脚本调试或离线环境验证。

四、使用方法与配置说明

4.1 镜像下载

镜像已发布至Docker Hub，可通过以下命令拉取：

默认版本（Node.js 10）

bash
docker pull docker.xuanyuan.run/ppiper/node-browsers

Node.js 12版本

bash
docker pull docker.xuanyuan.run/ppiper/node-browsers:node12

4.2 本地构建

若需本地构建镜像，在Dockerfile所在目录执行以下命令：

bash
docker build -t ppiper/node-browsers .

4.3 在Jenkins流水线中使用

本镜像需与基于ppiper/jenkins-master的Jenkins环境配合使用。典型集成方式为在Jenkinsfile中指定镜像作为执行代理，示例片段如下：

groovy
pipeline {
  agent {
    docker {
      image 'ppiper/node-browsers:node12'  // 根据需求选择标签
      reuseNode true
    }
  }
  stages {
    stage('End-to-End Test') {
      steps {
        sh 'npm install'  // 安装测试依赖
        sh 'npm run e2e'  // 执行端到端测试脚本
      }
    }
  }
}

详细使用场景可参考SAP博客文章。

4.4 Docker部署示例

本地测试运行

通过docker run命令启动容器并执行测试脚本：

bash
# 挂载本地测试代码目录，运行端到端测试
docker run -v $(pwd):/app -w /app docker.xuanyuan.run/ppiper/node-browsers:node12 sh -c "npm install && npm run e2e"

docker-compose配置

创建docker-compose.yml文件，定义测试服务：

yaml
version: '3'
services:
  e2e-test:
    image: docker.xuanyuan.run/ppiper/node-browsers:node12
    volumes:
      - ./:/app  # 挂载本地测试代码
    working_dir: /app
    command: sh -c "npm install && npm run e2e"

执行测试：

bash
docker-compose up

五、许可信息

本镜像的基础许可为https://github.com/SAP/devops-docker-node-browsers/blob/master/LICENSE。
注意：镜像可能包含其他第三方软件，其许可可能不同。LICENSE文件已内置於镜像中，使用前请检查镜像内所有组件的许可协议。