As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá.

Suporte personalizado para AMI

Configurando o ID da AMI do nó

A --node-ami bandeira permite vários casos de uso avançados, como usar uma AMI personalizada ou consultar a AWS em tempo real para determinar qual AMI usar. O sinalizador pode ser usado para imagens sem GPU e GPU.

O sinalizador pode usar o ID da imagem da AMI para uso explícito de uma imagem. Ele também pode usar as seguintes palavras-chave “especiais”:

Ao --node-ami definir uma string de ID, eksctl assumirá que uma AMI personalizada foi solicitada. Para nós AmazonLinux 2 e Ubuntu, gerenciados e autogerenciados pelo EKS, isso significa que isso overrideBootstrapCommand é necessário. Para AmazonLinux 2023, uma vez que ele para de usar o /etc/eks/bootstrap.sh script para inicialização de nós, não há suporte para um processo de inicialização do nodeadm (para obter mais informações, consulte a documentação de inicialização do nó). overrideBootstrapCommand

Exemplos de sinalizadores CLI:

eksctl create cluster --node-ami=auto

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

Exemplo de arquivo de configuração:

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>

A --node-ami bandeira também pode ser usada comeksctl create nodegroup.

Configurando a família AMI do nó

Eles --node-ami-family podem usar as seguintes palavras-chave:

Exemplo de bandeira CLI:

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

Exemplo de arquivo de configuração:

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

A --node-ami-family bandeira também pode ser usada comeksctl create nodegroup. eksctlexige que a família AMI seja definida explicitamente por meio do arquivo de configuração ou via sinalização da --node-ami-family CLI, sempre que estiver trabalhando com uma AMI personalizada.

Suporte à AMI personalizada do Windows

Somente grupos de nós autogerenciados do Windows podem especificar uma AMI personalizada. amiFamilydeve ser definido como uma família de AMI do Windows válida.

As seguintes PowerShell variáveis estarão disponíveis para o script de 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

Exemplo de arquivo de configuração:

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

Suporte personalizado para AMI da Bottlerocket

Para nós Bottlerocket, o não overrideBootstrapCommand é suportado. Em vez disso, para designar seu próprio contêiner de bootstrap, deve-se usar o bottlerocket campo como parte do arquivo de configuração. Por exemplo:

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