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` `pcluster`é o comando principal da AWS ParallelCluster CLI. Use a `pcluster` para executar e gerenciar clusters HPC na Nuvem AWS. ``` pcluster [ -h ] ( create | update | delete | start | stop | status | list | instances | ssh | dcv | createami | configure | version ) ... ``` ## Argumentos **`pcluster command`** Possíveis opções: [`configure`](pcluster.configure.md), [`create`](pluster.create.md), [`createami`](pcluster.createami.md), [`dcv`](pcluster.dcv.md), [`delete`](pcluster.delete.md), [`instances`](pcluster.instances.md), [`list`](pcluster.list.md), [`ssh`](pcluster.ssh.md), [`start`](pcluster.start.md), [`status`](pcluster.status.md), [`stop`](pcluster.stop.md), [`update`](pcluster.update.md), [`version`](pcluster.version.md) ## Subcomandos: **Topics** + [ ## Argumentos ](#pcluster.arguments) + [ ## Subcomandos: ](#pcluster.subcommands) + [ # `pcluster configure` ](pcluster.configure.md) + [ # `pcluster create` ](pluster.create.md) + [ # `pcluster createami` ](pcluster.createami.md) + [ # `pcluster dcv` ](pcluster.dcv.md) + [ # `pcluster delete` ](pcluster.delete.md) + [ # `pcluster instances` ](pcluster.instances.md) + [ # `pcluster list` ](pcluster.list.md) + [ # `pcluster ssh` ](pcluster.ssh.md) + [ # `pcluster start` ](pcluster.start.md) + [ # `pcluster status` ](pcluster.status.md) + [ # `pcluster stop` ](pcluster.stop.md) + [ # `pcluster update` ](pcluster.update.md) + [ # `pcluster version` ](pcluster.version.md) # `pcluster configure` Inicia uma AWS ParallelCluster configuração. Para obter mais informações, consulte [Configurando AWS ParallelCluster](getting-started-configuring-parallelcluster.md). ``` pcluster configure [ -h ] [ -c CONFIG_FILE ] [ -r REGION ] ``` ## Argumentos nomeados **-h, --help** Mostra o texto de ajuda para `pcluster configure`. **-c * CONFIG\$1FILE*, --config *CONFIG\$1FILE*** Especifica o caminho completo do arquivo de configuração alternativo a ser usado. O padrão é `~/.parallelcluster/config`. Para obter mais informações, consulte [Configurando AWS ParallelCluster](getting-started-configuring-parallelcluster.md). **-r *REGION*, --region *REGION*** Especifica o a Região da AWS ser usado. Se isso for especificado, a configuração ignora a Região da AWS detecção. Para excluir os recursos de rede na VPC, você pode excluir a pilha CloudFormation de rede. O nome da pilha começa com”parallelclusternetworking-“e contém a hora da criação no formato “YYYYMMDDHHMMSS”. Você pode listar as pilhas usando o comando [list-stacks](https://docs.aws.amazon.com/goto/aws-cli/cloudformation-2010-05-15/ListStacks). ``` $ aws --region us-east-1 cloudformation list-stacks \ --stack-status-filter "CREATE_COMPLETE" \ --query "StackSummaries[].StackName" | \ grep -e "parallelclusternetworking-" "parallelclusternetworking-pubpriv-20191029205804" ``` A pilha pode ser excluída usando o comando [delete-stack](https://docs.aws.amazon.com/goto/aws-cli/cloudformation-2010-05-15/DeleteStack). ``` $ aws --region us-east-1 cloudformation delete-stack \ --stack-name parallelclusternetworking-pubpriv-20191029205804 ``` A VPC que [`pcluster configure`](#pcluster.configure) cria para você não é criada na pilha de CloudFormation rede. Você pode excluir essa VPC manualmente no console ou usando a AWS CLI. ``` $ aws --region us-east-1 ec2 delete-vpc --vpc-id vpc-0b4ad9c4678d3c7ad ``` # `pcluster create` Cria um cluster. ``` pcluster create [ -h ] [ -c CONFIG_FILE ] [ -r REGION ] [ -nw ] [ -nr ] [ -u TEMPLATE_URL ] [ -t CLUSTER_TEMPLATE ] [ -p EXTRA_PARAMETERS ] [ -g TAGS ] cluster_name ``` ## Argumentos posicionais ***cluster\$1name*** Define o nome do cluster. O nome da AWS CloudFormation pilha é`parallelcluster-cluster_name`. ## Argumentos nomeados **-h, --help** Mostra o texto de ajuda para `pcluster create`. **-c *CONFIG\$1FILE*, --config *CONFIG\$1FILE*** Especifica o arquivo de configuração alternativo a ser usado. O padrão é `~/.parallelcluster/config`. **-r *REGION*, --region *REGION*** Especifica o a Região da AWS ser usado. A ordem de prioridade usada para selecionar o Região da AWS para um novo cluster é a seguinte: 1. `-r`ou `--region` parâmetro para[`pcluster create`](#pluster.create). 1. Variável de ambiente `AWS_DEFAULT_REGION`. 1. `aws_region_name`configuração na `[aws]` seção do arquivo de AWS ParallelCluster configuração (o local padrão é`~/.parallelcluster/config`.) Esse é o local atualizado pelo comando [`pcluster configure`](pcluster.configure.md). 1. `region`configuração na `[default]` seção do arquivo de AWS CLI configuração (`~/.aws/config`.) **-nw, --nowait** Indica para não aguardar eventos de pilha depois de executar um comando de pilha. O padrão é `False`. **-nr, --norollback** Desabilita a reversão da pilha do quando ocorrer erro. O padrão é `False`. **-u *TEMPLATE\$1URL*, --template-url *TEMPLATE\$1URL*** Especifica uma URL para o AWS CloudFormation modelo personalizado se ele foi usado quando criado. **-t *CLUSTER\$1TEMPLATE*, --cluster-template *CLUSTER\$1TEMPLATE*** Indica o modelo de cluster a ser usado. **-p *EXTRA\$1PARAMETERS*, --extra-parameters *EXTRA\$1PARAMETERS*** Adiciona parâmetros adicionais à criação da pilha. **-g *TAGS*, --tags *TAGS*** Especifica outras tags a serem adicionadas à pilha. Quando o comando é chamado e começa a sondar o status dessa chamada, é seguro usar "Ctrl\$1C" para sair. Você pode voltar a visualizar o status atual chamando `pcluster status mycluster`. **Exemplos usando a AWS ParallelCluster versão 2.11.7:** ``` $ pcluster create mycluster Beginning cluster creation for cluster: mycluster Info: There is a newer version 3.1.4 of AWS ParallelCluster available. Creating stack named: parallelcluster-mycluster Status: ComputeFleetHITSubstack - CREATE_IN_PROGRESS $ pcluster create mycluster --tags '{ "Key1" : "Value1" , "Key2" : "Value2" }' ``` # `pcluster createami` (Linux/macOS) Cria uma AMI personalizada para usar com. AWS ParallelCluster ``` pcluster createami [ -h ] -ai BASE_AMI_ID -os BASE_AMI_OS [ -i INSTANCE_TYPE ] [ -ap CUSTOM_AMI_NAME_PREFIX ] [ -cc CUSTOM_AMI_COOKBOOK ] [--no-public-ip] [ -post-install POST_INSTALL_SCRIPT ] [ -c CONFIG_FILE ] [-t CLUSTER_TEMPLATE] [--vpc-id VPC_ID] [--subnet-id SUBNET_ID] [ -r REGION ] ``` ## Dependências necessárias Além da AWS ParallelCluster CLI, a seguinte dependência é necessária para ser executada: `pcluster createami` + **Packer**: faça download da versão mais recente em [https://developer.hashicorp.com/packer/downloads](https://developer.hashicorp.com/packer/downloads). **nota** Antes da AWS ParallelCluster versão 2.8.0, era necessário usar o [Berkshelf](https://github.com/berkshelf/berkshelf) (instalado usando`gem install berkshelf`). `pcluster createami` ## Argumentos nomeados **-h, --help** Mostra o texto de ajuda para `pcluster createami`. **-ai *BASE\$1AMI\$1ID*, --ami-id *BASE\$1AMI\$1ID*** Especifica a AMI básica a ser usada para criar a AWS ParallelCluster AMI. **-os *BASE\$1AMI\$1OS*, --os *BASE\$1AMI\$1OS*** Especifica o sistema operacional da AMI de base. As opções válidas são: `alinux2`, `ubuntu1804`, `ubuntu2004` e `centos7`. O suporte do sistema operacional muda em diferentes AWS ParallelCluster versões: + Support for `centos8` removido na AWS ParallelCluster versão 2.10.4. + O suporte para `centos8` foi adicionado e o suporte para `centos6` foi removido no AWS ParallelCluster 2.10.0. + Support para alinux2 foi adicionado na AWS ParallelCluster versão 2.6.0. + Support para ubuntu1804 foi adicionado na versão 2.5.0. AWS ParallelCluster **-i *INSTANCE\$1TYPE*, --instance-type *INSTANCE\$1TYPE*** Especifica o tipo de instância a ser usado para criar a AMI. O padrão é `t2.xlarge`. Support para o `--instance-type` argumento foi adicionado na AWS ParallelCluster versão 2.4.1. **-ap *CUSTOM\$1AMI\$1NAME\$1PREFIX*, --ami-name-prefix *CUSTOM\$1AMI\$1NAME\$1PREFIX*** Especifica o nome do prefixo da AMI AWS ParallelCluster resultante. O padrão é `custom-ami-`. **-cc *CUSTOM\$1AMI\$1COOKBOOK*, --custom-cookbook *CUSTOM\$1AMI\$1COOKBOOK*** Especifica o livro de receitas a ser usado para criar a AMI AWS ParallelCluster . **--post-install *POST\$1INSTALL\$1SCRIPT*** Especifica o caminho para o script de pós-instalação. Os caminhos devem usar um esquema de URL `s3://`, `https://`, ou `file://`. Os exemplos incluem: + `https://bucket-name.s3.region.amazonaws.com/path/post_install.sh` + `s3://bucket-name/post_install.sh` + `file:///opt/project/post_install.sh` Support para o `--post-install` argumento foi adicionado na AWS ParallelCluster versão 2.10.0. **--no-public-ip** Não associe um endereço IP público à instância usada para criar a AMI. Por padrão, um endereço IP público está associado à instância. Support para o `--no-public-ip` argumento foi adicionado na AWS ParallelCluster versão 2.5.0. **-c *CONFIG\$1FILE*, --config *CONFIG\$1FILE*** Especifica o arquivo de configuração alternativo a ser usado. O padrão é `~/.parallelcluster/config`. **-t *CLUSTER\$1TEMPLATE*, --cluster-template *CLUSTER\$1TEMPLATE*** Especifica a [seção [`cluster`]](cluster-definition.md) do a *CONFIG\$1FILE* ser usada para recuperar as configurações de VPC e sub-rede. Support para o `--cluster-template` argumento foi adicionado na AWS ParallelCluster versão 2.4.0. **--vpc-id *VPC\$1ID*** Especifica o ID da VPC a ser usada para criar a AWS ParallelCluster AMI. Support para o `--vpc-id` argumento foi adicionado na AWS ParallelCluster versão 2.5.0. **--subnet-id *SUBNET\$1ID*** Especifica o ID da sub-rede a ser usada para criar a AMI AWS ParallelCluster . Support para o `--vpc-id` argumento foi adicionado na AWS ParallelCluster versão 2.5.0. **-r *REGION*, --region** *REGION* Especifica o a Região da AWS ser usado. O padrão é o Região da AWS especificado usando o [`pcluster configure`](pcluster.configure.md) comando. # `pcluster dcv` Interage com o servidor Amazon DCV em execução no nó principal. ``` pcluster dcv [ -h ] ( connect ) ``` **`pcluster dcv command`** Possíveis opções: [`connect`](#pcluster-dcv-connect) **nota** Alterações no suporte do sistema operacional para o `pcluster dcv` comando em diferentes AWS ParallelCluster versões: O suporte para o comando `pcluster dcv` no `centos8` foi adicionado ao AWS ParallelCluster versão 2.10.0. Support para o `pcluster dcv` comando em instâncias AWS baseadas em Graviton foi adicionado na AWS ParallelCluster versão 2.9.0. O suporte para o comando `pcluster dcv` no `ubuntu1804` foi adicionado ao AWS ParallelCluster versão 2.6.0. O suporte para o comando `pcluster dcv` no `centos7` foi adicionado ao AWS ParallelCluster versão 2.5.0. ## Argumentos nomeados **-h, --help** Mostra o texto de ajuda para `pcluster dcv`. ## Subcomandos ### `pcluster dcv connect` ``` pcluster dcv connect [ -h ] [ -k SSH_KEY_PATH ] [ -r REGION ] cluster_name ``` **Importante** O URL expira 30 segundos após ser emitido. Se a conexão não for estabelecida antes de o URL expirar, execute o `pcluster dcv connect` novamente para gerar um novo URL. #### Argumentos posicionais ***cluster\$1name*** Especifica o nome do cluster ao qual conectar-se. #### Argumentos nomeados **-h, --help** Mostra o texto de ajuda para `pcluster dcv connect`. **-k *SSH\$1KEY\$1PATH*, --key-path *SSH\$1KEY\$1PATH*** Caminho da chave SSH a ser usada para a conexão. A chave deve ser aquela especificada no momento da criação do cluster no parâmetro de configuração [`key_name`](cluster-definition.md#key-name). Este argumento é opcional, mas, se não for especificado, a chave deverá estar disponível por padrão para o cliente SSH. Por exemplo, adicione-o ao `ssh-agent` com `ssh-add`. **-r *REGION*, --region** *REGION* Especifica o a Região da AWS ser usado. O padrão é o Região da AWS especificado usando o [`pcluster configure`](pcluster.configure.md) comando. **-s, --show-url** Exibe um URL único para conectar-se à sessão do Amazon DCV. O navegador padrão não é aberto quando essa opção é especificada. Support para o `--show-url` argumento foi adicionado na AWS ParallelCluster versão 2.5.1. **Exemplo usando a AWS ParallelCluster versão 2.11.7:** ``` $ pcluster dcv connect -k ~/.ssh/id_rsa mycluster ``` Abre o navegador padrão para se conectar à sessão do Amazon DCV em execução no nó principal. Uma nova sessão do Amazon DCV será criada se uma ainda não tiver sido iniciada. ![\[A screenshot of the DCV console.\]](http://docs.aws.amazon.com/pt_br/parallelcluster/v2/ug/images/Dcv-image.png) # `pcluster delete` Exclui um cluster. ``` pcluster delete [ -h ] [ -c CONFIG_FILE ] [ -r REGION ] [ -nw ] cluster_name ``` ## Argumentos posicionais ***cluster\$1name*** Especifica o nome do cluster a ser excluído. ## Argumentos nomeados **-h, --help** Mostra o texto de ajuda para `pcluster delete`. **-c *CONFIG\$1FILE*, --config *CONFIG\$1FILE*** Especifica o arquivo de configuração alternativo a ser usado. O padrão é `~/.parallelcluster/config`. **--keep-logs** Mantenha os dados do CloudWatch Logs depois de excluir o cluster. O grupo de logs permanece até que você o exclua manualmente, mas os eventos de log expirarão com base na configuração [`retention_days`](cw-log-section.md#cw-log-section-retention-days). A configuração padrão será de 14 dias. O suporte para o argumento **--keep-logs** foi adicionado ao AWS ParallelCluster versão 2.6.0. **-r *REGION*, --region *REGION*** Especifica o a Região da AWS ser usado. O padrão é o Região da AWS especificado usando o [`pcluster configure`](pcluster.configure.md) comando. Quando o comando é chamado e começa a sondar o status dessa chamada, é seguro usar "Ctrl\$1C" para sair. Você pode voltar a visualizar o status atual chamando `pcluster status mycluster`. **Exemplo usando a AWS ParallelCluster versão 2.11.7:** ``` $ pcluster delete -c path/to/config -r us-east-1 mycluster Deleting: mycluster Status: RootRole - DELETE_COMPLETE Cluster deleted successfully. ``` Para excluir os recursos de rede na VPC, você pode excluir a pilha CloudFormation de rede. O nome da pilha começa com”parallelclusternetworking-“e contém a hora da criação no formato “YYYYMMDDHHMMSS”. Você pode listar as pilhas usando o comando [list-stacks](https://docs.aws.amazon.com/goto/aws-cli/cloudformation-2010-05-15/ListStacks). ``` $ aws --region us-east-1 cloudformation list-stacks \ --stack-status-filter "CREATE_COMPLETE" \ --query "StackSummaries[].StackName" | \ grep -e "parallelclusternetworking-" "parallelclusternetworking-pubpriv-20191029205804" ``` A pilha pode ser excluída usando o comando [delete-stack](https://docs.aws.amazon.com/goto/aws-cli/cloudformation-2010-05-15/DeleteStack). ``` $ aws --region us-east-1 cloudformation delete-stack \ --stack-name parallelclusternetworking-pubpriv-20191029205804 ``` A VPC que [`pcluster configure`](pcluster.configure.md) cria para você não é criada na pilha de CloudFormation rede. Você pode excluir essa VPC manualmente no console ou usando a AWS CLI. ``` $ aws --region us-east-1 ec2 delete-vpc --vpc-id vpc-0b4ad9c4678d3c7ad ``` # `pcluster instances` Exibe uma lista de todas as instâncias de um cluster. ``` pcluster instances [ -h ] [ -c CONFIG_FILE ] [ -r REGION ] cluster_name ``` ## Argumentos posicionais ***cluster\$1name*** Exibe as instâncias do cluster com o nome fornecido. ## Argumentos nomeados **-h, --help** Mostra o texto de ajuda para `pcluster instances`. **-c *CONFIG\$1FILE*, --config *CONFIG\$1FILE*** Especifica o arquivo de configuração alternativo a ser usado. O padrão é `~/.parallelcluster/config`. **-r *REGION*, --region *REGION*** Especifica o a Região da AWS ser usado. O padrão é o Região da AWS especificado usando o [`pcluster configure`](pcluster.configure.md) comando. **Exemplo usando a AWS ParallelCluster versão 2.11.7:** ``` $ pcluster instances -c path/to/config -r us-east-1 mycluster MasterServer i-1234567890abcdef0 ComputeFleet i-abcdef01234567890 ``` # `pcluster list` Exibe uma lista das pilhas associadas a. AWS ParallelCluster ``` pcluster list [ -h ] [ -c CONFIG_FILE ] [ -r REGION ] ``` ## Argumentos nomeados **-h, --help** Mostra o texto de ajuda para `pcluster list`. **--color** Exibe o status do cluster em cores. O padrão é `False`. **-c *CONFIG\$1FILE*, --config *CONFIG\$1FILE*** Especifica o arquivo de configuração alternativo a ser usado. O padrão é `c`. **-r *REGION*, --region *REGION*** Especifica o a Região da AWS ser usado. O padrão é o Região da AWS especificado usando o [`pcluster configure`](pcluster.configure.md) comando. Lista o nome de todas as AWS CloudFormation pilhas nomeadas`parallelcluster-*`. **Exemplo usando a AWS ParallelCluster versão 2.11.7:** ``` $ pcluster list -c path/to/config -r us-east-1 mycluster CREATE_IN_PROGRESS 2.11.7 myothercluster CREATE_IN_PROGRESS 2.11.7 ``` # `pcluster ssh` Executa um comando `ssh` com o nome de usuário e o endereço IP do cluster pré-preenchidos. Os argumentos arbitrários são anexados ao final do comando `ssh`. Esse comando pode ser personalizado na seção de aliases do arquivo de configuração. ``` pcluster ssh [ -h ] [ -d ] [ -r REGION ] cluster_name ``` ## Argumentos posicionais ***cluster\$1name*** Especifica o nome do cluster ao qual conectar-se. ## Argumentos nomeados **-h, --help** Mostra o texto de ajuda para `pcluster ssh`. **-d, --dryrun** Imprime o comando que seria executado e sai. O padrão é `False`. **-r *REGION*, --region *REGION*** Especifica o a Região da AWS ser usado. O padrão é a região especificada usando o comando [`pcluster configure`](pcluster.configure.md). **Exemplos usando a AWS ParallelCluster versão 2.11.7:** ``` $ pcluster ssh -d mycluster -i ~/.ssh/id_rsa SSH command: ssh ec2-user@1.1.1.1 -i /home/user/.ssh/id_rsa ``` ``` $ pcluster ssh 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 ``` O comando `ssh` é definido no arquivo de configuração global em [Seção `[aliases]`](aliases.md). Ele pode ser personalizado da maneira indicada a seguir. ``` [ aliases ] ssh = ssh {CFN_USER}@{MASTER_IP} {ARGS} ``` Variáveis substituídas: `CFN_USER` O nome de usuário para o [`base_os`](cluster-definition.md#base-os) que está selecionado. `MASTER_IP` O endereço IP do nó principal. `ARGS` Os argumentos opcionais a serem passados para o comando `ssh`. # `pcluster start` Inicia a frota de computação para um cluster que foi interrompido. ``` pcluster start [ -h ] [ -c CONFIG_FILE ] [ -r REGION ] cluster_name ``` ## Argumentos posicionais ***cluster\$1name*** Inicia a frota de computação do nome de cluster fornecido. ## Argumentos nomeados **-h, --help** Mostra o texto de ajuda para `pcluster start`. **-c *CONFIG\$1FILE*, --config *CONFIG\$1FILE*** Especifica o arquivo de configuração alternativo a ser usado. O padrão é `~/.parallelcluster/config`. **-r *REGION*, --region *REGION*** Especifica o a Região da AWS ser usado. O padrão é o Região da AWS especificado usando o [`pcluster configure`](pcluster.configure.md) comando. **Exemplo usando a AWS ParallelCluster versão 2.11.7:** ``` $ pcluster start mycluster Compute fleet status is: RUNNING. Submitting status change request. Request submitted successfully. It might take a while for the transition to complete. Please run 'pcluster status' if you need to check compute fleet status ``` Esse comando define os parâmetros do Grupo do Auto Scaling para um dos seguintes: + Os valores da configuração inicial (`max_queue_size` e `initial_queue_size`) a partir do modelo que foi usado para criar o cluster. + Os valores de configuração que foram usados para atualizar o cluster desde que foi criado pela primeira vez. # `pcluster status` Recebe o status atual do cluster. ``` pcluster status [ -h ] [ -c CONFIG_FILE ] [ -r REGION ] [ -nw ] cluster_name ``` ## Argumentos posicionais **cluster\$1name** Mostra o status do cluster com o nome fornecido. ## Argumentos nomeados **-h, --help** Mostra o texto de ajuda para `pcluster status`. **-c *CONFIG\$1FILE*, `--config` *CONFIG\$1FILE*** Especifica o arquivo de configuração alternativo a ser usado. O padrão é `~/.parallelcluster/config`. **-r *REGION*, --region *REGION*** Especifica o a Região da AWS ser usado. O padrão é o Região da AWS especificado usando o [`pcluster configure`](pcluster.configure.md) comando. **-nw, --nowait** Indica para não aguardar eventos de pilha depois de processar um comando de pilha. O padrão é `False`. **Exemplo usando a AWS ParallelCluster versão 2.11.7:** ``` $ pcluster status -c path/to/config -r us-east-1 mycluster Status: ComputeFleetHITSubstack - CREATE_IN_PROGRESS ``` # `pcluster stop` Interrompe a frota de computação, deixando o nó principal em execução. ``` pcluster stop [ -h ] [ -c CONFIG_FILE ] [ -r REGION ] cluster_name ``` ## Argumentos posicionais ***cluster\$1name*** Interrompe a frota de computação do nome de cluster fornecido. **Exemplo usando a AWS ParallelCluster versão 2.11.7:** ## Argumentos nomeados **-h, --help** Mostra o texto de ajuda para `pcluster stop`. **-c *CONFIG\$1FILE*, --config *CONFIG\$1FILE*** Especifica o arquivo de configuração alternativo a ser usado. O padrão é `~/.parallelcluster/config`. **-r *REGION*, --region *REGION*** Especifica o a Região da AWS ser usado. O padrão é o Região da AWS especificado usando o [`pcluster configure`](pcluster.configure.md) comando. ``` $ pcluster stop mycluster Compute fleet status is: STOPPED. Submitting status change request. Request submitted successfully. It might take a while for the transition to complete. Please run 'pcluster status' if you need to check compute fleet status ``` Define os parâmetros do grupo Auto Scaling como min/max/desired = 0/0/0 e encerra a frota de computação. O cabeçalho permanece em execução. Para encerrar todos os EC2 recursos e evitar EC2 cobranças, considere excluir o cluster. # `pcluster update` Analisa o arquivo de configuração para determinar se o cluster pode ser atualizado com segurança. Se a análise determinar que o cluster pode ser atualizado, precisará confirmar a alteração. Se a análise mostrar que o cluster não pode ser atualizado, as configurações que são a origem dos conflitos são enumeradas com detalhes. Para obter mais informações, consulte [Usar o `pcluster update`](using-pcluster-update.md). ``` pcluster update [ -h ] [ -c CONFIG_FILE ] [ --force ] [ -r REGION ] [ -nr ] [ -nw ] [ -t CLUSTER_TEMPLATE ] [ -p EXTRA_PARAMETERS ] [ -rd ] [ --yes ] cluster_name ``` ## Argumentos posicionais ***cluster\$1name*** Especifica o nome do cluster a ser atualizado. ## Argumentos nomeados **-h, --help** Mostra o texto de ajuda para `pcluster update`. **-c *CONFIG\$1FILE*, --config *CONFIG\$1FILE*** Especifica o arquivo de configuração alternativo a ser usado. O padrão é `~/.parallelcluster/config`. **--force** Habilita uma atualização mesmo se uma ou mais configurações tiverem uma alteração de bloqueio ou se for necessária uma ação pendente (como interromper a frota de computação) antes que a atualização possa continuar. Isso não deve ser combinado com o argumento `--yes`. **-r *REGION*, --region *REGION*** Especifica o a Região da AWS ser usado. O padrão é o Região da AWS especificado usando o [`pcluster configure`](pcluster.configure.md) comando. **-nr, --norollback** Desativa a reversão AWS CloudFormation da pilha em caso de erro. O padrão é `False`. **-nw, --nowait** Indica para não aguardar eventos de pilha depois de processar um comando de pilha. O padrão é `False`. **-t *CLUSTER\$1TEMPLATE*, --cluster-template *CLUSTER\$1TEMPLATE*** Especifica a seção do modelo de cluster a ser usada. **-p *EXTRA\$1PARAMETERS*, --extra-parameters *EXTRA\$1PARAMETERS*** Adiciona parâmetros adicionais a uma atualização de pilha. **-rd, --reset-desired** Redefine a capacidade atual de um Grupo do Auto Scaling para os valores da configuração inicial. O padrão é `False`. **--yes** Pressupõe automaticamente que a resposta a todos os avisos é sim. Isso não deve ser combinado com o argumento `--force`. ``` $ pcluster update -c path/to/config mycluster Retrieving configuration from CloudFormation for cluster mycluster... Validating configuration file .parallelcluster/config... Found Configuration Changes: # parameter old value new value --- -------------------------- ----------- ----------- [compute_resource default] 01 min_count 1 2 02 max_count 5 12 Validating configuration update... Congratulations! The new configuration can be safely applied to your cluster. Do you want to proceed with the update? - Y/N: Y Updating: mycluster Calling update_stack Status: parallelcluster-mycluster - UPDATE_COMPLETE ``` Quando o comando é chamado e começa a sondar o status dessa chamada, é seguro usar "Ctrl\$1C" para sair. Você pode voltar a visualizar o status atual chamando `pcluster status mycluster`. # `pcluster version` Exibe a AWS ParallelCluster versão. ``` pcluster version [ -h ] ``` Para sinalizadores específicos de comando, execute: `pcluster [command] –-help`. ## Argumentos nomeados **-h, --help** Mostra o texto de ajuda para `pcluster version`. Quando o comando é chamado e começa a sondar o status dessa chamada, é seguro usar "Ctrl\$1C" para sair. Você pode voltar a visualizar o status atual chamando `pcluster status mycluster`. ``` $ pcluster version 2.11.7 ```