Build Abschnitt

(Erforderlich) Gibt die Konfiguration an, in der das Image erstellt wird.

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

Build-Eigenschaften

InstanceType(Erforderlich,String)

Gibt den Instanztyp für die Instanz an, die zum Erstellen des Images verwendet wurde.

SubnetId(Fakultativ,String)

Gibt die ID eines vorhandenen Subnetzes an, in dem die Instanz bereitgestellt werden soll, um das Image zu erstellen. Das bereitgestellte Subnetz erfordert Internetzugang.

Warnung

pcluster build-imageverwendet die Standard-VPC. Wenn die Standard-VPC gelöscht wurde, möglicherweise mithilfe von AWS Control Tower oder AWS Landing Zone, muss die Subnetz-ID angegeben werden.

ParentImage(Erforderlich,) String

Gibt das Basisimage an. Das übergeordnete Image kann entweder ein AWS ParallelCluster Nicht-AMI oder ein offizielles AWS ParallelCluster AMI für dieselbe Version sein. Sie können kein AWS ParallelCluster offizielles oder benutzerdefiniertes AMI aus einer anderen Version von verwenden AWS ParallelCluster. Das Format muss entweder der ARN eines Images arn:Partition:imagebuilder:Region:Account:image/ImageName/ImageVersion oder eine AMI-ID seinami-12345678.

SecurityGroupIds(Fakultativ,[String])

Gibt die Liste der Sicherheitsgruppen-IDs für das Bild an.

Imds

Imds-Eigenschaften

(Optional) Gibt die Einstellungen für den ImageBuilder EC2-Build- und Testinstanz-Metadatendienst (IMDS) an.

Imds:
  ImdsSupport: string

ImdsSupport(Optional,) String

Gibt an, welche IMDS-Versionen in den ImageBuilder EC2-Build- und Test-Instances unterstützt werden. Unterstützte Werte sind v2.0 und v1.0. Der Standardwert ist v2.0.

Wenn auf gesetzt ImdsSupport istv1.0, werden sowohl IMDSv1 als auch IMDSv2 unterstützt.

Wenn auf gesetzt ImdsSupport istv2.0, wird nur IMDSv2 unterstützt.

Weitere Informationen finden Sie unter Verwenden von IMDSv2 im EC2-Benutzerhandbuch für Linux-Instances.

Aktualisierungsrichtlinie: Wenn diese Einstellung geändert wird, ist das Update nicht zulässig.

Anmerkung

Ab AWS ParallelCluster Version 3.7.0 ist der ImdsSupport Standardwert. v2.0 Wir empfehlen, dass Sie in Ihren Aufrufen für benutzerdefinierte Aktionen ImdsSupport auf IMDSv1 setzen v2.0 und dieses durch IMDSv2 ersetzen.

Support für Imds/ImdsSupportwurde mit AWS ParallelCluster Version 3.3.0 hinzugefügt.

Iam

Iam-Eigenschaften

(Optional) Gibt die IAM-Ressourcen für den Image-Build an.

Iam:
  InstanceRole: string
  InstanceProfile: string
  CleanupLambdaRole: string
  AdditionalIamPolicies:
    - Policy: string
  PermissionsBoundary: string

InstanceProfile(Optional,String)

Gibt ein Instanzprofil an, um das Standard-Instanzprofil für die EC2 Image Builder Builder-Instance zu überschreiben. InstanceProfileund InstanceRole und AdditionalIamPolicies können nicht zusammen angegeben werden. Das Format ist arn:Partition:iam::Account:instance-profile/InstanceProfileName.

InstanceRole(Fakultativ,String)

Gibt eine Instanzrolle an, um die Standard-Instanzrolle für die EC2 Image Builder Builder-Instance zu überschreiben. InstanceProfileund InstanceRole und AdditionalIamPolicies können nicht zusammen angegeben werden. Das Format ist arn:Partition:iam::Account:role/RoleName.

CleanupLambdaRole(Fakultativ,String)

Der ARN der IAM-Rolle, der für die AWS Lambda Funktion verwendet werden soll, die die AWS CloudFormation benutzerdefinierte Ressource unterstützt, die Build-Artefakte nach Abschluss des Builds entfernt. Lambda muss als Principal konfiguriert werden, der die Rolle übernehmen darf. Das Format ist arn:Partition:iam::Account:role/RoleName.

AdditionalIamPolicies(Fakultativ)

Gibt zusätzliche IAM-Richtlinien an, die an die EC2 Image Builder Builder-Instance angehängt werden sollen, die zur Erstellung des benutzerdefinierten AMI verwendet wurde.

AdditionalIamPolicies:
  - Policy: string

Policy(Optional,) [String]

Liste der IAM-Richtlinien. Das Format ist arn:Partition:iam::Account:policy/PolicyName.

PermissionsBoundary(Fakultativ,String)

Der ARN der IAM-Richtlinie, der als Berechtigungsgrenze für alle Rollen verwendet werden soll, die von AWS ParallelCluster erstellt wurden. Weitere Informationen zu den Grenzen von IAM-Berechtigungen finden Sie unter Berechtigungsgrenzen für IAM-Entitäten im IAM-Benutzerhandbuch. Das Format ist arn:Partition:iam::Account:policy/PolicyName.

Components

Components-Eigenschaften

(Optional) Gibt ImageBuilder EC2-Komponenten an, die während des AMI-Build-Prozesses zusätzlich zu den standardmäßig AWS ParallelCluster von bereitgestellten verwendet werden sollen. Solche Komponenten können verwendet werden, um den AMI-Erstellungsprozess anzupassen. Weitere Informationen finden Sie unter AWS ParallelCluster AMI-Anpassung.

Components:
  - Type: string
    Value: string

Type(Fakultativ,String)

Gibt den Typ des Typ-Wert-Paares für die Komponente an. Der Typ kann arn oder script sein.

Value(Fakultativ,String)

Gibt den Wert des Typ-Wert-Paares für die Komponente an. Wenn type gleich istarn, ist dies der ARN einer EC2 Image Builder Builder-Komponente. Wenn type gleich istscript, ist dies der https- oder s3-Link, der auf das Skript verweist, das bei der Erstellung der EC2 Image Builder Builder-Komponente verwendet werden soll.

Tags

Tags-Eigenschaften

(Optional) Gibt die Liste der Tags an, die in den Ressourcen festgelegt werden sollen, die zum Erstellen des AMI verwendet werden.

Tags:
  - Key: string
    Value: string

Key(Optional,String)

Definiert den Namen des Tags.

Value(Fakultativ,String)

Definiert den Wert des Tags.

UpdateOsPackages

UpdateOsPackages-Eigenschaften

(Optional) Gibt an, ob das Betriebssystem vor der Installation des AWS ParallelCluster Software-Stacks aktualisiert wird.

UpdateOsPackages:
  Enabled: boolean

Enabled(Optional,Boolean)

Fallstrue, wird das Betriebssystem aktualisiert und neu gestartet, bevor die AWS ParallelCluster Software installiert wird. Der Standardwert ist false.

Anmerkung

Wenn UpdateOsPackages aktiviert, werden alle verfügbaren Betriebssystempakete aktualisiert, einschließlich des Kernels. Als Kunde sind Sie dafür verantwortlich, zu überprüfen, ob das Update mit den AMI-Abhängigkeiten kompatibel ist, die nicht im Update enthalten sind.

Nehmen wir zum Beispiel an, Sie erstellen ein AMI für AWS ParallelCluster Version X.0, das mit Kernel-Version Y.0 und einigen Komponentenversionen Z.0 ausgeliefert wird. Angenommen, das verfügbare Update enthält die aktualisierte Kernelversion Y.1 ohne Updates für die Komponente Z.0. Vor der Aktivierung müssen Sie sicherstellenUpdateOsPackages, dass die Komponente Z.0 den Kernel Y.1 unterstützt.