**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à.
# Lavorare con le 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 il suo stato attuale
+ Configurazione, generica e specifica per il tipo di funzionalità
## Comprensione dello stato delle capacità
Le risorse di capacità 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\$1/clusters.
1. Seleziona il nome del cluster.
1. Scegli la scheda **Capacità** per visualizzare lo stato di tutte le funzionalità.
1. 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](capabilities-troubleshooting.md).
**AGGIORNAMENTO**: vengono applicate le modifiche alla configurazione. Attendi che lo stato ritorni a`ACTIVE`.
**ELIMINAZIONE**: la funzionalità viene rimossa dal cluster.
**CREATE\$1FAILED**: 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\$1FAILED: 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](capabilities-troubleshooting.md)- Risoluzione dei problemi generali relativi alle funzionalità
[Risolvi i problemi relativi alle funzionalità ACK](ack-troubleshooting.md)- Problemi specifici dell'ACK
[Risolvi i problemi relativi alle funzionalità di Argo CD](argocd-troubleshooting.md)- Problemi specifici di Argo CD
[Risolvi i problemi relativi alle funzionalità kro](kro-troubleshooting.md)- problemi specifici per kro
## Crea funzionalità
Per creare una funzionalità sul tuo cluster, consulta i seguenti argomenti:
+ [Crea una funzionalità ACK](create-ack-capability.md)— Crea una funzionalità ACK per gestire AWS le risorse utilizzando Kubernetes APIs
+ [Crea una funzionalità Argo CD](create-argocd-capability.md)— Crea una funzionalità Argo CD per la distribuzione continua GitOps
+ [Crea una funzionalità kro](create-kro-capability.md)— 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\$1/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, inclusi la configurazione e lo stato.
### Console
1. Apri la console Amazon EKS a https://console.aws.amazon.com/eks/ home\$1/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 in **Funzionalità gestite**.
1. 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](ack-considerations.md) le considerazioni su ACK
### Console
1. Apri la console Amazon EKS a https://console.aws.amazon.com/eks/ home\$1/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. 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](capability-kubernetes-resources.md)— Scopri le risorse Kubernetes fornite da ciascun tipo di funzionalità
+ [Concetti ACK](ack-concepts.md)— Comprendi i concetti e il ciclo di vita delle risorse di ACK
+ [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 kro e la composizione delle risorse