ppiper/node-browsers

Node Browsers Docker镜像文档

一、镜像概述与主要用途

本镜像是专为SAP开发项目的持续交付（CD）流水线设计的Docker镜像，优化用于Jenkins平台的https://github.com/SAP/jenkins-library%E3%80%82%E5%85%B6%E6%A0%B8%E5%BF%83%E7%94%A8%E9%80%94%E6%98%AF%E9%80%9A%E8%BF%87%E5%B0%81%E8%A3%85%E6%89%A7%E8%A1%8C%E6%B5%81%E6%B0%B4%E7%BA%BF%E6%AD%A5%E9%AA%A4%E6%89%80%E9%9C%80%E7%9A%84%E5%B7%A5%E5%85%B7%E5%92%8C%E7%8E%AF%E5%A2%83%EF%BC%8C%E7%AE%80%E5%8C%96CD%E5%B7%A5%E5%85%B7%E9%93%BE%E9%85%8D%E7%BD%AE%EF%BC%8C%E6%94%AF%E6%8C%81%E5%9C%A8Jenkins%E6%B5%81%E6%B0%B4%E7%BA%BF%E4%B8%AD%E5%AF%B9Web%E5%BA%94%E7%94%A8%E8%BF%9B%E8%A1%8C%E7%AB%AF%E5%88%B0%E7%AB%AF%E6%B5%8B%E8%AF%95%E3%80%82

二、核心功能与特性

• 环境封装：集成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 ppiper/node-browsers

Node.js 12版本

bash
docker pull 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 ppiper/node-browsers:node12 sh -c "npm install && npm run e2e"

docker-compose配置

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

yaml
version: '3'
services:
  e2e-test:
    image: 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%E3%80%82
注意：镜像可能包含其他第三方软件，其许可可能不同。LICENSE文件已内置於镜像中，使用前请检查镜像内所有组件的许可协议。