Resumo
O Kestra v2.0.0 altera o contrato de erros da API, leva o AI Copilot ao editor No-Code e amplia filtros, dashboards, assets e recursos operacionais. A versão principal exige revisão de clientes da API e de configurações que ainda usem a propriedade removida em pluginDefaults.
Novidades
- Kestra v2.0.0 — AI Copilot: o editor No-Code recebe o Copilot, provedores aceitam headers HTTP personalizados e a interface informa trocas de modelo ou de página consultada.
- Kestra v2.0.0 — CLI e execução: o novo comando
configuration-schemagera JSON Schema, o modo API-only pode desativar a interface e execuções recebem listas de permissão ou recusa para tarefas HTTP. - Kestra v2.0.0 — Assets e dashboards: dependências ganham visualização em DAG com freshness e filtros, enquanto gráficos aceitam mais formatos de exportação, carregamento progressivo e dashboards padrão.
- Kestra v2.0.0 — Segurança e operação: requisições autenticadas por cookie recebem proteção CSRF, arquivos ZIP passam por proteção contra expansão abusiva e a API expõe status de manutenção e métricas de instâncias de serviço.
Melhorias
- Kestra v2.0.0 — Interface: login, configurações, onboarding, Gantt, blueprints e referências de namespace ou flow recebem componentes e navegação revisados.
- Kestra v2.0.0 — Observabilidade: logs de TaskRuns dinâmicas aparecem na hierarquia correta, workers informam detalhes no caminho de falha e métricas acompanham pausa ou retomada de subscribers.
- Kestra v2.0.0 — SDK e autenticação: o repositório gera o SDK JavaScript e TypeScript, inclui URL na autenticação padrão e usa autenticação básica como fallback na edição OSS.
Correções
- Kestra v2.0.0 — Execuções e estado: estatísticas passam ao repositório dedicado, o andamento usa duração média e o tratamento de datas evita uma falha quando o estado não possui valor final.
- Kestra v2.0.0 — Interface e filtros: componentes de seleção, outputs e consultas recebem ajustes para estados vazios, seleção integral e campos protegidos.
Breaking changes
- Kestra v2.0.0 — Respostas da API: erros seguem RFC 9457 e usam
application/problem+json. A resposta removemessage,_linkse_embedded.errors[]; clientes devem lertypeedetail, e endpoints em lote usamerrors[]no lugar deinvalids[]. - Kestra v2.0.0 — Configuração de plugins: a flag
forcedfoi removida depluginDefaultsno nível do flow. Configurações que ainda declaram essa propriedade precisam ser revisadas antes da atualização.
Ponto de Atenção
- Kestra v2.0.0 — Migração: revise clientes HTTP, tratamento de erros em lote e arquivos de flow durante a preparação do deploy. A mudança de media type pode exigir ajustes em parsers, SDKs e testes de contrato.
- Kestra v2.0.0 — Teste sugerido: provoque um erro simples e uma falha em lote pela API, confirme
application/problem+json,type,detaileerrors[], e valide um flow que usavapluginDefaultsantes de atualizar o ambiente principal.
Notas da versão
- Kestra v2.0.0 — Publicação oficial: consulte o release no GitHub, publicado em 7 de setembro de 2026.