Crea un cluster Amazon EKS

Se disponi già di un ruolo IAM del cluster o intendi creare il tuo cluster coneksctl, puoi saltare questo passaggio. Per impostazione predefinita, eksctl crea un ruolo per te.

Per creare un file JSON della policy di attendibilità IAM, esegui il comando seguente.

cat >eks-cluster-role-trust-policy.json <<EOF
{
  "Version": "2012-10-17",
  "Statement": [
    {
      "Effect": "Allow",
      "Principal": {
        "Service": "eks.amazonaws.com"
      },
      "Action": "sts:AssumeRole"
    }
  ]
}
EOF

Crea il ruolo IAM del cluster Amazon EKS. Se necessario, inserisci il prefisso eks-cluster-role-trust-policy.json nel percorso del computer in cui hai eseguito la scrittura del file nella fase precedente. Il comando associa il criterio di attendibilità creato nella fase precedente al ruolo. Per creare un ruolo IAM, l'azione iam:CreateRole (autorizzazione) deve essere assegnata al principale IAM che sta creando il ruolo.

aws iam create-role --role-name myAmazonEKSClusterRole --assume-role-policy-document file://"eks-cluster-role-trust-policy.json"

Puoi assegnare la policy gestita da Amazon EKS o creare una policy personalizzata. Per conoscere le autorizzazioni minime che devi utilizzare nella policy personalizzata, consulta Ruolo IAM del cluster Amazon EKS.

Allega la policy gestita di Amazon EKS denominata Amazon EKSCluster Policy al ruolo. Per allegare una policy IAM a un principale IAM, è necessario assegnare al principale che sta allegando la policy una delle azioni IAM (autorizzazioni) seguenti: iam:AttachUserPolicy o iam:AttachRolePolicy.

aws iam attach-role-policy --policy-arn arn:aws: iam::aws:policy/AmazonEKSClusterPolicy --role-name myAmazonEKSClusterRole

È necessaria la versione 0.199.0 o una versione successiva dello strumento da riga di eksctl comando installato sul dispositivo o. AWS CloudShell Per l'installazione o l'aggiornamento di eksctl, consulta la sezione Installation nella documentazione di eksctl.

Crea un IPv4 cluster Amazon EKS con l'impostazione predefinita di Amazon EKS Kubernetes versione nella tua AWS regione predefinita. Prima di eseguire il comando, apporta le sostituzioni seguenti:

Sostituisci region-code con la AWS regione in cui desideri creare il cluster.

Sostituisci my-cluster con un nome da assegnare al cluster. Il nome può contenere solo caratteri alfanumerici (con distinzione tra lettere maiuscole e minuscole) e trattini. Deve iniziare con un carattere alfanumerico e non può superare i 100 caratteri. Il nome deve essere univoco all'interno della AWS regione e AWS dell'account in cui stai creando il cluster.

Sostituisci 1.31 con qualsiasi versione supportata da Amazon EKS.

Modifica i valori di vpc-private-subnets in base alle tue esigenze. Puoi anche aggiungerne altri IDs. È necessario specificare almeno due sottoreti IDs. Se preferisci specificare sottoreti pubbliche, puoi passare a. --vpc-private-subnets --vpc-public-subnets Alle sottoreti pubbliche è associata una tabella di routing con un percorso verso un gateway Internet, mentre alle sottoreti private non è associata una tabella di routing. Per questo motivo, ti consigliamo di utilizzare le sottoreti private quando possibile.

Le sottoreti scelte devono soddisfare i requisiti delle sottoreti di Amazon EKS. Prima di selezionare le sottoreti, ti consigliamo di conoscere tutti i requisiti e le considerazioni relative a VPC e sottoreti di Amazon EKS.

Esegui il comando seguente:

eksctl create cluster --name my-cluster --region region-code --version {k8s-n} --vpc-private-subnets subnet-ExampleID1,subnet-ExampleID2 --without-nodegroup

Il provisioning del cluster richiede diversi minuti. Durante la creazione del cluster, vengono visualizzate diverse righe di output. L'ultima riga di output è simile alla seguente riga di esempio.

[✓]  EKS cluster "my-cluster" in "region-code" region is ready

Continua con Fase 3: Aggiorna kubeconfig

Aprire la Console Amazon EKS.

Seleziona Aggiungi cluster e quindi Crea.

In Opzioni di configurazione, seleziona Configurazione personalizzata

In EKS Auto Mode, disattiva l'opzione Usa la modalità EKS Auto.

Nella pagina Configura cluster compila i campi seguenti:

Nella sezione Accesso al cluster della pagina di configurazione del cluster, inserisci i seguenti campi:

Nella pagina Specifica reti, seleziona i valori dei campi riportati di seguito:

Puoi specificare questa opzione solo con la famiglia di indirizzi IPv4 e solo durante la creazione del cluster. Se non lo specifichi, allora Kubernetes assegna gli indirizzi IP del servizio dai blocchi 10.100.0.0/16 o 172.20.0.0/16 CIDR.

(Facoltativo) Nella pagina Configura osservabilità, scegli le opzioni Parametri e Registrazione del piano di controllo da attivare. Per impostazione predefinita, i tipi di log sono disattivati.

Quando hai finito con questa pagina, seleziona Avanti.

Nella pagina Select add-ons (Seleziona componenti aggiuntivi), scegli i componenti aggiuntivi da aggiungere al tuo cluster. Alcuni componenti aggiuntivi sono preselezionati. Puoi scegliere tutti i componenti aggiuntivi Amazon EKS e i componenti aggiuntivi AWS Marketplace di cui hai bisogno. Se i componenti aggiuntivi del AWS Marketplace che desideri installare non sono elencati, puoi fare clic sulla numerazione delle pagine per visualizzare altri risultati di pagina o cercare i componenti aggiuntivi di AWS Marketplace disponibili inserendo il testo nella casella di ricerca. Puoi anche filtrare per categoria, fornitore o modello di prezzo e quindi scegliere i componenti aggiuntivi dai risultati della ricerca. Quando si crea un cluster, è possibile visualizzare, selezionare e installare qualsiasi componente aggiuntivo che supporti EKS Pod Identities, come descritto in. Scopri come EKS Pod Identity concede ai pod l'accesso ai servizi AWS

Quando hai finito con questa pagina, seleziona Avanti.

Alcuni componenti aggiuntivi, come Amazon VPC CNI, CoredNS e kube-proxy, vengono installati per impostazione predefinita. Se disabiliti uno dei componenti aggiuntivi predefiniti, ciò potrebbe influire sulla tua capacità di eseguire le applicazioni Kubernetes.

Nella pagina Configura le impostazioni dei componenti aggiuntivi selezionati, seleziona la versione da installare. Dopo la creazione del cluster, puoi eseguire in qualsiasi momento l'aggiornamento a una versione successiva.

Per i componenti aggiuntivi che supportano EKS Pod Identities, puoi utilizzare la console per generare automaticamente il ruolo con il nome, la policy AWS gestita e la policy di fiducia precompilati specificamente per il componente aggiuntivo. È possibile riutilizzare i ruoli esistenti o creare nuovi ruoli per i componenti aggiuntivi supportati. Per i passaggi per utilizzare la console per creare ruoli per componenti aggiuntivi che supportano le identità EKS Pod, consulta. Crea componente aggiuntivo (console)AWS Se un componente aggiuntivo non supporta EKS Pod Identity, viene visualizzato un messaggio con le istruzioni per utilizzare la procedura guidata per creare i ruoli IAM per gli account di servizio (IRSA) dopo la creazione del cluster.

Puoi aggiornare la configurazione di ogni componente aggiuntivo dopo la creazione del cluster. Per ulteriori informazioni sulla configurazione dei componenti aggiuntivi, consulta Aggiornamento di un componente aggiuntivo Amazon EKS. Quando hai finito con questa pagina, seleziona Avanti.

Nella pagina Rivedi e crea, controlla le informazioni che hai inserito o selezionato nelle pagine precedenti. Se devi apportare modifiche, seleziona Edit (Modifica). Quando sei soddisfatto, scegli Create. Durante il provisioning del cluster, nel campo Stato viene visualizzato il messaggio CREAZIONE.

Il provisioning del cluster richiede diversi minuti.

Continua con Fase 3: Aggiorna kubeconfig

Crea un cluster con il comando seguente. Prima di eseguire il comando, apporta le modifiche seguenti:

Puoi specificare questa opzione solo con la famiglia di indirizzi IPv4 e solo durante la creazione del cluster. Se non lo specifichi, allora Kubernetes assegna gli indirizzi IP del servizio dai blocchi 10.100.0.0/16 o 172.20.0.0/16 CIDR.

Il provisioning del cluster richiede diversi minuti. È possibile eseguire query sullo stato del cluster con il comando seguente.

aws eks describe-cluster --region region-code --name my-cluster --query "cluster.status"

Non procedere al passaggio successivo finché l'output restituito non èACTIVE.

Continua con Fase 3: Aggiorna kubeconfig

Se hai creato il cluster utilizzando eksctl, puoi ignorare questo passaggio, poiché è già stato completato da eksctl. Abilita kubectl per consentire la comunicazione con il cluster aggiungendo un nuovo contesto al file config kubectl. Per ulteriori informazioni su come creare e aggiornare il file, consulta Connessione kubectl a un cluster EKS creando un kubeconfig file.

aws eks update-kubeconfig --region region-code --name my-cluster

Di seguito viene riportato un output di esempio:

Added new context arn:aws: eks:region-code:111122223333:cluster/my-cluster to /home/username/.kube/config

Conferma la comunicazione con il cluster eseguendo il comando seguente.

kubectl get svc

Di seguito viene riportato un output di esempio:

NAME         TYPE        CLUSTER-IP   EXTERNAL-IP   PORT(S)   AGE
kubernetes   ClusterIP   10.100.0.1   <none>        443/TCP   28h

(Consigliato) Per utilizzare alcuni componenti aggiuntivi Amazon EKS o per abilitarne singoli Kubernetes carichi di lavoro per avere autorizzazioni IAM ( AWS Identity and Access Management) specifiche, crea un provider IAM OpenID Connect (OIDC) per il tuo cluster. Devi solo creare un IAM OIDC provider per il tuo cluster una sola volta. Per ulteriori informazioni sui componenti aggiuntivi di Amazon EKS, consulta Componenti aggiuntivi Amazon EKS. Per ulteriori informazioni sull'assegnazione di autorizzazioni IAM specifiche ai carichi di lavoro, consulta Ruoli IAM per gli account di servizio.

(Consigliato) Configura il cluster per Amazon VPC CNI plugin for Kubernetes plug-in prima di distribuire EC2 i nodi Amazon nel tuo cluster. Per impostazione predefinita, il plugin è stato installato con il cluster. Quando aggiungi EC2 nodi Amazon al tuo cluster, il plug-in viene distribuito automaticamente su ogni EC2 nodo Amazon che aggiungi. Il plug-in richiede di collegare una delle seguenti politiche IAM a un ruolo IAM. Se il tuo cluster utilizza la IPv4 famiglia, utilizza la policy IAM gestita da Amazoneks_CNI_Policy. Se il tuo cluster utilizza la IPv6 famiglia, utilizza una policy IAM creata da te.

Il ruolo IAM a cui si collega la policy può essere il ruolo IAM del nodo o un ruolo dedicato utilizzato solo per il plugin. Consigliamo di allegare la policy a quest'ultimo ruolo. Per ulteriori informazioni sulla creazione del ruolo, consulta Configurare il plug-in Amazon VPC CNI per utilizzare IRSA il nostro ruolo IAM nel nodo Amazon EKS.

Se hai distribuito il cluster utilizzando il AWS Management Console, puoi saltare questo passaggio. Implementa il AWS Management Console Amazon VPC CNI plugin for Kubernetes, CoreDNSe componenti aggiuntivi kube-proxy Amazon EKS, per impostazione predefinita.

Se si distribuisce il cluster utilizzando uno dei due eksctl o la AWS CLI, allora Amazon VPC CNI plugin for Kubernetes, CoreDNSe vengono distribuiti componenti aggiuntivi kube-proxy autogestiti. È possibile migrare il Amazon VPC CNI plugin for Kubernetes, CoreDNSe componenti aggiuntivi kube-proxy autogestiti distribuiti con il cluster nei componenti aggiuntivi di Amazon EKS. Per ulteriori informazioni, consulta Componenti aggiuntivi Amazon EKS.

(Facoltativo) Se non l'hai già fatto, puoi abilitare Prometheus metriche per il tuo cluster. Per ulteriori informazioni, consulta Creare uno scraper nella Guida per l'utente di Amazon Managed Service for Prometheus.

Se prevedi di distribuire carichi di lavoro nel tuo cluster che utilizzano volumi Amazon EBS e hai creato un cluster 1.23 o uno successivo, devi installare Amazon EBS CSI nel cluster prima di distribuire i carichi di lavoro.