**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à. # Abilitazione dei nodi ibridi su un cluster Amazon EKS esistente o modifica della configurazione Questo argomento offre una panoramica delle opzioni disponibili e descrive gli aspetti da considerare quando aggiungi, modifichi o rimuovi la configurazione dei nodi ibridi per un cluster Amazon EKS. Per consentire a un cluster Amazon EKS di utilizzare nodi ibridi, aggiungi gli intervalli CIDR degli indirizzi IP del nodo on-premises e, facoltativamente, la rete pod nella configurazione `RemoteNetworkConfig`. EKS utilizza questo elenco di CIDRs per abilitare la connettività tra il cluster e le reti locali. Per un elenco completo delle opzioni per l'aggiornamento della configurazione del [UpdateClusterConfig](https://docs.aws.amazon.com/eks/latest/APIReference/API_UpdateClusterConfig.html)cluster, consulta *Amazon EKS API Reference*. Puoi eseguire una delle seguenti azioni sulla configurazione della rete dei nodi ibridi EKS in un cluster: + [Aggiungi una configurazione di rete remota per abilitare i nodi ibridi EKS in un cluster esistente.](#hybrid-nodes-cluster-enable-existing) + [Aggiungi, modifica o rimuovi le reti di nodi remoti e quelle pod remote in un cluster esistente.](#hybrid-nodes-cluster-update-config) + [Rimuovi tutti gli intervalli CIDR della rete di nodi remoti per disabilitare i nodi ibridi EKS in un cluster esistente.](#hybrid-nodes-cluster-disable) ## Prerequisiti + Prima di abilitare il cluster Amazon EKS per nodi ibridi, assicurati che l’ambiente soddisfi i requisiti descritti in [Configurazione dei prerequisiti per i nodi ibridi](hybrid-nodes-prereqs.md) e specificati nel dettaglio in [Preparazione della rete per i nodi ibridi](hybrid-nodes-networking.md), [Preparazione del sistema operativo per i nodi ibridi](hybrid-nodes-os.md) e [Preparazione delle credenziali per i nodi ibridi](hybrid-nodes-creds.md). + Il cluster deve utilizzare una famiglia di IPv4 indirizzi. + Il cluster deve utilizzare una modalità di autenticazione del cluster tra `API` e `API_AND_CONFIG_MAP`. Il processo di modifica della modalità di autenticazione del cluster è descritto in [Cambia la modalità di autenticazione per utilizzare le voci di accesso](setting-up-access-entries.md). + Ti consigliamo di utilizzare l’accesso all’endpoint pubblico o privato per l’endpoint del server API Amazon EKS Kubernetes, ma non entrambi. Se scegli «Pubblico e privato», l'endpoint del server API Amazon EKS Kubernetes verrà sempre convertito in pubblico IPs per i nodi ibridi in esecuzione al di fuori del tuo VPC, il che può impedire ai nodi ibridi di entrare a far parte del cluster. Il processo per modificare l’accesso di rete al cluster è descritto in [Endpoint del server API del cluster](cluster-endpoint.md). + La versione più recente dell'interfaccia a riga di AWS comando (AWS CLI) installata e configurata sul dispositivo. Per verificare la versione attuale, usa `aws --version`. I gestori di pacchetti come yum, apt-get o Homebrew per macOS sono spesso diverse versioni dell'ultima versione della CLI. AWS Per installare la versione più recente, consulta [Installazione o aggiornamento alla versione più recente della AWS CLI e Configurazione delle impostazioni per la CLI](https://docs.aws.amazon.com/cli/latest/userguide/getting-started-install.html) [nella Guida per l'utente dell' AWS interfaccia](https://docs.aws.amazon.com/cli/latest/userguide/cli-configure-quickstart.html#cli-configure-quickstart-config) a riga di AWS comando. + Un [principale IAM](https://docs.aws.amazon.com/IAM/latest/UserGuide/id_roles#iam-term-principal) con l'autorizzazione a chiamare [UpdateClusterConfig](https://docs.aws.amazon.com/eks/latest/APIReference/API_UpdateClusterConfig.html)il tuo cluster Amazon EKS. + Aggiorna i componenti aggiuntivi alle versioni compatibili con i nodi ibridi. Per le versioni dei componenti aggiuntivi compatibili con i nodi ibridi, consulta [Configurare componenti aggiuntivi per nodi ibridi](hybrid-nodes-add-ons.md). + Se esegui componenti aggiuntivi non compatibili con i nodi ibridi, assicurati che il componente aggiuntivo [DaemonSet](https://kubernetes.io/docs/concepts/workloads/controllers/daemonset/)o la [distribuzione](https://kubernetes.io/docs/concepts/workloads/controllers/deployment/) abbiano la seguente regola di affinità per impedire la distribuzione su nodi ibridi. Aggiungi la seguente regola di affinità se non è già presente. ``` affinity: nodeAffinity: requiredDuringSchedulingIgnoredDuringExecution: nodeSelectorTerms: - matchExpressions: - key: eks.amazonaws.com/compute-type operator: NotIn values: - hybrid ``` ## Considerazioni L’oggetto `remoteNetworkConfig` JSON ha il seguente comportamento durante un aggiornamento: + Qualsiasi parte esistente della configurazione che non specifichi rimane invariata. Se non specificate nessuno né `remoteNodeNetworks` né `remotePodNetworks`, quella parte rimarrà la stessa. + Se si stanno modificando `remotePodNetworks` gli elenchi `remoteNodeNetworks` o di CIDRs, è necessario specificare l'elenco completo CIDRs che si desidera inserire nella configurazione finale. Quando specifichi una modifica all’elenco `remoteNodeNetworks` o all’elenco `remotePodNetworks` CIDR, EKS sostituisce l’elenco originale durante l’aggiornamento. + I blocchi CIDR del nodo e del pod in on-premises devono soddisfare i seguenti requisiti: 1. Rientrare in uno degli intervalli IPv4 RFC-1918:10.0.0.0/8, 172.16.0.0/12 o 192.168.0.0/16 o rientrare nell'intervallo CGNAT definito da RFC 6598: `100.64.0.0/10` 1. Non si sovrappongano tra loro, né tutti i CIDRs VPC per il cluster Amazon EKS o il servizio IPv4 Kubernetes CIDR. ## Abilitazione dei nodi ibridi su un cluster esistente È possibile abilitare i nodi ibridi EKS in un cluster esistente utilizzando: + [AWS CloudFormation](#hybrid-nodes-cluster-enable-cfn) + [AWS CLI](#hybrid-nodes-cluster-enable-cli) + [Console di gestione AWS](#hybrid-nodes-cluster-enable-console) ### Abilita i nodi ibridi EKS in un cluster esistente - AWS CloudFormation 1. Per abilitare i nodi ibridi EKS nel tuo cluster, aggiungi `RemoteNodeNetwork` e (opzionale) `RemotePodNetwork` al tuo CloudFormation modello e aggiorna lo stack. Tieni presente che `RemoteNodeNetwork` è un elenco con un massimo di un elemento `Cidrs` e che `Cidrs` è un elenco di più intervalli IP CIDR. ``` RemoteNetworkConfig: RemoteNodeNetworks: - Cidrs: [RemoteNodeCIDR] RemotePodNetworks: - Cidrs: [RemotePodCIDR] ``` 1. Continua su [Preparazione dell’accesso al cluster per i nodi ibridi](hybrid-nodes-cluster-prep.md). ### Abilitare i nodi ibridi EKS in un cluster esistente - AWS CLI 1. Esegui il comando seguente per abilitare `RemoteNetworkConfig` per i nodi ibridi EKS per il cluster EKS. Prima di eseguire il comando, sostituisci le impostazioni seguenti con le tue. Per un elenco completo delle impostazioni, consulta [UpdateClusterConfig](https://docs.aws.amazon.com/eks/latest/APIReference/API_UpdateClusterConfig.html)*Amazon EKS API Reference*. 1. `CLUSTER_NAME`: nome del cluster EKS da aggiornare 1. `AWS_REGION`: AWS Regione in cui è in esecuzione il cluster EKS. 1. `REMOTE_NODE_CIDRS`: il nodo on-premises CIDR per i tuoi nodi ibridi. 1. `REMOTE_POD_CIDRS` (facoltativo): il pod CIDR on-premises per i carichi di lavoro in esecuzione su nodi ibridi. ``` aws eks update-cluster-config \ --name CLUSTER_NAME \ --region AWS_REGION \ --remote-network-config '{"remoteNodeNetworks":[{"cidrs":["REMOTE_NODE_CIDRS"]}],"remotePodNetworks":[{"cidrs":["REMOTE_POD_CIDRS"]}]}' ``` 1. L’aggiornamento del cluster richiede diversi minuti. È possibile eseguire query sullo stato del cluster con il comando seguente. Sostituisci `CLUSTER_NAME` con il nome del cluster che stai modificando e `AWS_REGION` con la AWS regione in cui è in esecuzione il cluster. Non passare alla fase successiva finché l’output restituito non è `ACTIVE`. ``` aws eks describe-cluster \ --name CLUSTER_NAME \ --region AWS_REGION \ --query "cluster.status" ``` 1. Continua su [Preparazione dell’accesso al cluster per i nodi ibridi](hybrid-nodes-cluster-prep.md). ### Abilita i nodi ibridi EKS in un cluster esistente - Console di gestione AWS 1. Apri la console Amazon EKS in [Amazon EKS console](https://console.aws.amazon.com/eks/home#/clusters). 1. Scegliere il nome del cluster per visualizzare le informazioni sul cluster. 1. Scegliere la scheda **Reti**, quindi **Gestione**. 1. Nel menu a discesa, scegli **Reti remote**. 1. **Scegli Configura reti remote per abilitare i nodi ibridi** e specifica il nodo e il pod locali CIDRs per i nodi ibridi. 1. Scegliere **Salva le modifiche** per terminare. Attendi che lo stato del cluster ritorni su **Attivo**. 1. Continua su [Preparazione dell’accesso al cluster per i nodi ibridi](hybrid-nodes-cluster-prep.md). ## Aggiornamento della configurazione dei nodi ibridi in un cluster esistente È possibile effettuare modifiche `remoteNetworkConfig` in un cluster ibrido esistente utilizzando uno dei seguenti metodi: + [AWS CloudFormation](#hybrid-nodes-cluster-update-cfn) + [AWS CLI](#hybrid-nodes-cluster-update-cli) + [Console di gestione AWS](#hybrid-nodes-cluster-update-console) ### Aggiorna la configurazione ibrida in un cluster esistente - AWS CloudFormation 1. Aggiorna il CloudFormation modello con i nuovi valori CIDR di rete. ``` RemoteNetworkConfig: RemoteNodeNetworks: - Cidrs: [NEW_REMOTE_NODE_CIDRS] RemotePodNetworks: - Cidrs: [NEW_REMOTE_POD_CIDRS] ``` **Nota** Quando aggiorni gli elenchi `RemoteNodeNetworks` `RemotePodNetworks` CIDR, includi tutti CIDRs (nuovi ed esistenti). EKS sostituisce l’intero elenco durante gli aggiornamenti. L’omissione di questi campi dalla richiesta di aggiornamento mantiene le configurazioni esistenti. 1. Aggiorna CloudFormation lo stack con il modello modificato e attendi il completamento dell'aggiornamento dello stack. ### Aggiornamento della configurazione ibrida in un cluster esistente - AWS CLI 1. Per modificare la rete remota CIDRs, esegui il comando seguente. Sostituisci i valori le tue impostazioni: ``` aws eks update-cluster-config --name CLUSTER_NAME --region AWS_REGION --remote-network-config '{"remoteNodeNetworks":[{"cidrs":["NEW_REMOTE_NODE_CIDRS"]}],"remotePodNetworks":[{"cidrs":["NEW_REMOTE_POD_CIDRS"]}]}' ``` **Nota** Quando aggiorni gli elenchi `remoteNodeNetworks` `remotePodNetworks` CIDR, includi tutti CIDRs (nuovi ed esistenti). EKS sostituisce l’intero elenco durante gli aggiornamenti. L’omissione di questi campi dalla richiesta di aggiornamento mantiene le configurazioni esistenti. 1. Attendi che lo stato del cluster ritorni ad ATTIVO prima di procedere. ### Aggiorna la configurazione ibrida in un cluster esistente - Console di gestione AWS 1. Apri la console Amazon EKS in [Amazon EKS console](https://console.aws.amazon.com/eks/home#/clusters). 1. Scegliere il nome del cluster per visualizzare le informazioni sul cluster. 1. Scegliere la scheda **Reti**, quindi **Gestione**. 1. Nel menu a discesa, scegli **Reti remote**. 1. Aggiorna il CIDRs file sottostante `Remote node networks` e `Remote pod networks - Optional` secondo necessità. 1. Scegli **Salva modifiche** e attendi che lo stato del cluster ritorni **Attivo**. ## Disabilitazione dei nodi ibridi in un cluster esistente È possibile disabilitare i nodi ibridi EKS in un cluster esistente utilizzando: + [AWS CloudFormation](#hybrid-nodes-cluster-disable-cfn) + [AWS CLI](#hybrid-nodes-cluster-disable-cli) + [Console di gestione AWS](#hybrid-nodes-cluster-disable-console) ### Disabilita i nodi ibridi EKS in un cluster esistente - AWS CloudFormation 1. Per disabilitare i nodi ibridi EKS nel cluster, imposta `RemoteNodeNetworks` e `RemotePodNetworks` svuota gli array nel CloudFormation modello e aggiorna lo stack. ``` RemoteNetworkConfig: RemoteNodeNetworks: [] RemotePodNetworks: [] ``` ### Disabilita i nodi ibridi EKS in un cluster esistente - AWS CLI 1. Esegui i seguenti comandi per rimuovere `RemoteNetworkConfig` dal cluster EKS. Prima di eseguire il comando, sostituisci le impostazioni seguenti con le tue. Per un elenco completo delle impostazioni, consulta [UpdateClusterConfig](https://docs.aws.amazon.com/eks/latest/APIReference/API_UpdateClusterConfig.html)*Amazon EKS API Reference*. 1. `CLUSTER_NAME`: nome del cluster EKS da aggiornare 1. `AWS_REGION`: AWS Regione in cui è in esecuzione il cluster EKS. ``` aws eks update-cluster-config \ --name CLUSTER_NAME \ --region AWS_REGION \ --remote-network-config '{"remoteNodeNetworks":[],"remotePodNetworks":[]}' ``` 1. L’aggiornamento del cluster richiede diversi minuti. È possibile eseguire query sullo stato del cluster con il comando seguente. Sostituisci `CLUSTER_NAME` con il nome del cluster che stai modificando e `AWS_REGION` con la AWS regione in cui è in esecuzione il cluster. Non passare alla fase successiva finché l’output restituito non è `ACTIVE`. ``` aws eks describe-cluster \ --name CLUSTER_NAME \ --region AWS_REGION \ --query "cluster.status" ``` ### Disabilita i nodi ibridi EKS in un cluster esistente - Console di gestione AWS 1. Apri la console Amazon EKS in [Amazon EKS console](https://console.aws.amazon.com/eks/home#/clusters). 1. Scegliere il nome del cluster per visualizzare le informazioni sul cluster. 1. Scegliere la scheda **Reti**, quindi **Gestione**. 1. Nel menu a discesa, scegli **Reti remote**. 1. Scegli **Configura reti remote per abilitare i nodi ibridi** e rimuovere tutti i nodi CIDRs sottostanti `Remote node networks` e`Remote pod networks - Optional`. 1. Scegliere **Salva le modifiche** per terminare. Attendi che lo stato del cluster ritorni su **Attivo**.