

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

# Creazione di un’AMI personalizzata
<a name="hyperpod-custom-ami-how-to"></a>

La pagina seguente spiega come creare un'Amazon Machine Image (AMI) personalizzata utilizzando le AMI di base di Amazon SageMaker HyperPod. Inizia selezionando un’AMI di base, quindi crea un’AMI personalizzata utilizzando uno dei diversi metodi disponibili per la creazione di nuove immagini, ad esempio la AWS CLI.

## Seleziona un'AMI di SageMaker HyperPod base
<a name="hyperpod-custom-ami-select-base"></a>

È possibile selezionare un AMI di SageMaker HyperPod base tramite uno dei seguenti metodi.

### AWS selezione della console
<a name="hyperpod-custom-ami-console-selection"></a>

È possibile selezionare le SageMaker HyperPod AMI pubbliche tramite la AWS console o utilizzando la chiamata `DescribeImages` API. SageMaker HyperPod Le AMI sono pubbliche e visibili in tutti. Account AWS Puoi trovarle nel catalogo delle AMI Amazon EC2 applicando un filtro per cercare le AMI pubbliche di proprietà di Amazon.

Per trovare le SageMaker HyperPod AMI nella console:

1. Accedi alla console Amazon EC2.

1. Nel riquadro di navigazione a sinistra scegliere **AMIs (AMI)**.

1. Nell’elenco a discesa **Tipo di immagine**, seleziona **Immagini pubbliche**.

1. Nei filtri della barra di ricerca, imposta il filtro **Alias proprietario** su **amazon**.

1. Cerca le AMI con il prefisso ** HyperPod EKS ** (per l'orchestrazione di Amazon Elastic Kubernetes Service) o ** HyperPod Slurm ** (per l'orchestrazione di Slurm) e seleziona l'AMI più recente adatta al tuo caso d'uso.

### Recupera l'ultimo ID AMI pubblico tramite AWS CLI
<a name="hyperpod-custom-ami-cli-fetch"></a>

Se desideri utilizzare sempre l'AMI pubblica dell'ultima versione, è più efficiente utilizzare il parametro SageMaker HyperPod SSM pubblico che contiene il valore dell'ultimo ID AMI rilasciato da. SageMaker HyperPod

L’esempio seguente spiega come recuperare l’ID dell’AMI più recente con la AWS CLI:

```
aws ssm get-parameter \
  --name "/aws/service/sagemaker-hyperpod/ami/x86_64/eks-1.31-amazon-linux-2/latest/ami-id" \
  --region {{us-east-1}} \
  --query "Parameter.Value" \
  --output text
```

**Nota**  
Sostituisci il nome del parametro con la versione Kubernetes corrispondente o il sistema operativo base Slurm, se necessario. Ad esempio, per Kubernetes 1.30, usa. `/aws/service/sagemaker-hyperpod/ami/x86_64/eks-1.30-amazon-linux-2/latest/ami-id` Per Slurm su Ubuntu 22.04, usa. `/aws/service/sagemaker-hyperpod/ami/x86_64/slurm-ubuntu-22.04/latest/ami-id`

## Creazione di un’AMI personalizzata
<a name="hyperpod-custom-ami-build"></a>

Dopo aver selezionato un'AMI SageMaker HyperPod pubblica, usala come AMI di base per creare la tua AMI personalizzata con uno dei seguenti metodi. Tieni presente che questo non rappresenta un elenco completo per la creazione di AMI. Puoi utilizzare qualsiasi metodo a tua scelta per creare le AMI. SageMaker HyperPod non ha alcuna raccomandazione specifica.
+ **AWS Console di gestione**: puoi avviare un'istanza Amazon EC2 utilizzando l' SageMaker HyperPod AMI, apportare le personalizzazioni desiderate e quindi creare un'AMI da quell'istanza.
+ **AWS CLI**: puoi anche utilizzare il comando `aws ec2 create-image` per creare un’AMI da un’istanza Amazon EC2 esistente dopo aver eseguito la personalizzazione.
+ **HashiCorp Packer**: Packer è uno strumento open source HashiCorp che consente di creare immagini di macchine identiche per più piattaforme da un'unica configurazione di origine. Supporta la creazione di AMI e immagini per AWS altri provider di cloud e piattaforme di virtualizzazione.
+ **Image Builder**: EC2 Image Builder è un servizio AWS completamente gestito che semplifica l’automazione delle operazioni di creazione, manutenzione, convalida, condivisione e implementazione di immagini Linux o Windows Server. Per ulteriori informazioni, consulta la [Guida per l'utente di EC2 Image Builder](https://docs.aws.amazon.com/imagebuilder/latest/userguide/what-is-image-builder.html).

### Crea un'AMI personalizzata con gestione del cliente AWS KMS crittografia
<a name="hyperpod-custom-ami-build-kms"></a>

Le sezioni seguenti descrivono come creare un'AMI personalizzata con una AWS KMS chiave gestita dal cliente per crittografare i volumi HyperPod del cluster. Per ulteriori informazioni sulle chiavi gestite dal cliente HyperPod e sulla concessione delle autorizzazioni necessarie per le policy chiave IAM e KMS, consulta. [Gestito dal cliente AWS KMS key crittografia per SageMaker HyperPod](smcluster-cmk.md) Se prevedi di utilizzare un'AMI personalizzata crittografata con una chiave gestita dal cliente, assicurati di crittografare anche il volume principale Amazon EBS del HyperPod cluster con la stessa chiave.

#### AWS CLI esempio: crea una nuova AMI utilizzando EC2 Image Builder e un'immagine di base HyperPod
<a name="hyperpod-custom-ami-cli-example"></a>

L’esempio seguente illustra come creare un’AMI utilizzando Image Builder con crittografia AWS KMS :

```
aws imagebuilder create-image-recipe \
    name "{{hyperpod-custom-recipe}}" \
    version "1.0.0" \
    parent-image "{{<hyperpod-base-image-id>}}" \
    block-device-mappings DeviceName="/dev/xvda",Ebs={VolumeSize=100,VolumeType=gp3,Encrypted=true,KmsKeyId=arn:aws:kms:{{us-east-1}}:{{111122223333}}:key/{{key-id}},DeleteOnTermination=true}
```

#### Console Amazon EC2: creazione di una nuova AMI da Amazon EC2
<a name="hyperpod-custom-ami-console-example"></a>

Per creare un’AMI da un’istanza Amazon EC2 con la console di Amazon EC2:

1. Right-click sulla tua istanza Amazon EC2 personalizzata e scegli ** Crea immagine. **

1. Nella sezione **Crittografia**, seleziona **Crittografa snapshot**.

1. Seleziona la chiave KMS dall’elenco a discesa. Ad esempio: `arn:aws:kms:{{us-east-2}}:{{111122223333}}:key/{{<your-kms-key-id>}}` oppure utilizza l’alias della chiave: `alias/{{<your-hyperpod-key>}}`.

#### AWS CLI esempio: crea una nuova AMI da un'istanza Amazon EC2
<a name="hyperpod-custom-ami-cli-create-image"></a>

Utilizza il comando `aws ec2 create-image` con la crittografia AWS KMS :

```
aws ec2 create-image \
    instance-id "{{<instance-id>}}" \
    name "{{MyCustomHyperPodAMI}}" \
    description "{{Custom HyperPod AMI}}" \
    block-device-mappings '[
        {
            "DeviceName": "/dev/xvda",
            "Ebs": {
                "Encrypted": true,
                "KmsKeyId": "arn:aws:kms:{{us-east-1}}:{{111122223333}}:key/{{key-id}}",
                "VolumeType": "gp2" 
            }
        }
    ]'
```