

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

# Personalizza i modelli di lancio di Amazon EKS

AWS Batch su Amazon EKS supporta i modelli di avvio. Le funzionalità del modello di lancio sono limitate.

**Importante**  
Per le AMI EKS AL2, AWS Batch corse `/etc/eks/bootstrap.sh`. Non correre `/etc/eks/bootstrap.sh` nel modello di lancio o cloud-init user-data script. È possibile aggiungere parametri aggiuntivi oltre a `--kubelet-extra-args` parametro a [bootstrap.sh](https://github.com/awslabs/amazon-eks-ami/blob/al2/templates/al2/runtime/bootstrap.sh). Per fare ciò, imposta `AWS_BATCH_KUBELET_EXTRA_ARGS` variabile in `/etc/aws-batch/batch.config` file. Per ulteriori informazioni, vedere l'esempio seguente.
Per EKS AL2023, AWS Batch utilizza il [NodeConfigSpec](https://awslabs.github.io/amazon-eks-ami/nodeadm/doc/api/#nodeconfigspec) da EKS per far sì che le istanze si uniscano al cluster EKS. AWS Batch popola [ClusterDetails](https://awslabs.github.io/amazon-eks-ami/nodeadm/doc/api/#clusterdetails) nel [NodeConfigSpec](https://awslabs.github.io/amazon-eks-ami/nodeadm/doc/api/#nodeconfigspec) per il cluster EKS e non è necessario specificarli.

**Nota**  
Ti consigliamo di non impostare nessuna delle seguenti opzioni [NodeConfigSpec](https://awslabs.github.io/amazon-eks-ami/nodeadm/doc/api/#nodeconfigspec) impostazioni nel modello di avvio come AWS Batch sovrascriveranno i tuoi valori. Per ulteriori informazioni, consulta [Responsabilità condivisa di Kubernetes nodi](eks-ce-shared-responsibility.md).  
`Taints`
`Cluster Name`
`apiServerEndpoint`
`certificatAuthority`
`CIDR`
Non creare etichette con il prefisso `batch.amazonaws.com/`

**Nota**  
Se il modello di avvio viene modificato dopo [CreateComputeEnvironment](https://docs.aws.amazon.com/batch/latest/APIReference/API_CreateComputeEnvironment.html) si chiama, [UpdateComputeEnvironment](https://docs.aws.amazon.com/batch/latest/APIReference/API_UpdateComputeEnvironment.html) deve essere chiamato per valutare la versione del modello di avvio da sostituire.

**Topics**
+ [Inserisci `kubelet` argomenti aggiuntivi](#kubelet-extra-args)
+ [Configurare il runtime del contenitore](#change-container-runtime)
+ [Montare un volume Amazon EFS](#mounting-efs-volume)
+ [Supporto IPv6](#eks-ipv6-support)

## Inserisci `kubelet` argomenti aggiuntivi
<a name="kubelet-extra-args"></a>

AWS Batch supporta l'aggiunta di argomenti aggiuntivi a `kubelet` comando. Per l'elenco dei parametri supportati, vedere [kubelet](https://kubernetes.io/docs/reference/command-line-tools-reference/kubelet/) nel *Kubernetes documentazione*. Nel seguente esempio per le AMI EKS AL2, `{{--node-labels mylabel=helloworld}}` viene aggiunto a `kubelet` riga di comando.

```
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==--
```

Per le AMI EKS AL2023 il formato del file è YAML. Per l'elenco dei parametri supportati, vedere [NodeConfigSpec](https://awslabs.github.io/amazon-eks-ami/nodeadm/doc/api/#nodeconfigspec) nel *Kubernetes documentazione*. Nel seguente esempio per le AMI EKS AL203, `{{--node-labels mylabel=helloworld}}` viene aggiunto al `kubelet` riga di comando.

```
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==--
```

## Configurare il runtime del contenitore
<a name="change-container-runtime"></a>

Puoi usare il AWS Batch `CONTAINER_RUNTIME` variabile di ambiente per configurare il runtime del contenitore su un nodo gestito. L'esempio seguente imposta il runtime del contenitore su `containerd` quando `bootstrap.sh` corre. Per ulteriori informazioni, vedere [`containerd`](https://kubernetes.io/docs/setup/production-environment/container-runtimes/#containerd) nel *Kubernetes documentazione*. 

Se stai usando un ottimizzato `EKS_AL2023` o `EKS_AL2023_NVIDIA` AMI non è necessario specificare solo il runtime del contenitore **contenitori** è supportato.

**Nota**  
Il `CONTAINER_RUNTIME` la variabile di ambiente è equivalente a `--container-runtime` opzione di `bootstrap.sh`. Per ulteriori informazioni, vedere [Options](https://kubernetes.io/docs/reference/command-line-tools-reference/kubelet/#options) nel *Kubernetes documentazione*.

```
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==--
```

## Montare un volume Amazon EFS
<a name="mounting-efs-volume"></a>

Puoi utilizzare i modelli di avvio per montare i volumi sul nodo. Nel seguente esempio, `cloud-config` `packages` e `runcmd` vengono utilizzate le impostazioni. Per ulteriori informazioni, vedere [Esempi di configurazione cloud](https://cloudinit.readthedocs.io/en/latest/topics/examples.html) nel *cloud-init documentazione*.

```
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==--
```

Per utilizzare questo volume nel lavoro, è necessario aggiungerlo nel [Proprietà EKS](https://docs.aws.amazon.com/batch/latest/APIReference/API_EksProperties.html) parametro a [RegisterJobDefinition](https://docs.aws.amazon.com/batch/latest/APIReference/API_RegisterJobDefinition.html). L'esempio seguente è una parte importante della definizione del lavoro.

```json
{
    "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}}"
                    }
                }
            ]
        }
    }
}
```

Nel nodo, il volume Amazon EFS è montato nel `/mnt/efs` directory. Nel contenitore per il job Amazon EKS, il volume è montato nel `/efs` directory.

## Supporto IPv6
<a name="eks-ipv6-support"></a>

AWS Batch supporta cluster Amazon EKS con indirizzi IPv6. Non sono richieste personalizzazioni per AWS Batch supporto. Tuttavia, prima di iniziare, ti consigliamo di esaminare le considerazioni e le condizioni descritte in [Assegnazione di indirizzi IPv6 a pod e servizi](https://docs.aws.amazon.com/eks/latest/userguide/cni-ipv6.html) nel *Guida per l'utente di Amazon EKS*.