Pular para o conteúdo
BetaBreaking change

Cloudflare CLI 1.0.0-beta.29

Confira as mudanças desta versão e os avisos antes de atualizar.

Publicada em
Posição no histórico
4 de 10
Nesta página

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.ts ou em CLOUDFLARE_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 --worker no lugar de --worker-id ou do identificador posicional. --worker-id e --script-name continuam como aliases, e cf workers get e cf workers delete mantêm a entrada posicional. O --help mostra 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_HEADERS recebe 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 indica cf deploy --force.
  • Cloudflare CLI 1.0.0-beta.29 — Estado local: comandos com --local gravam em .cloudflare/state, ao lado do cloudflare.config.ts mais próximo, o mesmo diretório usado pelo plugin da Cloudflare para Vite. Assim cf kv keys list --local enxerga 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 de cf previews deploy sai de cena e a flag --preview-name escolhe a Preview, como em cf 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> define CLOUDFLARE_AUTH_PROFILE para os processos filhos, incluindo comandos de framework e os delegados cf-vite e cf-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/protobuf são tratadas como binárias, assim como application/vnd.google.protobuf, e o cf workers versions profile grava 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_modules acima dela, incluindo dependências hoisted de workspace.
  • Cloudflare CLI 1.0.0-beta.29 — Argumentos do servidor de desenvolvimento: cf dev repassa argumentos ao servidor de framework detectado, então projetos Vite aceitam --port e --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 --help dos comandos e o cf schema descrevem 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 ...more e 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/config 0.31.0, @cloudflare/containers-shared 0.24.0 e miniflare 5.20261109.0-beta.

Correções

  • Cloudflare CLI 1.0.0-beta.29 — Busca de recursos no deploy: cf previews deploy encontra 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 de Authorization no encaminhamento para serviços locais.
  • Cloudflare CLI 1.0.0-beta.29 — Ctrl+C no Windows: cf dev, cf build e cf init iniciam npm e npx pelo 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 feature deixa de funcionar. A chamada precisa usar cf 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 --local não leem mais o diretório global usado antes. Para reaproveitar o estado antigo, informe --persist-to com o diretório state da configuração do cf, como ~/.config/cloudflare/state no 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.

Versões anteriores

    • Cloudflare CLI 1.0.0-beta.28

      O Cloudflare CLI 1.0.0-beta.28 valida o limite de itens de corpos em array em vez de dividir a requisição em lotes.

      Beta
    • Cloudflare CLI 1.0.0-beta.27

      O Cloudflare CLI 1.0.0-beta.27 separa campos da API que colidiam com flags próprias do cf, e comandos gerados expõem --organization-profile e --input-<nome>.

      Beta
    • Cloudflare CLI 1.0.0-beta.26

      O Cloudflare CLI 1.0.0-beta.26 ajusta a busca de comandos do cf cli search e coloca cf deploy no topo dos resultados para site estático e Pages.

      Beta
    • Cloudflare CLI 1.0.0-beta.24

      O Cloudflare CLI 1.0.0-beta.24 entrega ao Miniflare a resolução do registro de desenvolvimento usada por cf dev e --local.

      Beta
    • Cloudflare CLI 1.0.0-beta.23

      O Cloudflare CLI 1.0.0-beta.23 atualiza a superfície de comandos gerada a partir da publicação do Forge OpenAPI e sobe as dependências do Workers SDK.

      Beta

Versões posteriores

    • Cloudflare CLI 1.0.0-beta.32

      O Cloudflare CLI 1.0.0-beta.32 exige Wrangler 4.161.0 ou mais recente no delegado cf-wrangler e para de definir CLOUDFLARECFAUTH nos servidores de desenvolvimento.

      BetaBreaking change
    • Cloudflare CLI 1.0.0-beta.31

      O Cloudflare CLI 1.0.0-beta.31 grava os caminhos dos source maps relativos à raiz do projeto antes do upload, o que encurta os stack traces de Workers publicados.

      BetaBreaking change
    • Cloudflare CLI 1.0.0-beta.30

      O Cloudflare CLI 1.0.0-beta.30 reescreve a saída de autenticação para leitura humana e acrescenta cf whoami como alias de cf auth whoami.

      BetaBreaking change
Ver todas as 10 versões do Cloudflare CLI
Histórico de versões