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à. # Sezione `Build` **(Obbligatorio)** Specificate la configurazione in cui verrà creata l'immagine. ``` Build: Imds: ImdsSupport: string InstanceType: string SubnetId: string ParentImage: string Iam: InstanceRole: string InstanceProfile: string CleanupLambdaRole: string AdditionalIamPolicies: - Policy: string PermissionsBoundary: string Components: - Type: string Value: string Tags: - Key: string Value: string SecurityGroupIds: - string UpdateOsPackages: Enabled: boolean Installation: NvidiaSoftware: Enabled: boolean LustreClient: Enabled: boolean ``` ## Proprietà `Build` `InstanceType`(**Obbligatorio**,`String`) Speciifica il tipo di istanza utilizzata per creare l'immagine. `SubnetId`(**Facoltativo,`String`)** Speciifica l'ID di una sottorete esistente in cui effettuare il provisioning dell'istanza per creare l'immagine. La sottorete fornita richiede l'accesso a Internet. Tieni presente che potrebbe essere necessario [modificare gli attributi di indirizzo IP della sottorete se la](https://docs.aws.amazon.com/vpc/latest/userguide/subnet-public-ip.html) compilazione fallisce. `pcluster build-image`utilizza il VPC predefinito. Se il VPC predefinito è stato eliminato, magari utilizzando AWS Control Tower o AWS Landing Zone, è necessario specificare l'ID della sottorete. Quando si specifica il SubnetId, si consiglia di specificare anche la SecurityGroupIds proprietà. Se ometti, AWS ParallelCluster utilizzerà SecurityGroupIds i gruppi di sicurezza predefiniti o si baserà sul comportamento predefinito all'interno della sottorete specificata. Quando si utilizzano entrambi, si ottengono i seguenti vantaggi: + Controllo granulare: quando li definisci in modo esplicito entrambi, ti assicuri che le istanze avviate durante il processo di creazione dell'immagine siano collocate nella sottorete corretta e disponga dell'accesso preciso alla rete necessario per i componenti della build e tutti i servizi richiesti (come l'accesso a S3 per gli script di compilazione). + Migliori pratiche di sicurezza: quando definisci i gruppi di sicurezza appropriati, ciò aiuta a limitare l'accesso alla rete solo alle porte e ai servizi necessari, il che migliora la sicurezza dell'ambiente di compilazione. + Evitare potenziali problemi: se ci si affida esclusivamente ai valori predefiniti, è possibile che i gruppi di sicurezza siano troppo aperti o troppo restrittivi, il che può causare problemi durante il processo di creazione. `ParentImage`**(Obbligatorio,)** `String` Specifica l'immagine di base. L'immagine principale può essere non AWS ParallelCluster AMI o un' AWS ParallelCluster AMI ufficiale per la stessa versione. Non puoi usare un'AMI AWS ParallelCluster ufficiale o personalizzata di una versione diversa di AWS ParallelCluster. Il formato deve essere l'ARN di un'immagine `arn:Partition:imagebuilder:Region:Account:image/ImageName/ImageVersion` o un ID AMI. `ami-12345678` `SecurityGroupIds`(**Facoltativo,`[String]`)** Specifica l'elenco dei gruppi di sicurezza IDs per l'immagine. ### `Imds` #### Proprietà `Imds` **(Facoltativo)** Speciifica le impostazioni IMDS (Build and Test Instance Metadata Service) di Amazon ImageBuilder EC2. ``` Imds: ImdsSupport: string ``` `ImdsSupport`**(Facoltativo,)** `String` Speciifica quali versioni IMDS sono supportate nelle istanze di build e test di Amazon ImageBuilder EC2. I valori supportati sono `v2.0` e `v1.0`. Il valore predefinito è `v2.0`. Se `ImdsSupport` è impostato su`v1.0`, entrambi IMDSv1 sono supportati. IMDSv2 Se `ImdsSupport` è impostato su`v2.0`, solo IMDSv2 è supportato. Per ulteriori informazioni, consulta [Use IMDSv2](https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/configuring-instance-metadata-service.html) in the *Amazon EC2 User Guide for Linux instances*. [Politica di aggiornamento: se questa impostazione viene modificata, l'aggiornamento non è consentito.](using-pcluster-update-cluster-v3.md#update-policy-fail-v3) A partire dalla AWS ParallelCluster versione 3.7.0, il `ImdsSupport` valore predefinito è. `v2.0` Ti consigliamo di impostare `v2.0` e `ImdsSupport` sostituire IMDSv1 con IMDSv2 nelle tue azioni personalizzate le chiamate. Il supporto per [`Imds`](#Build-v3-Imds)/[`ImdsSupport`](#yaml-build-image-Build-Imds-ImdsSupport)viene aggiunto con la AWS ParallelCluster versione 3.3.0. ### `Iam` #### Proprietà `Iam` (**Facoltativo**) Specifica le risorse IAM per la creazione dell'immagine. ``` Iam: InstanceRole: string InstanceProfile: string CleanupLambdaRole: string AdditionalIamPolicies: - Policy: string PermissionsBoundary: string ``` `InstanceProfile`(**Facoltativo,`String`)** Speciifica un profilo di istanza per sovrascrivere il profilo di istanza predefinito per l'istanza EC2 Image Builder. `InstanceProfile`e `AdditionalIamPolicies` non possono essere `InstanceRole` specificati insieme. Il formato è `arn:Partition:iam::Account:instance-profile/InstanceProfileName`. `InstanceRole`(**Facoltativo**,`String`) Speciifica un ruolo di istanza per sovrascrivere il ruolo di istanza predefinito per l'istanza EC2 Image Builder. `InstanceProfile`e `AdditionalIamPolicies` non possono essere `InstanceRole` specificati insieme. Il formato è `arn:Partition:iam::Account:role/RoleName`. `CleanupLambdaRole`(**Facoltativo**,`String`) L'ARN del ruolo IAM da utilizzare per la AWS Lambda funzione che supporta la risorsa CloudFormation personalizzata che rimuove gli artefatti della build al completamento della build. Lambda deve essere configurata come principale autorizzata ad assumere il ruolo. Il formato è `arn:Partition:iam::Account:role/RoleName`. `AdditionalIamPolicies`(**Facoltativo)** Specifica policy IAM aggiuntive da collegare all'istanza EC2 Image Builder utilizzata per produrre l'AMI personalizzata. ``` AdditionalIamPolicies: - Policy: string ``` `Policy`**(Facoltativo,)** `[String]` Elenco delle politiche IAM. Il formato è `arn:Partition:iam::Account:policy/PolicyName`. `PermissionsBoundary`(**Facoltativo**,`String`) L'ARN della policy IAM da utilizzare come limite delle autorizzazioni per tutti i ruoli creati da. AWS ParallelCluster*Per ulteriori informazioni sui limiti delle autorizzazioni IAM, consulta la sezione Limiti delle [autorizzazioni per le entità IAM nella Guida per l'utente IAM](https://docs.aws.amazon.com/IAM/latest/UserGuide/access_policies_boundaries.html).* Il formato è `arn:Partition:iam::Account:policy/PolicyName`. ### `Components` #### Proprietà `Components` (**Facoltativo**) Specifica i componenti di Amazon ImageBuilder EC2 da utilizzare durante il processo di creazione dell'AMI oltre a quelli forniti di default da. AWS ParallelCluster Tali componenti possono essere utilizzati per personalizzare il processo di creazione dell'AMI. Per ulteriori informazioni, consulta [AWS ParallelCluster Personalizzazione AMI](custom-ami-v3.md). ``` Components: - Type: string Value: string ``` `Type`(**Facoltativo**,`String`) Speciifica il tipo di coppia tipo-valore per il componente. Il tipo può essere o. `arn` `script` `Value`(**Facoltativo**,`String`) Specifica il valore della coppia tipo-valore per il componente. Quando type è`arn`, questo è l'ARN di un componente EC2 Image Builder. Quando il tipo è`script`, questo è il ponente. https or s3 link that points to the script to use when you create the EC2 Image Builder com ### `Tags` #### Proprietà `Tags` (**Facoltativo**) Specifica l'elenco di tag da impostare nelle risorse utilizzate per creare l'AMI. ``` Tags: - Key: string Value: string ``` `Key`(**Facoltativo,`String`)** Definisce il nome del tag. `Value`(**Facoltativo**,`String`) Definisce il valore del tag. ### `UpdateOsPackages` #### Proprietà `UpdateOsPackages` (**Facoltativo**) Specificate se il sistema operativo viene aggiornato prima di installare lo AWS ParallelCluster stack software. ``` UpdateOsPackages: Enabled: boolean ``` `Enabled`(**Facoltativo**,) `Boolean` Se`true`, il sistema operativo viene aggiornato e riavviato prima di installare il AWS ParallelCluster software. Il valore predefinito è `false`. Quando `UpdateOsPackages` è abilitato, tutti i pacchetti del sistema operativo disponibili vengono aggiornati, incluso il kernel. In qualità di cliente, è tua responsabilità verificare che l'aggiornamento sia compatibile con le dipendenze AMI non incluse nell'aggiornamento. Ad esempio, supponiamo di voler creare un'AMI per la AWS ParallelCluster versione X.0 fornita con la versione del kernel Y.0 e la versione di alcuni componenti Z.0. Supponiamo che l'aggiornamento disponibile includa la versione aggiornata del kernel Y.1 senza aggiornamenti al componente Z.0. Prima di abilitarlo`UpdateOsPackages`, è tua responsabilità verificare che il componente Z.0 supporti il kernel Y.1. ### `Installation` #### Proprietà `Installation` **(Facoltativo)** Specifica il software aggiuntivo da installare sull'immagine. ``` Installation: NvidiaSoftware: Enabled: boolean LustreClient: Enabled: boolean ``` `NvidiaSoftware`proprietà (**facoltativo)** Specifica il software Nvidia da installare. ``` NvidiaSoftware: Enabled: boolean ``` `Enabled`(**Facoltativo**,) `boolean` Se`true`, verranno installati il driver GPU Nvidia e CUDA. Il valore predefinito è `false`. `LustreClient`**proprietà (opzionale)** Speciifica che verrà installato il client Amazon FSx Lustre. ``` LustreClient: Enabled: boolean ``` `Enabled`(**Facoltativo**,) `boolean` Se`true`, verrà installato il client Lustre. Il valore predefinito è `true`.