Pular para o conteúdo

Conectar a Cloudflare

A bohr cria o Worker de cada projeto, o sandbox do agente e a homologação na sua conta da Cloudflare, com um token de API que você fornece. A instância guarda o token criptografado e só o usa para criar e atualizar os Workers dos seus projetos.

  • A conta precisa estar no plano Workers Paid: o sandbox do agente é um Cloudflare Container.
  • A conta precisa de um subdomínio workers.dev. Se você nunca abriu Workers & Pages no painel da Cloudflare, abra uma vez: isso cria o subdomínio.
  1. No passo Cloudflare, clique em Criar o token na Cloudflare. Isso abre a página de tokens da Cloudflare com as permissões principais preenchidas.
  2. Antes de salvar, adicione a permissão Containers: Edit. O link não consegue preenchê-la.
  3. Crie o token, copie, cole em Token da API da Cloudflare e clique em Conectar.

O token precisa destas permissões:

Permissão Por quê
Workers Scripts: Edit Cria os Workers dos projetos. Também cobre Durable Objects e o subdomínio workers.dev.
Account Settings: Read Lê os dados da conta.
Containers: Edit O sandbox do agente. Precisa do plano Workers Paid. Adicione à mão.
D1: Edit Cria o banco de dados dos projetos criados a partir de um modelo. Já vem preenchida pelo link; só projetos de modelo precisam dela.

Quando falta alguma coisa, o painel mostra “O token não tem todas as permissões” com a lista. Edite o token na Cloudflare (ou crie outro pelo modelo), adicione o que falta e cole de novo.

Se o token enxerga mais de uma conta da Cloudflare, a bohr pede Escolha a conta da Cloudflare: escolha aquela em que os seus projetos devem rodar e clique em Usar esta conta.

Para você distinguir o trabalho da bohr do seu:

  • Toda chamada à API da Cloudflare que a bohr faz envia User-Agent: bohr/<version> (+https://bohr.io); isso aparece no audit log da sua conta.
  • Os Workers que a bohr cria (o Worker do agente e o Worker da homologação de cada projeto) levam as tags bohr e bohr-project:<id>, e os deployments deles a mensagem bohr.
  • Os deploys de produção rodam wrangler deploy --message "bohr" --tag "bohr-<commit>".
  • As contas conectadas ficam listadas em Conta › Contas conectadas › Cloudflare. Você pode desconectar uma conta quando nenhum projeto a usar mais; apague também o token no painel da Cloudflare (My Profile → API Tokens).
  • Uma organização conecta a própria conta da Cloudflare, separada da sua.