**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:
+ 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 di capacità
+ Uno stato che ne indica lo stato attuale
+ Configurazione, sia generica che specifica per il tipo di funzionalità
## 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**:
1. Apri la console Amazon EKS all'indirizzo https://console.aws.amazon.com/eks/home \#/clusters.
1. Seleziona il nome del cluster.
1. Scegli la ** scheda ** Funzionalità per visualizzare lo stato di tutte le funzionalità.
1. Per informazioni dettagliate sullo stato di salute, scegli la ** scheda ** Osservabilità, quindi il cluster di ** monitoraggio**, quindi la ** scheda ** Capacità.
** 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](capabilities-troubleshooting.md).
**AGGIORNAMENTO**: le modifiche alla configurazione sono in corso di applicazione. Attendi il ripristino dello stato`ACTIVE`.
**ELIMINAZIONE**: la funzionalità viene rimossa dal cluster.
**CREATE\_FAILED**: il programma di installazione ha rilevato un errore. Le cause più comuni includono:
+ 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
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.
**Suggerimento**
Per una guida dettagliata alla risoluzione dei problemi, consulta:
[Risoluzione dei problemi relativi alle funzionalità EKS](capabilities-troubleshooting.md)- Risoluzione dei problemi relativi alle funzionalità generali
[Risolvi i problemi relativi alle funzionalità ACK](ack-troubleshooting.md)- problemi ACK-specific
[Risolvi i problemi relativi alle funzionalità Argo CD](argocd-troubleshooting.md)- Problemi con Argo CD-specific
[Risolvi i problemi relativi alle funzionalità kro](kro-troubleshooting.md)- problemi kro specifici
## Crea funzionalità
Per creare una funzionalità sul tuo cluster, consulta i seguenti argomenti:
+ [Crea una funzionalità ACK](create-ack-capability.md)— Creare una funzionalità ACK per gestire AWS le risorse utilizzando le API Kubernetes
+ [Crea una funzionalità Argo CD](create-argocd-capability.md)— Creare una funzionalità Argo CD per la distribuzione continua GitOps
+ [Crea una funzionalità kro](create-kro-capability.md)— Creare una funzionalità kro per la composizione e l'orchestrazione delle risorse
## Elenca le funzionalità
È possibile elencare tutte le risorse di funzionalità in un cluster.
### Console
1. Apri la console Amazon EKS all'indirizzo https://console.aws.amazon.com/eks/home \#/clusters.
1. Seleziona il nome del cluster per aprire la pagina dei dettagli del cluster.
1. Scegli la ** scheda ** Funzionalità.
1. 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, inclusa la sua configurazione e lo stato.
### Console
1. Apri la console Amazon EKS all'indirizzo https://console.aws.amazon.com/eks/home \#/clusters.
1. Seleziona il nome del cluster per aprire la pagina dei dettagli del cluster.
1. Scegli la ** scheda ** Funzionalità.
1. Scegli la funzionalità che desideri visualizzare tra le funzionalità ** gestite**.
1. Visualizza i dettagli delle funzionalità, tra cui stato, configurazione e ora di creazione.
### 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 esempio`my-ack`,`my-argocd`, o`my-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, inclusi l'applicazione di 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::111122223333:role/NewCapabilityRole}}
```
**Nota**
Non tutte le proprietà delle funzionalità possono essere aggiornate dopo la creazione. Per informazioni dettagliate su cosa può essere modificato, consulta la documentazione specifica della funzionalità.
## Eliminare una funzionalità
Quando non è più necessaria una funzionalità sul cluster, è possibile eliminare la risorsa di funzionalità.
**Importante**
**Elimina le risorse del cluster prima di eliminare la funzionalità. **
L'eliminazione di una risorsa di capacità non comporta automaticamente l'eliminazione delle risorse create tramite tale capacità:
Tutte le Kubernetes Custom Resource Definitions (CRD) 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 tuo 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. Vedi le considerazioni su ACK [Considerazioni ACK per EKS](ack-considerations.md)
### Console
1. Apri la console Amazon EKS all'indirizzo https://console.aws.amazon.com/eks/home \#/clusters.
1. Seleziona il nome del cluster per aprire la pagina dei dettagli del cluster.
1. Scegli la ** scheda ** Funzionalità.
1. Seleziona la funzionalità che desideri eliminare dall'elenco delle funzionalità ** gestite**.
1. Scegli la funzionalità ** Elimina**.
1. Nella finestra di dialogo di conferma, digita il nome della funzionalità per confermare l'eliminazione.
1. Scegliere **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 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
+ [Capability: risorse Kubernetes](capability-kubernetes-resources.md)— Scopri le risorse Kubernetes fornite da ciascun tipo di funzionalità
+ [Concetti ACK](ack-concepts.md)— Comprendi i concetti di ACK e il ciclo di vita delle risorse
+ [Lavorare con Argo CD](working-with-argocd.md)— Utilizzo delle funzionalità di Argo CD per i flussi di lavoro GitOps
+ [concetti kro](kro-concepts.md)— Comprendi i concetti di kro e la composizione delle risorse