Seção Build

(Obrigatório) Especifica a configuração na qual a imagem será criada.

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

Propriedades do Build

InstanceType (Obrigatório, String)

Especifica o tipo de instância usada para criar a imagem.

SubnetId (Opcional, String)

Especifica o ID de uma sub-rede existente na qual o servidor provisiona a instância para a criação da imagem. A sub-rede fornecida requer acesso à Internet.

Atenção

pcluster build-imageusa o padrãoVPC. Se o padrão VPC tiver sido excluído, talvez usando AWS Control Tower ou AWS Landing Zone, então o ID da sub-rede deve ser especificado.

ParentImage (Obrigatório, String)

Especifica a imagem base. A imagem principal pode ser não AWS ParallelCluster AMIou um oficial AWS ParallelCluster AMIpara a mesma versão. Você não pode usar um AWS ParallelCluster oficial ou personalizado AMI de uma versão diferente do AWS ParallelCluster. O formato deve ser ARN de uma imagem arn:Partition:imagebuilder:Region:Account:image/ImageName/ImageVersion ou de um AMI IDami-12345678.

SecurityGroupIds (Opcional, [String])

Especifica a lista de grupos de segurança IDs para a imagem.

Imds

Propriedades do Imds

(Opcional) Especifica as configurações do serviço de metadados de instância de EC2 ImageBuilder criação e teste da Amazon (IMDS).

Imds:
  ImdsSupport: string

ImdsSupport (Opcional, String)

Especifica quais IMDS versões são suportadas nas instâncias de EC2 ImageBuilder compilação e teste da Amazon. Os valores compatíveis são v2.0 e v1.0. O valor padrão é v2.0.

Se ImdsSupport estiver definido comov1.0, ambos IMDSv1 IMDSv2 são suportados.

Se ImdsSupport estiver definido comov2.0, somente IMDSv2 é suportado.

Para obter mais informações, consulte Use IMDSv2 no Guia do EC2 usuário da Amazon para instâncias Linux.

Política de atualização: se essa configuração for alterada, a atualização não será permitida.

nota

Começando com AWS ParallelCluster versão 3.7.0, o valor ImdsSupport padrão é. v2.0 Recomendamos que você ImdsSupport defina v2.0 e IMDSv1 substitua por IMDSv2 em suas chamadas de ações personalizadas.

Support ImdsImdsSupportpara/é adicionado com AWS ParallelCluster versão 3.3.0.

Iam

Propriedades do Iam

(Opcional) Especifica os IAM recursos para a criação da imagem.

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

InstanceProfile (Opcional, String)

Especifica um perfil de instância para substituir o perfil de instância padrão da instância EC2 Image Builder. InstanceProfilee InstanceRole e AdditionalIamPolicies não podem ser especificados juntos. O formato é arn:Partition:iam::Account:instance-profile/InstanceProfileName.

InstanceRole (Opcional, String)

Especifica uma função de instância para substituir a função de instância padrão para a instância do EC2 Image Builder. InstanceProfilee InstanceRole e AdditionalIamPolicies não podem ser especificados juntos. O formato é arn:Partition:iam::Account:role/RoleName.

CleanupLambdaRole (Opcional, String)

O ARN da IAM função a ser usada para o AWS Lambda função que apóia o AWS CloudFormation recurso personalizado que remove artefatos de construção após a conclusão da construção. O Lambda precisa ser configurado como entidade principal autorizada a assumir a função. O formato é arn:Partition:iam::Account:role/RoleName.

AdditionalIamPolicies(Opcional)

Especifica IAM políticas adicionais a serem anexadas à instância do EC2 Image Builder usada para produzir a personalizaçãoAMI.

AdditionalIamPolicies:
  - Policy: string

Policy (Opcional, [String])

Lista de IAM políticas. O formato é arn:Partition:iam::Account:policy/PolicyName.

PermissionsBoundary (Opcional, String)

A IAM política ARN a ser usada como limite de permissões para todas as funções criadas por AWS ParallelCluster. Para obter mais informações sobre limites de IAM permissões, consulte Limites de permissões para IAM entidades no Guia IAM do usuário. O formato é arn:Partition:iam::Account:policy/PolicyName.

Components

Propriedades do Components

(Opcional) Especifica EC2 ImageBuilder os componentes da Amazon a serem usados durante o processo de AMI criação, além dos fornecidos por padrão pelo AWS ParallelCluster. Esses componentes podem ser usados para personalizar o processo de AMI construção. Para obter mais informações, consulte AWS ParallelCluster Personalização da AMI.

Components:
  - Type: string
    Value: string

Type (Opcional, String)

Especifica o tipo do par tipo-valor para o componente. O tipo pode ser arn ou script.

Value (Opcional, String)

Especifica o valor do par tipo-valor para o componente. Quando o tipo éarn, esse é o componente ARN do EC2 Image Builder. Quando o tipo éscript, esse é o https or s3 link pointing to the script to use when creating the EC2 Image Builder com ponente.

Tags

Propriedades do Tags

(Opcional) Especifica a lista de tags a serem definidas nos recursos usados para criar o. AMI

Tags:
  - Key: string
    Value: string

Key (Opcional, String)

Define o nome da tag.

Value (Opcional, String)

Define o valor da tag.

UpdateOsPackages

Propriedades do UpdateOsPackages

(Opcional) Especifica se o sistema operacional é atualizado antes da instalação AWS ParallelCluster pilha de software.

UpdateOsPackages:
  Enabled: boolean

Enabled (Opcional, Boolean)

Setrue, o sistema operacional for atualizado e reinicializado antes de instalar o AWS ParallelCluster software. O padrão é false.

nota

Quando UpdateOsPackages é ativado, todos os pacotes de sistema operacional disponíveis são atualizados, incluindo o kernel. Como cliente, você é responsável por verificar se a atualização é compatível com as AMI dependências que não estão incluídas na atualização.

Por exemplo, suponha que você esteja construindo um AMI para AWS ParallelCluster versão X.0 que vem com a versão Y.0 do kernel e a versão Z.0 de alguns componentes. Suponha que a atualização disponível inclua a versão atualizada do kernel Y.1 sem atualizações para o componente Z.0. Antes de habilitar UpdateOsPackages, é sua responsabilidade verificar se o componente Z.0 é compatível com o kernel Y.1.