mcpField
D
deploy-cloudflare

deploy-cloudflare

github.com/dralgorhythm云与 DevOps12857 次安装14 周前更新
代码仓库

关于 deploy-cloudflare

面向使用 Wrangler 的开发者，提供 Cloudflare Pages 与 Workers 的配置和部署指导，也涵盖环境变量、密钥及 DNS 管理。

主要功能

  1. 01部署 Cloudflare Pages 与 Workers
  2. 02配置构建和运行环境
  3. 03管理变量与加密密钥
  4. 04使用命令管理 DNS 记录
  5. 05本地开发、预览与回滚

适用场景

  1. 01发布静态网站到 Pages
  2. 02部署和测试 Workers
  3. 03为不同环境配置密钥
  4. 04通过 Wrangler 管理 DNS 与部署

安装

复制下面的命令，在终端中运行。

$npx skills add https://github.com/dralgorhythm/claude-agentic-framework --skill deploy-cloudflare

安装后在 Claude Code 中输入/deploy-cloudflare确认已加载。

详细介绍

部署到 Cloudflare

为什么选择 Cloudflare？

  • 全球边缘网络（300 多个城市）
  • 零冷启动（Workers）
  • 自动 HTTPS 和 DDoS 防护
  • 集成 CDN 和 DNS
  • 慷慨的免费套餐

快速入门

# Install Wrangler
npm install -g wrangler

# Login
wrangler login

# Deploy Pages
wrangler pages deploy ./dist

# Deploy Worker
wrangler deploy

Cloudflare Pages

部署静态网站
# One-time deploy
wrangler pages deploy ./dist --project-name=my-app

# Connect Git repo (auto-deploy)
wrangler pages project create my-app --production-branch=main
构建配置
# wrangler.toml (Pages Functions)
name = "my-app"
compatibility_date = "2025-01-01"

[build]
command = "npm run build"

Cloudflare Workers

Worker 配置
# wrangler.toml
name = "my-worker"
main = "src/index.ts"
compatibility_date = "2025-01-01"

[vars]
ENVIRONMENT = "production"

[[kv_namespaces]]
binding = "MY_KV"
id = "abc123"
基本 Worker
export default {
  async fetch(request, env, ctx) {
    return new Response('Hello from the edge!', {
      headers: { 'Content-Type': 'text/plain' }
    });
  }
};

环境与密钥

# Set secret (encrypted)
wrangler secret put API_KEY

# Set variable (plain text)
wrangler pages secret put API_URL

# Bulk upload
echo "SECRET_KEY" | wrangler secret put SECRET_KEY

DNS 管理

# List DNS records
wrangler dns list example.com

# Add A record
wrangler dns create example.com --type A --name www --content 1.2.3.4

# Update record
wrangler dns update example.com --type A --name www --content 5.6.7.8

部署工作流

1. 初始化项目
wrangler init my-project
cd my-project
2. 本地开发
wrangler dev
3. 部署
# Production
wrangler deploy

# Preview
wrangler deploy --env staging

最佳实践

  1. 使用环境：分离预发布环境和生产环境
  2. 版本管理：需要时通过仪表板回滚
  3. 边缘缓存：利用 Cache API 提升性能
  4. 速率限制：为 Workers 设置速率限制以提供保护
  5. 监控：启用 Workers Analytics

常用命令

# View logs (tail)
wrangler tail

# List deployments
wrangler deployments list

# Rollback
wrangler rollback --message "Revert breaking change"

# KV operations
wrangler kv:key put --binding=MY_KV "key" "value"
wrangler kv:key get --binding=MY_KV "key"

反模式

  • 不要 将密钥存储在 wrangler.toml 中（使用 wrangler secret）
  • 不要 未经本地测试就部署（wrangler dev）
  • 不要 忽略 compatibility_date（会影响运行时行为）
  • 不要 使用 Workers 执行长时间运行的任务（限制为 30 秒）

评论

支持 Markdown