Resumo
O Cloudflare CLI 1.0.0-beta.29 concentra a maior leva de mudanças da linha 1.0.0. A versão deixa de guardar a seleção de account entre execuções, unifica --worker nos comandos de Worker, aceita um diretório de assets estáticos no cf deploy e move o estado local para .cloudflare/state. A publicação também troca o argumento posicional de cf previews deploy por --preview-name, o que quebra chamadas existentes.
Novidades
- Cloudflare CLI 1.0.0-beta.29 — Seleção de account: a escolha não é mais guardada entre execuções. Com credenciais que alcançam uma única account, ela é selecionada automaticamente. Com mais de uma account e sem escolha no
cloudflare.config.tsou emCLOUDFLARE_ACCOUNT_ID, o cf pergunta de novo na próxima execução e reutiliza a seleção apenas dentro da execução atual. - Cloudflare CLI 1.0.0-beta.29 — Flag
--worker: comandos gerados de Worker e de versão aceitam--workerno lugar de--worker-idou do identificador posicional.--worker-ide--script-namecontinuam como aliases, ecf workers getecf workers deletemantêm a entrada posicional. O--helpmostra a flag junto das demais opções. - Cloudflare CLI 1.0.0-beta.29 — Deploy de assets estáticos:
cf deploy [diretório]publica um diretório de assets pré-compilados e gera um Build Output somente de assets. O caminho reaproveita a configuração de Worker apenas de assets e dispensa a delegação de build. Projetos com entrypoint de Worker ou Container continuam sem o diretório e usam o build delegado. - Cloudflare CLI 1.0.0-beta.29 — Cabeçalhos da API:
CLOUDFLARE_API_HEADERSrecebe um objeto JSON, como{"X-Custom-Header":"value"}, e acrescenta cabeçalhos às requisições da API da Cloudflare. Os cabeçalhos customizados substituem cabeçalhos de requisição existentes, os de corpo e de transporte ficam protegidos e valores fora da lista de diagnóstico continuam ocultos no log. - Cloudflare CLI 1.0.0-beta.29 —
cf deploy --force: a flag publica o Worker quando o último deploy veio da API de scripts ou quando a configuração remota conflita com o Build Output local. O deploy segue estrito por padrão, e um upload abortado agora indicacf deploy --force. - Cloudflare CLI 1.0.0-beta.29 — Estado local: comandos com
--localgravam em.cloudflare/state, ao lado docloudflare.config.tsmais próximo, o mesmo diretório usado pelo plugin da Cloudflare para Vite. Assimcf kv keys list --localenxerga os registros criados pelo servidor de desenvolvimento. Fora de um projeto,--persist-to <dir>escolhe o local do estado. - Cloudflare CLI 1.0.0-beta.29 —
--preview-name: o argumento posicional decf previews deploysai de cena e a flag--preview-nameescolhe a Preview, como emcf previews deploy --preview-name feature. Sem a flag, o padrão continua sendo o branch de CI ou do Git, e o erro mostra a sintaxe quando não há branch. - Cloudflare CLI 1.0.0-beta.29 — Perfil de autenticação nos servidores de desenvolvimento:
cf dev --profile <nome>defineCLOUDFLARE_AUTH_PROFILEpara os processos filhos, incluindo comandos de framework e os delegadoscf-viteecf-wrangler. Os delegados experimentais exigem Wrangler 4.159.0 ou mais recente, ou o plugin da Cloudflare para Vite a partir de 2.0.0-beta.v.13, e recusam versões anteriores mesmo sem perfil definido. - Cloudflare CLI 1.0.0-beta.29 — Superfície de comandos: várias publicações do Forge OpenAPI atualizam a superfície de comandos gerada.
Melhorias
- Cloudflare CLI 1.0.0-beta.29 — Respostas protobuf: respostas declaradas como
application/protobufsão tratadas como binárias, assim comoapplication/vnd.google.protobuf, e ocf workers versions profilegrava os bytes crus de pprof quando a especificação da API adotar o tipo padrão. - Cloudflare CLI 1.0.0-beta.29 — Executáveis de framework: os comandos de framework detectados são resolvidos a partir da aplicação e dos diretórios
node_modulesacima dela, incluindo dependências hoisted de workspace. - Cloudflare CLI 1.0.0-beta.29 — Argumentos do servidor de desenvolvimento:
cf devrepassa argumentos ao servidor de framework detectado, então projetos Vite aceitam--porte--host. Os argumentos depois de--e os limites entre eles são preservados, inclusive caminhos com espaço e valores numéricos. - Cloudflare CLI 1.0.0-beta.29 — Descrição de flags JSON: o
--helpdos comandos e ocf schemadescrevem formas JSON rasas, com nomes de campo, tipos, opções de enum e chaves opcionais de flags de array e de objeto. Objetos aninhados aparecem abreviados com{...}, campos omitidos com...moree campos somente leitura ficam de fora. - Cloudflare CLI 1.0.0-beta.29 — Dependências: são atualizadas as dependências publicadas pelo repositório Workers SDK, entre elas
@cloudflare/config0.31.0,@cloudflare/containers-shared0.24.0 eminiflare5.20261109.0-beta.
Correções
- Cloudflare CLI 1.0.0-beta.29 — Busca de recursos no deploy:
cf previews deployencontra o namespace de Durable Object de um Container mesmo quando ele aparece depois dos primeiros 1000 namespaces. As consultas de recurso do deploy seguem a paginação por número de página, inclusive no provisionamento de Queue. - Cloudflare CLI 1.0.0-beta.29 — Campos somente leitura: campos enviados pelo servidor ficam de fora das flags de entrada, dos prompts e das mensagens de validação, mesmo quando o esquema compartilhado marca o campo como obrigatório. Valores somente leitura informados pelo usuário são ignorados na validação local.
- Cloudflare CLI 1.0.0-beta.29 — Corpo com posicionais: valores posicionais são reunidos ao corpo JSON quando o comando usa
--body, e os posicionais obrigatórios continuam exigidos. Valores conflitantes são recusados antes do envio ou da simulação. - Cloudflare CLI 1.0.0-beta.29 — Cabeçalhos no log: valores de cabeçalho fora da lista segura de diagnóstico são ocultados em qualquer configuração de sanitização, e
X-Auth-Keyé removido junto deAuthorizationno encaminhamento para serviços locais. - Cloudflare CLI 1.0.0-beta.29 — Ctrl+C no Windows:
cf dev,cf buildecf initiniciamnpmenpxpelo script da CLI, e não pelos lançadores.cmd. Com isso, o Ctrl+C encerra o processo sem deixar o cf parado no prompt de terminar o job em lote.
Breaking changes
- Cloudflare CLI 1.0.0-beta.29 — Preview por posição:
cf previews deploy featuredeixa de funcionar. A chamada precisa usarcf previews deploy --preview-name feature. - Cloudflare CLI 1.0.0-beta.29 — Delegados de desenvolvimento: os delegados experimentais recusam Wrangler anterior à 4.159.0 e o plugin da Cloudflare para Vite anterior a 2.0.0-beta.v.13.
- Cloudflare CLI 1.0.0-beta.29 — Estado local anterior: comandos
--localnão leem mais o diretório global usado antes. Para reaproveitar o estado antigo, informe--persist-tocom o diretóriostateda configuração do cf, como~/.config/cloudflare/stateno Linux.
Ponto de Atenção
A troca do argumento posicional interrompe scripts de deploy de Preview, e o estado local antigo não é lido sem --persist-to. O perfil escolhido em cf dev vale para os processos filhos, o que muda a credencial usada pelo servidor de framework. Teste sugerido: rode cf previews deploy --preview-name homolog num projeto de teste, liste os registros locais com cf kv keys list --local e confira se o servidor de Vite enxerga os mesmos registros que o cf gravou.
Notas da versão
As mudanças estão nas notas oficiais do Cloudflare CLI 1.0.0-beta.29, publicadas em 10/11/2026. A publicação é uma pré-release da linha 1.0.0 e traz o maior volume de mudanças da série.