CEVIU Logo
Voltar

O seu control plane está pronto para o Crossplane v2?

Aprofundamento CEVIU

Aprofundamento

O Crossplane v2 não é só uma atualização de versão: é uma reescrita estrutural do modelo de abstração. Enquanto a v1 tratava infraestrutura como um domínio isolado, a v2 funde aplicações e infra em uma única camada de composição, agora qualquer recurso Kubernetes pode ser incluído em uma Composition, desde Secrets até Deployments. Isso elimina a necessidade de orquestradores paralelos (como Argo CD + Crossplane) para entregar pilhas completas. A mudança para recursos namespaced por padrão também não é só técnica: reduz drasticamente o risco de conflito entre equipes em ambientes multi-tenant, já que XRs e MRs passam a obedecer ao mesmo modelo de RBAC e escopo que os recursos nativos.

As Operations são o novo ponto de entrada para lógica operacional contínua, não mais apenas 'criar e esquecer'. Elas transformam tarefas como renovação de certificados ou rotação de chaves em pipelines observáveis, executados como Jobs com saída estruturada. Isso alinha o Crossplane diretamente com práticas modernas de SRE, onde a confiabilidade depende menos de estado estático e mais de capacidade de resposta a eventos. O comando crossplane beta upgrade check, lançado na v1.20.9, é a primeira peça concreta dessa transição: ele não apenas lista incompatibilidades, mas mapeia cada recurso problemático (ex: um Composition usando patch-and-transform) para a alternativa equivalente na v2 (ex: uma função de pipeline com o novo runtime de funções).

O que mudou

A cobertura anterior do CEVIU sobre o Kubernetes v1.36 (5/2026) mostrou a consolidação da validação declarativa como GA, um movimento paralelo ao do Crossplane v2, que agora leva essa ideia além dos tipos nativos: as Compositions v2 passam a suportar validação declarativa integrada via OpenAPI v3, com erros reportados diretamente no status do recurso composto. Também há evolução direta em relação à cobertura sobre o Claude Code na AWS (6/2026): enquanto aquele artigo destacou auditorias paralelas em IaC, o upgrade check do Crossplane é a primeira ferramenta de análise estática *específica para control planes*, com foco em compatibilidade semântica, não só sintática, ela entende o impacto de remover o ControllerConfig ou external secret stores no fluxo real de provisionamento.

Por que isso importa

Equipes que usam Crossplane para construir plataformas internas precisam entender que migrar para a v2 não é um 'upgrade' técnico, mas uma mudança de contrato operacional. A remoção do patch-and-transform composition exige reescrita de lógicas de personalização; a adoção de namespaces padrão força revisão de políticas de rede e RBAC; e as Operations exigem novos padrões de observabilidade, não basta monitorar o estado do XR, agora é preciso rastrear execuções de pipelines. Ignorar isso gera dívida técnica acumulada em abstrações que deixam de ser mantidas, aumentando o custo de operação em vez de reduzi-lo.

Linha do tempo

  1. Lançamento oficial da Crossplane v2.0, após sete anos de projeto e graduação na CNCF

  2. Lançamento da Crossplane v2.1, primeira versão pós-graduação com foco em estabilidade de APIs

  3. Crossplane v2.2 introduz 'pipeline inspector' em alpha para depuração de composições

  4. Lançamento da Crossplane v2.3, com melhorias em segurança de funções e controle de acesso a secrets

  5. Crossplane v1.20.9 traz o comando 'crossplane beta upgrade check' para preparar migrações para v2

Perguntas frequentes

O comando 'crossplane beta upgrade check' resolve todos os problemas de migração?

Não. Ele identifica incompatibilidades conhecidas e sugere correções, mas não converte automaticamente código. Casos como a substituição de ControllerConfig por ManagedResourcePolicy exigem redesign de fluxos de aprovação e auditoria. A ferramenta é um diagnóstico, não um remediation tool.

Posso usar Crossplane v1 e v2 simultaneamente no mesmo cluster?

Sim, mas com restrições. As APIs v1 continuam suportadas, mas não podem coexistir com recursos v2 no mesmo namespace se compartilharem nomes de tipo. A recomendação oficial é isolar ambientes de migração com namespaces dedicados e usar o upgrade check para priorizar quais composições migrar primeiro.

Quais são os principais riscos operacionais ao adotar as Operations?

Operations rodam como Jobs, então falhas não geram eventos persistentes no estado do recurso. Sem integração com sistemas de alerta ou logs centralizados, erros de execução podem passar despercebidos. É essencial configurar captura de stdout/stderr e vincular métricas de sucesso/falha a dashboards de SLO.

A v2 do Crossplane ainda é compatível com provedores externos como Upbound ou community packages?

Sim, mas com adaptação. Pacotes criados para v1 exigem atualização mínima para declarar compatibilidade com a v2, especialmente se usam funcionalidades removidas. A Upbound já lançou pacotes v2.3-compatíveis para AWS, Azure e GCP, mas pacotes da comunidade podem ter atraso de até duas semanas após cada release trimestral.

Avalie este artigo:
Compartilhar:
Categoria
CEVIU DevOps
Publicado
08 de junho de 2026
Fonte
CEVIU DevOps

Quer receber mais sobre CEVIU DevOps?

Conteúdo curado diariamente, direto no seu e-mail.

Conteúdo curado diariamenteDiversas categoriasCancele quando quiser
O seu control plane está pronto para o Crossplane v2? — CEVIU News