Integracao Cloudflare

Conecte sua conta Cloudflare ao BuildShip pra gerenciar dominios, DNS, SSL/TLS e cache diretamente do chat. O time de IA pode apontar dominios pros seus projetos, limpar cache depois de deploy e configurar registros de email (SPF, DKIM, MX).

O que da pra fazer

• Apontar dominios proprios (meusite.com) pros seus projetos BuildShip
• Gerenciar registros DNS (A, CNAME, MX, TXT)
• Limpar cache apos deploy
• Configurar SSL/TLS (recomendado: "Full Strict")
• Configurar email via registros MX
• Deploy de Cloudflare Workers

Como conectar

Passo 1: gerar o API Token

1. Acesse dash.cloudflare.com/profile/api-tokens
2. Clique em "Create Token"
3. Escolha o template "Edit zone DNS" (o mais comum) ou "Custom token" pra permissoes mais amplas
4. Se for Custom token, marque estas permissoes:
   • Zone > DNS > Edit
   • Zone > Zone > Read
   • Zone > Cache Purge > Purge
   • (opcional) Account > Workers Scripts > Edit
5. Em Zone Resources, escolha "Include > All zones" ou apenas zonas especificas
6. Clique Continue to summary e Create Token
7. Copie o token — ele so aparece uma vez

Passo 2: pegar o Account ID

1. Acesse dash.cloudflare.com
2. No canto superior direito, clique no seu nome de usuario
3. O Account ID aparece no painel da direita (ou na URL depois de dash.cloudflare.com/)

Passo 3: pegar o Zone ID (opcional, so pro dominio especifico)

1. No dashboard Cloudflare, clique no dominio que voce quer usar
2. Va em Overview
3. No painel da direita, em "API", copie o Zone ID

Passo 4: conectar no BuildShip

1. Abra qualquer projeto no BuildShip
2. Na barra lateral do chat, clique em Integracoes
3. Clique em Cloudflare
4. Cole:
   • API Token (obrigatorio)
   • Account ID (opcional, necessario pra Workers)
   • Zone ID (opcional, necessario pra operar numa zona especifica)
5. Clique Ativar

Apontar um dominio proprio pra um projeto

Depois que a integracao Cloudflare estiver ativa, voce pode pedir ao time:

"Aponta o dominio meusite.com pra esse projeto"

O time vai:

1. Criar o registro DNS no Cloudflare apontando pro servidor do BuildShip
2. Ativar SSL automatico
3. Aguardar a propagacao (geralmente 1-5 minutos com Cloudflare)
4. Confirmar que o site esta acessivel via HTTPS

Limpar cache depois de deploy

Se voce atualizou um arquivo e nao esta vendo as mudancas, pode ser cache do Cloudflare. Peca ao time:

"Limpa o cache do Cloudflare pro site meusite.com"

Problemas comuns

Erro 403 "Authentication error"

O token e invalido ou nao tem as permissoes necessarias. Verifique que o token foi criado com scope Zone:DNS:Edit no minimo. Se ainda nao funcionar, recrie o token.

Erro 9109 "Zone not found"

O Zone ID que voce colou nao pertence a essa conta, ou o token nao tem acesso a essa zona. Verifique se o token foi criado com "All zones" ou se inclui a zona correta em "Zone Resources".

DNS nao propaga

Com Cloudflare, a propagacao e quase instantanea quando o registro esta "proxied" (nuvem laranja). Se esta demorando, verifique se o proxy esta ativado. Se estiver "DNS only" (nuvem cinza), aguarde o TTL anterior expirar.

Site mostra erro 521 ou 522

O Cloudflare nao consegue conectar no servidor de origem. Verifique que o projeto BuildShip tem preview rodando e que o IP/porta estao corretos. Voce pode pedir ao time: "o site meusite.com esta dando 521, verifica o que pode ser".