Supporto AMI personalizzato

Impostazione dell'ID AMI del nodo

Il --node-ami flag consente una serie di casi d'uso avanzati, come l'utilizzo di un'AMI personalizzata o l'esecuzione di query su AWS in tempo reale per determinare quale AMI utilizzare. Il flag può essere utilizzato sia per immagini non GPU che per immagini GPU.

Il flag può utilizzare l'ID dell'immagine AMI per un'immagine da utilizzare in modo esplicito. Può anche accettare le seguenti parole chiave «speciali»:

Parola chiave	Descrizione
auto	Indica che l'AMI da utilizzare per i nodi deve essere trovata interrogando AWS EC2. Questo si riferisce al resolver automatico.
ssm automatico	Indica che l'AMI da utilizzare per i nodi deve essere trovata interrogando AWS SSM Parameter Store.

Nota

Quando --node-ami si imposta su una stringa ID, eksctl si presume che sia stata richiesta un'AMI personalizzata. Per i nodi AmazonLinux 2 e Ubuntu, sia gestiti da EKS che autogestiti, ciò significa che overrideBootstrapCommand è necessario. Per il AmazonLinux 2023, poiché smette di usare lo /etc/eks/bootstrap.sh script per il bootstrap dei nodi, a favore di un processo di inizializzazione di nodeadm (per maggiori informazioni, consulta i documenti di bootstrapping dei nodi), non è supportato. overrideBootstrapCommand

Esempi di flag CLI:

eksctl create cluster --node-ami=auto

# with a custom ami id
eksctl create cluster --node-ami=ami-custom1234

Esempio di file Config:

nodeGroups:
  - name: ng1
    instanceType: p2.xlarge
    amiFamily: AmazonLinux2
    ami: auto
  - name: ng2
    instanceType: m5.large
    amiFamily: AmazonLinux2
    ami: ami-custom1234
managedNodeGroups:
  - name: m-ng-2
    amiFamily: AmazonLinux2
    ami: ami-custom1234
    instanceType: m5.large
    overrideBootstrapCommand: |
      #!/bin/bash
      /etc/eks/bootstrap.sh <cluster-name>

La --node-ami bandiera può essere utilizzata anche coneksctl create nodegroup.

Impostazione del nodo AMI Family

--node-ami-familyPossono assumere le seguenti parole chiave:

Parola chiave	Descrizione
AmazonLinux2	Indica che deve essere utilizzata l'immagine AMI EKS basata su Amazon Linux 2 (impostazione predefinita).
AmazonLinux2023	Indica che deve essere utilizzata l'immagine AMI EKS basata su Amazon Linux 2023.
Ubuntu 2004	Indica che deve essere utilizzata l'immagine AMI EKS basata su Ubuntu 20.04 LTS (Focal) (supportata per EKS 1.29).
UbuntuPro2004	Indica che deve essere utilizzata l'immagine AMI EKS basata su Ubuntu Pro 20.04 LTS (Focal) (disponibile per EKS >= 1.27, ◄1.29).
Ubuntu 2204	Indica che deve essere utilizzata l'immagine EKS AMI basata su Ubuntu 22.04 LTS (Jammy) (disponibile per EKS >= 1.29).
UbuntuPro2204	Indica che deve essere utilizzata l'immagine EKS AMI basata su Ubuntu Pro 22.04 LTS (Jammy) (disponibile per EKS >= 1.29).
Ubuntu 2404	Indica che deve essere utilizzata l'immagine AMI EKS basata su Ubuntu 24.04 LTS (Noble) (disponibile per EKS >= 1.31).
UbuntuPro2404	Indica che deve essere utilizzata l'immagine AMI EKS basata su Ubuntu Pro 24.04 LTS (Noble) (disponibile per EKS >= 1.31).
Bottlerocket	Indica che deve essere utilizzata l'immagine AMI EKS basata su Bottlerocket.
WindowsServer2019 FullContainer	Indica che deve essere utilizzata l'immagine AMI EKS basata su Windows Server 2019 Full Container.
WindowsServer2019 CoreContainer	Indica che deve essere utilizzata l'immagine AMI EKS basata su Windows Server 2019 Core Container.
WindowsServer2022 FullContainer	Indica che deve essere utilizzata l'immagine AMI EKS basata su Windows Server 2022 Full Container.
WindowsServer2022 CoreContainer	Indica che deve essere utilizzata l'immagine AMI EKS basata su Windows Server 2022 Core Container.

Esempio di flag CLI:

eksctl create cluster --node-ami-family=AmazonLinux2

Esempio di file Config:

nodeGroups:
  - name: ng1
    instanceType: m5.large
    amiFamily: AmazonLinux2
managedNodeGroups:
  - name: m-ng-2
    instanceType: m5.large
    amiFamily: Ubuntu2204

La --node-ami-family bandiera può essere utilizzata anche coneksctl create nodegroup. eksctlrichiede che la famiglia AMI sia impostata esplicitamente tramite il file di configurazione o tramite il flag --node-ami-family CLI, ogni volta che si lavora con un'AMI personalizzata.

Nota

Al momento, i gruppi di nodi gestiti da EKS supportano solo le seguenti famiglie AMI quando si lavora con applicazioni personalizzate AMIs:AmazonLinux2023,AmazonLinux2, e Ubuntu1804 Ubuntu2004 Ubuntu2204

Supporto AMI personalizzato per Windows

Solo i gruppi di nodi Windows autogestiti possono specificare un'AMI personalizzata. amiFamilydeve essere impostato su una famiglia di AMI Windows valida.

Le seguenti PowerShell variabili saranno disponibili per lo script bootstrap:

$EKSBootstrapScriptFile
$EKSClusterName
$APIServerEndpoint
$Base64ClusterCA
$ServiceCIDR
$KubeletExtraArgs
$KubeletExtraArgsMap: A hashtable containing arguments for the kubelet, e.g., @{ 'node-labels' = ''; 'register-with-taints' = ''; 'max-pods' = '10'}
$DNSClusterIP
$ContainerRuntime

Esempio di file Config:

nodeGroups:
  - name: custom-windows
    amiFamily: WindowsServer2022FullContainer
    ami: ami-01579b74557facaf7
    overrideBootstrapCommand: |
      & $EKSBootstrapScriptFile -EKSClusterName "$EKSClusterName" -APIServerEndpoint "$APIServerEndpoint" -Base64ClusterCA "$Base64ClusterCA" -ContainerRuntime "containerd" -KubeletExtraArgs "$KubeletExtraArgs" 3>&1 4>&1 5>&1 6>&1

Supporto AMI personalizzato Bottlerocket

Per i nodi Bottlerocket, non è supportato. overrideBootstrapCommand Invece, per designare il proprio contenitore bootstrap, è necessario utilizzare il bottlerocket campo come parte del file di configurazione. (ad esempio

  nodeGroups:
  - name: bottlerocket-ng
    ami: ami-custom1234
    amiFamily: Bottlerocket
    bottlerocket:
      enableAdminContainer: true
      settings:
        bootstrap-containers:
          bootstrap:
            source: <MY-CONTAINER-URI>