**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à. # Creare un cluster con la modalità automatica Amazon EKS Questo capitolo spiega come creare un cluster Amazon EKS con la modalità automatica abilitata utilizzando vari strumenti e interfacce. La modalità automatica semplifica la creazione di cluster grazie alla configurazione e alla gestione automatiche dell’infrastruttura di calcolo, della rete e dell’archiviazione del cluster. Si imparerà come creare un cluster con la modalità automatica utilizzando la AWS CLI, la Console di gestione AWS o lo strumento a riga di comando eksctl. **Nota** La modalità automatica EKS richiede la versione 1.29 o successive di Kubernetes. Scegliere lo strumento preferito in base alle esigenze: la Console di gestione AWS offre un’interfaccia visiva ideale per scoprire le funzionalità della modalità automatica EKS e creare singoli cluster. La AWS CLI è la soluzione ideale per attività di scripting e automazione, in particolare quando si integra la creazione di cluster in flussi di lavoro o pipeline CI/CD esistenti. Lo strumento CLI eksctl offre un’esperienza nativa per Kubernetes ed è consigliato agli utenti che hanno familiarità con gli strumenti Kubernetes e che desiderano operazioni a riga di comando semplificate con impostazioni predefinite ragionevoli. Prima di iniziare, assicurarsi di aver installato e configurato i prerequisiti necessari, incluse le autorizzazioni IAM adeguate per creare cluster EKS. Per ulteriori informazioni su come installare strumenti CLI come `kubectl`, `aws` e `eksctl`, consultare [Configurazione per l’utilizzo di Amazon EKS](setting-up.md). È possibile utilizzare la AWS CLI, la Console di gestione AWS o lo strumento CLI eksctl per creare un cluster con la modalità automatica Amazon EKS. **Topics** + [Crea un cluster di EKS Auto Mode con la CLI di eksctl](automode-get-started-eksctl.md) + [Crea un cluster EKS Auto Mode con la AWS CLI](automode-get-started-cli.md) + [Crea un cluster di EKS Auto Mode con la Console di gestione AWS](automode-get-started-console.md) # Crea un cluster di EKS Auto Mode con la CLI di eksctl Questo argomento ti mostra come creare un cluster di Amazon EKS Auto Mode con l’interfaccia a riga di comando (CLI) di eksctl. Puoi creare un cluster Auto Mode eseguendo un singolo comando CLI o applicando un file di configurazione YAML. Entrambi i metodi offrono le stesse funzionalità, con l’approccio YAML che offre un controllo più granulare sulle impostazioni del cluster. La CLI di eksctl semplifica il processo di creazione e gestione dei cluster di EKS Auto Mode gestendo la creazione e la configurazione delle risorse AWS sottostanti. Prima di procedere, assicurati di avere le credenziali AWS e le autorizzazioni necessarie configurate sul computer locale. Questa guida presuppone che tu abbia una certa familiarità con i concetti base di Amazon EKS e che gli strumenti CLI richiesti siano già stati installati. **Nota** Devi installare la versione `0.195.0` o una versione successiva di eksctl. Per ulteriori informazioni, consulta [eksctl releases](https://github.com/eksctl-io/eksctl/releases) su GitHub. ## Crea un cluster di EKS Auto Mode con un comando CLI Devi avere l’installazione degli strumenti `aws` ed `eksctl`. Devi aver effettuato l’accesso ad AWS CLI con autorizzazioni sufficienti per gestire le risorse AWS tra cui: istanze EC2, reti EC2, cluster EKS e ruoli IAM. Per ulteriori informazioni, consulta [Configurazione per l’utilizzo di Amazon EKS](setting-up.md). Esegui il seguente comando per creare un nuovo cluster di EKS Auto Mode con ``` eksctl create cluster --name= --enable-auto-mode ``` ## Crea un cluster di EKS Auto Mode con un file YAML Devi avere l’installazione degli strumenti `aws` ed `eksctl`. Devi aver effettuato l’accesso ad AWS CLI con autorizzazioni sufficienti per gestire le risorse AWS tra cui: istanze EC2, reti EC2, cluster EKS e ruoli IAM. Per ulteriori informazioni, consulta [Configurazione per l’utilizzo di Amazon EKS](setting-up.md). Esamina le opzioni di configurazione di EKS Auto Mode nella risorsa ClusterConfig di esempio qui sotto. Per la specifica completa di ClusterConfig, consulta [eksctl documentation](https://eksctl.io/usage/creating-and-managing-clusters/). AWS suggerisce di abilitare EKS Auto Mode. Se è la prima volta che crei un cluster di EKS Auto Mode, lascia il `nodeRoleARN` non precisato per creare un ruolo IAM del nodo per EKS Auto Mode. Se disponi già di un ruolo IAM del nodo nell’account AWS, AWS suggerisce di riutilizzarlo. AWS suggerisce di non specificare alcun valore per `nodePools`. EKS Auto Mode creerà pool di nodi predefiniti. Puoi utilizzare l’API Kubernetes per creare pool di nodi aggiuntivi. ``` # cluster.yaml apiVersion: eksctl.io/v1alpha5 kind: ClusterConfig metadata: name: region: iam: # ARN of the Cluster IAM Role # optional, eksctl creates a new role if not supplied # suggested to use one Cluster IAM Role per account serviceRoleARN: autoModeConfig: # defaults to false enabled: boolean # optional, defaults to [general-purpose, system]. # suggested to leave unspecified # To disable creation of nodePools, set it to the empty array ([]). nodePools: []string # optional, eksctl creates a new role if this is not supplied # and nodePools are present. nodeRoleARN: string ``` Salva il file `ClusterConfig` con nome `cluster.yaml` e usa il seguente comando per creare il cluster: ``` eksctl create cluster -f cluster.yaml ``` # Crea un cluster EKS Auto Mode con la AWS CLI I cluster della modalità automatica di EKS automatizzano le attività di routine di gestione del cluster l’elaborazione, l’archiviazione e la rete. Ad esempio, i cluster della modalità automatica di EKS rilevano automaticamente quando sono necessari nodi aggiuntivi ed effettuano il provisioning di nuove istanze EC2 per soddisfare le richieste di carico di lavoro. Questo argomento illustra la creazione di un nuovo cluster EKS Auto Mode utilizzando la AWS CLI e, facoltativamente, la distribuzione di un carico di lavoro di esempio. ## Prerequisiti + 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`. Per installare la versione più recente, consulta [Installazione](https://docs.aws.amazon.com/cli/latest/userguide/getting-started-install.html) e [configurazione rapida](https://docs.aws.amazon.com/cli/latest/userguide/cli-chap-configure.html#cli-configure-quickstart-config) con aws configure nella Guida per l'utente dell'interfaccia a riga di AWS comando. + Accedi alla CLI con autorizzazioni IAM sufficienti per creare AWS risorse tra cui politiche IAM, ruoli IAM e cluster EKS. + Lo strumento da riga di comando kubectl installato sul tuo dispositivo. AWS suggerisce di utilizzare la stessa versione di kubectl della versione Kubernetes del cluster EKS. Per installare o aggiornare kubectl, consulta [Impostazione di `kubectl` e `eksctl`](install-kubectl.md). ## Specifica le sottoreti VPC La modalità automatica di Amazon EKS implementa i nodi nelle sottoreti VPC. Quando si crea un cluster EKS, devi specificare le sottoreti VPC in cui verranno implementati i nodi. Puoi utilizzare le sottoreti VPC predefinite nel tuo AWS account o creare un VPC dedicato per carichi di lavoro critici. + AWS suggerisce di creare un VPC dedicato per il cluster. Informazioni su come [Creazione di un Amazon VPC per il cluster Amazon EKS.](creating-a-vpc.md). + La console EKS aiuta a creare un nuovo VPC. Informazioni su come [Crea un cluster di EKS Auto Mode con la Console di gestione AWS](automode-get-started-console.md). + In alternativa, puoi utilizzare il VPC predefinito del tuo AWS account. Usa le seguenti istruzioni per trovare la IDs sottorete. ### Per trovare la sottorete IDs del tuo VPC predefinito **Utilizzo della AWS CLI:** 1. Esegui il comando seguente per elencare il VPC di default e le relative sottoreti: ``` aws ec2 describe-subnets --filters "Name=vpc-id,Values=$(aws ec2 describe-vpcs --query 'Vpcs[?IsDefault==`true`].VpcId' --output text)" --query 'Subnets[*].{ID:SubnetId,AZ:AvailabilityZone}' --output table ``` 1. Salva l'output e annota la ** IDssottorete**. Output di esempio: ``` ---------------------------------------- | DescribeSubnets | ---------------------------------------- | SubnetId | AvailabilityZone | |--------------------|---------------------| | subnet-012345678 | us-west-2a | | subnet-234567890 | us-west-2b | | subnet-345678901 | us-west-2c | ---------------------------------------- ``` ## Ruoli IAM per cluster della modalità automatica di EKS ### Ruolo IAM del cluster EKS Auto Mode richiede un ruolo Cluster IAM per eseguire azioni nell' AWS account, come il provisioning di nuove istanze EC2. È necessario creare questo ruolo per concedere a EKS le autorizzazioni necessarie. AWS consiglia di allegare le seguenti politiche AWS gestite al ruolo Cluster IAM: + [EKSComputePolitica di Amazon](security-iam-awsmanpol.md#security-iam-awsmanpol-AmazonEKSComputePolicy) + [AmazonEKSBlockStoragePolicy](security-iam-awsmanpol.md#security-iam-awsmanpol-AmazonEKSBlockStoragePolicy) + [AmazonEKSLoadBalancingPolicy](security-iam-awsmanpol.md#security-iam-awsmanpol-AmazonEKSLoadBalancingPolicy) + [EKSNetworkingPolitica di Amazon](security-iam-awsmanpol.md#security-iam-awsmanpol-AmazonEKSNetworkingPolicy) + [EKSClusterPolitica di Amazon](security-iam-awsmanpol.md#security-iam-awsmanpol-amazoneksclusterpolicy) ### Ruolo IAM del nodo Quando creai un cluster della modalità automatica di EKS, specifichi un ruolo IAM del nodo. Quando modalità automatica di EKS crea nodi per elaborare carichi di lavoro in sospeso, a ogni nuovo nodo di istanza EC2 viene assegnato il ruolo IAM del nodo. Questo ruolo consente al nodo di comunicare con EKS, ma in genere non è accessibile ai carichi di lavoro in esecuzione sul nodo. Se desideri concedere le autorizzazioni ai carichi di lavoro in esecuzione su un nodo, usa EKS Pod Identity. Per ulteriori informazioni, consulta [Informazioni su come EKS Pod Identity consente ai pod di accedere ai servizi AWS](pod-identities.md). Devi creare questo ruolo e allegare la seguente politica AWS gestita: + [AmazonEKSWorkerNodeMinimalPolicy](security-iam-awsmanpol.md#security-iam-awsmanpol-AmazonEKSWorkerNodeMinimalPolicy) + [AmazonEC2ContainerRegistryPullOnly](https://docs.aws.amazon.com/AmazonECR/latest/userguide/security-iam-awsmanpol.html#security-iam-awsmanpol-AmazonEC2ContainerRegistryPullOnly) La modalità automatica di EKS richiede anche un ruolo collegato ai servizi, che viene creato e configurato automaticamente da AWS. Per ulteriori informazioni, consulta [AWSServiceRoleForAmazonEKS](using-service-linked-roles-eks.md). ## Creazione di un ruolo IAM per un cluster della modalità automatica di EKS ### Passaggio 1: creazione della policy di attendibilità Crea una policy di attendibilità che consenta al servizio Amazon EKS di assumere tale ruolo. Salva la policy come `trust-policy.json`: ``` { "Version":"2012-10-17", "Statement": [ { "Effect": "Allow", "Principal": { "Service": "eks.amazonaws.com" }, "Action": [ "sts:AssumeRole", "sts:TagSession" ] } ] } ``` ### Passaggio 2: creazione del ruolo IAM Usa la policy di attendibilità per creare il ruolo IAM del cluster: ``` aws iam create-role \ --role-name AmazonEKSAutoClusterRole \ --assume-role-policy-document file://trust-policy.json ``` ### Passaggio 3: annotazione del ruolo ARN Recupera e salva l’ARN del nuovo ruolo per usarlo nelle fasi successive: ``` aws iam get-role --role-name AmazonEKSAutoClusterRole --query "Role.Arn" --output text ``` ### Passaggio 4: collegamento delle policy obbligatorie Allega le seguenti politiche AWS gestite al ruolo Cluster IAM per concedere le autorizzazioni necessarie: **EKSClusterPolitica di Amazon**: ``` aws iam attach-role-policy \ --role-name AmazonEKSAutoClusterRole \ --policy-arn arn:aws: iam::aws:policy/AmazonEKSClusterPolicy ``` **EKSComputePolitica di Amazon**: ``` aws iam attach-role-policy \ --role-name AmazonEKSAutoClusterRole \ --policy-arn arn:aws: iam::aws:policy/AmazonEKSComputePolicy ``` **Amazon EKSBlock StoragePolicy**: ``` aws iam attach-role-policy \ --role-name AmazonEKSAutoClusterRole \ --policy-arn arn:aws: iam::aws:policy/AmazonEKSBlockStoragePolicy ``` **Amazon EKSLoad BalancingPolicy**: ``` aws iam attach-role-policy \ --role-name AmazonEKSAutoClusterRole \ --policy-arn arn:aws: iam::aws:policy/AmazonEKSLoadBalancingPolicy ``` **EKSNetworkingPolitica di Amazon**: ``` aws iam attach-role-policy \ --role-name AmazonEKSAutoClusterRole \ --policy-arn arn:aws: iam::aws:policy/AmazonEKSNetworkingPolicy ``` ## Creazione di un ruolo IAM per un nodo modalità automatica di EKS ### Passaggio 1: creazione della policy di attendibilità Crea una policy di attendibilità che consenta al servizio Amazon EKS di assumere tale ruolo. Salva la policy come `node-trust-policy.json`: ``` { "Version":"2012-10-17", "Statement": [ { "Effect": "Allow", "Principal": { "Service": "ec2.amazonaws.com" }, "Action": "sts:AssumeRole" } ] } ``` #### Passaggio 2: creare il ruolo IAM del nodo Utilizza il **node-trust-policyfile.json** del passaggio precedente per definire quali entità possono assumere il ruolo. Per creare il ruolo IAM del nodo, esegui il seguente comando: ``` aws iam create-role \ --role-name AmazonEKSAutoNodeRole \ --assume-role-policy-document file://node-trust-policy.json ``` #### Passaggio 3: annotazione del ruolo ARN Una volta creato il ruolo, recupera e salva l’ARN del ruolo IAM del nodo. Sarà necessario usare questo ARN nei passaggi successivi. Usa il seguente comando per ottenere l’ARN: ``` aws iam get-role --role-name AmazonEKSAutoNodeRole --query "Role.Arn" --output text ``` #### Passaggio 4: collegamento delle policy obbligatorie Allega le seguenti policy AWS gestite al ruolo Node IAM per fornire le autorizzazioni necessarie: **Amazon EKSWorker NodeMinimalPolicy**: ``` aws iam attach-role-policy \ --role-name AmazonEKSAutoNodeRole \ --policy-arn arn:aws: iam::aws:policy/AmazonEKSWorkerNodeMinimalPolicy ``` **Amazon EC2 ContainerRegistryPullOnly**: ``` aws iam attach-role-policy \ --role-name AmazonEKSAutoNodeRole \ --policy-arn arn:aws: iam::aws:policy/AmazonEC2ContainerRegistryPullOnly ``` ## Creazione di un cluster della modalità automatica di EKS ### Panoramica di Per creare un cluster EKS Auto Mode utilizzando la AWS CLI, sono necessari i seguenti parametri: + `cluster-name`: il nome del cluster. + `k8s-version`: la versione di Kubernetes (ad esempio, 1.31). + `subnet-ids`: sottorete IDs identificata nei passaggi precedenti. + `cluster-role-arn`: ARN del ruolo IAM del cluster. + `node-role-arn`: ARN del ruolo IAM del nodo. #### Configurazioni predefinite del cluster Esaminare questi valori e funzionalità predefiniti prima di creare il cluster: + `nodePools`: modalità automatica di EKS include pool di nodi generici e predefiniti di sistema. Maggiori informazioni sui [Node Pools](create-node-pool.md). **Nota:** i pool di nodi in modalità automatica di EKS differiscono dai gruppi di nodi gestiti di Amazon EKS ma possono coesistere nello stesso cluster. + `computeConfig.enabled`: automatizza le attività di elaborazione di routine, come la creazione e l’eliminazione di istanze EC2. + `kubernetesNetworkConfig.elasticLoadBalancing.enabled`: automatizza le attività di bilanciamento del carico, includendo la creazione e l’eliminazione dei bilanciatori del carico elastico. + `storageConfig.blockStorage.enabled`: automatizza le attività di archiviazione, come la creazione e l’eliminazione di volumi Amazon EBS. + `accessConfig.authenticationMode`: richiede voci di accesso EKS. Maggiori informazioni su [EKS authentication modes](grant-k8s-access.md). #### Esegui il comando Usa il comando seguente per creare il cluster: ``` aws eks create-cluster \ --region ${AWS_REGION} \ --cli-input-json \ "{ \"name\": \"${CLUSTER_NAME}\", \"version\": \"${K8S_VERSION}\", \"roleArn\": \"${CLUSTER_ROLE_ARN}\", \"resourcesVpcConfig\": { \"subnetIds\": ${SUBNETS_JSON}, \"endpointPublicAccess\": true, \"endpointPrivateAccess\": true }, \"computeConfig\": { \"enabled\": true, \"nodeRoleArn\":\"${NODE_ROLE_ARN}\", \"nodePools\": [\"general-purpose\", \"system\"] }, \"kubernetesNetworkConfig\": { \"elasticLoadBalancing\": { \"enabled\": true } }, \"storageConfig\": { \"blockStorage\": { \"enabled\": true } }, \"accessConfig\": { \"authenticationMode\": \"API\" } }" ``` ### Verifica lo stato del cluster #### Fase 1: verificare la creazione del cluster Esegui il comando seguente per verificare lo stato del cluster. La creazione del cluster richiede in genere 15 minuti. ``` aws eks describe-cluster --name "${CLUSTER_NAME}" --output json ``` #### Fase 2: aggiornare kubeconfig Una volta che il cluster è pronto, aggiorna il file kubeconfig locale per consentire a `kubectl` di comunicare con il cluster. Questa configurazione utilizza la AWS CLI per l'autenticazione. ``` aws eks update-kubeconfig --name "${CLUSTER_NAME}" ``` #### Fase 3: verificare i pool di nodi Elenca i pool di nodi nel cluster con il comando seguente: ``` kubectl get nodepools ``` ## Fasi successive + Informazioni su [deploy a sample workload](automode-workload.md) nel nuovo cluster della modalità automatica di EKS. # Crea un cluster di EKS Auto Mode con la Console di gestione AWS La creazione di un cluster di EKS Auto Mode nella Console di gestione AWS richiede meno configurazione rispetto ad altre opzioni. EKS si integra con AWS IAM e le reti VPC per aiutarti a creare le risorse associate a un cluster EKS. Hai due opzioni per creare un cluster nella console: + Configurazione rapida (con EKS Auto Mode) + Configurazione personalizzata Questo argomento illustra come creare un cluster di EKS Auto Mode utilizzando l’opzione di configurazione rapida. ## Crea un EKS Auto Mode utilizzando l’opzione di configurazione rapida Deve aver effettuato l’accesso a Console di gestione AWS con autorizzazioni sufficienti per gestire risorse AWS tra cui: istanze EC2, reti EC2, cluster EKS e ruoli IAM. 1. Passa alla console EKS 1. Fai clic su **Crea cluster**. 1. Conferma che l’opzione di **configurazione rapida** è selezionata 1. Determina i seguenti valori o usare i valori predefiniti per un cluster di test. + **Nome** del cluster + Versione di Kubernetes 1. Seleziona il ruolo IAM del cluster. Se è la prima volta che hai creato un cluster di EKS Auto Mode, utilizza l’opzione **Crea ruolo consigliato**. + Facoltativamente, puoi riutilizzare un singolo ruolo IAM del cluster nell’account AWS per tutti i cluster di EKS Auto Mode. + Il ruolo IAM del cluster include le autorizzazioni necessarie affinché EKS Auto Mode gestisca le risorse, tra cui istanze EC2, volumi EBS e bilanciatori del carico EC2. + L’opzione **Crea ruolo consigliato** precompila tutti i campi con i valori consigliati. Seleziona **Avanti** e poi **Crea**. Il ruolo utilizzerà il nome `AmazonEKSAutoClusterRole` suggerito. + Se recentemente hai creato un nuovo ruolo, usa l’icona **Aggiorna** per ricaricare il menu a discesa di selezione del ruolo. 1. Seleziona il ruolo IAM del nodo. Se è la prima volta che hai creato un cluster di EKS Auto Mode, utilizza l’opzione **Crea ruolo consigliato**. + Facoltativamente, puoi riutilizzare un singolo ruolo IAM del nodo nell’account AWS per tutti i cluster di EKS Auto Mode. + Il ruolo IAM del nodo include le autorizzazioni necessarie per la connessione dei nodi Auto Mode al cluster. Il ruolo IAM del nodo deve includere le autorizzazioni per recuperare le immagini ECR per i container. + L’opzione **Crea ruolo consigliato** precompila tutti i campi con i valori consigliati. Seleziona **Avanti** e poi **Crea**. Il ruolo utilizzerà il nome `AmazonEKSAutoNodeRole` suggerito. + Se recentemente hai creato un nuovo ruolo, usa l’icona **Aggiorna** per ricaricare il menu a discesa di selezione del ruolo. 1. Seleziona il VPC per il cluster di EKS Auto Mode. Scegli **Crea VPC** per creare un nuovo VPC per EKS oppure scegli un VPC creato in precedenza per EKS. + Se utilizzi la console VPC per creare un nuovo VPC, AWS suggerisce di creare almeno un gateway NAT per zona di disponibilità. In caso contrario, puoi usare tutte le altre impostazioni predefinite. + Per ulteriori informazioni e dettagli sui requisiti del cluster IPv6, consulta [Creazione di un Amazon VPC per il cluster Amazon EKS.](creating-a-vpc.md). 1. (opzionale) EKS Auto Mode popola automaticamente le sottoreti private per il VPC selezionato. Puoi rimuovere le sottoreti indesiderate. + EKS seleziona automaticamente le sottoreti private dal VPC seguendo le migliori pratiche. Facoltativamente, puoi selezionare sottoreti aggiuntive dal VPC, come quelle pubbliche. 1. (facoltativo) Seleziona **Visualizza impostazioni predefinite di configurazione rapida** per esaminare tutti i valori di configurazione per il nuovo cluster. La tabella indica che alcuni valori non sono modificabili dopo la creazione del cluster. 1. Selezionare **Creazione di un cluster**. Il completamento della creazione del cluster potrebbe richiedere quindici minuti. ## Fasi successive + Informazioni su [Deploy a Sample Workload to your EKS Auto Mode cluster](sample-storage-workload.md)