Personalize os modelos de lançamento do Amazon EKS

AWS Batch no Amazon EKS oferece suporte a modelos de lançamento. Há restrições sobre o que seu modelo de lançamento pode fazer.

Adicionar argumentos extras de kubelet

AWS Batch suporta a adição de argumentos extras ao comando kubelet. Para obter a lista completa de parâmetros compatíveis, consulte kubelet na documentação Kubernetes. No exemplo a seguir para AMIs EKS AL2, --node-labels mylabel=helloworld é adicionado à linha de comando kubelet.

MIME-Version: 1.0
      Content-Type: multipart/mixed; boundary="==MYBOUNDARY=="

      --==MYBOUNDARY==
      Content-Type: text/x-shellscript; charset="us-ascii"

      #!/bin/bash
      mkdir -p /etc/aws-batch

      echo AWS_BATCH_KUBELET_EXTRA_ARGS=\"--node-labels mylabel=helloworld\" >> /etc/aws-batch/batch.config

      --==MYBOUNDARY==--

Para AMIs EKS AL2023, o formato do arquivo é YAML. Para obter a lista completa de parâmetros compatíveis, consulte NodeConfigSpec na documentação Kubernetes. No exemplo a seguir para AMIs EKS AL2023, --node-labels mylabel=helloworld é adicionado à linha de comando kubelet.

MIME-Version: 1.0
Content-Type: multipart/mixed; boundary="==MYBOUNDARY=="

--==MYBOUNDARY==
Content-Type: application/node.eks.aws

apiVersion: node.eks.aws/v1alpha1
kind: NodeConfig
spec:
  kubelet:
    flags:
    - --node-labels=mylabel=helloworld

--==MYBOUNDARY==--

Configurar o runtime do contêiner

Você pode usar a variável de ambiente AWS Batch CONTAINER_RUNTIME para configurar o runtime do contêiner em um nó gerenciado. O exemplo a seguir define o runtime do contêiner para containerd quando bootstrap.sh for executado. Para obter mais informações, consulte containerd na documentação Kubernetes.

Se você estiver usando uma AMI otimizada EKS_AL2023 ou EKS_AL2023_NVIDIA, não precisará especificar o runtime do contêiner, pois somente containerd é compatível.

MIME-Version: 1.0
      Content-Type: multipart/mixed; boundary="==MYBOUNDARY=="

      --==MYBOUNDARY==
      Content-Type: text/x-shellscript; charset="us-ascii"

      #!/bin/bash
      mkdir -p /etc/aws-batch

      echo CONTAINER_RUNTIME=containerd >> /etc/aws-batch/batch.config

      --==MYBOUNDARY==--

Montar um volume do Amazon EFS

Você pode usar modelos de execução para montar volumes no nó. No exemplo a seguir, as configurações cloud-config packages e runcmd são usadas. Para obter mais informações, consulte Exemplos de configuração de Nuvem na documentação cloud-init.

MIME-Version: 1.0
Content-Type: multipart/mixed; boundary="==MYBOUNDARY=="

--==MYBOUNDARY==
Content-Type: text/cloud-config; charset="us-ascii"

packages:
- amazon-efs-utils

runcmd:
- file_system_id_01=fs-abcdef123
- efs_directory=/mnt/efs

- mkdir -p ${efs_directory}
- echo "${file_system_id_01}:/ ${efs_directory} efs _netdev,noresvport,tls,iam 0 0" >> /etc/fstab
- mount -t efs -o tls ${file_system_id_01}:/ ${efs_directory}

--==MYBOUNDARY==--

Para usar esse volume na tarefa, ele deve ser adicionado no parâmetro EksProperties para RegisterJobDefinition. O exemplo a seguir é uma grande parte da definição do trabalho.

{
    "jobDefinitionName": "MyJobOnEks_EFS",
    "type": "container",
    "eksProperties": {
        "podProperties": {
            "containers": [
                {
                    "image": "public.ecr.aws/amazonlinux/amazonlinux:2",
                    "command": ["ls", "-la", "/efs"],
                    "resources": {
                        "limits": {
                            "cpu": "1",
                            "memory": "1024Mi"
                        }
                    },
                    "volumeMounts": [
                        {
                            "name": "efs-volume",
                            "mountPath": "/efs"
                        }
                    ]
                }
            ],
            "volumes": [
                {
                    "name": "efs-volume",
                    "hostPath": {
                        "path": "/mnt/efs"
                    }
                }
            ]
        }
    }
}

No nó, o volume do Amazon EFS é montado no diretório /mnt/efs. No contêiner do trabalho do Amazon EKS, o volume é montado no diretório /efs.

Suporte a IPv6

AWS Batch é compatível com clusters do Amazon EKS que têm endereços IPv6. Nenhuma personalização é necessária para suporte AWS Batch. No entanto, antes de começar, recomendamos que você analise as considerações e condições descritas em Atribuição de endereços IPv6 para pods e serviços no Guia do usuário do Amazon EKS.