Lavorare con risorse di capacità

Questo argomento descrive le operazioni comuni per la gestione delle risorse funzionali per tutti i tipi di capacità.

Risorse di funzionalità EKS

Le funzionalità EKS sono AWS risorse che abilitano funzionalità gestite sul tuo cluster Amazon EKS. Le funzionalità vengono eseguite in EKS, eliminando la necessità di installare e gestire controller e altri componenti operativi sui nodi di lavoro. Le funzionalità vengono create per uno specifico cluster EKS e rimangono associate a quel cluster per l'intero ciclo di vita.

Ogni risorsa funzionale ha:

• Un nome univoco all'interno del cluster

• Un tipo di funzionalità (ACK, ARGOCD o KRO)

• Un Amazon Resource Name (ARN), che specifica sia il nome che il tipo

• Un ruolo IAM basato sulla capacità

• Uno stato che indica lo stato attuale

• Configurazione, generica e specifica per il tipo di funzionalità

Comprensione dello stato delle capacità

Le risorse funzionali hanno uno stato che indica il loro stato attuale. È possibile visualizzare lo stato e l'integrità delle funzionalità nella console EKS o utilizzando la AWS CLI.

Console:

1. Apri la console Amazon EKS a https://console.aws.amazon.com/eks/home#/clusters.

2. Seleziona il nome del cluster.

3. Scegli la scheda Capacità per visualizzare lo stato di tutte le funzionalità.

4. Per informazioni dettagliate sullo stato di salute, scegli la scheda Osservabilità, quindi Monitor cluster, quindi la scheda Capacità.

AWS CLI:

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

Stati delle capacità

CREAZIONE: La funzionalità è in fase di configurazione. Puoi allontanarti dalla console: la funzionalità continuerà a creare in background.

ATTIVA: La funzionalità è attiva e pronta per l'uso. Se le risorse non funzionano come previsto, controlla lo stato delle risorse e le autorizzazioni IAM. Per ulteriori informazioni, consulta Risoluzione dei problemi delle funzionalità EKS.

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

ELIMINAZIONE: la funzionalità viene rimossa dal cluster.

CREATE_FAILED: l'installazione ha rilevato un errore. Le cause più comuni includono:

• La politica di fiducia dei ruoli IAM è errata o mancante

• Il ruolo IAM non esiste o non è accessibile

• Problemi di accesso al cluster

• Parametri di configurazione non validi

Consulta la sezione relativa allo stato delle funzionalità per dettagli specifici sugli errori.

UPDATE_FAILED: aggiornamento della configurazione non riuscito. Controlla la sezione sullo stato delle funzionalità per i dettagli e verifica le autorizzazioni IAM.

Suggerimento

Per una guida dettagliata alla risoluzione dei problemi, consulta:

• Risoluzione dei problemi delle funzionalità EKS- Risoluzione dei problemi generali relativi alle funzionalità

• Risolvi i problemi relativi alle funzionalità ACK- Problemi specifici dell'ACK

• Risolvi i problemi relativi alle funzionalità di Argo CD- Problemi specifici di Argo CD

• Risolvi i problemi relativi alle funzionalità kro- problemi specifici per kro

Crea funzionalità

Per creare una funzionalità sul tuo cluster, consulta i seguenti argomenti:

• Crea una funzionalità ACK— Crea una funzionalità ACK per gestire AWS le risorse utilizzando Kubernetes APIs

• Crea una funzionalità Argo CD— Crea una funzionalità Argo CD per la distribuzione continua GitOps

• Crea una funzionalità kro— Crea una funzionalità kro per la composizione e l'orchestrazione delle risorse

Elenca le funzionalità

È possibile elencare tutte le risorse funzionali presenti in un cluster.

Console

1. Apri la console Amazon EKS a https://console.aws.amazon.com/eks/home#/clusters.

2. Seleziona il nome del cluster per aprire la pagina dei dettagli del cluster.

3. Scegli la scheda Capacità.

4. Visualizza le risorse relative alle funzionalità in Funzionalità gestite.

AWS CLI

Usa il list-capabilities comando per visualizzare tutte le funzionalità del tuo cluster. Sostituiscilo region-code con la AWS regione in cui si trova il cluster e sostituiscilo my-cluster con il nome del cluster.

aws eks list-capabilities \
  --region region-code \
  --cluster-name my-cluster
         

{
    "capabilities": [
        {
            "capabilityName": "my-ack",
            "arn": "arn:aws:eks:us-west-2:111122223333:capability/my-cluster/ack/my-ack/abc123",
            "type": "ACK",
            "status": "ACTIVE",
            "createdAt": "2025-11-02T10:30:00.000000-07:00",
            "modifiedAt": "2025-11-02T10:32:15.000000-07:00",
        },
        {
            "capabilityName": "my-kro",
            "arn": "arn:aws:eks:us-west-2:111122223333:capability/my-cluster/kro/my-kro/abc123",
            "type": "KRO",
            "status": "ACTIVE",
            "version": "v0.6.3",
            "createdAt": "2025-11-02T10:30:00.000000-07:00",
            "modifiedAt": "2025-11-02T10:32:15.000000-07:00",
        },
        {
            "capabilityName": "my-argocd",
            "arn": "arn:aws:eks:us-west-2:111122223333:capability/my-cluster/argocd/my-argocd/abc123",
            "type": "ARGOCD",
            "status": "ACTIVE",
            "version": "3.1.8-eks-1",
            "createdAt": "2025-11-21T08:22:28.486000-05:00",
            "modifiedAt": "2025-11-21T08:22:28.486000-05:00"
        }
    ]
}

Descrivi una funzionalità

Ottieni informazioni dettagliate su una funzionalità specifica, inclusi la configurazione e lo stato.

Console

1. Apri la console Amazon EKS a https://console.aws.amazon.com/eks/home#/clusters.

2. Seleziona il nome del cluster per aprire la pagina dei dettagli del cluster.

3. Scegli la scheda Capacità.

4. Scegli la funzionalità che desideri visualizzare in Funzionalità gestite.

5. Visualizza i dettagli delle funzionalità, tra cui lo stato, la configurazione e l'ora di creazione.

AWS CLI

Utilizzate il describe-capability comando per visualizzare informazioni dettagliate. Sostituisci region-code con la AWS regione in cui si trova il cluster, sostituisci my-cluster con il nome del cluster e sostituisci capability-name con il nome della funzionalità (ack, argocd o kro).

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

Output di esempio:

{
  "capability": {
    "capabilityName": "my-ack",
    "capabilityArn": "arn:aws:eks:us-west-2:111122223333:capability/my-cluster/ack/my-ack/abc123",
    "clusterName": "my-cluster",
    "type": "ACK",
    "roleArn": "arn:aws:iam::111122223333:role/AmazonEKSCapabilityACKRole",
    "status": "ACTIVE",
    "configuration": {},
    "tags": {},
    "health": {
      "issues": []
    },
    "createdAt": "2025-11-19T17:11:30.242000-05:00",
    "modifiedAt": "2025-11-19T17:11:30.242000-05:00",
    "deletePropagationPolicy": "RETAIN"
  }
}

Aggiorna la configurazione di una funzionalità

È possibile aggiornare alcuni aspetti della configurazione di una funzionalità dopo la creazione. Le opzioni di configurazione specifiche variano in base al tipo di funzionalità.

Nota

Le risorse di funzionalità EKS sono completamente gestite, comprese le patch e gli aggiornamenti delle versioni. L'aggiornamento di una funzionalità aggiornerà la configurazione delle risorse e non comporterà aggiornamenti di versione dei componenti delle funzionalità gestite.

AWS CLI

Usa il update-capability comando per modificare una funzionalità:

aws eks update-capability \
  --region region-code \
  --cluster-name my-cluster \
  --capability-name capability-name \
  --role-arn arn:aws:iam::[.replaceable]111122223333:role/NewCapabilityRole
         

Nota

Non tutte le proprietà delle funzionalità possono essere aggiornate dopo la creazione. Fate riferimento alla documentazione specifica sulle funzionalità per i dettagli su cosa è possibile modificare.

Eliminare una funzionalità

Quando non è più necessaria una funzionalità nel cluster, è possibile eliminare la risorsa relativa alla capacità.

Importante

Eliminare le risorse del cluster prima di eliminare la funzionalità.

L'eliminazione di una risorsa di capacità non elimina automaticamente le risorse create tramite tale funzionalità:

• Tutte le Kubernetes Custom Resource Definitions (CRDs) rimangono installate nel cluster.

• Le risorse ACK rimangono nel cluster e le AWS risorse corrispondenti rimangono nel tuo account

• Le applicazioni Argo CD e le relative risorse Kubernetes rimangono nel cluster

• kro ResourceGraphDefinitions e le istanze rimangono nel cluster

È necessario eliminare queste risorse prima di eliminare la funzionalità per evitare risorse orfane.

Facoltativamente, puoi scegliere di conservare AWS le risorse associate alle risorse ACK Kubernetes. Consulta le considerazioni su ACK

Console

1. Apri la console Amazon EKS a https://console.aws.amazon.com/eks/home#/clusters.

2. Seleziona il nome del cluster per aprire la pagina dei dettagli del cluster.

3. Scegli la scheda Capacità.

4. Seleziona la funzionalità che desideri eliminare dall'elenco delle funzionalità gestite.

5. Scegli la funzionalità Elimina.

6. Nella finestra di dialogo di conferma, digita il nome della funzionalità per confermare l'eliminazione.

7. Scegli Elimina.

AWS CLI

Usa il delete-capability comando per eliminare una risorsa di funzionalità:

Sostituisci region-code con la AWS regione in cui si trova il cluster, sostituisci my-cluster con il nome del cluster e sostituisci capability-name con il nome della funzionalità da eliminare.

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

Fasi successive

• Capability: risorse Kubernetes— Scopri le risorse Kubernetes fornite da ciascun tipo di funzionalità

• Concetti ACK— Comprendi i concetti e il ciclo di vita delle risorse di ACK

• Lavorare con Argo CD— Utilizzo delle funzionalità di Argo CD per i flussi di lavoro GitOps

• concetti kro— Comprendi i concetti kro e la composizione delle risorse