

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

# Usar o `pcluster update`
<a name="using-pcluster-update"></a>

A partir da AWS ParallelCluster versão 2.8.0, [`pcluster update`](pcluster.update.md) analisa as configurações usadas para criar o cluster atual e as configurações no arquivo de configuração em busca de problemas. Se algum problema for descoberto, ele será relatado e as etapas a serem seguidas para corrigi-los serão exibidas. Por exemplo, se a configuração [`compute_instance_type`](cluster-definition.md#compute-instance-type) for alterada para um tipo de instância diferente, a frota de computação deverá ser interrompida antes que uma atualização possa continuar. Esse problema é relatado quando é descoberto. Se nenhum problema de bloqueio for relatado, você será perguntado se deseja aplicar as alterações.

A documentação de cada configuração define a política de atualização para essa configuração.

**Política de atualização: essas configurações podem ser alteradas durante uma atualização.****Política de atualização: essa configuração pode ser alterada durante uma atualização.**  
Essas configurações podem ser alteradas, e o cluster pode ser atualizado usando o [`pcluster update`](pcluster.update.md).

**Política de atualização: se essa configuração for alterada, a atualização não será permitida.**  
Essas configurações não podem ser alteradas se o cluster existente não tiver sido excluído. A alteração deve ser revertida ou o cluster deve ser excluído (usando [`pcluster delete`](pcluster.delete.md)) e, em seguida, um novo cluster é criado (usando[`pcluster create`](pluster.create.md)) no lugar do antigo cluster.

**Política de atualização: essa configuração não é analisada durante uma atualização.**  
Essas configurações podem ser alteradas, e o cluster pode ser atualizado usando o [`pcluster update`](pcluster.update.md).

**Política de atualização: a frota de computação deve ser interrompida para que essa configuração seja alterada para uma atualização.**  
Essas configurações não podem ser alteradas enquanto a frota de computação existir. A alteração deve ser revertida ou a frota de computação deve ser interrompida (usando [`pcluster stop`](pcluster.stop.md)), atualizada (usando [`pcluster update`](pcluster.update.md)) e, em seguida, uma nova frota de computação é criada (usando [`pcluster start`](pcluster.start.md)).

**Política de atualização: essa configuração não pode ser diminuída durante uma atualização.**  
Essas configurações podem ser alteradas, mas não podem ser diminuídas. Se essas configurações precisarem ser reduzidas, será necessário excluir o cluster (usando [`pcluster delete`](pcluster.delete.md)) e criar um novo cluster (usando [`pcluster create`](pluster.create.md)).

**Política de atualização: reduzir o tamanho de uma fila abaixo do número atual de nós exige que a frota de computação seja interrompida primeiro.**  
Essas configurações podem ser alteradas, mas se a alteração reduzir o tamanho da fila abaixo do tamanho atual, a frota de computação deverá ser interrompida (usando [`pcluster stop`](pcluster.stop.md)), atualizada (usando [`pcluster update`](pcluster.update.md)), e depois uma nova frota de computação é criada (usando [`pcluster start`](pcluster.start.md)).

**Política de atualização: reduzir o número de nós estáticos na fila exige que a frota de computação seja interrompida primeiro.**  
Essas configurações podem ser alteradas, mas se a alteração reduzir o número de nós estáticos na fila abaixo do tamanho atual, a frota de computação deverá ser interrompida (usando [`pcluster stop`](pcluster.stop.md)), atualizada (usando [`pcluster update`](pcluster.update.md)), e depois uma nova frota de computação é criada (usando [`pcluster start`](pcluster.start.md)).

**Política de atualização: se essa configuração for alterada, a atualização não será permitida. A atualização dessa configuração não pode ser forçada.**  
Essas configurações não podem ser alteradas se o cluster existente não tiver sido excluído. A alteração deve ser revertida ou o cluster deve ser excluído (usando [`pcluster delete`](pcluster.delete.md)) e, em seguida, um novo cluster é criado (usando[`pcluster create`](pluster.create.md)) no lugar do antigo cluster.

**Política de atualização: se os sistemas de arquivos AWS ParallelCluster gerenciados do Amazon FSx for Lustre não estiverem especificados na configuração, essa configuração poderá ser alterada durante uma atualização.**  
Essa configuração pode ser alterada se [`[cluster]`[`fsx_settings`](cluster-definition.md#fsx-settings)](cluster-definition.md)não for especificada ou se ambos `fsx_settings` e [`fsx-fs-id`](fsx-section.md#fsx-fs-id)in [`[fsx fs]`](fsx-section.md)forem especificados para montar um sistema de arquivos externo existente FSx para o Lustre.

Este exemplo demonstra uma [`pcluster update`](pcluster.update.md) com algumas alterações que bloqueiam a atualização.

```
$ pcluster update
  Validating configuration file /home/username/.parallelcluster/config...
Retrieving configuration from CloudFormation for cluster test-1...
Found Changes:

#   section/parameter         old value                 new value               
--  ------------------------  ------------------------  ------------------------
    [cluster default]
01* compute_instance_type     t2.micro                  c4.xlarge
02* ebs_settings              ebs2                      -

    [vpc default]
03  additional_sg             sg-0cd61884c4ad16341       sg-0cd61884c4ad11234

    [ebs ebs2]
04* shared_dir                shared                     my/very/very/long/sha...

Validating configuration update...
The requested update cannot be performed. Line numbers with an asterisk indicate 
updates requiring additional actions. Please look at the details below:

#01
Compute fleet must be empty to update "compute_instance_type"
How to fix:
Make sure that there are no jobs running, then run the following command: 
  pcluster stop -c $CONFIG_FILE $CLUSTER_NAME

#02
Cannot add/remove EBS Sections
How to fix:
Revert "ebs_settings" value to "ebs2"

#04
Cannot change the mount dir of an existing EBS volume
How to fix:
Revert "my/very/very/long/shared/dir" to "shared"

In case you want to override these checks and proceed with the update please
use the --force flag. Note that the cluster could end up in an unrecoverable
state.

Update aborted.
```