Build Section - AWS ParallelCluster
Propriétés de Build

Les traductions sont fournies par des outils de traduction automatique. En cas de conflit entre le contenu d'une traduction et celui de la version originale en anglais, la version anglaise prévaudra.

Build Section

(Obligatoire) Spécifie la configuration dans laquelle l'image sera créée.

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

Propriétés de Build

InstanceType(Obligatoire,String)

Spécifie le type d'instance pour l'instance utilisée pour créer l'image.

SubnetId(Facultatif,String)

Spécifie l'ID d'un sous-réseau existant dans lequel fournir l'instance pour créer l'image. Le sous-réseau fourni nécessite un accès Internet.

Avertissement

pcluster build-imageutilise la valeur par défautVPC. Si la valeur par défaut VPC a été supprimée, par exemple en utilisant AWS Control Tower ou AWS Landing Zone, l'ID du sous-réseau doit être spécifié.

ParentImage(Obligatoire,String)

Spécifie l'image de base. L'image parent peut être une image non officielle AWS ParallelCluster AMI ou une image officielle AWS ParallelCluster AMI pour la même version. Vous ne pouvez pas utiliser une version AWS ParallelCluster officielle ou personnalisée AMI d'une autre version de AWS ParallelCluster. Le format doit être celui ARN d'une image arn:Partition:imagebuilder:Region:Account:image/ImageName/ImageVersion ou d'un AMI identifiantami-12345678.

SecurityGroupIds(Facultatif,[String])

Spécifie la liste des groupes de sécurité IDs pour l'image.

Imds

Propriétés de Imds

(Facultatif) Spécifie les paramètres du service de métadonnées des instances de EC2 ImageBuilder création et de test Amazon (IMDS).

Imds:
  ImdsSupport: string
ImdsSupport(Facultatif,String)

Spécifie les IMDS versions prises en charge dans les instances de EC2 ImageBuilder build et de test Amazon. Les valeurs prises en charge sont v2.0 et v1.0. La valeur par défaut est v2.0.

S'il ImdsSupport est défini surv1.0, IMDSv1 les deux IMDSv2 sont pris en charge.

S'il ImdsSupport est défini surv2.0, seul IMDSv2 est pris en charge.

Pour plus d'informations, consultez la section Utilisation IMDSv2 dans le guide de EC2 l'utilisateur Amazon pour les instances Linux.

Politique de mise à jour : si ce paramètre est modifié, la mise à jour n'est pas autorisée.

Note

À partir de AWS ParallelCluster la version 3.7.0, la valeur ImdsSupport par défaut estv2.0. Nous vous recommandons de ImdsSupport définir v2.0 et de remplacer IMDSv1 par IMDSv2 dans vos appels d'actions personnalisés.

Support pour Imds/ImdsSupportest ajouté avec AWS ParallelCluster la version 3.3.0.

Iam

Propriétés de Iam

(Facultatif) Spécifie les IAM ressources pour la création de l'image.

Iam:
  InstanceRole: string
  InstanceProfile: string
  CleanupLambdaRole: string
  AdditionalIamPolicies:
    - Policy: string
  PermissionsBoundary: string
InstanceProfile(Facultatif,String)

Spécifie un profil d'instance pour remplacer le profil d'instance par défaut pour l'instance EC2 Image Builder. InstanceProfileInstanceRoleet AdditionalIamPolicies ne peuvent pas être spécifiés ensemble. Le format est arn:Partition:iam::Account:instance-profile/InstanceProfileName.

InstanceRole(Facultatif,String)

Spécifie un rôle d'instance pour remplacer le rôle d'instance par défaut pour l'instance EC2 Image Builder. InstanceProfileInstanceRoleet AdditionalIamPolicies ne peuvent pas être spécifiés ensemble. Le format est arn:Partition:iam::Account:role/RoleName.

CleanupLambdaRole(Facultatif,String)

Le IAM rôle à utiliser pour la AWS Lambda fonction ARN de sauvegarde de la ressource AWS CloudFormation personnalisée qui supprime les artefacts de construction à la fin de la construction. Lambda doit être configuré en tant que principal autorisé à assumer le rôle. Le format est arn:Partition:iam::Account:role/RoleName.

AdditionalIamPolicies(Facultatif)

Spécifie IAM les politiques supplémentaires à associer à l'instance EC2 Image Builder utilisée pour produire la personnalisationAMI.

AdditionalIamPolicies:
  - Policy: string
Policy(Facultatif,[String])

Liste des IAM politiques Le format est arn:Partition:iam::Account:policy/PolicyName.

PermissionsBoundary(Facultatif,String)

La ARN IAM politique à utiliser comme limite d'autorisations pour tous les rôles créés par AWS ParallelCluster. Pour plus d'informations sur IAM les limites des autorisations, reportez-vous à la section Limites des autorisations pour les IAM entités du Guide de IAM l'utilisateur. Le format est arn:Partition:iam::Account:policy/PolicyName.

Components

Propriétés de Components

(Facultatif) Spécifie EC2 ImageBuilder les composants Amazon à utiliser pendant le processus de AMI création en plus de ceux fournis par défaut par AWS ParallelCluster. Ces composants peuvent être utilisés pour personnaliser le processus de AMI construction. Pour de plus amples informations, veuillez consulter AWS ParallelCluster AMIpersonnalisation.

Components:
  - Type: string
    Value: string
Type(Facultatif,String)

Spécifie le type de la paire type/valeur pour le composant. Le type peut être arn ouscript.

Value(Facultatif,String)

Spécifie la valeur de la paire type/valeur du composant. Lorsque le type estarn, il s'agit ARN d'un composant EC2 Image Builder. Lorsque le type estscript, c'est le https or s3 link pointing to the script to use when creating the EC2 Image Builder com ponent.

Tags

Propriétés de Tags

(Facultatif) Spécifie la liste des balises à définir dans les ressources utilisées pour créer leAMI.

Tags:
  - Key: string
    Value: string
Key(Facultatif,String)

Définit le nom de la balise.

Value(Facultatif,String)

Définit la valeur de la balise.

UpdateOsPackages

Propriétés de UpdateOsPackages

(Facultatif) Spécifie si le système d'exploitation est mis à jour avant l'installation de la pile AWS ParallelCluster logicielle.

UpdateOsPackages:
  Enabled: boolean
Enabled(Facultatif,Boolean)

Sitrue, le système d'exploitation est mis à jour et redémarré avant d'installer le AWS ParallelCluster logiciel. L’argument par défaut est false.

Note

Lorsque cette option UpdateOsPackages est activée, tous les packages de système d'exploitation disponibles sont mis à jour, y compris le noyau. En tant que client, il vous incombe de vérifier que la mise à jour est compatible avec les AMI dépendances qui ne sont pas incluses dans la mise à jour.

Supposons, par exemple, que vous créez un fichier AMI pour AWS ParallelCluster la version X.0 fourni avec la version du noyau Y.0 et une version de composant Z.0. Supposons que la mise à jour disponible inclut la version Y.1 du noyau mise à jour sans mise à jour du composant Z.0. Avant de l'activerUpdateOsPackages, il est de votre responsabilité de vérifier que le composant Z.0 supporte le noyau Y.1.