Aidez à améliorer cette page

Les traductions sont fournies par des outils de traduction automatique. En cas de conflit entre le contenu d'une traduction et celui de la version originale en anglais, la version anglaise prévaudra.

Pour contribuer à ce guide de l'utilisateur, cliquez sur le GitHub lien Modifier cette page qui se trouve dans le volet droit de chaque page.

Les traductions sont fournies par des outils de traduction automatique. En cas de conflit entre le contenu d'une traduction et celui de la version originale en anglais, la version anglaise prévaudra.

Résoudre les problèmes liés aux fonctionnalités KRO

La fonctionnalité est ACTIVE mais ResourceGraphDefinitions ne fonctionne pas

Si votre fonctionnalité KRO affiche un ACTIVE statut mais ResourceGraphDefinitions ne crée pas de ressources sous-jacentes, vérifiez l'état de la fonctionnalité, les autorisations RBAC et l'état des ressources.

Vérifiez l'état des capacités  :

Vous pouvez consulter les problèmes d'état et d'état des fonctionnalités dans la console EKS ou à l'aide de l' AWS interface de ligne de commande.

Console  :

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

Causes courantes :

Vérifiez les autorisations RBAC :

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

Si la fonctionnalité ne dispose pas des autorisations requises, associez-la à l'AmazonEKSClusterAdminPolicyentrée d'accès de la fonctionnalité kro ou créez des politiques RBAC plus restrictives pour une utilisation en production. Consultez Configurer les autorisations Kro pour plus de détails.

ResourceGraphDefinition État de la vérification  :

# 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}'

ResourceGraphDefinitions avoir trois conditions de statut clés :

Si ResourceGraphAccepted c'est le casFalse, vérifiez que le message de condition ne contient pas d'erreurs de validation, telles que des champs inconnus, des incohérences de type ou des dépendances circulaires.

Instances créées mais les ressources sous-jacentes n'apparaissent pas

S'il existe des instances de ressources personnalisées mais que les ressources Kubernetes sous-jacentes (déploiements, services ConfigMaps) ne sont pas créées, vérifiez que kro dispose des autorisations nécessaires et vérifiez les erreurs de composition.

Vérifiez l'état de l'instance  :

# 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}'

Les instances disposent d'un state champ indiquant l'état de haut niveau :

Les instances ont également quatre conditions de statut :

Concentrez-vous sur l'Readyétat pour déterminer l'état de santé de l'instance. Si Ready c'est le casFalse, vérifiez les sous-conditions pour identifier la phase qui a échoué.

Vérifiez les autorisations RBAC :

La fonctionnalité kro nécessite des autorisations pour créer les ressources Kubernetes sous-jacentes définies dans votre. ResourceGraphDefinitions

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

Si des autorisations sont manquantes, associez-les à l'AmazonEKSClusterAdminPolicyentrée d'accès de la fonctionnalité kro ou créez des politiques RBAC plus restrictives pour une utilisation en production. Consultez Configurer les autorisations Kro pour plus de détails.

Erreurs d'expression CEL

Les erreurs d'expression CEL sont détectées au moment de ResourceGraphDefinition la création, et non lors de la création des instances. kro valide toute la syntaxe CEL, vérifie le type des expressions par rapport aux schémas Kubernetes et vérifie l'existence des champs lorsque vous créez le RGD.

Erreurs de validation CEL courantes  :

Vérifiez l'état de validation du 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
      

Si ResourceGraphAccepted c'est le casFalse, le message de condition contient l'erreur de validation.

Exemples d'expressions CEL valides  :

# 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}

Les dépendances aux ressources ne sont pas résolues

kro déduit automatiquement les dépendances à partir des expressions CEL et crée les ressources dans le bon ordre. Si les ressources ne sont pas créées comme prévu, vérifiez l'ordre de dépendance et l'état de préparation des ressources.

Afficher l'ordre de création calculé :

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

Cela montre l'ordre calculé en fonction des références d'expression CEL entre les ressources.

Vérifiez l'état de préparation des ressources  :

# 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}'

Vérifiez les conditions ReadyWhen (si elles sont utilisées)  :

Le champ readyWhen est facultatif. Si ce n'est pas spécifié, les ressources sont considérées comme prêtes immédiatement après leur création. Si vous avez défini readyWhen des conditions, vérifiez qu'elles vérifient correctement l'état de préparation des ressources :

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

Vérifiez les événements liés aux ressources  :

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

Échecs de validation du schéma

Si les instances ne sont pas créées en raison d'erreurs de validation du schéma, vérifiez que l'instance répond aux exigences du schéma RGD.

Vérifiez les erreurs de validation  :

# 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"

Problèmes de validation courants  :

Révisez le schéma RGD :

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

Assurez-vous que votre instance fournit tous les champs obligatoires avec les types corrects.

Étapes suivantes