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 su che si trova 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 relativi alle funzionalità EKS

Approccio generale alla risoluzione dei problemi

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

Usa i log del controller per la risoluzione dei problemi

Se hai configurato la distribuzione dei log dei 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 uno specifico controller di servizio ACK:

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

Per filtrare ulteriormente per 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

Usa il application campo per isolare i log per 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

Usa 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 sullo stato tramite la console EKS e l'describe-capabilityAPI.

Console:

La scheda Funzionalità mostra:

AWS CLI:

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

La risposta include:

Stati di capacità comuni

CREAZIONE: la funzionalità è in fase di configurazione.

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

AGGIORNAMENTO: le modifiche alla configurazione sono in corso di applicazione. Attendi il ripristino dello statoACTIVE.

CREATE_FAILED o UPDATE_FAILED: durante l'installazione o l'aggiornamento si è verificato un errore. Per i dettagli, consulta la sezione sullo stato di salute. 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 relative allo stato delle risorse forniscono informazioni su:

Rivedi le autorizzazioni IAM e l'accesso al cluster

Molti problemi di funzionalità derivano da problemi di autorizzazione IAM o da una configurazione di accesso al cluster mancante. Verifica sia le autorizzazioni del Capability Role che le voci di accesso al cluster.

Controlla le autorizzazioni del ruolo IAM

Verifica che il Capability Role 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 le voci di accesso e le politiche di accesso EKS appropriate sul cluster in cui operano.

Verifica l'esistenza di una voce di accesso:

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 multi-cluster di Argo CD:

In caso di distribuzione su cluster remoti, verifica che il Capability Role abbia una voce di accesso 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 capacità rimane nello CREATING stato più a lungo del previsto:

Risorse non create o aggiornate

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

L'integrità delle capacità mostra problemi

Se describe-capability mostra problemi di salute:

Fasi successive