Crea sistemi autogestiti Microsoft Windows nodi - Amazon EKS
eksctlAWS Management Console

Aiutaci 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à.

Vuoi contribuire a questa guida per l'utente? Scorri fino alla fine di questa pagina e seleziona Modifica questa pagina su GitHub. I tuoi contributi contribuiranno a rendere la nostra guida utente migliore per tutti.

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à.

Crea sistemi autogestiti Microsoft Windows nodi

Questo argomento descrive come avviare gruppi di Auto Scaling di Windows nodi che si registrano nel tuo EKS cluster Amazon. Dopo che i nodi si sono uniti al cluster, puoi eseguire la distribuzione Kubernetes applicazioni destinate a loro.

Importante

  • EKSI nodi Amazon sono EC2 istanze Amazon standard e vengono fatturati in base ai normali prezzi delle EC2 istanze Amazon. Per ulteriori informazioni, consulta i EC2prezzi di Amazon.

  • Puoi avviare nodi Windows in cluster EKS estesi Amazon su AWS Outposts, ma non puoi avviarli in cluster AWS locali su Outposts. Per ulteriori informazioni, consulta Implementa Amazon in EKS locale con Outposts AWS.

Attiva Windows supporto per il tuo cluster. Ti consigliamo di esaminare le considerazioni importanti prima di avviare un Windows gruppo di nodi. Per ulteriori informazioni, consulta Attiva Windows supporto.

Puoi avviare la gestione automatica Windows nodi con una delle seguenti caratteristiche:

eksctl

Avvia nodi Windows autogestiti utilizzando `eksctl

Questa procedura presuppone che eksctl sia installato e che la versione eksctl sia almeno 0.199.0. È possibile verificare la tua versione con il seguente comando.

eksctl version

Per istruzioni sull'installazione o sull'aggiornamento di eksctl, consulta la sezione Installation nella documentazione di eksctl.

Nota

Questa procedura funziona solo per i cluster creati con eksctl.

  1. (Facoltativo) Se la CNIpolicy gestita di Amazon EKS _ IAM _Policy (se hai un IPv4 cluster) o la AmazonEKS_CNI_IPv6_Policy (che hai creato tu stesso se hai un IPv6 cluster) è collegata al IAMruolo del tuo EKS nodo Amazon, ti consigliamo di assegnarlo a un IAM ruolo da associare al Kubernetes aws-nodeaccount di servizio invece. Per ulteriori informazioni, consulta Configura il VPC CNI plug-in Amazon da utilizzare IRSA.

  2. In questa procedura si presuppone la disponibilità di un cluster. Se non disponi già di un EKS cluster Amazon e di un gruppo di nodi Amazon Linux per aggiungere un Windows gruppo di nodi a, ti consigliamo di seguirloInizia a usare Amazon EKS — eksctl. Questa guida fornisce una guida completa su come creare un EKS cluster Amazon con nodi Amazon Linux.

    Crea il tuo gruppo di nodi con il comando seguente. region-codeSostituiscilo con la AWS regione in cui si trova il cluster. Sostituisci my-cluster con il nome del 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 ng-windows con un nome per il gruppo di nodi. Il nome del gruppo di nodi non può superare i 63 caratteri. Deve iniziare con una lettera o un numero, ma può anche includere trattini e caratteri di sottolineatura. In Kubernetes versione 1.24 o successiva, puoi sostituirla 2019 con 2022 to use Windows Server 2022. Sostituisci il resto di example values con i valori in tuo possesso.

    Importante

    Per distribuire un gruppo di nodi nelle sottoreti AWS Outposts, AWS Wavelength AWS o Local Zone, non passare le sottoreti AWS Outposts, Wavelength o Local Zone quando crei il cluster. Crea il gruppo di nodi con un file di configurazione, specificando le sottoreti AWS Outposts, Wavelength o Local Zone. Per ulteriori informazioni, vedere Creazione di un gruppo di nodi da un file di configurazione e lo Schema del file config nella documentazione su eksctl.

    eksctl create nodegroup \
    --region region-code \
    --cluster my-cluster \
    --name ng-windows \
    --node-type t2.large \
    --nodes 3 \
    --nodes-min 1 \
    --nodes-max 4 \
    --managed=false \
    --node-ami-family WindowsServer2019FullContainer
    Nota

    • Se i nodi non riescono a unirsi al cluster, consultare Impossibile aggiungere i nodi al cluster nella Guida alla risoluzione dei problemi.

    • Per vedere le opzioni disponibili per i comandi eksctl, inserire il comando seguente.

      eksctl command -help

    Di seguito viene riportato un output di esempio: Durante la creazione dei nodi vengono generate diverse righe. Una delle ultime righe di output è simile alla seguente riga di esempio.

    [✔]  created 1 nodegroup(s) in cluster "my-cluster"

  3. (Facoltativo) Implementate un'applicazione di esempio per testare il cluster e Windows nodi.

  4. Ti consigliamo di bloccare Pod accesso a IMDS se sono vere le seguenti condizioni:

    • Hai intenzione di assegnare IAM ruoli a tutti i tuoi Kubernetes account di servizio in modo che Pods dispongono solo delle autorizzazioni minime di cui hanno bisogno.

    • No Pods nel cluster richiedono l'accesso al servizio di metadati dell'EC2istanza Amazon (IMDS) per altri motivi, come il recupero della regione corrente. AWS

    Per ulteriori informazioni, consulta Limita l'accesso al profilo dell'istanza assegnato al nodo (worker).

AWS Management Console

Prerequisiti

Passaggio 1: Avviare i nodi Windows autogestiti utilizzando il AWS Management Console

  1. Attendi che lo stato del cluster risulti ACTIVE. Se i nodi vengono avviati prima che il cluster sia attivo, la registrazione al cluster non riesce e sarà necessario riavviarli.

  2. Apri la console AWS CloudFormation

  3. Seleziona Crea stack.

  4. Per Specificare il modello, seleziona Amazon S3 URL.

  5. Copia quanto segue URL e incollalo in Amazon S3 URL.

    https://s3.us-west-2.amazonaws.com/amazon-eks/cloudformation/2023-02-09/amazon-eks-windows-nodegroup.yaml

  6. Seleziona due volte Next (Avanti).

  7. Nella pagina Quick create stack (Creazione rapida pila), inserire i seguenti parametri di conseguenza:

    • Nome dello stack: scegli un nome per lo stack. AWS CloudFormation Ad esempio, puoi chiamarlo -nodes````. my-cluster

    • ClusterName: inserisci il nome che hai usato per creare il tuo EKS cluster Amazon.

      Importante

      Questo nome deve corrispondere esattamente al nome che hai usato nella Fase 1: Crea il tuo EKS cluster Amazon. Altrimenti, i tuoi nodi non possono entrare a far parte del cluster.

    • ClusterControlPlaneSecurityGroup: Scegli il gruppo di sicurezza dall' AWS CloudFormation output che hai generato quando hai creato il tuo VPC. Nella procedura seguente viene illustrato un metodo per recuperare il gruppo applicabile.

      1. Apri la EKSconsole Amazon.

      2. Scegli il nome del cluster.

      3. Scegli la scheda Reti.

      4. Usa il valore dei gruppi di sicurezza aggiuntivi come riferimento quando selezioni dall'elenco ClusterControlPlaneSecurityGroupa discesa.

    • NodeGroupName: inserisci un nome per il tuo gruppo di nodi. Questo nome può essere usato in seguito per identificare il gruppo di nodi Auto Scaling creato per i tuoi nodi. Il nome del gruppo di nodi non può superare i 63 caratteri. Deve iniziare con una lettera o un numero, ma può anche includere trattini e caratteri di sottolineatura.

    • NodeAutoScalingGroupMinSize: Inserisci il numero minimo di nodi su cui il gruppo Auto Scaling del nodo può scalare.

    • NodeAutoScalingGroupDesiredCapacity: Inserisci il numero di nodi desiderato su cui scalare quando viene creato lo stack.

    • NodeAutoScalingGroupMaxSize: Inserisci il numero massimo di nodi su cui il gruppo Auto Scaling del nodo può scalare orizzontalmente.

    • NodeInstanceType: scegli un tipo di istanza per i tuoi nodi. Per ulteriori informazioni, consulta Scegli un tipo di istanza Amazon EC2 node ottimale.

      Nota

      I tipi di istanza supportati per l'ultima versione del VPCCNIplug-in Amazon per Kubernetes sono elencati in vpc_ip_resource_limit.go su GitHub. Potrebbe essere necessario aggiornare la CNI versione per utilizzare i tipi di istanza supportati più recenti. Per ulteriori informazioni, consulta Amazon VPC CNI.

    • NodeImageIdSSMParam: precompilato con il parametro Amazon EC2 Systems Manager dell'attuale opzione Amazon optimized consigliata EKS Windows ID principaleAMI. Per utilizzare la versione completa di Windows, sostituire Core conFull.

    • NodeImageId: (Facoltativo) Se utilizzi il tuo account personalizzato AMI (anziché uno EKS ottimizzato per AmazonAMI), inserisci un AMI ID del nodo per la tua AWS regione. Se specifichi un valore per questo campo, questo sostituisce tutti i valori nel NodeImageIdSSMParamcampo.

    • NodeVolumeSize: Specificate la dimensione del volume root per i nodi, in GiB.

    • KeyName: inserisci il nome di una coppia di EC2 SSH chiavi Amazon che puoi usare per connetterti ai tuoi nodi dopo il lancio. SSH Se non disponi già di una coppia di EC2 chiavi Amazon, puoi crearne una in AWS Management Console. Per ulteriori informazioni, consulta le coppie di EC2 chiavi Amazon nella Amazon EC2 User Guide.

      Nota

      Se non fornisci una key pair qui, lo AWS CloudFormation stack non viene creato.

    • BootstrapArguments: Specificate eventuali argomenti opzionali da passare allo script di bootstrap del nodo, ad esempio utilizzando kubelet argomenti aggiuntivi. -KubeletExtraArgs

    • D isableIMDSv 1: Per impostazione predefinita, ogni nodo supporta Instance Metadata Service versione 1 (IMDSv1) e. IMDSv2 È possibile disabilitareIMDSv1. Per prevenire nodi futuri e Pods nel gruppo di nodi da utilizzareMDSv1, imposta D isableIMDSv 1 su true. Per ulteriori informazioni suIMDS, vedere Configurazione del servizio di metadati dell'istanza.

    • VpcId: Seleziona l'ID per VPCquello che hai creato.

    • NodeSecurityGroups: Seleziona il gruppo di sicurezza creato per il tuo Linux gruppo di nodi quando hai creato il tuo VPC. Se le ricette di Linux ai nodi sono associati più di un gruppo di sicurezza, specificali tutti. Questo per, ad esempio, se Linux il gruppo di nodi è stato creato coneksctl.

    • Sottoreti: scegliere le sottoreti create. Se hai creato il tuo VPC utilizzando la procedura descritta in Crea un Amazon VPC per il tuo EKS cluster Amazon, specifica solo le sottoreti private all'interno dei VPC nodi in cui avviare i nodi.

      Importante

      • Se una qualsiasi delle sottoreti è pubblica, devi abilitare l'impostazione di assegnazione automatica degli indirizzi IP pubblici. Se l'impostazione non è abilitata per la sottorete pubblica, a tutti i nodi distribuiti in quella sottorete pubblica non verrà assegnato un indirizzo IP pubblico e non saranno in grado di comunicare con il cluster o altri servizi. AWS Se la sottorete è stata distribuita prima del 26 marzo 2020 utilizzando uno dei EKS AWS CloudFormation VPCmodelli Amazon o utilizzandoeksctl, l'assegnazione automatica degli indirizzi IP pubblici è disabilitata per le sottoreti pubbliche. Per informazioni su come abilitare l'assegnazione di indirizzi IP pubblici per una sottorete, consulta Modifica dell'attributo di assegnazione degli indirizzi IPv4 pubblici per la sottorete. Se il nodo viene distribuito in una sottorete privata, è in grado di comunicare con il cluster e altri servizi tramite un gateway. AWS NAT

      • Se le sottoreti non dispongono di accesso a Internet, assicurati di conoscere le considerazioni e i passaggi aggiuntivi descritti in Implementazione di cluster privati con accesso limitato a Internet.

      • Se si AWS selezionano le sottoreti Outposts, Wavelength o Local Zone, le sottoreti non devono essere state passate al momento della creazione del cluster.

  8. Confermare che lo stack sia in grado di creare risorse IAM, quindi scegliere Create stack (Crea stack).

  9. Al termine della creazione dello stack, selezionalo nella console e scegli Output.

  10. Registra il per il gruppo di nodi che è stato NodeInstanceRolecreato. Ne hai bisogno quando configuri il tuo Amazon EKS Windows nodi.

Passaggio 2: abilita i nodi a unirsi al cluster

  1. Verifica se disponi già di una ConfigMap per aws-auth.

    kubectl describe configmap -n kube-system aws-auth

  2. Se ti viene mostrata una ConfigMap per aws-auth, aggiornala se necessario.

    1. Apri ConfigMap per la modifica.

      kubectl edit -n kube-system configmap/aws-auth

    2. Aggiungi nuove voci mapRoles, se necessario. Imposta rolearn i NodeInstanceRolevalori sui valori registrati nelle procedure precedenti.

      [...]
data:
  mapRoles: |
- rolearn: <ARN of linux instance role (not instance profile)>
      username: system:node:{{EC2PrivateDNSName}}
      groups:
        - system:bootstrappers
        - system:nodes
    - rolearn: <ARN of windows instance role (not instance profile)>
      username: system:node:{{EC2PrivateDNSName}}
      groups:
        - system:bootstrappers
        - system:nodes
        - eks:kube-proxy-windows
[...]

    3. Salva il file ed esci dall'editor di testo.

  3. Se hai ricevuto un messaggio di errore che indica "Error from server (NotFound): configmaps "aws-auth" not found", applica lo ConfigMap di stock.

    1. Scarica la mappa di configurazione.

      curl -O https://s3.us-west-2.amazonaws.com/amazon-eks/cloudformation/2020-10-29/aws-auth-cm-windows.yaml

    2. Nel aws-auth-cm-windows.yaml file, impostate i rolearn valori NodeInstanceRolesui valori applicabili registrati nelle procedure precedenti. Per eseguire questa operazione, utilizza un editor di testo o sostituisci i example values tramite il comando seguente:

      sed -i.bak -e 's|<ARN of linux instance role (not instance profile)>|my-node-linux-instance-role|' \
    -e 's|<ARN of windows instance role (not instance profile)>|my-node-windows-instance-role|' aws-auth-cm-windows.yaml
      Importante

      • Non modificate altre righe in questo file.

      • Non utilizzare lo stesso IAM ruolo per entrambi Windows e Linux nodi.

    3. Applica la configurazione. L'esecuzione di questo comando potrebbe richiedere alcuni minuti.

      kubectl apply -f aws-auth-cm-windows.yaml

  4. Guarda lo stato dei nodi e attendi che raggiungano lo stato Ready.

    kubectl get nodes --watch

    Inserisci Ctrl+C per tornare a un prompt dello shell (interprete di comandi).

    Nota

    Se ricevi qualsiasi altro errore di tipo di risorsa o autorizzazione, consulta la sezione Accesso negato o non autorizzato (kubectl) nell'argomento relativo alla risoluzione dei problemi.

    Se i nodi non riescono a unirsi al cluster, Impossibile aggiungere i nodi al cluster consulta il capitolo Risoluzione dei problemi.

Fase 3: Azioni aggiuntive

  1. (Facoltativo) Implementate un'applicazione di esempio per testare il cluster e Windows nodi.

  2. (Facoltativo) Se la CNIpolicy gestita di Amazon EKS _ IAM _Policy (se hai un IPv4 cluster) o la AmazonEKS_CNI_IPv6_Policy (che hai creato tu stesso se hai un IPv6 cluster) è collegata al IAMruolo del tuo EKS nodo Amazon, ti consigliamo di assegnarlo a un IAM ruolo da associare al Kubernetes aws-nodeaccount di servizio invece. Per ulteriori informazioni, consulta Configura il VPC CNI plug-in Amazon da utilizzare IRSA.

  3. Ti consigliamo di bloccare Pod accesso a IMDS se sono vere le seguenti condizioni:

    • Hai intenzione di assegnare IAM ruoli a tutti i tuoi Kubernetes account di servizio in modo che Pods dispongono solo delle autorizzazioni minime di cui hanno bisogno.

    • No Pods nel cluster richiedono l'accesso al servizio di metadati dell'EC2istanza Amazon (IMDS) per altri motivi, come il recupero della regione corrente. AWS

    Per ulteriori informazioni, consulta Limitazione dell'accesso al profilo dell'istanza assegnato al nodo worker.

📝 Modifica questa pagina su GitHub