使用 Cloudflare Workers 实施 Gmail 发送 - 开发指南

这是使用 cloudflare workers 实施 gmail 发送系列的第 2 部分：

• 第 1 部分：设置 ✅
• 第 2 部分：开发环境（当前）
• 第 3 部分：实施（即将推出）

介绍

在第 1 部分中设置 gmail api 访问权限后，我们现在将为 cloudflare workers 配置开发环境。本指南重点介绍创建一个与 cloudflare pages 和 workers 无缝协作的强大开发设置。

了解 cloudflare 基础设施

cloudflare 在全球分布式边缘计算平台上运行。当流量增加时，页面会在这些服务器之间复制，并将用户定向到最近的服务器。这种无服务器架构无需管理您自己的服务器、docker 容器或 kubernetes 集群。

cloudflare 工作人员和页面

工人概况

cloudflare workers 是处理请求的无服务器函数。 cloudflare pages 处理前端（静态内容），而 workers 则管理表单处理和电子邮件发送等后端操作。

可用的存储选项

workers 可以与各种 cloudflare 存储解决方案集成：

1. d1:

   • 基于 sqlite 的无服务器 sql 数据库
   • 高达10gb存储容量
   • 30天时间旅行功能

2. kv（键值）:

   • 全球分布式键值存储
   • 针对边缘阅读进行了优化

3. 耐用物体：

   • 一致的状态管理
   • 分布式系统的理想选择

4. r2:

   • s3 兼容的对象存储
   • 大文件处理能力

5. 超级光驱:

   • postgresql 数据库连接器
   • 优化连接池

关于牧马人的重要说明

最近牧马人使用模式的变化需要引起注意。以前，wrangler 通常是全局安装的，但推荐的方法已更改：

旧方法（不推荐）：

npm install -g wrangler
wrangler init my-project

新推荐方法：

npm create cloudflare@latest

此更改提供了更好的项目隔离和版本管理。

cloudflare worker 中的语言环境

虽然 cloudflare workers 可能看起来与 node.js 类似，但存在重要差异：

• 原生 node.js 模块不可用
• 代码必须与浏览器兼容
• 支持 typescript，提供强大的打字优势
• 每个项目安装 node.js 仅用于开发
• 必须使用直接 http 请求而不是 node.js 库

了解 cloudflare 页面应用程序

cloudflare pages 应用程序与传统 workers 不同：

• 它们是在 cloudflare pages 平台上运行的完全集成的 web 应用程序
• pages functions 通过 /functions 目录扩展此功能
• 此集成允许直接在您的页面应用程序中进行服务器端处理（例如电子邮件处理）
• 使用pages functions时不需要单独部署worker

开发环境设置

1. 前提条件

• 创建 cloudflare 帐户
• 将 github 存储库连接到 pages
• 配置部署设置

2. 项目结构设置

创建以下目录结构：

your-project/
├── src/
│   └── pages/
│       └── index.astro
├── functions/
│   ├── contact-form.ts
│   └── tsconfig.json
├── public/
├── astro.config.mjs
├── package.json
└── wrangler.toml

初始化为：

mkdir functions
touch functions/contact-form.ts functions/tsconfig.json wrangler.toml

3.安装依赖项

npm install --save-dev typescript @cloudflare/workers-types

4. 配置 typescript

添加到functions/tsconfig.json：

{
  "compileroptions": {
    "target": "esnext",
    "module": "esnext",
    "lib": ["esnext"],
    "types": ["@cloudflare/workers-types"],
    "sourcemap": true
  }
}

更新项目 tsconfig.json:

{
  "include": ["src/**/*"],
  "exclude": ["functions/**/*"]
}

下一步

本系列的下一篇文章将介绍实现细节，包括：

• 创建邮件发送功能
• 处理表单提交
• 错误处理和验证
• 测试和部署

请继续关注第 3 部分，我们将把所有内容与实际实现结合起来。

以上就是使用 Cloudflare Workers 实施 Gmail 发送 - 开发指南的详细内容，更多请关注硕下网其它相关文章！