Resumo
O Cloudflare CLI 1.0.0-beta.24 entrega ao Miniflare a resolução do registro de desenvolvimento usada por cf dev e --local. A versão aceita arquivo em cada campo binário de formulário multipart, o que permite enviar um _worker.js no Pages Direct Upload. O --help do --secrets-file explica a expansão de variáveis do arquivo dotenv.
Novidades
- Cloudflare CLI 1.0.0-beta.24 — Registro de desenvolvimento: durante o beta, o cf deixa de sobrescrever os caminhos de registro usados por
cf deve--local. O Miniflare v5 assume o padrão<diretório de configuração da Cloudflare>/dev-registry/v5e a substituição porCLOUDFLARE_DEV_REGISTRY_PATH. O cf não interpreta maisCLOUDFLARE_REGISTRY_PATHnem converte configurações de registro para processos filhos, e as variáveis exportadas chegam intactas à ferramenta do projeto. - Cloudflare CLI 1.0.0-beta.24 — Multipart com arquivo por campo: comandos multipart gerados acrescentam uma flag para cada campo de formulário
format: binaryalém do payload preenchido por--file. Ocf pages deployments createaceita--worker-js,--routes-jsone--redirectspara os campos de formulário. A lista inclui--worker-bundlee--functions-filepath-routing-config-json, então um Direct Upload de Pages pode incluir um_worker.jsem modo avançado com--worker-js @./_worker.js. As flags aceitam conteúdo literal ou@caminho/do/arquivo, e as duas formas sobem como partes de arquivo. - Cloudflare CLI 1.0.0-beta.24 — Superfície de comandos: a superfície de comandos gerada acompanha três publicações do Forge OpenAPI.
Melhorias
- Cloudflare CLI 1.0.0-beta.24 — Expansão no
--secrets-file: a ajuda decf deploye decf workers versions createexplica como arquivos dotenv expandem$VARe${VAR}com valores do processo e com valores anteriores do próprio arquivo. Valores do processo substituem chaves iguais do arquivo, inclusive quando vazios de forma explícita, e apenas as chaves declaradas no arquivo são enviadas. - Cloudflare CLI 1.0.0-beta.24 — Cifrão literal no
--help: o--helpmostra como escapar um cifrão com barra invertida, como emPASSWORD=pa\$word, ou usar JSON para preservar o valor exato. O texto também recomenda arquivos dotenv confiáveis, porque a referência alcança qualquer variável de ambiente do processo.
Correções
A publicação não registra correção de comportamento.
Ponto de Atenção
O Wrangler mantém o registro padrão próprio, então processos que precisam compartilhar recursos de desenvolvimento com o cf dependem do mesmo CLOUDFLARE_DEV_REGISTRY_PATH. A expansão de variáveis no arquivo de segredos alcança o ambiente do processo e pode enviar valores que não estavam no arquivo. Teste sugerido: rode cf dev num projeto com plugin da Cloudflare para Vite, liste os recursos locais e confirme que os dois processos enxergam o mesmo registro. Depois faça um Direct Upload de Pages com --worker-js @./_worker.js e confira o arquivo no deploy.
Notas da versão
As mudanças estão nas notas oficiais do Cloudflare CLI 1.0.0-beta.24, publicadas em 27/10/2026. A publicação é uma pré-release da linha 1.0.0.