**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à.
# Connettere un cluster Kubernetes esterno alla Console di gestione Amazon EKS
È possibile collegare un cluster Kubernetes esterno ad Amazon EKS utilizzando più metodi, come illustrato nel seguente processo. Questo processo prevede due passaggi: registrare il cluster con Amazon EKS e installare l'agente `eks-connector` nel cluster.
**Importante**
È necessario completare il secondo passaggio entro 3 giorni dal completamento del primo passaggio, ossia prima che la registrazione scada.
## Considerazioni
È possibile utilizzare i manifesti YAML durante l’installazione dell’agente. In alternativa, puoi usare Helm se registri il cluster con Console di gestione AWS o AWS Command Line Interface. Tuttavia, non è possibile utilizzare Helm per installare l’agente se si registra il cluster con `eksctl`.
## Prerequisiti
+ Assicurati di avere creato il ruolo agente del connettore Amazon EKS. Seguire i passaggi descritti alla pagina [Creating the Amazon EKS connector agent role](connector-iam-role.md#create-connector-role).
+ È necessario disporre delle autorizzazioni seguenti per registrare un cluster:
+ `eks:RegisterCluster`
+ `ssm:CreateActivation`
+ `ssm:DeleteActivation`
+ `iam:PassRole`
## Fase 1: Registrazione del cluster
Per registrare un cluster in Amazon EKS Connector, è possibile utilizzare uno dei seguenti strumenti:
+ [AWS CLI](#awscli_register_cluster_connect)
+ [Console di gestione AWS](#console_register_cluster_connect)
+ [`eksctl`](#eksctl_register_cluster_connect)
### AWS CLI
1. AWS La CLI deve essere installata. Per installarlo o aggiornarlo, consulta [Installazione della AWS CLI](https://docs.aws.amazon.com/cli/latest/userguide/cli-chap-install.html).
1. Per la configurazione del plug-in, specificare il ruolo IAM dell'agente Amazon EKS Connector. Per ulteriori informazioni, consulta [Ruoli IAM richiesti per Amazon EKS Connector](eks-connector.md#connector-iam-permissions).
```
aws eks register-cluster \
--name my-first-registered-cluster \
--connector-config roleArn=arn:aws: iam::111122223333:role/AmazonEKSConnectorAgentRole,provider="OTHER" \
--region aws-region
```
Di seguito viene riportato un output di esempio.
```
{
"cluster": {
"name": "my-first-registered-cluster",
"arn": "arn:aws: eks:region:111122223333:cluster/my-first-registered-cluster",
"createdAt": 1627669203.531,
"ConnectorConfig": {
"activationId": "xxxxxxxxACTIVATION_IDxxxxxxxx",
"activationCode": "xxxxxxxxACTIVATION_CODExxxxxxxx",
"activationExpiry": 1627672543.0,
"provider": "OTHER",
"roleArn": "arn:aws: iam::111122223333:role/AmazonEKSConnectorAgentRole"
},
"status": "CREATING"
}
}
```
I valori `aws-region`, `activationId`, e `activationCode` verranno utilizzati nel prossimo passaggio.
### Console di gestione AWS
1. Aprire la [Console Amazon EKS](https://console.aws.amazon.com/eks/home#/clusters).
1. Scegli **Add cluster** (Aggiungi cluster) e seleziona **Register** (Registra) per visualizzare la pagina di configurazione.
1. Nella pagina **Configura cluster** compilare i campi riportati di seguito:
+ **Nome**: un nome univoco per il cluster.
+ **Provider**: scegli per visualizzare l'elenco a discesa dei provider del cluster Kubernetes. Se non si conosce il provider specifico, selezionare **Altro**.
+ **Ruolo plug-in EKS**: selezionare il ruolo da utilizzare per la connessione del cluster.
1. Selezionare **Registra cluster**.
1. Viene visualizzata la pagina Panoramica del cluster. Se desideri utilizzare il grafico Helm, copia il comando `helm install` e prosegui con il passaggio successivo. Se desideri utilizzare il manifesto YAML, scegli **Scarica file YAML** per scaricare il file manifesto sull'unità locale.
**Importante**
Questa è l'unica occasione per copiare il comando `helm install` o eseguire il download di questo file. Non uscire da questa pagina, poiché il link non sarà accessibile e sarà necessario annullare la registrazione del cluster e riavviare i passaggi dall’inizio.
Il comando o il file manifesto può essere utilizzato una sola volta per il cluster registrato. Se si eliminano risorse dal cluster Kubernetes, è necessario registrare nuovamente il cluster e ottenere un nuovo file manifesto.
Continua con la fase successiva per applicare il file manifesto al cluster Kubernetes.
### `eksctl`
1. Deve essere installato `eksctl` versione `0.68` o successiva. Per installarlo o aggiornarlo, consulta la pagina [Inizia a usare Amazon EKS — `eksctl`](getting-started-eksctl.md).
1. Registra il cluster fornendo un nome, un provider e una regione.
```
eksctl register cluster --name my-cluster --provider my-provider --region region-code
```
Output di esempio:
```
2021-08-19 13:47:26 [ℹ] creating IAM role "eksctl-20210819194112186040"
2021-08-19 13:47:26 [ℹ] registered cluster "" successfully
2021-08-19 13:47:26 [ℹ] wrote file eks-connector.yaml to
2021-08-19 13:47:26 [ℹ] wrote file eks-connector-clusterrole.yaml to
2021-08-19 13:47:26 [ℹ] wrote file eks-connector-console-dashboard-full-access-group.yaml to
2021-08-19 13:47:26 [!] note: "eks-connector-clusterrole.yaml" and "eks-connector-console-dashboard-full-access-group.yaml" give full EKS Console access to IAM identity "", edit if required; read https://eksctl.io/usage/eks-connector for more info
2021-08-19 13:47:26 [ℹ] run `kubectl apply -f eks-connector.yaml,eks-connector-clusterrole.yaml,eks-connector-console-dashboard-full-access-group.yaml` before expiry to connect the cluster
```
In questo modo vengono creati file sul computer locale. Questi file devono essere applicati al cluster esterno entro 3 giorni; in caso contrario, la registrazione scade.
1. In un terminale in grado di accedere al cluster, applica il file `eks-connector-binding.yaml`:
```
kubectl apply -f eks-connector-binding.yaml
```
## Fase 2: Installazione dell'agente `eks-connector`
Per installare l’agente `eks-connector`, utilizzare uno dei seguenti strumenti:
+ [Helm](#helm_agent_cluster_connect)
+ [yaml](#yaml_agent_cluster_connect)
### Helm
**Nota**
Se il cluster è stato registrato con `eksctl`, utilizzare il metodo con manifesto YAML anziché il metodo con grafico Helm.
1. Se hai utilizzato la AWS CLI nel passaggio precedente, sostituisci il comando `ACTIVATION_CODE` e `ACTIVATION_ID` nel comando seguente con i `activationCode` valori`activationId`, e rispettivamente. Sostituisci `aws-region` con la AWS regione che hai usato nel passaggio precedente. Quindi esegui il comando per installare l'`eks-connector`agente nel cluster registrato:
```
$ helm install eks-connector \
--namespace eks-connector \
oci://public.ecr.aws/eks-connector/eks-connector-chart \
--set eks.activationCode=ACTIVATION_CODE \
--set eks.activationId=ACTIVATION_ID \
--set eks.agentRegion=aws-region
```
Se hai usato il Console di gestione AWS nel passaggio precedente, usa il comando che hai copiato dal passaggio precedente con questi valori compilati.
1. Verifica l'integrità dell'implementazione del `eks-connector` installato e attendi che lo stato del cluster registrato in Amazon EKS diventi `ACTIVE`.
### yaml
Completare la connessione applicando il file manifesto Amazon EKS Connector al proprio cluster Kubernetes. A tale scopo, è necessario utilizzare i metodi descritti in precedenza. Se il manifesto non viene applicato entro tre giorni, la registrazione di Amazon EKS Connector scade. Se la connessione al cluster scade, la registrazione del cluster deve essere annullata prima di poterlo connettere nuovamente.
1. Eseguire il download del file YAML di Amazon EKS Connector.
```
curl -O https://amazon-eks.s3.us-west-2.amazonaws.com/eks-connector/manifests/eks-connector/latest/eks-connector.yaml
```
1. Modifica il file YAML del connettore Amazon EKS per sostituire tutti i riferimenti di `%AWS_REGION%`, `%EKS_ACTIVATION_ID%` e `%EKS_ACTIVATION_CODE%` con i valori `aws-region`, `activationId`, e `activationCode` dell'output del passaggio precedente.
Il comando di esempio seguente può sostituire questi valori.
```
sed -i "s~%AWS_REGION%~$aws-region~g; s~%EKS_ACTIVATION_ID%~$EKS_ACTIVATION_ID~g; s~%EKS_ACTIVATION_CODE%~$(echo -n $EKS_ACTIVATION_CODE | base64)~g" eks-connector.yaml
```
**Importante**
Assicurarsi che il codice di attivazione sia in formato base64.
1. In un terminale dotato di accesso al cluster, è possibile applicare il file manifesto aggiornato eseguendo il seguente comando:
```
kubectl apply -f eks-connector.yaml
```
1. Dopo aver applicato al cluster Kubernetes il manifesto e i file YAML dell'associazione dei ruoli di Amazon EKS Connector, verificare che il cluster sia connesso.
```
aws eks describe-cluster \
--name "my-first-registered-cluster" \
--region AWS_REGION
```
L'output deve includere `status=ACTIVE`.
1. (Facoltativo) Assegna tag al cluster. Per ulteriori informazioni, consulta [Organizzazione delle risorse Amazon EKS con tag](eks-using-tags.md).
## Fasi successive
In caso di problemi con questi passaggi, consulta la pagina [Risoluzione dei problemi del connettore Amazon EKS](troubleshooting-connector.md).
Per concedere ai [principali IAM](https://docs.aws.amazon.com/IAM/latest/UserGuide/id_roles.html#iam-term-principal) aggiuntivi l’accesso alla console Amazon EKS al fine di visualizzare le risorse Kubernetes in un cluster connesso, consultare [Concedere l’accesso per visualizzare le risorse del cluster Kubernetes in una console Amazon EKS](connector-grant-access.md).