Puppeteer Heroku Buildpack 使用教程

项目介绍

puppeteer-heroku-buildpack 是一个用于在 Heroku 平台上部署 Puppeteer 应用的构建包。Puppeteer 是一个 Node 库，它提供了一个高级 API 来通过 DevTools 协议控制无头 Chrome 或 Chromium。这个构建包简化了在 Heroku 上运行 Puppeteer 所需的配置和依赖管理。

项目快速启动

步骤 1: 清除现有构建包

首先，清除 Heroku 应用上的所有现有构建包：

heroku buildpacks:clear

步骤 2: 添加 Puppeteer Heroku Buildpack

添加 puppeteer-heroku-buildpack 和 heroku/nodejs 构建包：

heroku buildpacks:add --index 1 https://github.com/jontewks/puppeteer-heroku-buildpack
heroku buildpacks:add --index 2 heroku/nodejs

步骤 3: 修改 Puppeteer 启动配置

在 Puppeteer 启动函数中添加必要的参数：

const browser = await puppeteer.launch({
  args: ['--no-sandbox', '--disable-setuid-sandbox']
});

步骤 4: 部署到 Heroku

提交更改并推送到 Heroku：

git add .
git commit -m "Setup Puppeteer with Heroku buildpack"
git push heroku master

应用案例和最佳实践

应用案例

• 生成网页截图和 PDF：使用 Puppeteer 自动化生成高质量的网页截图和 PDF 文件。
• 网页爬虫：利用 Puppeteer 进行网页内容的自动化抓取和解析。

最佳实践

• 缓存配置：对于 Puppeteer v19 及以上版本，确保在 package.json 中添加以下脚本以正确缓存 Chromium：

  "scripts": {
    "heroku-postbuild": "mkdir -p /cache && mv /app/cache/puppeteer /cache"
  }
  

• 错误处理：在 Puppeteer 脚本中添加适当的错误处理逻辑，以捕获和处理可能的异常。

典型生态项目

• Heroku Node.js Buildpack：用于在 Heroku 上部署 Node.js 应用的基础构建包。
• Puppeteer：用于自动化和测试无头 Chrome 或 Chromium 的 Node 库。
• Heroku CLI：用于管理 Heroku 应用的命令行工具。

通过以上步骤和最佳实践，您可以在 Heroku 上成功部署和运行 Puppeteer 应用，实现各种自动化任务和测试需求。