Ajudar a melhorar esta página

Para contribuir com este guia de usuário, escolha o link Editar esta página no GitHub, disponível no painel direito de cada página.

Solução de problemas em funcionalidades do kro

Este tópico fornece orientações para a solução de problemas à funcionalidade do EKS para o kro, incluindo verificações de integridade da funcionalidade, permissões de RBAC, erros relacionados à expressão CEL e problemas de composição de recursos.

A funcionalidade está com o status ACTIVE, mas as ResourceGraphDefinitions não estão funcionando

Se a funcionalidade do kro apresentar o status ACTIVE, mas as ResourceGraphDefinitions não estiverem criando recursos subjacentes, verifique a integridade da funcionalidade, as permissões de RBAC e o status do recurso.

Verifique a integridade da funcionalidade:

Você pode visualizar problemas de integridade e de status da funcionalidade no console do EKS ou usando a AWS CLI.

Console do:

AWS CLI:

# View capability status and health
aws eks describe-capability \
  --region region-code \
  --cluster-name my-cluster \
  --capability-name my-kro

# Look for issues in the health section

Causas comuns:

Verifique as permissões do RBAC:

# Check if capability has cluster admin policy
kubectl get accessentry -A | grep kro

Se a funcionalidade não tiver as permissões necessárias, associe a política AmazonEKSClusterAdminPolicy à entrada de acesso da funcionalidade do kro ou crie políticas de RBAC mais restritivas para uso em ambientes de produção. Para mais detalhes, consulte Configuração de permissões do kro.

Verifique o status da ResourceGraphDefinition:

# List all RGDs
kubectl get resourcegraphdefinition

# Describe specific RGD
kubectl describe resourcegraphdefinition my-rgd

# Check for validation errors
kubectl get resourcegraphdefinition my-rgd -o jsonpath='{.status.conditions}'

As ResourceGraphDefinitions contam com três condições de status fundamentais:

Se ResourceGraphAccepted for False, verifique a mensagem da condição para erros de validação, como campos desconhecidos, incompatibilidades de tipo ou dependências circulares.

As instâncias foram criadas, porém os recursos subjacentes não estão sendo exibidos

Se existirem instâncias de recursos personalizados, mas os recursos subjacentes do Kubernetes (como Deployments, Services e ConfigMaps) não estiverem sendo criados, valide as permissões do kro e verifique se há erros na composição.

Verifique o status da instância:

# Describe the instance (replace with your custom resource kind and name)
kubectl describe custom-kind
         my-instance

# View instance events
kubectl get events --field-selector involvedObject.name=my-instance

# Check instance status conditions
kubectl get custom-kind
         my-instance -o jsonpath='{.status.conditions}'

# Check instance state
kubectl get custom-kind
         my-instance -o jsonpath='{.status.state}'

As instâncias têm um campo state que indica o status geral:

Além disso, as instâncias contam com quatro condições de status:

Monitore a condição Ready para determinar a integridade da instância. Se Ready for False, verifique as subcondições para identificar em qual fase ocorreu a falha.

Verifique as permissões do RBAC:

A funcionalidade do kro precisa de permissões para criar os recursos subjacentes do Kubernetes, definidos nas ResourceGraphDefinitions.

# Check if the capability has the AmazonEKSClusterAdminPolicy
kubectl get accessentry -A | grep kro

Se as permissões estiverem ausentes, associe a política AmazonEKSClusterAdminPolicy à entrada de acesso da funcionalidade do kro ou crie políticas de RBAC mais restritivas para uso em ambientes de produção. Para mais detalhes, consulte Configuração de permissões do kro.

Erros em expressões CEL

Os erros em expressões CEL são detectados no momento da criação da ResourceGraphDefinition, e não quando as instâncias são criadas. O kro valida toda a sintaxe do CEL, verifica os tipos das expressões em relação aos esquemas do Kubernetes e verifica a existência de campos ao criar a RGD.

Erros comuns de validação em expressões CEL:

Verifique o status de validação da RGD:

# Check if RGD was accepted
kubectl get resourcegraphdefinition my-rgd -o jsonpath='{.status.conditions[?(@.type=="ResourceGraphAccepted")]}'

# View detailed validation errors
kubectl describe resourcegraphdefinition my-rgd
      

Se ResourceGraphAccepted for False, a mensagem da condição conterá o erro de validação.

Exemplos de expressões CEL válidas:

# Reference schema field
${schema.spec.appName}

# Conditional expression
${schema.spec.replicas > 1}

# String template (expressions must return strings)
name: "${schema.spec.appName}-service"

# Standalone expression (can be any type)
replicas: ${schema.spec.replicaCount}

# Resource reference
${deployment.status.availableReplicas}

# Optional field access (returns null if field doesn't exist)
${configmap.data.?DATABASE_URL}

As dependências de recursos não estão sendo resolvidas

O kro identifica dependências automaticamente por meio das expressões CEL, garantindo a criação dos recursos na sequência correta. Se os recursos não estiverem sendo criados conforme o esperado, verifique a ordem de dependência e a prontidão dos recursos.

Confira a ordem de criação definida pelo sistema:

# See the order kro will create resources
kubectl get resourcegraphdefinition my-rgd -o jsonpath='{.status.topologicalOrder}'

Isso mostra a ordem definida pelo sistema com base nas referências de expressões CEL entre os recursos.

Verifique a prontidão dos recursos:

# View instance status to see which resources are ready
kubectl get custom-kind
         my-instance -o jsonpath='{.status}'

# Check specific resource status
kubectl get deployment my-deployment -o jsonpath='{.status.conditions}'

Verifique as condições readyWhen (se houver):

O campo readyWhen é opcional. Se não for especificado, os recursos serão considerados prontos imediatamente após a criação. Se você definiu condições readyWhen, confirme se elas estão verificando o estado de prontidão do recurso de forma correta:

resources:
  - id: deployment
    readyWhen:
      - ${deployment.status.availableReplicas == deployment.spec.replicas}

Verifique os eventos do recurso:

# View events for the underlying resources
kubectl get events -n namespace --sort-by='.lastTimestamp'

Ocorrem falhas de validação do esquema

Se a criação de instâncias falhar devido a erros de validação do esquema, verifique se a instância corresponde aos requisitos de esquema da RGD.

Verifique os erros de validação:

# Attempt to create instance and view error
kubectl apply -f instance.yaml

# View existing instance validation status
kubectl describe custom-kind
         my-instance | grep -A 5 "Validation"

Problemas comuns de validação:

Analise o esquema da RGD:

# View the schema definition
kubectl get resourcegraphdefinition my-rgd -o jsonpath='{.spec.schema}'

Certifique-se de que sua instância contenha todos os campos requeridos com os respectivos tipos configurados corretamente.

Próximas etapas