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à.

Lavorare con risorse di capacità

Elenca, descrivi, aggiorna ed elimina le risorse di funzionalità sui tuoi cluster Amazon EKS.

Risorse relative alle 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 mantenere controller e altri componenti operativi sui nodi di lavoro. Le funzionalità vengono create per un cluster EKS specifico e rimangono affiliate a quel cluster per l'intero ciclo di vita.

Ogni risorsa di funzionalità ha:

Comprensione dello stato della capacità

Lo stato delle risorse di capacità indica il loro stato attuale. È possibile visualizzare lo stato e l'integrità delle funzionalità nella console EKS o utilizzando la AWS CLI.

Console:

AWS CLI:

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

Stati delle funzionalità

CREAZIONE: la capacità è in fase di configurazione. È possibile uscire dalla console: la funzionalità continuerà a creare in background.

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

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

ELIMINAZIONE: la funzionalità viene rimossa dal cluster.

CREATE_FAILED: il programma di installazione ha rilevato un errore. Le cause più comuni includono:

Controlla la sezione sullo 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.

Crea funzionalità

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

Elenca le funzionalità

È possibile elencare tutte le risorse di funzionalità in un cluster.

Console

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, inclusa la sua configurazione e lo stato.

Console

AWS CLI

Usa 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 tuo cluster e sostituisci capability-name con il nome che hai dato alla tua capacità quando l'hai creata (ad esempiomy-ack,my-argocd, omy-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à.

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::111122223333:role/NewCapabilityRole
         

Eliminare una funzionalità

Quando non è più necessaria una funzionalità sul cluster, è possibile eliminare la risorsa di funzionalità.

Console

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 tuo cluster e sostituisci capability-name con il nome della capacità da eliminare.

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

Fasi successive