Contribuisci a migliorare questa pagina

Le traduzioni sono generate tramite traduzione automatica. In caso di conflitto tra il contenuto di una traduzione e la versione originale in Inglese, quest'ultima prevarrà.

Per contribuire a questa guida per l'utente, scegli il GitHub link Modifica questa pagina nel riquadro destro di ogni pagina.

Le traduzioni sono generate tramite traduzione automatica. In caso di conflitto tra il contenuto di una traduzione e la versione originale in Inglese, quest'ultima prevarrà.

Risoluzione dei problemi delle funzionalità EKS

Un approccio generale alla risoluzione dei problemi

Per la risoluzione dei problemi relativi a EKS Capabilities, seguite questo approccio generale:

Utilizza i registri del controller per la risoluzione dei problemi

Se hai configurato la consegna dei log del controller (vediAccedi ai registri del controller EKS Capabilities), puoi interrogare i log per identificare errori di riconciliazione, conflitti di risorse e problemi di configurazione.

Errori di interrogazione su tutti i controller

fields @timestamp, controller, message, error
| filter level = "error"
| sort @timestamp desc
| limit 50

Filtra i log per uno specifico controller di servizio ACK

Usa il controllerGroup campo per isolare i log da un controller di servizio ACK specifico:

fields @timestamp, message, error
| filter controllerGroup = "s3.services.k8s.aws"
| filter level = "error"
| sort @timestamp desc

Per filtrare ulteriormente in base al tipo di risorsa (ad esempio, solo SecurityGroup i log del controller EC2):

fields @timestamp, message, error
| filter controllerGroup = "ec2.services.k8s.aws"
| filter controllerKind = "SecurityGroup"
| sort @timestamp desc
| limit 100

Filtrare i log per una specifica applicazione Argo CD

Utilizzate il application campo per isolare i log di una particolare applicazione Argo CD:

fields @timestamp, message, error
| filter application = "my-application"
| sort @timestamp desc
| limit 100

Tieni traccia della riconciliazione per una risorsa specifica

Utilizza il reconcileID campo per seguire un singolo ciclo di riconciliazione:

fields @timestamp, level, message, error
| filter reconcileID = "your-reconcile-id"
| sort @timestamp asc

Schemi di registro comuni che indicano problemi

Verifica lo stato della funzionalità

Tutte le funzionalità EKS forniscono informazioni sanitarie tramite la console EKS e l'describe-capabilityAPI.

Console:

La scheda Capacità mostra:

AWS CLI:

aws eks describe-capability \
  --region region-code \
  --cluster-name my-cluster \
  --capability-name my-capability-name
      

La risposta include:

Stati di funzionalità comuni

CREAZIONE: La funzionalità è in fase di configurazione.

ATTIVO: La funzionalità è attiva e pronta all'uso. Se le risorse non funzionano come previsto, controlla lo stato delle risorse e le autorizzazioni IAM.

AGGIORNAMENTO: vengono applicate le modifiche alla configurazione. Attendi che lo stato ritorni aACTIVE.

CREATE_FAILED o UPDATE_FAILED: durante l'installazione o l'aggiornamento si è verificato un errore. Consulta la sezione dedicata alla salute per i dettagli. Cause comuni:

Verifica lo stato delle risorse Kubernetes

EKS Capabilities crea e gestisce le Kubernetes Custom Resource Definitions (CRD) nel tuo cluster. Durante la risoluzione dei problemi, controlla lo stato delle risorse che hai creato:

# List resources of a specific type
kubectl get resource-kind -A

# Describe a specific resource to see conditions and events
kubectl describe resource-kind
         resource-name -n namespace

# View resource status conditions
kubectl get resource-kind
         resource-name -n namespace -o jsonpath='{.status.conditions}'

# View events related to the resource
kubectl get events --field-selector involvedObject.name=resource-name -n namespace
      

Le condizioni sullo stato delle risorse forniscono informazioni su:

Verifica le autorizzazioni IAM e l'accesso al cluster

Molti problemi di funzionalità derivano da problemi di autorizzazione IAM o dalla mancata configurazione dell'accesso al cluster. Verifica sia le autorizzazioni di Capability Role che le voci di accesso al cluster.

Controlla le autorizzazioni dei ruoli IAM

Verifica che il ruolo Capability disponga delle autorizzazioni necessarie:

# List attached managed policies
aws iam list-attached-role-policies --role-name my-capability-role

# List inline policies
aws iam list-role-policies --role-name my-capability-role

# Get specific policy details
aws iam get-role-policy --role-name my-capability-role --policy-name policy-name

# View the role's trust policy
aws iam get-role --role-name my-capability-role --query 'Role.AssumeRolePolicyDocument'

La politica di fiducia deve consentire al responsabile del capabilities.eks.amazonaws.com servizio:

{
  "Version": "2012-10-17",
  "Statement": [
    {
      "Effect": "Allow",
      "Principal": {
        "Service": "capabilities.eks.amazonaws.com"
      },
      "Action": "sts:AssumeRole"
    }
  ]
}

Controlla le voci di accesso e le politiche di accesso di EKS

Tutte le funzionalità richiedono voci di accesso e politiche di accesso EKS adeguate nel cluster in cui operano.

Verifica che esista Access Entry:

aws eks list-access-entries \
  --cluster-name my-cluster \
  --region region-code
         

Cerca il Capability Role ARN nell'elenco. Se manca, la funzionalità non può accedere al cluster.

Controlla le politiche di accesso allegate alla voce:

aws eks list-associated-access-policies \
  --cluster-name my-cluster \
  --principal-arn arn:aws:iam::111122223333:role/my-capability-role \
  --region region-code
         

Tutte le funzionalità richiedono politiche di accesso appropriate:

Per le implementazioni multicluster di Argo CD:

Se effettui la distribuzione su cluster remoti, verifica che il Capability Role abbia un Access Entry su ogni cluster di destinazione:

# Check Access Entry on target cluster
aws eks describe-access-entry \
  --cluster-name target-cluster \
  --principal-arn arn:aws:iam::111122223333:role/argocd-capability-role \
  --region region-code
         

Se l'Access Entry non è presente in un cluster di destinazione, Argo CD non può distribuire applicazioni su di esso. Registra i cluster di destinazionePer i dettagli di configurazione, vedere.

Capability-specific risoluzione dei problemi

Per una guida dettagliata alla risoluzione dei problemi specifica per ogni tipo di funzionalità:

Problemi comuni a tutte le funzionalità

Capacità bloccata nello stato CREATING

Se una funzionalità rimane attiva CREATING più a lungo del previsto:

Risorse non create o aggiornate

Se la funzionalità è ACTIVE presente ma le risorse non vengono create o aggiornate:

Lo stato delle capacità mostra problemi

Se describe-capability presenta problemi di salute:

Fasi successive