Cloudflare Deploy
Habilidade consolidada para construir na plataforma Cloudflare. Use as árvores de decisão abaixo para encontrar o produto certo e carregue as referências detalhadas.
Pré-requisitos
- Quando a sandbox bloqueia as chamadas de rede de implantação, execute novamente com
sandbox_permissions=require_escalated.
- A implantação pode levar alguns minutos. Use valores de timeout apropriados.
Autenticação (Obrigatório Antes da Implantação)
Verifique a autenticação antes de wrangler deploy, wrangler pages deploy ou npm run deploy:
npx wrangler whoami # Mostra a conta se autenticado
Não autenticado? → references/wrangler/auth.md
- Interativo/local:
wrangler login (OAuth único)
- CI/CD: Configure a variável de ambiente
CLOUDFLARE_API_TOKEN
Árvores de Decisão Rápidas
"Preciso executar código"
Precisa executar código?
├─ Funções serverless na edge → workers/
├─ Aplicação full-stack com deploys por Git → pages/
├─ Coordenação com estado/tempo real → durable-objects/
├─ Trabalhos multi-etapa de longa duração → workflows/
├─ Executar containers → containers/
├─ Multi-tenant (clientes implantam código) → workers-for-platforms/
├─ Tarefas agendadas (cron) → cron-triggers/
├─ Lógica edge leve (modificar HTTP) → snippets/
├─ Processar eventos de execução do Worker (logs/observabilidade) → tail-workers/
└─ Otimizar latência para infraestrutura backend → smart-placement/
"Preciso armazenar dados"
Precisa de armazenamento?
├─ Chave-valor (config, sessões, cache) → kv/
├─ SQL relacional → d1/ (SQLite) ou hyperdrive/ (Postgres/MySQL existente)
├─ Armazenamento de objetos/arquivos (compatível com S3) → r2/
├─ Fila de mensagens (processamento assíncrono) → queues/
├─ Embeddings vetoriais (IA/busca semântica) → vectorize/
├─ Estado consistente e forte por entidade → durable-objects/ (armazenamento DO)
├─ Gerenciamento de segredos → secrets-store/
├─ ETL de streaming para R2 → pipelines/
└─ Cache persistente (retenção de longo prazo) → cache-reserve/
"Preciso de IA/ML"
Precisa de IA?
├─ Executar inferência (LLMs, embeddings, imagens) → workers-ai/
├─ Banco de dados vetorial para RAG/busca → vectorize/
├─ Construir agentes de IA com estado → agents-sdk/
├─ Gateway para qualquer provedor de IA (caching, roteamento) → ai-gateway/
└─ Widget de busca alimentado por IA → ai-search/
"Preciso de conectividade/rede"
Precisa de rede?
├─ Expor serviço local para internet → tunnel/
├─ Proxy TCP/UDP (não-HTTP) → spectrum/
├─ Servidor TURN WebRTC → turn/
├─ Conectividade de rede privada → network-interconnect/
├─ Otimizar roteamento → argo-smart-routing/
├─ Otimizar latência para backend (não usuário) → smart-placement/
└─ Vídeo/áudio em tempo real → realtimekit/ ou realtime-sfu/
"Preciso de segurança"
Precisa de segurança?
├─ Web Application Firewall → waf/
├─ Proteção DDoS → ddos/
├─ Detecção/gerenciamento de bots → bot-management/
├─ Proteção de API → api-shield/
├─ Alternativa CAPTCHA → turnstile/
└─ Detecção de vazamento de credenciais → waf/ (ruleset gerenciado)
"Preciso de mídia/conteúdo"
Precisa de mídia?
├─ Otimização/transformação de imagens → images/
├─ Streaming/codificação de vídeo → stream/
├─ Automação do navegador/screenshots → browser-rendering/
└─ Gerenciamento de scripts de terceiros → zaraz/
"Preciso de infraestrutura como código"
Precisa de IaC? → pulumi/ (Pulumi), terraform/ (Terraform), ou api/ (API REST)
Índice de Produtos
Computação & Runtime
| Produto |
Referência |
| Workers |
references/workers/ |
| Pages |
references/pages/ |
| Pages Functions |
references/pages-functions/ |
| Durable Objects |
references/durable-objects/ |
| Workflows |
references/workflows/ |
| Containers |
references/containers/ |
| Workers for Platforms |
references/workers-for-platforms/ |
| Cron Triggers |
references/cron-triggers/ |
| Tail Workers |
references/tail-workers/ |
| Snippets |
references/snippets/ |
| Smart Placement |
references/smart-placement/ |
Armazenamento & Dados
| Produto |
Referência |
| KV |
references/kv/ |
| D1 |
references/d1/ |
| R2 |
references/r2/ |
| Queues |
references/queues/ |
| Hyperdrive |
references/hyperdrive/ |
| DO Storage |
references/do-storage/ |
| Secrets Store |
references/secrets-store/ |
| Pipelines |
references/pipelines/ |
| R2 Data Catalog |
references/r2-data-catalog/ |
| R2 SQL |
references/r2-sql/ |
IA & Machine Learning
| Produto |
Referência |
| Workers AI |
references/workers-ai/ |
| Vectorize |
references/vectorize/ |
| Agents SDK |
references/agents-sdk/ |
| AI Gateway |
references/ai-gateway/ |
| AI Search |
references/ai-search/ |
Conectividade & Rede
| Produto |
Referência |
| Tunnel |
references/tunnel/ |
| Spectrum |
references/spectrum/ |
| TURN |
references/turn/ |
| Network Interconnect |
references/network-interconnect/ |
| Argo Smart Routing |
references/argo-smart-routing/ |
| Workers VPC |
references/workers-vpc/ |
Segurança
| Produto |
Referência |
| WAF |
references/waf/ |
| DDoS Protection |
references/ddos/ |
| Bot Management |
references/bot-management/ |
| API Shield |
references/api-shield/ |
| Turnstile |
references/turnstile/ |
Mídia & Conteúdo
| Produto |
Referência |
| Images |
references/images/ |
| Stream |
references/stream/ |
| Browser Rendering |
references/browser-rendering/ |
| Zaraz |
references/zaraz/ |
Comunicação em Tempo Real
| Produto |
Referência |
| RealtimeKit |
references/realtimekit/ |
| Realtime SFU |
references/realtime-sfu/ |
Ferramentas para Desenvolvedores
| Produto |
Referência |
| Wrangler |
references/wrangler/ |
| Miniflare |
references/miniflare/ |
| C3 |
references/c3/ |
| Observability |
references/observability/ |
| Analytics Engine |
references/analytics-engine/ |
| Web Analytics |
references/web-analytics/ |
| Sandbox |
references/sandbox/ |
| Workerd |
references/workerd/ |
| Workers Playground |
references/workers-playground/ |
Infraestrutura como Código
| Produto |
Referência |
| Pulumi |
references/pulumi/ |
| Terraform |
references/terraform/ |
| API |
references/api/ |
Outros Serviços
| Produto |
Referência |
| Email Routing |
references/email-routing/ |
| Email Workers |
references/email-workers/ |
| Static Assets |
references/static-assets/ |
| Bindings |
references/bindings/ |
| Cache Reserve |
references/cache-reserve/ |
Resolução de Problemas
Acesso de Rede Escalado
Se a implantação falhar devido a problemas de rede (timeouts, erros de DNS, conexões resetadas), execute novamente o deploy com permissões escaladas (use sandbox_permissions=require_escalated). O deploy requer acesso de rede escalado quando a rede de sandbox bloqueia requisições de saída.
Exemplo de orientação ao usuário:
O deploy precisa de acesso de rede escalado para implantar na Cloudflare. Posso executar novamente o comando com permissões escaladas—quer que eu proceda?
artubss