ringcentral/web-tools

Node + Puppeteer + Java + SonarScanner 镜像文档

镜像概述

本Docker镜像集成了Node.js、Puppeteer、Java运行时环境及SonarScanner工具，旨在为开发团队提供一站式开发与质量保障环境。通过整合前端开发、自动化测试及代码质量分析工具，简化开发流程，提升团队协作效率。

核心功能与特性

多工具集成

• Node.js：内置LTS版本Node.js及npm/yarn包管理器，支持JavaScript/TypeScript应用开发与运行。
• Puppeteer：包含Chrome浏览器无头模式，支持网页自动化测试、截图、PDF生成及前端性能分析。
• Java运行时：集成OpenJDK，满足依赖Java环境的工具运行需求（如SonarScanner）。
• SonarScanner：预置SonarQube代码质量分析工具，支持多语言代码静态检查（JavaScript/TypeScript/Java等）。

开箱即用

• 无需手动配置多工具依赖，容器启动即可使用全部功能。
• 内置Puppeteer所需系统依赖（如字体、图形库），避免运行时环境缺失问题。

使用场景

• 前端自动化测试：通过Puppeteer执行网页UI自动化测试、端到端测试（E2E）。
• 代码质量管控：结合SonarScanner对JavaScript/TypeScript/Java项目进行代码规范检查、漏洞检测及复杂度分析。
• 全栈项目开发：支持同时进行前端（Node.js/Puppeteer）与后端（Java依赖）开发任务。
• CI/CD流程集成：作为CI/CD流水线中的执行环境，自动化完成测试与代码质量检查步骤。

使用方法

基本运行命令

bash
docker run -it --rm \
  -v $(pwd):/app \
  -w /app \
  [镜像名称] \
  /bin/bash

参数说明：

• -v $(pwd):/app：挂载本地项目目录至容器内/app路径
• -w /app：设置工作目录为/app
• [镜像名称]：替换为实际Docker镜像名称

典型操作示例

1. 执行Puppeteer自动化脚本

在容器内运行前端自动化测试脚本：

bash
node your-puppeteer-script.js

2. 运行SonarScanner代码分析

配置SonarQube服务器连接后执行代码分析：

bash
sonar-scanner \
  -Dsonar.projectKey=your-project-key \
  -Dsonar.host.url=http://sonarqube-server:9000 \
  -Dsonar.login=your-token \
  -Dsonar.sources=.

3. 安装Node.js依赖并运行应用

bash
npm install  # 或 yarn install
npm run start

环境变量配置

注意事项

• Puppeteer运行需确保容器具备网络访问权限（如访问测试目标网页）。
• SonarScanner分析需提前配置SonarQube服务器地址及访问令牌。
• 本地项目目录挂载时，注意文件权限问题，可通过-u $(id -u):$(id -g)参数指定用户ID。

维护与更新

• 镜像定期更新以同步Node.js、Java及SonarScanner的官方稳定版本。
• 如需自定义工具版本，可基于本镜像构建新镜像并修改对应依赖版本。