Sezione Build

(Obbligatorio) Specifica 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

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.

avvertimento

pcluster build-imageutilizza il VPC predefinito. Se il VPC predefinito è stato eliminato, magari utilizzando AWS Control Tower o AWS Landing Zone, è necessario specificare l'ID della sottorete.

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 degli ID dei gruppi di sicurezza per l'immagine.

Imds

Proprietà Imds

(Facoltativo) Specifica le impostazioni IMDS ( ImageBuilder build and test instance metadata service) di EC2.

Imds:
  ImdsSupport: string

ImdsSupport(Facoltativo,) String

Speciifica quali versioni IMDS sono supportate nelle istanze di ImageBuilder build e test EC2. I valori supportati sono v2.0 e v1.0. Il valore predefinito è v2.0.

Se ImdsSupport è impostato suv1.0, sono supportati sia IMDSv1 che IMDSv2.

Se ImdsSupport è impostato su, è supportato solo IMDSv2. v2.0

Per ulteriori informazioni, consulta Use IMDSv2 nella Guida per l'utente EC2 per le istanze Linux.

Politica di aggiornamento: se questa impostazione viene modificata, l'aggiornamento non è consentito.

Nota

A partire dalla AWS ParallelCluster versione 3.7.0, il valore predefinito è. ImdsSupport v2.0 Ti consigliamo di impostare v2.0 e ImdsSupport sostituire IMDSv1 con IMDSv2 nelle chiamate ad azioni personalizzate.

Il supporto per Imds/ImdsSupportviene 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. InstanceProfilee 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. InstanceProfilee 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 di supporto della risorsa AWS 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 ParallelClusterPer ulteriori informazioni sui limiti delle autorizzazioni IAM, consulta la sezione Limiti delle autorizzazioni per le entità IAM nella Guida per l'utente IAM. Il formato è arn:Partition:iam::Account:policy/PolicyName.

Components

Proprietà Components

(Facoltativo) Specifica ImageBuilder i componenti EC2 da utilizzare durante il processo di creazione dell'AMI in aggiunta 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.

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 type èscript, questo è il link https o s3 che punta allo script da utilizzare durante la creazione del componente EC2 Image Builder.

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

Setrue, il sistema operativo viene aggiornato e riavviato prima di installare il AWS ParallelCluster software. Il valore predefinito è false.

Nota

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 creare un'AMI per la AWS ParallelCluster versione X.0 fornita con la versione del kernel Y.0 e la versione Z.0 di alcuni componenti. Supponiamo che l'aggiornamento disponibile includa la versione aggiornata del kernel Y.1 senza aggiornamenti al componente Z.0. Prima di abilitarloUpdateOsPackages, è tua responsabilità verificare che il componente Z.0 supporti il kernel Y.1.