As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá.
# Arquivos de configuração de imagem de compilação
AWS ParallelCluster a versão 3 usa arquivos YAML 1.1 para criar parâmetros de configuração de imagem. Confirme se o recuo está correto para reduzir os erros de configuração. Para obter mais informações, consulte a especificação do YAML 1.1 em [https://yaml.org/spec/1.1/](https://yaml.org/spec/1.1/).
Esses arquivos de configuração são usados para definir como suas AWS ParallelCluster AMIs personalizadas são criadas usando o EC2 Image Builder. Os processos personalizados de criação de AMI são acionados usando o comando [`pcluster build-image`](pcluster.build-image-v3.md). Para ver alguns exemplos de arquivos de configuração, consulte [https://github.com/aws/aws- parallelcluster/tree/release-3.0/cli/tests/pcluster/schemas/test\$1imagebuilder\$1schema/test \$1imagebuilder\$1schema](https://github.com/aws/aws-parallelcluster/tree/release-3.0/cli/tests/pcluster/schemas/test_imagebuilder_schema/test_imagebuilder_schema).
**Topics**
+ [
## Propriedades dos arquivos de configuração de imagem de compilação
](#build-image-v3.properties)
+ [
# Seção `Build`
](Build-v3.md)
+ [
# Seção `Image`
](build-Image-v3.md)
+ [
# Seção `DeploymentSettings`
](DeploymentSettings-build-image-v3.md)
## Propriedades dos arquivos de configuração de imagem de compilação
`Region` (**Opcional**, `String`)
Especifica o Região da AWS para a `build-image` operação. Por exemplo, .`us-east-2`
`CustomS3Bucket` (**Opcional**, `String`)
Especifica o nome de um bucket do Amazon S3 criado em AWS sua conta para armazenar recursos que são usados pelo processo de criação personalizado da AMI e para exportar registros. As informações usadas pela imagem estão no bucket personalizado para configuração da imagem. AWS ParallelCluster mantém um bucket do Amazon S3 em cada AWS região na qual você cria clusters. Por padrão, esses buckets do Amazon S3 são denominados `parallelcluster-hash-v1-DO-NOT-DELETE`.
# 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
Installation:
NvidiaSoftware:
Enabled: boolean
LustreClient:
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. Observe que talvez seja necessário [modificar os atributos de endereçamento IP da sua sub-rede](https://docs.aws.amazon.com/vpc/latest/userguide/subnet-public-ip.html) se a compilação falhar.
O `pcluster build-image` usa a VPC padrão. Se a VPC padrão tiver sido excluída, talvez usando AWS Control Tower nossa AWS Landing Zone, a ID da sub-rede deverá ser especificada.
Ao especificar o SubnetId, é recomendável especificar também a SecurityGroupIds propriedade. Se você deixar de SecurityGroupIds fora, AWS ParallelCluster usará grupos de segurança padrão ou confiará no comportamento padrão dentro da sub-rede especificada. Ao usar os dois, você obtém as seguintes vantagens:
+ Controle granular: ao definir explicitamente os dois, você garante que as instâncias iniciadas durante o processo de criação da imagem sejam colocadas na sub-rede correta e tenham o acesso preciso à rede de que você precisa para seus componentes de compilação e quaisquer serviços necessários (como acesso ao S3 para scripts de construção).
+ Práticas recomendadas de segurança: quando você define grupos de segurança apropriados, isso ajuda a restringir o acesso à rede somente às portas e serviços necessários, o que aumenta a segurança do seu ambiente de compilação.
+ Evitar possíveis problemas: se você confiar apenas em padrões, isso pode resultar em grupos de segurança muito abertos ou muito restritivos, o que pode causar problemas durante o processo de criação.
`ParentImage` (**Obrigatório**, `String`)
Especifica a imagem base. A imagem principal pode ser uma AWS ParallelCluster AMI não AMI ou uma AWS ParallelCluster AMI oficial para a mesma versão. Você não pode usar uma AMI AWS ParallelCluster oficial ou personalizada de uma versão diferente do AWS ParallelCluster. O formato deve ser o ARN de uma imagem `arn:Partition:imagebuilder:Region:Account:image/ImageName/ImageVersion` ou uma ID de AMI `ami-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 criação e teste (IMDS) do Amazon ImageBuilder EC2.
```
Imds:
ImdsSupport: string
```
`ImdsSupport` (**Opcional**, `String`)
Especifica quais versões do IMDS são suportadas nas instâncias de compilação e teste do Amazon ImageBuilder EC2. Os valores compatíveis são `v2.0` e `v1.0`. O valor padrão é `v2.0`.
Se `ImdsSupport` estiver definido como`v1.0`, ambos IMDSv1 IMDSv2 são suportados.
Se `ImdsSupport` estiver definido como`v2.0`, somente IMDSv2 é suportado.
Para obter mais informações, consulte [Use IMDSv2](https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/configuring-instance-metadata-service.html) no *Guia do usuário do Amazon EC2 para instâncias Linux.*
[Política de atualização: se essa configuração for alterada, a atualização não será permitida.](using-pcluster-update-cluster-v3.md#update-policy-fail-v3)
A partir da 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.
O suporte para [`Imds`](#Build-v3-Imds)/foi [`ImdsSupport`](#yaml-build-image-Build-Imds-ImdsSupport)adicionado com a AWS ParallelCluster versão 3.3.0.
### `Iam`
#### Propriedades do `Iam`
(**Opcional**) Especifica os recursos do IAM 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 para a instância do EC2 Image Builder. `InstanceProfile` e `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. `InstanceProfile` e `InstanceRole` e `AdditionalIamPolicies` não podem ser especificados juntos. O formato é `arn:Partition:iam::Account:role/RoleName`.
`CleanupLambdaRole` (**Opcional**, `String`)
O ARN da função do IAM a ser usado para a AWS Lambda função que apóia o recurso CloudFormation personalizado que remove artefatos de construção na 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 políticas adicionais do IAM a serem anexadas à instância do EC2 Image Builder usada para produzir a AMI personalizada.
```
AdditionalIamPolicies:
- Policy: string
```
`Policy` (**Opcional**, `[String]`)
Lista de políticas do IAM. O formato é `arn:Partition:iam::Account:policy/PolicyName`.
`PermissionsBoundary` (**Opcional**, `String`)
O ARN da política do IAM usado como limite de permissões para todos os perfis do IAM criados pelo AWS ParallelCluster. Para obter mais informações sobre limites de permissões do IAM, consulte [Limites de permissões para entidades do IAM](https://docs.aws.amazon.com/IAM/latest/UserGuide/access_policies_boundaries.html) no *Guia do usuário do IAM*. O formato é `arn:Partition:iam::Account:policy/PolicyName`.
### `Components`
#### Propriedades do `Components`
(**Opcional**) Especifica os componentes do Amazon ImageBuilder EC2 a serem usados durante o processo de criação da AMI, além dos fornecidos por padrão pela. AWS ParallelCluster Esses componentes podem ser usados para personalizar o processo de criação da AMI. Para obter mais informações, consulte [AWS ParallelCluster Personalização da AMI](custom-ami-v3.md).
```
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 ARN de um componente do EC2 Image Builder. Quando o tipo é`script`, esse é o https or s3 link that points to the script to use when you create the EC2 Image Builder com ponente.
### `Tags`
#### Propriedades do `Tags`
(**Opcional**) Especifica a lista de tags a serem definidas nos recursos usados para criar a 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 da pilha AWS ParallelCluster de software.
```
UpdateOsPackages:
Enabled: boolean
```
`Enabled` (**Opcional**, `Boolean`)
Se`true`, o sistema operacional for atualizado e reinicializado antes de instalar o AWS ParallelCluster software. O padrão é `false`.
Quando `UpdateOsPackages` é ativado, todos os pacotes de sistema operacional disponíveis são atualizados, incluindo o kernel. Como cliente, é sua responsabilidade verificar se a atualização é compatível com as dependências da AMI que não estão incluídas na atualização.
Por exemplo, suponha que você queira criar uma AMI para a AWS ParallelCluster versão X.0 que vem com a versão Y.0 do kernel e a versão Z.0 de algum componente. 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.
### `Installation`
#### Propriedades do `Installation`
**(Opcional)** Especifica o software adicional a ser instalado na imagem.
```
Installation:
NvidiaSoftware:
Enabled: boolean
LustreClient:
Enabled: boolean
```
`NvidiaSoftware`propriedades (**opcional**)
Especifica o software Nvidia a ser instalado.
```
NvidiaSoftware:
Enabled: boolean
```
`Enabled` (**Opcional**, `boolean`)
Se`true`, o driver da GPU Nvidia e o CUDA serão instalados. O padrão é `false`.
`LustreClient`propriedades (**opcional**)
Especifica que o cliente Amazon FSx Lustre será instalado.
```
LustreClient:
Enabled: boolean
```
`Enabled` (**Opcional**, `boolean`)
Se`true`, o cliente Lustre será instalado. O padrão é `true`.
# Seção `Image`
**(Opcional)** Define as propriedades da imagem para a criação da imagem.
```
Image:
Name: string
RootVolume:
Size: integer
Encrypted: boolean
KmsKeyId: string
Tags:
- Key: string
Value: string
```
## Propriedades do `Image`
`Name` (**Opcional**, `String`)
Especifica o nome da AMI. Se não for especificado, o nome usado ao chamar o comando [`pcluster build-image`](pcluster.build-image-v3.md) será usado.
### `Tags`
#### Propriedades do `Tags`
(**Opcional**) Especifica pares de chave-valor para a imagem.
```
Tags:
- Key: string
Value: string
```
`Key` (**Opcional**, `String`)
Define o nome da tag.
`Value` (**Opcional**, `String`)
Define o valor da tag.
### `RootVolume`
#### Propriedades do `RootVolume`
(**Opcional**) Especifica as propriedades do volume raiz da imagem.
```
RootVolume:
Size: integer
Encrypted: boolean
KmsKeyId: string
```
`Size` (**Opcional**, `Integer`)
Especifica o tamanho do volume raiz da imagem em GiB. O tamanho padrão é o tamanho de [`ParentImage`](Build-v3.md#yaml-build-image-Build-ParentImage) mais 27 GiB.
`Encrypted` (**Opcional**, `Boolean`)
Especifica se o volume está criptografado. O valor padrão é `false`.
`KmsKeyId` (**Opcional**, `String`)
Especifica o ARN da chave usada para criptografar AWS KMS o volume. O formato é "`arn:Partition:kms:Region:Account:key/KeyId`.
# Seção `DeploymentSettings`
**nota**
`DeploymentSettings`é adicionado a partir da AWS ParallelCluster versão 3.4.0.
**(Opcional)** Especifica a configuração das definições de implantação.
```
DeploymentSettings:
LambdaFunctionsVpcConfig:
SecurityGroupIds:
- string
SubnetIds:
- string
```
## Propriedades do `DeploymentSettings`
### `LambdaFunctionsVpcConfig`
**(Opcional)** Especifica as configurações de VPC AWS Lambda das funções. Para obter mais informações, consulte [AWS Lambda Configuração de VPC em AWS ParallelCluster](lambda-vpc-v3.md).
```
LambdaFunctionsVpcConfig:
SecurityGroupIds:
- string
SubnetIds:
- string
```
#### `LambdaFunctionsVpcConfig properties`
`SecurityGroupIds` (**Obrigatório**, `[String]`)
A lista dos grupos de segurança da Amazon VPC IDs que estão anexados às funções do Lambda.
[Política de atualização: se essa configuração for alterada, a atualização não será permitida.](using-pcluster-update-cluster-v3.md#update-policy-fail-v3)
`SubnetIds` (**Obrigatório**, `[String]`)
A lista de sub-redes IDs anexadas às funções do Lambda.
[Política de atualização: se essa configuração for alterada, a atualização não será permitida.](using-pcluster-update-cluster-v3.md#update-policy-fail-v3)
**nota**
Os sub-redes e grupos de segurança devem estar na mesma VPC.