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á.

# `pcluster build-image`
<a name="pcluster.build-image-v3"></a>

Crie uma AWS ParallelCluster imagem personalizada na região especificada.

```
pcluster build-image [-h]
                 --image-configuration IMAGE_CONFIGURATION 
                 --image-id IMAGE_ID
                [--debug]
                [--dryrun DRYRUN]
                [--query QUERY]
                [--region REGION]
                [--rollback-on-failure ROLLBACK_ON_FAILURE]
                [--suppress-validators SUPPRESS_VALIDATORS [SUPPRESS_VALIDATORS ...]]
                [--validation-failure-level {INFO,WARNING,ERROR}]
```

## Argumentos nomeados
<a name="pcluster-v3.build-image.namedargs"></a>

**-h, --help**  
Mostra o texto de ajuda para `pcluster build-image`.

**--image-configuration, -c *IMAGE\$1CONFIGURATION***  
Especifica o arquivo de configuração da imagem como um documento YAML.

**--image-id, -i *IMAGE\$1ID***  
Especifica o id da imagem que será criada.

**--debug**  
Ative o registro da depuração.

**--dryrun *DRYRUN***  
Quando `true`, o comando executa a validação sem criar recursos. Use esse parâmetro para validar a configuração da imagem. (Padronizado como `false`).

**--query *QUERY***  
JMESPath consulta a ser executada na saída.

**--region, -r *REGION***  
Especifica o a Região da AWS ser usado. O Região da AWS deve ser especificado usando a configuração [Região](image-builder-configuration-file-v3.md#yaml-build-image-Region) no arquivo de configuração da imagem, a variável de `AWS_DEFAULT_REGION` ambiente, a `region` configuração na `[default]` seção do `~/.aws/config` arquivo ou o `--region` parâmetro.

**--rollback-on-failure *ROLLBACK\$1ON\$1FAILURE***  
Se definido como `true`, inicia automaticamente uma reversão da pilha de imagens em caso de falhas. (Padronizado como `false`.)

**--suppress-validators * SUPPRESS\$1VALIDATORS* [*SUPPRESS\$1VALIDATORS ...*]**  
Identifica um ou mais validadores de configuração a serem suprimidos.  
Formato: (`ALL`\$1`type:[A-Za-z0-9]+`)

**--validation-failure-level \$1`INFO`,`WARNING`,`ERROR`\$1**  
O nível mínimo de validação que faz com que a criação de imagem falhe. (Padronizado como `ERROR`.)

**Exemplo usando a AWS ParallelCluster versão 3.1.2:**

```
$ pcluster build-image --image-configuration image-config.yaml --image-id custom-alinux2-image
{
  "image": {
    "imageId": "custom-alinux2-image",
    "imageBuildStatus": "BUILD_IN_PROGRESS",
    "cloudformationStackStatus": "CREATE_IN_PROGRESS",
    "cloudformationStackArn": "arn:aws:cloudformation:us-east-1:123456789012:stack/custom-alinux2-image/1234abcd-56ef-78gh-90ij-abcd1234efgh",
    "region": "us-east-1",
    "version": "3.1.2"
  }
}
```

**Atenção**  
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 no arquivo de configuração da imagem. Para obter mais informações, consulte [SubnetId](HeadNode-v3.md#yaml-HeadNode-Networking-SubnetId).