Puppeteer Docker 镜像文档

镜像概述

本镜像专为GitLab Runner设计，集成了Puppeteer运行环境，旨在简化GitLab CI/CD流水线中Puppeteer相关任务的部署流程。通过直接使用此预构建镜像，可避免在流水线中重复构建Puppeteer环境，显著节省构建时间（相比流水线内构建节省约一半时间）。

核心功能与特性

• 环境预配置：内置Puppeteer运行所需基础环境，无需在流水线中从零构建
• 时间优化：相比在CI/CD流水线中动态安装配置Puppeteer，可节省约50%的构建时间
• GitLab集成：专为GitLab Runner环境优化，无缝适配GitLab CI/CD流程

使用场景

适用于GitLab Runner管理的CI/CD流水线环境，主要用于执行基于Puppeteer的自动化任务，如网页截图生成、前端自动化测试、页面数据爬取等场景。

使用方法与配置说明

前置要求

• 已配置GitLab Runner的GitLab项目
• 项目中包含Puppeteer脚本文件（如main.js）

GitLab CI/CD配置示例

在项目的.gitlab-ci.yml文件中添加如下配置，即可使用本镜像运行Puppeteer任务：

yaml
image: dseegers/puppeteer:latest

stages:
  - example  # 定义流水线阶段

# 定义具体任务
peerberry:
  stage: example  # 关联到example阶段
  before_script:
    - npm install puppeteer  # 安装Puppeteer依赖（当前版本需在流水线中执行此步骤）
  script:
    - node main.js  # 运行Puppeteer脚本（需确保项目中存在main.js文件）
  artifacts:
    paths:
      - screenshot.png  # 存储生成的截图等产物（根据实际脚本输出调整路径）

配置说明

• 指定镜像：通过image: dseegers/puppeteer:latest指定使用本镜像
• 安装依赖：before_script阶段执行npm install puppeteer安装Puppeteer npm包
• 执行脚本：script阶段通过node main.js运行用户编写的Puppeteer脚本
• 产物处理：artifacts配置用于保存脚本生成的文件（如示例中的screenshot.png），便于流水线完成后查看或下载

注意事项

• 确保项目中存在Puppeteer脚本文件（如示例中的main.js），并根据实际需求调整脚本内容
• artifacts路径需与脚本输出文件路径保持一致，以确保产物正确收集
• 如需使用特定版本的Puppeteer，可在npm install puppeteer命令后指定版本号，如npm install puppeteer@19.0.0