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á.
# AWS ParallelCluster Comandos CLI
`pcluster`é o comando principal da AWS ParallelCluster CLI. Você usa `pcluster` para iniciar e gerenciar clusters de HPC no Nuvem AWS e para criar e gerenciar imagens de AMI personalizadas.
`pcluster3-config-converter`é usado para converter configurações de cluster no formato da AWS ParallelCluster versão 2 para o formato da AWS ParallelCluster versão 3.
```
pcluster [-h] ( build-image | configure |
create-cluster | dcv-connect |
delete-cluster | delete-cluster-instances | delete-image |
describe-cluster | describe-cluster-instances |
describe-compute-fleet | describe-image |
export-cluster-logs | export-image-logs |
get-cluster-log-events | get-cluster-stack-events |
get-image-log-events | get-image-stack-events |
list-cluster-log-streams | list-clusters |
list-images | list-image-log-streams | list-official-images |
ssh | update-cluster |
update-compute-fleet | version ) ...
pcluster3-config-converter [-h] [-t CLUSTER_TEMPLATE]
[-c CONFIG_FILE]
[--force-convert]
[-o OUTPUT_FILE]
```
**Topics**
+ [`pcluster`](pcluster-v3.md)
+ [`pcluster3-config-converter`](pcluster3-config-converter.md)
# `pcluster`
`pcluster`é o comando principal da AWS ParallelCluster CLI. Use a `pcluster` para executar e gerenciar clusters HPC na Nuvem AWS.
O `pcluster` grava logs de seus comandos em arquivos `pcluster.log.#` em `/home/user/.parallelcluster/`. Para obter mais informações, consulte [Logs da CLI `pcluster`](troubleshooting-v3-pc-cli-logs.md).
Para usar o `pcluster`, você tem um perfil do IAM com as [permissões](iam-roles-in-parallelcluster-v3.md#iam-roles-in-parallelcluster-v3-example-user-policies) necessárias para executar.
```
pcluster [-h]
```
## Argumentos
**`pcluster command`**
Opções possíveis: [`build-image`](pcluster.build-image-v3.md)\$1 [`configure`](pcluster.configure-v3.md)\$1 [`create-cluster`](pcluster.create-cluster-v3.md)\$1 [`dcv-connect`](pcluster.dcv-connect-v3.md)\$1 [`delete-cluster`](pcluster.delete-cluster-v3.md)\$1 [`delete-cluster-instances`](pcluster.delete-cluster-instances-v3.md)\$1 [`delete-image`](pcluster.delete-image-v3.md)\$1 [`describe-cluster`](pcluster.describe-cluster-v3.md)\$1 [`describe-cluster-instances`](pcluster.describe-cluster-instances-v3.md)\$1 [`describe-compute-fleet`](pcluster.describe-compute-fleet-v3.md)\$1 [`describe-image`](pcluster.describe-image-v3.md)\$1 [`export-cluster-logs`](pcluster.export-cluster-logs-v3.md)\$1 [`export-image-logs`](pcluster.export-image-logs-v3.md)\$1 [`get-cluster-log-events`](pcluster.get-cluster-log-events-v3.md)\$1 [`get-cluster-stack-events`](pcluster.get-cluster-stack-events-v3.md)\$1 [`get-image-log-events`](pcluster.get-image-log-events-v3.md)\$1 [`get-image-stack-events`](pcluster.get-image-stack-events-v3.md)\$1 [`list-clusters`](pcluster.list-clusters-v3.md)\$1 [`list-cluster-log-streams`](pcluster.list-cluster-log-streams-v3.md)\$1 [`list-images`](pcluster.list-images-v3.md)\$1 [`list-image-log-streams`[`list-official-images`](pcluster.list-official-images-v3.md)](pcluster.list-image-log-streams-v3.md)\$1 [`ssh`](pcluster.ssh-v3.md)\$1 [`update-cluster`](pcluster.update-cluster-v3.md)\$1 [`update-compute-fleet`](pcluster.update-compute-fleet-v3.md)\$1 [`version`](pcluster.version-v3.md)
**Subcomandos:**
**Topics**
+ [Argumentos](#pcluster.arguments-v3)
+ [`pcluster build-image`](pcluster.build-image-v3.md)
+ [`pcluster configure`](pcluster.configure-v3.md)
+ [`pcluster create-cluster`](pcluster.create-cluster-v3.md)
+ [`pcluster dcv-connect`](pcluster.dcv-connect-v3.md)
+ [`pcluster delete-cluster`](pcluster.delete-cluster-v3.md)
+ [`pcluster delete-cluster-instances`](pcluster.delete-cluster-instances-v3.md)
+ [`pcluster delete-image`](pcluster.delete-image-v3.md)
+ [`pcluster describe-cluster`](pcluster.describe-cluster-v3.md)
+ [`pcluster describe-cluster-instances`](pcluster.describe-cluster-instances-v3.md)
+ [`pcluster describe-compute-fleet`](pcluster.describe-compute-fleet-v3.md)
+ [`pcluster describe-image`](pcluster.describe-image-v3.md)
+ [`pcluster export-cluster-logs`](pcluster.export-cluster-logs-v3.md)
+ [`pcluster export-image-logs`](pcluster.export-image-logs-v3.md)
+ [`pcluster get-cluster-log-events`](pcluster.get-cluster-log-events-v3.md)
+ [`pcluster get-cluster-stack-events`](pcluster.get-cluster-stack-events-v3.md)
+ [`pcluster get-image-log-events`](pcluster.get-image-log-events-v3.md)
+ [`pcluster get-image-stack-events`](pcluster.get-image-stack-events-v3.md)
+ [`pcluster list-clusters`](pcluster.list-clusters-v3.md)
+ [`pcluster list-cluster-log-streams`](pcluster.list-cluster-log-streams-v3.md)
+ [`pcluster list-images`](pcluster.list-images-v3.md)
+ [`pcluster list-image-log-streams`](pcluster.list-image-log-streams-v3.md)
+ [`pcluster list-official-images`](pcluster.list-official-images-v3.md)
+ [`pcluster ssh`](pcluster.ssh-v3.md)
+ [`pcluster update-cluster`](pcluster.update-cluster-v3.md)
+ [`pcluster update-compute-fleet`](pcluster.update-compute-fleet-v3.md)
+ [`pcluster version`](pcluster.version-v3.md)
# `pcluster build-image`
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
**-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).
# `pcluster configure`
Inicia um assistente de configuração interativo para a AWS ParallelCluster versão 3. Para obter mais informações, consulte [Configure e crie um cluster com a interface de linha de AWS ParallelCluster comando](install-v3-configuring.md).
```
pcluster configure [-h]
--config CONFIG
[--debug]
[--region REGION]
```
## Argumentos nomeados
**-h, --help**
Mostra o texto de ajuda para `pcluster configure`.
**--config *CONFIG***
Caminho de saída do arquivo de configuração gerado.
**--debug**
Ative o registro da depuração.
**--region, -r *REGION***
Especifica o a Região da AWS ser usado. A Região deve ser especificada 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 ambiente `AWS_DEFAULT_REGION`, a configuração `region` na seção `[default]` do arquivo `~/.aws/config` ou o parâmetro `--region`.
# `pcluster create-cluster`
Cria um AWS ParallelCluster cluster.
```
pcluster create-cluster [-h]
--cluster-configuration CLUSTER_CONFIGURATION
--cluster-name CLUSTER_NAME
[--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
**-h, --help**
Mostra o texto de ajuda para `pcluster create-cluster`.
**--cluster-configuration, -c *CLUSTER\$1CONFIGURATION***
Especifica o arquivo de configuração do cluster YAML.
**--cluster-name, -n *CLUSTER\$1NAME***
O nome do novo cluster a ser criado.
O nome deve iniciar com um caractere alfabético. O nome do pode ter até 60 caracteres. Se a contabilidade do Slurm estiver ativada, o nome poderá ter até 40 caracteres.
Caracteres válidos: a-z, A-Z, 0-9 e - (hífen).
**--debug**
Habilita o log de depuração.
**--dryrun *DRYRUN***
Quando `true`, o comando executa a validação sem criar recursos. Você pode usar isso para validar a configuração do cluster. (Padronizado como `false`.)
**--query *QUERY***
Especifica a 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 [`Region`](cluster-configuration-file-v3.md#yaml-Region)configuração no arquivo de configuração do cluster, 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 cluster em caso de falhas. (Padronizado como `true`.)
**--suppress-validators *SUPPRESS\$1VALIDATORS* [*SUPPRESS\$1VALIDATORS* ...]**
Identifica um ou mais validadores de configuração a serem suprimidos.
Formato: (`ALL`\$1typo:`[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.4:**
```
$ pcluster create-cluster -c cluster-config.yaml -n cluster-v3
{
"cluster": {
"clusterName": "cluster-v3",
"cloudformationStackStatus": "CREATE_IN_PROGRESS",
"cloudformationStackArn": "arn:aws:cloudformation:us-east-1:123456789012:stack/cluster-v3/1234abcd-56ef-78gh-90ij-abcd1234efgh",
"region": "us-east-1",
"version": "3.1.4",
"clusterStatus": "CREATE_IN_PROGRESS"
}
}
```
# `pcluster dcv-connect`
Permite conectar-se ao nó principal por meio de uma sessão interativa usando o Amazon DCV.
```
pcluster dcv-connect [-h]
--cluster-name CLUSTER_NAME
[--debug]
[--key-path KEY_PATH]
[--login-node-ip LOGIN_NODE_IP]
[--region REGION]
[--show-url]
```
## Argumentos nomeados
**-h, --help**
Mostra o texto de ajuda para `pcluster dcv-connect`.
**--cluster-name, -n *CLUSTER\$1NAME***
Especifica o nome do cluster.
**--debug**
Habilita o log de depuração.
**--key-path *KEY\$1PATH***
Especifica o caminho da chave SSH a ser usada para a conexão.
**--login-node-ip**
Especifica o endereço IP público ou privado de um nó de login no cluster. O uso desse argumento permite a conexão com um nó de login no cluster com DCV habilitado.
Esse argumento foi adicionado na AWS ParallelCluster versão 3.11.0.
**--region, -r *REGION***
Especifica o a Região da AWS ser usado. O Região da AWS deve ser especificado usando 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.
**--show-url**
Imprime o URL que seria usado para a conexão DCV e sai.
**Exemplo usando a AWS ParallelCluster versão 3.11**
```
$ pcluster dcv-connect -n cluster-3Dcv --login-node-ip 198.51.100.44 -r us-east-1 --key-path /home/user/.ssh/key.pem
```
![\[A screenshot of the DCV console.\]](http://docs.aws.amazon.com/pt_br/parallelcluster/latest/ug/images/Dcv-image.png)
# `pcluster delete-cluster`
Inicia a exclusão de um cluster.
```
pcluster delete-cluster [-h]
--cluster-name CLUSTER_NAME
[--debug]
[--query QUERY]
[--region REGION]
```
## Argumentos nomeados
**-h, --help**
Mostra o texto de ajuda para `pcluster delete-cluster`.
**--cluster-name, -n *CLUSTER\$1NAME***
Especifica o nome do cluster.
**--debug**
Habilita o log de depuração.
**--query *QUERY***
Especifica a JMESPath consulta a ser executada na saída.
**--region, -r *REGION***
Especifica o a Região da AWS ser usado. A região deve ser especificada usando a variável de ambiente `AWS_DEFAULT_REGION`, a configuração `region` na seção `[default]` do arquivo `~/.aws/config` ou o parâmetro `--region`.
**Exemplo usando a AWS ParallelCluster versão 3.1.4:**
```
$ pcluster delete-cluster -n cluster-v3
{
"cluster": {
"clusterName": "cluster-v3",
"cloudformationStackStatus": "DELETE_IN_PROGRESS",
"cloudformationStackArn": "arn:aws:cloudformation:us-east-1:123456789012:stack/cluster-v3/1234abcd-56ef-78gh-90ij-abcd1234efgh",
"region": "us-east-1",
"version": "3.1.4",
"clusterStatus": "DELETE_IN_PROGRESS"
}
}
```
# `pcluster delete-cluster-instances`
Inicia o encerramento forçado de todos os nós de computação do cluster. Isso não funciona com AWS Batch clusters.
```
pcluster delete-cluster-instances [-h]
--cluster-name CLUSTER_NAME
[--debug]
[--force FORCE]
[--query QUERY]
[--region REGION]
```
## Argumentos nomeados
**-h, --help**
Mostra o texto de ajuda para `pcluster delete-cluster-instances`.
**--cluster-name, -n *CLUSTER\$1NAME***
Especifica o nome do cluster.
**--debug**
Habilita o log de depuração.
**--force *FORCE***
Quando `true`, força a exclusão ignorando os erros de validação. (Padronizado como `false`.)
**--query *QUERY***
Especifica a 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 variável de `AWS_DEFAULT_REGION` ambiente, a `region` configuração na `[default]` seção do `~/.aws/config` arquivo ou o `--region` parâmetro.
```
$ pcluster delete-cluster-instances -n cluster-v3
```
# `pcluster delete-image`
Inicia a exclusão da AWS ParallelCluster imagem personalizada.
```
pcluster delete-image [-h]
--image-id IMAGE_ID
[--debug]
[--force FORCE]
[--query QUERY]
[--region REGION]
```
## Argumentos nomeados
**-h, --help**
Mostra o texto de ajuda para `pcluster delete-image`.
**--image-id, -i *IMAGE\$1ID***
Especifica o id da imagem que será excluída.
**--debug**
Habilita o log de depuração.
**--force *FORCE***
Quando `true`, força a exclusão caso haja instâncias usando a AMI ou se a AMI for compartilhada. (Padronizado como `false`.)
**--query *QUERY***
Especifica a 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 variável de `AWS_DEFAULT_REGION` ambiente, a `region` configuração na `[default]` seção do `~/.aws/config` arquivo ou o `--region` parâmetro.
**Exemplo usando a AWS ParallelCluster versão 3.1.4:**
```
$ pcluster delete-image --image-id custom-alinux2-image
{
"image": {
"imageId": "custom-alinux2-image",
"imageBuildStatus": "DELETE_IN_PROGRESS",
"region": "us-east-1",
"version": "3.1.4"
}
}
```
# `pcluster describe-cluster`
Obter informações detalhadas sobre um cluster.
```
pcluster describe-cluster [-h]
--cluster-name CLUSTER_NAME
[--debug]
[--query QUERY]
[--region REGION]
```
## Argumentos nomeados
**-h, --help**
Mostra o texto de ajuda para `pcluster describe-cluster`.
**--cluster-name, -n *CLUSTER\$1NAME***
Especifica o nome do cluster.
**--debug**
Habilita o log de depuração.
**--query *QUERY***
Especifica a 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 variável de `AWS_DEFAULT_REGION` ambiente, a `region` configuração na `[default]` seção do `~/.aws/config` arquivo ou o `--region` parâmetro.
**Exemplos usando a AWS ParallelCluster versão 3.1.4:**
Descrever os detalhes do cluster:
```
$ pcluster describe-cluster -n cluster-v3
{
"creationTime": "2022-07-12T17:19:16.101Z",
"headNode": {
"launchTime": "2022-07-12T17:22:21.000Z",
"instanceId": "i-1234567890abcdef0",
"publicIpAddress": "198.51.100.44",
"instanceType": "t2.micro",
"state": "running",
"privateIpAddress": "192.0.2.0.196"
},
"loginNodes": [
{
"status": "active",
"poolName": "pool1",
"address": "cluster-v3-eMr9BYRKZVDa-e5bb34f40b24f51d.elb.us-east-1.amazonaws.com",
"scheme": "internet-facing",
"healthyNodes": 1,
"unhealthyNodes": 0
},
{
"status": "active",
"poolName": "pool2",
"address": "cluster-v3-PaQ7GgC27sic-aba10c890247b36b.elb.us-east-1.amazonaws.com",
"scheme": "internet-facing",
"healthyNodes": 1,
"unhealthyNodes": 0
}
],
"version": "3.1.4",
"clusterConfiguration": {
"url": "https://parallelcluster-e5ca74255d6c3886-v1-do-not-delete..."
},
"tags": [
{
"value": "3.11",
"key": "parallelcluster:version"
}
],
"cloudFormationStackStatus": "CREATE_COMPLETE",
"clusterName": "cluster-v3",
"computeFleetStatus": "RUNNING",
"cloudformationStackArn": "arn:aws:cloudformation:us-east-1:123456789012:stack/cluster-v3/1234abcd-56ef-78gh-90ij-abcd1234efgh",
"lastUpdatedTime": "2022-07-12T17:19:16.101Z",
"region": "us-east-1",
"clusterStatus": "CREATE_COMPLETE"
}
```
Use `describe-cluster` para recuperar a configuração do cluster:
```
$ curl -o - $(pcluster describe-cluster -n cluster-v3 --query clusterConfiguration.url | xargs echo)
Region: us-east-1
Image:
Os: alinux2
HeadNode:
InstanceType: t2.micro
Networking:
SubnetId: subnet-abcdef01234567890
Ssh:
KeyName: adpc
Iam:
S3Access:
- BucketName: cluster-v3-bucket
KeyName: logs
EnableWriteAccess: true
Scheduling:
Scheduler: slurm
SlurmQueues:
- Name: queue1
ComputeResources:
- Name: t2micro
InstanceType: t2.micro
MinCount: 0
MaxCount: 10
Networking:
SubnetIds:
- subnet-021345abcdef6789
```
# `pcluster describe-cluster-instances`
Descreve as instâncias em um cluster.
```
pcluster describe-cluster-instances [-h]
--cluster-name CLUSTER_NAME
[--debug]
[--next-token NEXT_TOKEN]
[--node-type {HeadNode,ComputeNode,LoginNode}]
[--query QUERY]
[--queue-name QUEUE_NAME]
[--region REGION]
```
## Argumentos nomeados
**-h, --help**
Mostra o texto de ajuda para `pcluster describe-cluster-instances`.
**--cluster-name, -n *CLUSTER\$1NAME***
Especifica o nome do cluster.
**--debug**
Habilita o log de depuração.
**--next-token *NEXT\$1TOKEN***
O token para o próximo conjunto de resultados.
**--node-type \$1`HeadNode`,`ComputeNode`,`LoginNode`\$1**
Especifica os tipos de nós a serem listados. Os valores com suporte `HeadNode`, `ComputeNode` e `LoginNode`. Se esse parâmetro não for especificado, as instâncias `HeadNode`, `ComputeNode` e `LoginNode` serão descritas.
**--query *QUERY***
Especifica a JMESPath consulta a ser executada na saída.
**--queue-name *QUEUE\$1NAME***
Especifica o nome da fila a ser definido. Se esse parâmetro não for especificado, as instâncias em todas as filas serão descritas.
**--region, -r *REGION***
Especifica o a Região da AWS ser usado. O Região da AWS deve ser especificado usando 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.
**Exemplo usando a AWS ParallelCluster versão 3.1.4:**
```
$ pcluster describe-cluster-instances -n cluster-v3
{
"instances": [
{
"launchTime": "2022-07-12T17:22:21.000Z",
"instanceId": "i-1234567890abcdef0",
"publicIpAddress": "198.51.100.44",
"instanceType": "t2.micro",
"state": "running",
"nodeType": "HeadNode",
"privateIpAddress": "192.0.2.0.196"
},
{
"launchTime": "2022-07-12T17:37:42.000Z",
"instanceId": "i-021345abcdef6789",
"queueName": "queue1",
"publicIpAddress": "198.51.100.44",
"instanceType": "t2.micro",
"state": "pending",
"nodeType": "ComputeNode",
"privateIpAddress": "192.0.2.0.196"
},
{
"launchTime": "2022-07-12T17:37:42.000Z",
"instanceId": "i-021345abcdef6789",
"poolName": "pool1",
"publicIpAddress": "198.51.100.44",
"instanceType": "t2.micro",
"state": "pending",
"nodeType": "loginNode",
"privateIpAddress": "192.0.2.0.196"
}
]
}
```
# `pcluster describe-compute-fleet`
Descreve o status da frota de computação.
```
pcluster describe-compute-fleet [-h]
--cluster-name CLUSTER_NAME
[--debug]
[--query QUERY]
[--region REGION]
```
## Argumentos nomeados
**-h, --help**
Mostra o texto de ajuda para `pcluster describe-compute-fleet`.
**--cluster-name, -n *CLUSTER\$1NAME***
Especifica o nome do cluster.
**--debug**
Habilita o log de depuração.
**--query *QUERY***
Especifica a 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 variável de `AWS_DEFAULT_REGION` ambiente, a `region` configuração na `[default]` seção do `~/.aws/config` arquivo ou o `--region` parâmetro.
**Exemplo usando a AWS ParallelCluster versão 3.1.4:**
```
$ pcluster describe-compute-fleet -n pcluster-v3
{
"status": "RUNNING",
"lastStatusUpdatedTime": "2022-07-12T17:24:26.000Z"
}
```
# `pcluster describe-image`
Obtém informações detalhadas sobre uma imagem.
```
pcluster describe-image [-h]
--image-id IMAGE_ID
[--debug]
[--query QUERY]
[--region REGION]
```
## Argumentos nomeados
**-h, --help**
Mostra o texto de ajuda para `pcluster describe-image`.
**--image-id, -i *IMAGE\$1ID***
Especifica o ID da imagem.
**--debug**
Habilita o log de depuração.
**--query *QUERY***
Especifica a 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 variável de `AWS_DEFAULT_REGION` ambiente, a `region` configuração na `[default]` seção do `~/.aws/config` arquivo ou o `--region` parâmetro.
**Exemplo usando a AWS ParallelCluster versão 3.1.2:**
```
$ pcluster describe-image --image-id custom-alinux2-image
{
"imageConfiguration: {
"url": "https://parallelcluster-1234abcd5678-v1-do-not-delete.../configs/image-config.yaml"
},
"imageId": "custom-alinux2-image",
"creationTime": "2022-04-05T20:23:07.000Z"
"imageBuildStatus": "BUILD_COMPLETE",
"region": "us-east-1",
"ec2AmiInfo": {
"amiName": "custom-alinux2-image 2022-04-05T19-55-22.518Z",
"amiId": "ami-1234abcd5678efgh",
"description": "AWS ParallelCluster AMI for alinux2, kernel-4.14.268-205.500.amzn2.x86_64, lustre-2.10.8-5.amzn2.x86_64, efa-1.14.2-1.amzn2.x86_64, dcv-2021.3.11591-1.el7.x86_64, slurm-21-08-6-1",
"state": "AVAILABLE",
"tags": [
{
"value": "arn:aws:imagebuilder:us-east-1:123456789012:image/parallelclusterimage-custom-alinux2-image/3.1.2/1",
"key": "Ec2ImageBuilderArn"
},
{
"value": "parallelcluster-1234abcd5678efgh-v1-do-not-delete",
"key": "parallelcluster:amzn-s3-demo-bucket"
},
{
"value": "custom-alinux2-image",
"key": "parallelcluster:image_name"
},
{
"value": "available",
"key": "parallelcluster:build_status"
},
{
"value": "s3://amzn-s3-demo-bucket/parallelcluster/3.1.2/images/custom-alinux2-image-1234abcd5678efgh/configs/image-config.yaml",
"key": "parallelcluster:build_config"
},
{
"value": "Amazon EC2 Image Builder",
"key": "CreatedBy"
},
{
"value": "arn:aws:logs:us-east-1:123456789012:log-group:/aws/imagebuilder/ParallelClusterImage-custom-alinux2-image",
"key": "parallelcluster:build_log"
},
{
"value": "4.14.268-205.500.amzn2.x86_64",
"key": "parallelcluster:kernel_version"
},
{
"value": "arn:aws:imagebuilder:us-east-1:444455556666:image/amazon-linux-2-x86/2022.3.16/1",
"key": "parallelcluster:parent_image"
},
{
"value": "3.1.2",
"key": "parallelcluster:version"
},
{
"value": "0.5.14",
"key": "parallelcluster:munge_version"
},
{
"value": "21-08-6-1",
"key": "parallelcluster:slurm_version"
},
{
"value": "2021.3.11591-1.el7.x86_64",
"key": "parallelcluster:dcv_version"
},
{
"value": "alinux2-image",
"key": "parallelcluster:image_id"
},
{
"value": "3.2.3",
"key": "parallelcluster:pmix_version"
},
{
"value": "parallelcluster/3.15.0/images/alinux2-image-abcd1234efgh56781234",
"key": "parallelcluster:s3_image_dir"
},
{
"value": "1.14.2-1.amzn2.x86_64",
"key": "parallelcluster:efa_version"
},
{
"value": "alinux2",
"key": "parallelcluster:os"
},
{
"value": "aws-parallelcluster-cookbook-3.1.2",
"key": "parallelcluster:bootstrap_file"
},
{
"value": "1.8.23-10.amzn2.1.x86_64",
"key": "parallelcluster:sudo_version"
},
{
"value": "2.10.8-5.amzn2.x86_64",
"key": "parallelcluster:lustre_version"
}
],
"architecture": "x86_64"
},
"version": "3.1.2"
}
```
# `pcluster export-cluster-logs`
Exporta os logs do cluster para um arquivamento local `tar.gz` passando por um bucket do Amazon S3.
```
pcluster export-cluster-logs [-h]
--cluster-name CLUSTER_NAME
[--bucket BUCKET_NAME]
[--bucket-prefix BUCKET_PREFIX]
[--debug]
[--end-time END_TIME]
[--filters FILTER [FILTER ...]]
[--keep-s3-objects KEEP_S3_OBJECTS]
[--output-file OUTPUT_FILE]
[--region REGION]
[--start-time START_TIME]
```
**nota**
O `export-cluster-logs` comando espera que o CloudWatch Logs conclua a exportação dos registros, portanto, espera-se que ele passe um período sem nenhuma saída.
## Argumentos nomeados
**-h, --help**
Mostra o texto de ajuda para `pcluster export-cluster-logs`.
**--bucket *BUCKET\$1NAME***
Especifica o nome do bucket do Amazon S3 para o qual exportar dados de logs de cluster. Deve estar na mesma região do cluster.
+ Você deve adicionar permissões à política de bucket do Amazon S3 para conceder CloudWatch acesso. Para obter mais informações, consulte [Definir permissões em um bucket do Amazon S3 no Guia](https://docs.aws.amazon.com/AmazonCloudWatch/latest/logs/S3ExportTasks.html#S3Permissions) do *usuário de CloudWatch registros*.
+ **A partir da AWS ParallelCluster versão **3.12.0**, a `--bucket` opção é opcional.** Se a opção não for especificada, o bucket padrão AWS ParallelCluster regional (`parallelcluster-hash-v1-DO-NOT-DELETE`) será usado ou, se o bucket do Amazon S3 apontado por `CustomS3Bucket` estiver especificado na configuração do cluster, ele será usado. Se você não especificar a `--bucket` opção e usar o AWS ParallelCluster bucket padrão, não poderá exportar registros para a `parallelcluster/` pasta, pois ela é uma pasta protegida reservada para uso interno.
Se o bucket AWS ParallelCluster padrão for usado, o pcluster se encarregará de configurar a política do bucket. Se você personalizou a política do bucket e depois atualizou para a AWS ParallelCluster versão **3.12.0**, a política do bucket será substituída e você precisará reaplicar suas alterações.
**--cluster-name, -n *CLUSTER\$1NAME***
Especifica o nome do cluster.
**--bucket-prefix *BUCKET\$1PREFIX***
Especifica o caminho no bucket do Amazon S3 para o qual os dados de log exportados devem ser armazenados.
Por padrão, o prefixo do bucket é:
```
cluster-name-logs-202209061743.tar.gz
```
`202209061743`é um exemplo da hora em `%Y%m%d%H%M` formato.
A partir da AWS ParallelCluster versão **3.12.0**, se você não especificar a `--bucket` opção e usar o AWS ParallelCluster bucket padrão, não poderá exportar registros para a `parallelcluster/` pasta, pois é uma pasta protegida reservada para uso interno.
**--debug**
Habilita o log de depuração.
**--end-time *END\$1TIME***
Especifica o final do intervalo de tempo para coletar eventos de log, expresso no formato ISO 8601 (`YYYY-MM-DDThh:mm:ssZ`, por exemplo `2021-01-01T20:00:00Z`'). Eventos com uma marca de data/hora igual ou posterior a esse horário não estão incluídos. Elementos de tempo (por exemplo, minutos e segundos) podem ser omitidos. O valor padrão é o horário atual.
**--filters *FILTER* [*FILTER* ...]**
Especifica filtros para o log. Formato: `Name=a,Values=1 Name=b,Values=2,3`. Filtros compatíveis para:
`private-dns-name`
Especifica a forma abreviada do nome DNS privado da instância (por exemplo, `ip-10-0-0-101`).
`node-type`
Especifica o tipo de nó, o único valor aceito para esse filtro é `HeadNode`.
**--keep-s3-objects *KEEP\$1S3\$1OBJECTS***
Se for `true`, as exportações de objetos exportados para o Amazon S3 serão mantidas. (Padronizado como `false`.)
**--output-file *OUTPUT\$1FILE***
Especifica o caminho do arquivo onde será salvo o arquivamento de log. Se isso for fornecido, os logs serão salvos localmente. Caso contrário, eles serão enviados para o Amazon S3 com o URL retornado na saída. O padrão é fazer upload para o Amazon S3.
**--region, -r *REGION***
Especifica o a Região da AWS ser usado. O Região da AWS deve ser especificado usando 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.
**--start-time *START\$1TIME***
Especifica o início do intervalo de tempo, expresso no formato ISO 8601 (`YYYY-MM-DDThh:mm:ssZ`, por exemplo `2021-01-01T20:00:00Z`). Eventos de log com uma marca de data/hora igual ou posterior a esse horário estão incluídos. Se não for especificado, o padrão é a hora em que o cluster foi criado.
**Exemplo usando a AWS ParallelCluster versão 3.1.4:**
```
$ pcluster export-cluster-logs --bucket cluster-v3-bucket -n cluster-v3
{
"url": "https://cluster-v3-bucket..."
}
```
## Não é possível recuperar os registros?
Se você não conseguir recuperar os registros usando o `export-cluster-logs` comando, faça o seguinte:
+ Recupere os registros manualmente do grupo de CloudWatch registros do cluster.
+ Se o grupo de registros estiver vazio, faça o SSH nos nós do cluster e recupere os registros listados em. [Solução de problemas de inicialização do nó](troubleshooting-v3-scaling-issues.md#troubleshooting-v3-node-init)
+ Se os nós do cluster não estiverem acessíveis porque o cluster falhou na criação, recrie o cluster com a opção `--rollback-on-failure false` e recupere os registros dos nós.
# `pcluster export-image-logs`
Exporta os logs da pilha do construtor de imagens para um arquivo `tar.gz` local passando por um bucket do Amazon S3.
```
pcluster export-image-logs [-h]
--image-id IMAGE_ID
[--bucket BUCKET]
[--bucket-prefix BUCKET_PREFIX]
[--debug]
[--end-time END_TIME]
[--keep-s3-objects KEEP_S3_OBJECTS]
[--output-file OUTPUT_FILE]
[--region REGION]
[--start-time START_TIME]
```
**nota**
O `export-image-logs` comando espera que o CloudWatch Logs conclua a exportação dos registros, portanto, espera-se que ele passe um período sem nenhuma saída.
## Argumentos nomeados
**-h, --help**
Mostra o texto de ajuda para `pcluster export-image-logs`.
**--bucket *BUCKET\$1NAME***
Especifica o nome do bucket do Amazon S3 para o qual exportar logs criação de imagem. Deve estar na mesma região da imagem.
+ Você deve adicionar permissões à política de bucket do Amazon S3 para conceder CloudWatch acesso. Para obter mais informações, consulte [Definir permissões em um bucket do Amazon S3 no Guia](https://docs.aws.amazon.com/AmazonCloudWatch/latest/logs/S3ExportTasks.html#S3Permissions) do *usuário de CloudWatch registros*.
+ **A partir da AWS ParallelCluster versão **3.12.0**, a `--bucket` opção é opcional.** Se a opção não for especificada, o bucket padrão AWS ParallelCluster regional (`parallelcluster-hash-v1-DO-NOT-DELETE`) será usado ou, se `CustomS3Bucket` for especificado na configuração da imagem, ele será usado.
Se o bucket AWS ParallelCluster padrão for usado, o pcluster se encarregará de configurar a política do bucket. Se você personalizar a política de bucket antes de atualizar para a AWS ParallelCluster versão **3.12.0**, a política de bucket será substituída e você precisará reaplicar as alterações.
**--image-id, -i *IMAGE\$1ID***
O ID da imagem cujos logs serão exportados.
**--bucket-prefix *BUCKET\$1PREFIX***
Especifica o caminho no bucket do Amazon S3 para o qual os dados de log exportados devem ser armazenados.
Por padrão, o prefixo do bucket é:
```
ami-id-logs-202209061743.tar.gz
```
`202209061743` é a hora atual no formato `%Y%m%d%H%M`.
A partir da AWS ParallelCluster versão **3.12.0**, se você não especificar a `--bucket` opção e usar o AWS ParallelCluster bucket padrão, não poderá exportar registros para a `parallelcluster/` pasta, pois é uma pasta protegida reservada para uso interno.
**--debug**
Habilita o log de depuração.
**--end-time *END\$1TIME***
Especifica o final do intervalo de tempo para coletar eventos de log, expresso no formato ISO 8601 (`YYYY-MM-DDThh:mm:ssZ`, por exemplo `2021-01-01T20:00:00Z`'). Eventos com uma marca de data/hora igual ou posterior a esse horário não estão incluídos. Elementos de tempo (por exemplo, minutos e segundos) podem ser omitidos. O valor padrão é o horário atual.
**--keep-s3-objects *KEEP\$1S3\$1OBJECTS***
Se for `true`, as exportações de objetos exportados para o Amazon S3 serão mantidas. (Padronizado como `false`.)
**--output-file *OUTPUT\$1FILE***
Especifica o caminho do arquivo onde será salvo o arquivamento de log. Se isso for fornecido, os logs serão salvos localmente. Caso contrário, eles serão enviados para o Amazon S3 com o URL retornado na saída. O padrão é fazer upload para o Amazon S3.
**--region, -r *REGION***
Especifica o a Região da AWS ser usado. O Região da AWS deve ser especificado usando 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.
**--start-time *START\$1TIME***
Especifica o início do intervalo de tempo, expresso no formato ISO 8601 (`YYYY-MM-DDThh:mm:ssZ`, por exemplo `2021-01-01T20:00:00Z`). Eventos de log com uma marca de data/hora igual ou posterior a esse horário estão incluídos. Se não for especificado, o padrão é a hora em que o cluster foi criado.
**Exemplo usando a AWS ParallelCluster versão 3.1.4:**
```
$ pcluster export-image-logs --bucket image-v3-bucket --image-id ami-1234abcd5678efgh
{
"url": "https://image-v3-bucket..."
}
```
# `pcluster get-cluster-log-events`
Recupera os eventos associados a um fluxo de logs.
```
pcluster get-cluster-log-events [-h]
--cluster-name CLUSTER_NAME
--log-stream-name LOG_STREAM_NAME
[--debug]
[--end-time END_TIME]
[--limit LIMIT]
[--next-token NEXT_TOKEN]
[--query QUERY]
[--region REGION]
[--start-from-head START_FROM_HEAD]
[--start-time START_TIME]
```
## Argumentos nomeados
**-h, --help**
Mostra o texto de ajuda para `pcluster get-cluster-log-events`.
**--cluster-name, -n *CLUSTER\$1NAME***
Especifica o nome do cluster.
**--log-stream-name *LOG\$1STREAM\$1NAME***
Especifica o nome do fluxo de logs. Você pode usar o comando `list-cluster-log-streams` para recuperar um fluxo de logs associado a um evento ou eventos.
**--debug**
Habilita o log de depuração.
**--end-time *END\$1TIME***
Especifica o final do intervalo de tempo, expresso no formato ISO 8601 (`YYYY-MM-DDThh:mm:ssZ`, por exemplo `2021-01-01T20:00:00Z`). Eventos com uma marca de data/hora igual ou posterior a esse horário não estão incluídos.
**--limit *LIMIT***
Especifica o número de eventos de log retornados pela consulta. Se um valor não for especificado, o máximo será o máximo de eventos de log que couberem em um tamanho de resposta de 1 MB, com até 10.000 eventos de log.
**--next-token *NEXT\$1TOKEN***
O token para o próximo conjunto de resultados.
**--query *QUERY***
Especifica a 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 variável de `AWS_DEFAULT_REGION` ambiente, a `region` configuração na `[default]` seção do `~/.aws/config` arquivo ou o `--region` parâmetro.
**--start-from-head *START\$1FROM\$1HEAD***
Se o valor for `true`, os primeiros eventos de log serão retornados primeiro. Se o valor for `false`, os eventos de log mais recentes serão retornados primeiro. (Padronizado como `false`.)
**--start-time *START\$1TIME***
Especifica o início do intervalo de tempo, expresso no formato ISO 8601 (`YYYY-MM-DDThh:mm:ssZ`, por exemplo `2021-01-01T20:00:00Z`). Eventos com uma marca de data/hora igual ou posterior a esse horário estão incluídos.
**Exemplo usando a AWS ParallelCluster versão 3.1.4:**
```
$ pcluster get-cluster-log-events \
-c cluster-v3 \
-r us-east-1 \
--log-stream-name ip-198-51-100-44.i-1234567890abcdef0.clustermgtd \
--limit 3
{
"nextToken": "f/36966906399261933213029082268132291405859205452101451780/s",
"prevToken": "b/36966906399239632467830551644990755687586557090595471362/s",
"events": [
{
"message": "2022-07-12 19:16:53,379 - [slurm_plugin.clustermgtd:_maintain_nodes] - INFO - Performing node maintenance actions",
"timestamp": "2022-07-12T19:16:53.379Z"
},
{
"message": "2022-07-12 19:16:53,380 - [slurm_plugin.clustermgtd:_maintain_nodes] - INFO - Following nodes are currently in replacement: (x0) []",
"timestamp": "2022-07-12T19:16:53.380Z"
},
{
"message": "2022-07-12 19:16:53,380 - [slurm_plugin.clustermgtd:_terminate_orphaned_instances] - INFO - Checking for orphaned instance",
"timestamp": "2022-07-12T19:16:53.380Z"
}
]
}
```
# `pcluster get-cluster-stack-events`
Recupera os eventos associados a uma pilha do cluster especificado.
**nota**
A partir da versão 3.6.0, AWS ParallelCluster usa pilhas aninhadas para criar os recursos associados às filas e aos recursos computacionais. A API `GetClusterStackEvents` e o comando `pcluster get-cluster-stack-events` retornam apenas os eventos da pilha principal do cluster. Você pode visualizar os eventos da pilha de clusters, incluindo aqueles relacionados a filas e recursos computacionais, no console. CloudFormation
```
pcluster get-cluster-stack-events [-h]
--cluster-name CLUSTER_NAME
[--debug]
[--next-token NEXT_TOKEN]
[--query QUERY]
[--region REGION]
```
## Argumentos nomeados
**-h, --help**
Mostra o texto de ajuda para `pcluster get-cluster-stack-events`.
**--cluster-name, -n *CLUSTER\$1NAME***
Especifica o nome do cluster.
**--debug**
Habilita o log de depuração.
**--next-token *NEXT\$1TOKEN***
O token para o próximo conjunto de resultados.
**--query *QUERY***
Especifica a 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 variável de `AWS_DEFAULT_REGION` ambiente, a `region` configuração na `[default]` seção do `~/.aws/config` arquivo ou o `--region` parâmetro.
**Exemplo usando a AWS ParallelCluster versão 3.1.4:**
```
$ pcluster get-cluster-stack-events \
-n cluster-v3 \
-r us-east-1 \
--query "events[0]"
{
"eventId": "1234abcd-56ef-78gh-90ij-abcd1234efgh",
"physicalResourceId": "arn:aws:cloudformation:us-east-1:123456789012:stack/cluster-v3/1234abcd-56ef-78gh-90ij-abcd1234efgh",
"resourceStatus": "CREATE_COMPLETE",
"stackId": "arn:aws:cloudformation:us-east-1:123456789012:stack/cluster-v3/1234abcd-56ef-78gh-90ij-abcd1234efgh",
"stackName": "cluster-v3",
"logicalResourceId": "cluster-v3",
"resourceType": "AWS::CloudFormation::Stack",
"timestamp": "2022-07-12T18:29:12.140Z"
}
```
# `pcluster get-image-log-events`
Recupere os eventos de log associados a uma criação de imagem.
```
pcluster get-image-log-events [-h]
--image-id IMAGE_ID
--log-stream-name LOG_STREAM_NAME
[--debug]
[--end-time END_TIME]
[--limit LIMIT]
[--next-token NEXT_TOKEN]
[--query QUERY]
[--region REGION]
[--start-from-head START_FROM_HEAD]
[--start-time START_TIME]
```
## Argumentos nomeados
**-h, --help**
Mostra o texto de ajuda para `pcluster get-image-log-events`.
**--image-id, -i *IMAGE\$1ID***
Especifica o ID da imagem.
**--log-stream-name *LOG\$1STREAM\$1NAME***
Especifica o nome do fluxo de logs. Você pode usar o comando `list-image-log-streams` para recuperar um fluxo de logs associado a um evento ou eventos.
**--debug**
Habilita o log de depuração.
**--end-time *END\$1TIME***
Especifica o final do intervalo de tempo, expresso no formato ISO 8601 (`YYYY-MM-DDThh:mm:ssZ`, por exemplo `2021-01-01T20:00:00Z`). Eventos com uma marca de data/hora igual ou posterior a esse horário não estão incluídos.
**--limit *LIMIT***
Especifica o número de eventos de log retornados pela consulta. Se um valor não for especificado, o máximo será o máximo de eventos de log que couberem em um tamanho de resposta de 1 MB, com até 10.000 eventos de log.
**--next-token *NEXT\$1TOKEN***
O token para o próximo conjunto de resultados.
**--query *QUERY***
Especifica a 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 variável de `AWS_DEFAULT_REGION` ambiente, a `region` configuração na `[default]` seção do `~/.aws/config` arquivo ou o `--region` parâmetro.
**--start-from-head *START\$1FROM\$1HEAD***
Se o valor for `true`, os primeiros eventos de log serão retornados primeiro. Se o valor for `false`, os eventos de log mais recentes serão retornados primeiro. (Padronizado como `false`.)
**--start-time *START\$1TIME***
Especifica o início do intervalo de tempo, expresso no formato ISO 8601 (`YYYY-MM-DDThh:mm:ssZ`, por exemplo `2021-01-01T20:00:00Z`). Eventos com uma marca de data/hora igual ou posterior a esse horário estão incluídos.
**Exemplo usando a AWS ParallelCluster versão 3.1.2:**
```
$ pcluster get-image-log-events --image-id custom-alinux2-image --region us-east-1 --log-stream-name 3.1.2/1 --limit 3
{
"nextToken": "f/36778317771100849897800729464621464113270312017760944178/s",
"prevToken": "b/36778317766952911290874033560295820514557716777648586800/s",
"events": [
{
"message": "ExecuteBash: FINISHED EXECUTION",
"timestamp": "2022-04-05T22:13:26.633Z"
},
{
"message": "Document arn:aws:imagebuilder:us-east-1:123456789012:component/parallelclusterimage-test-1234abcd-56ef-78gh-90ij-abcd1234efgh/3.1.2/1",
"timestamp": "2022-04-05T22:13:26.741Z"
},
{
"message": "TOE has completed execution successfully",
"timestamp": "2022-04-05T22:13:26.819Z"
}
]
}
```
# `pcluster get-image-stack-events`
Recupera os eventos associados a uma pilha de uma criação de imagem especificada.
```
pcluster get-image-stack-events [-h]
--image-id IMAGE_ID
[--debug]
[--next-token NEXT_TOKEN]
[--query QUERY]
[--region REGION]
```
## Argumentos nomeados
**-h, --help**
Mostra o texto de ajuda para `pcluster get-image-stack-events`.
**--image-id, -i *IMAGE\$1ID***
Especifica o ID da imagem.
**--debug**
Habilita o log de depuração.
**--next-token *NEXT\$1TOKEN***
O token para o próximo conjunto de resultados.
**--query *QUERY***
Especifica a 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 variável de `AWS_DEFAULT_REGION` ambiente, a `region` configuração na `[default]` seção do `~/.aws/config` arquivo ou o `--region` parâmetro.
**Exemplo usando a AWS ParallelCluster versão 3.1.2:**
```
$ pcluster get-image-stack-events --image-id custom-alinux2-image --region us-east-1 --query "events[0]"
{
"eventId": "ParallelClusterImage-CREATE_IN_PROGRESS-2022-04-05T21:39:24.725Z",
"physicalResourceId": "arn:aws:imagebuilder:us-east-1:123456789012:image/parallelclusterimage-custom-alinux2-image/3.1.2/1",
"resourceStatus": "CREATE_IN_PROGRESS",
"resourceStatusReason": "Resource creation Initiated",
"resourceProperties": "{\"InfrastructureConfigurationArn\":\"arn:aws:imagebuilder:us-east-1:123456789012:infrastructure-configuration/parallelclusterimage-1234abcd-56ef-78gh-90ij-abcd1234efgh\",\"ImageRecipeArn\":\"arn:aws:imagebuilder:us-east-1:123456789012:image-recipe/parallelclusterimage-custom-alinux2-image/3.1.2\",\"DistributionConfigurationArn\":\"arn:aws:imagebuilder:us-east-1:123456789012:distribution-configuration/parallelclusterimage-1234abcd-56ef-78gh-90ij-abcd1234efgh\",\"EnhancedImageMetadataEnabled\":\"false\",\"Tags\":{\"parallelcluster:image_name\":\"custom-alinux2-image\",\"parallelcluster:image_id\":\"custom-alinux2-image\"}}",
"stackId": "arn:aws:cloudformation:us-east-1:123456789012:stack/custom-alinux2-image/1234abcd-56ef-78gh-90ij-abcd1234efgh",
"stackName": "custom-alinux2-image",
"logicalResourceId": "ParallelClusterImage",
"resourceType": "AWS::ImageBuilder::Image",
"timestamp": "2022-04-05T21:39:24.725Z"
}
```
# `pcluster list-clusters`
Retorna uma lista de clusters existentes.
```
pcluster list-clusters [-h]
[--cluster-status {CREATE_IN_PROGRESS,CREATE_FAILED,CREATE_COMPLETE,
DELETE_IN_PROGRESS,DELETE_FAILED,UPDATE_IN_PROGRESS,
UPDATE_COMPLETE,UPDATE_FAILED}
[{CREATE_IN_PROGRESS,CREATE_FAILED,CREATE_COMPLETE,
DELETE_IN_PROGRESS,DELETE_FAILED,UPDATE_IN_PROGRESS,
UPDATE_COMPLETE,UPDATE_FAILED} ...]]
[--debug]
[--next-token NEXT_TOKEN]
[--query QUERY]
[--region REGION]
```
## Argumentos nomeados
**-h, --help**
Mostra o texto de ajuda para `pcluster list-clusters`.
**--cluster-status \$1`CREATE_IN_PROGRESS`, `CREATE_FAILED`, `CREATE_COMPLETE`, `DELETE_IN_PROGRESS`, `DELETE_FAILED`, `UPDATE_IN_PROGRESS`, `UPDATE_COMPLETE`, `UPDATE_FAILED`\$1 [\$1`CREATE_IN_PROGRESS`, `CREATE_FAILED`, `CREATE_COMPLETE`, `DELETE_IN_PROGRESS`, `DELETE_FAILED`, `UPDATE_IN_PROGRESS`, `UPDATE_COMPLETE`, `UPDATE_FAILED`\$1 ...]**
Especifica a lista de status de cluster a serem filtrados. (Padronizado como `all`.)
**--debug**
Habilita o log de depuração.
**--next-token *NEXT\$1TOKEN***
O token para o próximo conjunto de resultados.
**--query *QUERY***
Especifica a 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 variável de `AWS_DEFAULT_REGION` ambiente, a `region` configuração na `[default]` seção do `~/.aws/config` arquivo ou o `--region` parâmetro.
**Exemplo usando a AWS ParallelCluster versão 3.1.4:**
```
$ pcluster list-clusters
{
"clusters": [
{
"clusterName": "cluster-v3",
"cloudformationStackStatus": "CREATE_COMPLETE",
"cloudformationStackArn": "arn:aws:cloudformation:us-east-1:123456789012:stack/cluster-v3/1234abcd-56ef-78gh-90ij-abcd1234efgh",
"region": "us-east-1",
"version": "3.1.4",
"clusterStatus": "CREATE_COMPLETE"
}
]
}
```
# `pcluster list-cluster-log-streams`
Recupera a lista de fluxo de logs associados a um cluster.
```
pcluster list-cluster-log-streams [-h]
--cluster-name CLUSTER_NAME
[--filters FILTERS [FILTERS ...]]
[--next-token NEXT_TOKEN] [--debug]
[--query QUERY]
[--region REGION]
```
## Argumentos nomeados
**-h, --help**
Mostra o texto de ajuda para `pcluster list-cluster-log-streams`.
**--cluster-name, -n *CLUSTER\$1NAME***
Especifica o nome do cluster.
**--debug**
Habilita o log de depuração.
**--filters *FILTERS* [*FILTERS* ...]**
Especifica filtros para o fluxo de logs. Formato: `Name=a,Values=1 Name=b,Values=2,3`. Filtros compatíveis para:
`private-dns-name`
Especifica a forma abreviada do nome DNS privado da instância (por exemplo, `ip-10-0-0-101`).
`node-type`
Especifica o tipo de nó, o único valor aceito para esse filtro é `HeadNode`.
**--next-token *NEXT\$1TOKEN***
O token para o próximo conjunto de resultados.
**--query *QUERY***
Especifica a 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 variável de `AWS_DEFAULT_REGION` ambiente, a `region` configuração na `[default]` seção do `~/.aws/config` arquivo ou o `--region` parâmetro.
**Exemplo usando a AWS ParallelCluster versão 3.1.4:**
```
$ pcluster list-cluster-log-streams \
-n cluster-v3 \
-r us-east-1 \
--query 'logStreams[*].logStreamName'
[
"ip-172-31-58-205.i-1234567890abcdef0.cfn-init",
"ip-172-31-58-205.i-1234567890abcdef0.chef-client",
"ip-172-31-58-205.i-1234567890abcdef0.cloud-init",
"ip-172-31-58-205.i-1234567890abcdef0.clustermgtd",
"ip-172-31-58-205.i-1234567890abcdef0.slurmctld",
"ip-172-31-58-205.i-1234567890abcdef0.supervisord",
"ip-172-31-58-205.i-1234567890abcdef0.system-messages"
]
```
# `pcluster list-images`
Recupera a lista de imagens personalizadas existentes.
```
pcluster list-images [-h]
--image-status {AVAILABLE,PENDING,FAILED}
[--debug]
[--next-token NEXT_TOKEN]
[--query QUERY]
[--region REGION]
```
## Argumentos nomeados
**-h, --help**
Mostra o texto de ajuda para `pcluster list-images`.
**--image-status \$1`AVAILABLE`,`PENDING`,`FAILED`\$1**
Filtra as imagens retornadas pelo status fornecido.
**--debug**
Habilita o log de depuração.
**--next-token *NEXT\$1TOKEN***
O token para o próximo conjunto de resultados.
**--query *QUERY***
Especifica a 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 variável de `AWS_DEFAULT_REGION` ambiente, a `region` configuração na `[default]` seção do `~/.aws/config` arquivo ou o `--region` parâmetro.
**Exemplo usando a AWS ParallelCluster versão 3.1.2:**
```
$ pcluster list-images --image-status AVAILABLE
{
"images": [
{
"imageId": "custom-alinux2-image",
"imageBuildStatus": "BUILD_COMPLETE",
"ec2AmiInfo": {
"amiId": "ami-1234abcd5678efgh"
},
"region": "us-east-1",
"version": "3.1.2"
}
]
}
```
# `pcluster list-image-log-streams`
Recupera a lista de fluxo de logs associados a uma imagem.
```
pcluster list-image-log-streams [-h]
--image-id IMAGE_ID
[--next-token NEXT_TOKEN] [--debug]
[--query QUERY]
[--region REGION]
```
## Argumentos nomeados
**-h, --help**
Mostra o texto de ajuda para `pcluster list-image-log-streams`.
**--image-id, -i *IMAGE\$1ID***
Especifica o ID da imagem.
**--debug**
Habilita o log de depuração.
**--next-token *NEXT\$1TOKEN***
O token para o próximo conjunto de resultados.
**--query *QUERY***
Especifica a 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 variável de `AWS_DEFAULT_REGION` ambiente, a `region` configuração na `[default]` seção do `~/.aws/config` arquivo ou o `--region` parâmetro.
**Exemplo usando a AWS ParallelCluster versão 3.1.2:**
```
$ pcluster list-image-log-streams --image-id custom-alinux2-image --region us-east-1 --query 'logStreams[*].logStreamName'
[
"3.0.0/1",
"3.1.2/1"
]
```
# `pcluster list-official-images`
Descreva o oficial AWS ParallelCluster AMIs.
```
pcluster list-official-images [-h]
[--architecture ARCHITECTURE]
[--debug]
[--os OS]
[--query QUERY]
[--region REGION]
```
## Argumentos nomeados
**-h, --help**
Mostra o texto de ajuda para `pcluster list-official-images`.
**--architecture *ARCHITECTURE***
Especifica a arquitetura a ser usada para filtrar os resultados. Se esse parâmetro não for especificado, todas as arquiteturas serão retornadas.
**--debug**
Habilita o log de depuração.
**--os *OS***
Especifica o sistema operacional a ser usado para filtrar os resultados. Se esse parâmetro não for especificado, todos os sistemas operacionais serão retornados.
**--query *QUERY***
Especifica a 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.
**Exemplo usando a AWS ParallelCluster versão 3.1.2:**
```
$ pcluster list-official-images
{
"images": [
{
"amiId": "ami-015cfeb4e0d6306b2",
"os": "ubuntu2204",
"name": "aws-parallelcluster-3.1.2-ubuntu-2204-lts-hvm-x86_64-202202261505 2022-02-26T15-08-34.759Z",
"version": "3.1.2",
"architecture": "x86_64"
},
{
"amiId": "ami-036f23237ce49d25b",
"os": "ubuntu2204",
"name": "aws-parallelcluster-3.1.2-ubuntu-1804-lts-hvm-x86_64-202202261505 2022-02-26T15-08-17.558Z",
"version": "3.1.2",
"architecture": "x86_64"
},
{
"amiId": "ami-09e5327e694d89ef4",
"os": "ubuntu2204",
"name": "aws-parallelcluster-3.1.2-ubuntu-2204-lts-hvm-arm64-202202261505 2022-02-26T15-08-45.736Z",
"version": "3.1.2",
"architecture": "arm64"
},
{
"amiId": "ami-0b9b0874c35f626ae",
"os": "alinux2",
"name": "aws-parallelcluster-3.1.2-amzn2-hvm-x86_64-202202261505 2022-02-26T15-08-31.311Z",
"version": "3.1.2",
"architecture": "x86_64"
},
{
"amiId": "ami-0d0de4f95f56374bc",
"os": "alinux2",
"name": "aws-parallelcluster-3.1.2-amzn2-hvm-arm64-202202261505 2022-02-26T15-08-46.088Z",
"version": "3.1.2",
"architecture": "arm64"
},
{
"amiId": "ami-0ebf7bc54b8740dc6",
"os": "ubuntu2204",
"name": "aws-parallelcluster-3.1.2-ubuntu-1804-lts-hvm-arm64-202202261505 2022-02-26T15-08-45.293Z",
"version": "3.1.2",
"architecture": "arm64"
}
]
}
```
# `pcluster ssh`
Executa um comando `ssh` com o nome de usuário de cluster e o endereço IP pré-preenchidos. Os argumentos arbitrários são anexados ao final da linha de comando `ssh`.
```
pcluster ssh [-h]
--cluster-name CLUSTER_NAME
[--debug]
[--dryrun DRYRUN]
[--region REGION]
```
## Argumentos nomeados
**-h, --help**
Mostra o texto de ajuda para `pcluster ssh`.
**--cluster-name, -n *CLUSTER\$1NAME***
Especifica o nome do cluster ao qual conectar-se.
**--debug**
Habilita o log de depuração.
**--dryrun *DRYRUN***
Quando `true`, imprime a linha de comando que seria executado e sai. (Padronizado como `false`.)
**--region, -r *REGION***
Especifica o a Região da AWS ser usado. O Região da AWS deve ser especificado usando 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.
Exemplo:
```
$ pcluster ssh --cluster-name mycluster -i ~/.ssh/id_rsa
```
Executa um comando `ssh` com o nome de usuário e o endereço IP do cluster pré-preenchidos:
```
ssh ec2-user@1.1.1.1 -i ~/.ssh/id_rsa
```
# `pcluster update-cluster`
Atualiza um cluster existente para corresponder às configurações de um arquivo de configuração especificado.
**nota**
A atualização do cluster será bem-sucedida somente se todos os nós do cluster tiverem aplicado a atualização com êxito. Se a atualização falhar, consulte a [Ver `clusterStatus` é `UPDATE_FAILED` com comando `pcluster describe-cluster`](troubleshooting-fc-v3-update-cluster.md#update-cluster-failure-v3) seção para obter orientações sobre solução de problemas.
```
pcluster update-cluster [-h]
--cluster-configuration CLUSTER_CONFIGURATION
--cluster-name CLUSTER_NAME
[--debug]
[--dryrun DRYRUN]
[--force-update FORCE_UPDATE]
[--query QUERY]
[--region REGION]
[--suppress-validators SUPPRESS_VALIDATORS [SUPPRESS_VALIDATORS ...]]
[--validation-failure-level {INFO,WARNING,ERROR}]
```
## Argumentos nomeados
**-h, --help**
Mostra o texto de ajuda para `pcluster update-cluster`.
**--cluster-configuration, -c *CLUSTER\$1CONFIGURATION***
Especifica o arquivo de configuração do cluster YAML.
**--cluster-name, -n *CLUSTER\$1NAME***
Especifica o nome do cluster.
**--debug**
Habilita o log de depuração.
**--dryrun *DRYRUN***
Quando `true`, executa a validação sem atualizar o cluster e sem criar recursos. Ele pode ser usado para validar a configuração da imagem e os requisitos de atualização. (Padronizado como `false`.)
**--force-update *FORCE\$1UPDATE***
Quando`true`, força a atualização ignorando os erros de validação da atualização. (Padronizado como `false`.)
**--query *QUERY***
Especifica a 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 [`Region`](cluster-configuration-file-v3.md#yaml-Region)configuração no arquivo de configuração do cluster, 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.
**--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 *\$1INFO,WARNING,ERROR\$1***
Especifica o nível de falhas de validação relatado para a atualização.
**Exemplo usando a AWS ParallelCluster versão 3.1.4:**
```
$ pcluster update-cluster -c cluster-config.yaml -n cluster-v3 -r us-east-1
{
"cluster": {
"clusterName": "cluster-v3",
"cloudformationStackStatus": "UPDATE_IN_PROGRESS",
"cloudformationStackArn": "arn:aws:cloudformation:us-east-1:123456789012:stack/cluster-v3/1234abcd-56ef-78gh-90ij-abcd1234efgh",
"region": "us-east-1",
"version": "3.1.4",
"clusterStatus": "UPDATE_IN_PROGRESS"
},
"changeSet": [
{
"parameter": "HeadNode.Iam.S3Access",
"requestedValue": {
"BucketName": "amzn-s3-demo-bucket1",
"KeyName": "output",
"EnableWriteAccess": false
}
},
{
"parameter": "HeadNode.Iam.S3Access",
"currentValue": {
"BucketName": "amzn-s3-demo-bucket2",
"KeyName": "logs",
"EnableWriteAccess": true
}
}
]
}
```
# `pcluster update-compute-fleet`
Atualiza o status da frota de computação do cluster.
```
pcluster update-compute-fleet [-h]
--cluster-name CLUSTER_NAME
--status {START_REQUESTED,STOP_REQUESTED,ENABLED,DISABLED}
[--debug]
[--query QUERY]
[--region REGION]
```
## Argumentos nomeados
**-h, --help**
Mostra o texto de ajuda para `pcluster update-compute-fleet`.
**--cluster-name, -n *CLUSTER\$1NAME***
Especifica o nome do cluster.
**--status \$1START\$1REQUESTED,STOP\$1REQUESTED,ENABLED,DISABLED\$1**
Especifica o status aplicado à frota de computação do cluster. Os status `START_REQUESTED` e `STOP_REQUESTED` correspondem ao Slurm agendador, enquanto os status a `ENABLED` e `DISABLED` correspondem ao agendador. AWS Batch
**--debug**
Habilita o log de depuração.
**--query *QUERY***
Especifica a 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 variável de `AWS_DEFAULT_REGION` ambiente, a `region` configuração na `[default]` seção do `~/.aws/config` arquivo ou o `--region` parâmetro.
**Exemplo usando a AWS ParallelCluster versão 3.1.4:**
```
$ pcluster update-compute-fleet -n cluster-v3 --status STOP_REQUESTED
{
"status": "STOP_REQUESTED",
"lastStatusUpdatedTime": "2022-07-12T20:19:47.653Z"
}
```
# `pcluster version`
Exibe a versão do AWS ParallelCluster.
```
pcluster version [-h] [--debug]
```
## Argumentos nomeados
**-h, --help**
Mostra o texto de ajuda para `pcluster version`.
**--debug**
Habilita o log de depuração.
**Exemplo usando a AWS ParallelCluster versão 3.1.4:**
```
$ pcluster version
{
"version": "3.1.4"
}
```
# `pcluster3-config-converter`
Lê um arquivo de configuração da AWS ParallelCluster versão 2 e grava um arquivo de configuração da AWS ParallelCluster versão 3.
```
pcluster3-config-converter [-h]
[-t CLUSTER_TEMPLATE]
[-c CONFIG_FILE]
[--force-convert]
[-o OUTPUT_FILE]
```
## Argumentos nomeados
**-h, --help**
Mostra o texto de ajuda para `pcluster3-config-converter`.
**-t *CLUSTER\$1TEMPLATE*, --cluster-template *CLUSTER\$1TEMPLATE***
Especifica a [seção de `[cluster]`](https://docs.aws.amazon.com/parallelcluster/v2/ug/cluster-definition.html) do arquivo de configuração a ser convertida. Se não for especificado, o script procurará o parâmetro [cluster-template](https://docs.aws.amazon.com/parallelcluster/v2/ug/global.html#cluster-template) na [seção de `[global]`](https://docs.aws.amazon.com/parallelcluster/v2/ug/global.html) ou pesquisará por `[cluster default]`.
**-c *CONFIG\$1FILE*, --config-file *CONFIG\$1FILE***
Especifica o arquivo de configuração da AWS ParallelCluster versão 2 a ser lido.
**--force-convert**
Permite a conversão mesmo se uma ou mais configurações não forem suportadas e não forem recomendadas.
**-o *OUTPUT\$1FILE*, --output-file *OUTPUT\$1FILE***
Especifica o arquivo de configuração da AWS ParallelCluster versão 3 a ser gravado. Se esse parâmetro não for especificado, a configuração será gravada em stdout.
**nota**
O `pcluster3-config-converter` comando foi adicionado na AWS ParallelCluster versão 3.0.1.