

Les traductions sont fournies par des outils de traduction automatique. En cas de conflit entre le contenu d'une traduction et celui de la version originale en anglais, la version anglaise prévaudra.

# `pcluster`
<a name="pcluster"></a>

`pcluster`est la principale commande de la AWS ParallelCluster CLI. Vous pouvez `pcluster` lancer et gérer des clusters HPC dans le AWS Cloud.

```
pcluster [ -h ] ( create | update | delete | start | stop | status | list |
                  instances | ssh | dcv | createami | configure | version ) ...
```

## Arguments
<a name="pcluster.arguments"></a>

**`pcluster command`**  
Choix possibles : [`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)

## Sous-commandes :
<a name="pcluster.subcommands"></a>

**Topics**
+ [

## Arguments
](#pcluster.arguments)
+ [

## Sous-commandes :
](#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`
<a name="pcluster.configure"></a>

Commence une AWS ParallelCluster configuration. Pour de plus amples informations, veuillez consulter [Configuration AWS ParallelCluster](getting-started-configuring-parallelcluster.md).

```
pcluster configure [ -h ] [ -c CONFIG_FILE ] [ -r REGION ]
```

## Arguments nommés
<a name="pcluster.configure.namedargs"></a>

**-h, --help**  
Affiche le texte d'aide pour`pcluster configure`.

**-c * CONFIG\$1FILE*, --config *CONFIG\$1FILE***  
Spécifie le chemin complet de l'autre fichier de configuration à utiliser.  
La valeur par défaut est `~/.parallelcluster/config`.  
Pour de plus amples informations, veuillez consulter [Configuration AWS ParallelCluster](getting-started-configuring-parallelcluster.md).

**-r *REGION*, --region *REGION***  
Spécifie le Région AWS à utiliser. Si cela est spécifié, la configuration ignore la Région AWS détection.

Pour supprimer les ressources réseau du VPC, vous pouvez supprimer la pile CloudFormation réseau. Le nom de la pile commence par »parallelclusternetworking-» et contient l'heure de création au format « YYYYMMDDHHMMSS ». Vous pouvez répertorier les piles à l'aide de la commande [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"
```

La pile peut être supprimée à l'aide de la commande [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
```

Le VPC [`pcluster configure`](#pcluster.configure) créé pour vous n'est pas créé dans la pile CloudFormation réseau. Vous pouvez supprimer ce VPC manuellement dans la console ou à l'aide du. AWS CLI

```
$ aws --region us-east-1 ec2 delete-vpc --vpc-id vpc-0b4ad9c4678d3c7ad
```

# `pcluster create`
<a name="pluster.create"></a>

Crée un nouveau cluster.

```
pcluster create [ -h ] [ -c CONFIG_FILE ] [ -r REGION ] [ -nw ] [ -nr ]
                [ -u TEMPLATE_URL ] [ -t CLUSTER_TEMPLATE ]
                [ -p EXTRA_PARAMETERS ] [ -g TAGS ]
                cluster_name
```

## Arguments positionnels
<a name="pluster.create.arg"></a>

***cluster\$1name***  
Définit le nom du cluster. Le nom de la AWS CloudFormation pile est`parallelcluster-cluster_name`.

## Arguments nommés
<a name="pluster.create.namedarg"></a>

**-h, --help**  
Affiche le texte d'aide pour`pcluster create`.

**-c *CONFIG\$1FILE*, --config *CONFIG\$1FILE***  
Spécifie l'autre fichier de configuration à utiliser.  
La valeur par défaut est `~/.parallelcluster/config`.

**-r *REGION*, --region *REGION***  
Spécifie le Région AWS à utiliser. L'ordre de priorité utilisé pour sélectionner le Région AWS pour un nouveau cluster est le suivant :  

1. `-r`ou `--region` paramètre to[`pcluster create`](#pluster.create).

1. `AWS_DEFAULT_REGION`variable d'environnement.

1. `aws_region_name`paramètre dans `[aws]` la section du fichier de AWS ParallelCluster configuration (l'emplacement par défaut est`~/.parallelcluster/config`.) Il s'agit de l'emplacement mis à jour par la [`pcluster configure`](pcluster.configure.md) commande.

1. `region`réglage dans `[default]` la section du fichier de AWS CLI configuration (`~/.aws/config`.)

**-nw, --nowait**  
Indique de ne pas attendre les événements de pile après avoir exécuté une commande de pile.  
La valeur par défaut est `False`.

**-nr, --norollback**  
Désactive la restauration de la pile en cas d'erreur.  
La valeur par défaut est `False`.

**-u *TEMPLATE\$1URL*, --template-url *TEMPLATE\$1URL***  
Spécifie une URL pour le AWS CloudFormation modèle personnalisé s'il a été utilisé lors de sa création.

**-t *CLUSTER\$1TEMPLATE*, --cluster-template *CLUSTER\$1TEMPLATE***  
Indique le cluster de modèle à utiliser.

**-p *EXTRA\$1PARAMETERS*, --extra-parameters *EXTRA\$1PARAMETERS***  
Ajoute des paramètres supplémentaires pour créer la pile.

**-g *TAGS*, --tags *TAGS***  
Spécifie des balises supplémentaires à ajouter à la pile.

Lorsque la commande est appelée et commence à demander l'état de cet appel, vous pouvez utiliser « Ctrl-C » pour quitter l'appel en toute sécurité. Vous pouvez revenir à l'affichage du statut actuel en appelant `pcluster status mycluster`.

**Exemples utilisant AWS ParallelCluster la version 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`
<a name="pcluster.createami"></a>

(Linux/macOS) Crée une AMI personnalisée à utiliser avec. 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 ]
```

## Dépendances requises
<a name="pcluster.createami.required-dependencies"></a>

Outre la AWS ParallelCluster CLI, la dépendance suivante est requise pour fonctionner `pcluster createami` :
+ **Packer** : Téléchargez la dernière version à partir de [https://developer.hashicorp.com/packer/downloads](https://developer.hashicorp.com/packer/downloads).

**Note**  
Avant AWS ParallelCluster la version 2.8.0, [Berkshelf](https://github.com/berkshelf/berkshelf) (installé à l'aide de`gem install berkshelf`) devait être utilisé. `pcluster createami`

## Arguments nommés
<a name="pcluster.createami.namedarg"></a>

**-h, --help**  
Affiche le texte d'aide pour`pcluster createami`.

**-ai *BASE\$1AMI\$1ID*, --ami-id *BASE\$1AMI\$1ID***  
Spécifie l'AMI de base à utiliser pour créer l' AWS ParallelCluster AMI.

**-os *BASE\$1AMI\$1OS*, --os *BASE\$1AMI\$1OS***  
Spécifie le système d'exploitation de l'AMI de base. Les options valides sont : `alinux2`, `ubuntu1804`, `ubuntu2004` et `centos7`.  
Le système d'exploitation prend en charge les modifications dans AWS ParallelCluster les différentes versions :  
+ Support pour `centos8` a été supprimé dans la AWS ParallelCluster version 2.10.4.
+ Support pour `centos8` a été ajouté, et le support pour `centos6` a été supprimé dans la AWS ParallelCluster version 2.10.0.
+ Support pour alinux2 a été ajouté dans AWS ParallelCluster la version 2.6.0.
+ Support pour ubuntu1804 a été ajouté dans la version 2.5.0. AWS ParallelCluster 

**-i *INSTANCE\$1TYPE*, --instance-type *INSTANCE\$1TYPE***  
Spécifie le type d'instance à utiliser pour créer l'AMI.  
La valeur par défaut est `t2.xlarge`.  
Support pour `--instance-type` cet argument a été ajouté dans la AWS ParallelCluster version 2.4.1.

**-ap *CUSTOM\$1AMI\$1NAME\$1PREFIX*, --ami-name-prefix *CUSTOM\$1AMI\$1NAME\$1PREFIX***  
Spécifie le nom du préfixe de l' AWS ParallelCluster AMI résultante.  
La valeur par défaut est `custom-ami-`.

**-cc *CUSTOM\$1AMI\$1COOKBOOK*, --custom-cookbook *CUSTOM\$1AMI\$1COOKBOOK***  
Spécifie le livre de recettes à utiliser pour créer l' AWS ParallelCluster AMI.

**--post-install *POST\$1INSTALL\$1SCRIPT***  
Spécifie le chemin d'accès au script de post-installation. Les chemins doivent utiliser un schéma d'`file://`URL `s3://``https://`, ou. Voici quelques exemples :  
+ `https://bucket-name.s3.region.amazonaws.com/path/post_install.sh`
+ `s3://bucket-name/post_install.sh`
+ `file:///opt/project/post_install.sh`
Support pour `--post-install` cet argument a été ajouté dans la AWS ParallelCluster version 2.10.0.

**--no-public-ip**  
N'associez pas d'adresse IP publique à l'instance utilisée pour créer l'AMI. Par défaut, une adresse IP publique est associée à l'instance.  
Support pour `--no-public-ip` cet argument a été ajouté dans la AWS ParallelCluster version 2.5.0.

**-c *CONFIG\$1FILE*, --config *CONFIG\$1FILE***  
Spécifie l'autre fichier de configuration à utiliser.  
La valeur par défaut est `~/.parallelcluster/config`.

**-t *CLUSTER\$1TEMPLATE*, --cluster-template *CLUSTER\$1TEMPLATE***  
Spécifie la [section [`cluster`]](cluster-definition.md) *CONFIG\$1FILE* à utiliser pour récupérer les paramètres du VPC et du sous-réseau.  
Support pour `--cluster-template` cet argument a été ajouté dans la AWS ParallelCluster version 2.4.0.

**--vpc-id *VPC\$1ID***  
Spécifie l'ID du VPC à utiliser pour créer l'AMI AWS ParallelCluster .  
Support pour `--vpc-id` cet argument a été ajouté dans la AWS ParallelCluster version 2.5.0.

**--subnet-id *SUBNET\$1ID***  
Spécifie l'ID du sous-réseau à utiliser pour créer l' AWS ParallelCluster AMI.  
Support pour `--vpc-id` cet argument a été ajouté dans la AWS ParallelCluster version 2.5.0.

**-r *REGION*, --region** *REGION*  
Spécifie le Région AWS à utiliser. La valeur par défaut est celle Région AWS spécifiée à l'aide de la [`pcluster configure`](pcluster.configure.md) commande.

# `pcluster dcv`
<a name="pcluster.dcv"></a>

Interagit avec le serveur Amazon DCV exécuté sur le nœud principal.

```
pcluster dcv [ -h ] ( connect )
```

**`pcluster dcv command`**  
Choix possibles : [`connect`](#pcluster-dcv-connect)

**Note**  
Le système d'exploitation prend en charge les modifications apportées à la `pcluster dcv` commande dans différentes AWS ParallelCluster versions :  
Support pour la `pcluster dcv` commande on `centos8` a été ajouté dans la AWS ParallelCluster version 2.10.0.
Support de la `pcluster dcv` commande sur les instances AWS basées sur Graviton a été ajouté dans la AWS ParallelCluster version 2.9.0.
Support pour la `pcluster dcv` commande on `ubuntu1804` a été ajouté dans la AWS ParallelCluster version 2.6.0.
Support pour la `pcluster dcv` commande on `centos7` a été ajouté dans la AWS ParallelCluster version 2.5.0.

## Arguments nommés
<a name="pcluster.dcv.namedarg"></a>

**-h, --help**  
Affiche le texte d'aide pour`pcluster dcv`.

## Sous-commandes
<a name="pcluster-dcv-subcommands"></a>

### `pcluster dcv connect`
<a name="pcluster-dcv-connect"></a>

```
pcluster dcv connect [ -h ] [ -k SSH_KEY_PATH ] [ -r REGION ] cluster_name
```

**Important**  
L'URL expire 30 secondes après sa publication. Si la connexion n'est pas établie avant l'expiration de l'URL, `pcluster dcv connect` réexécutez pour générer une nouvelle URL.

#### Arguments positionnels
<a name="pcluster.dcv.connect.arg"></a>

***cluster\$1name***  
Spécifie le nom du cluster auquel se connecter.

#### Arguments nommés
<a name="pcluster.dcv.connect.namedarg"></a>

**-h, --help**  
Affiche le texte d'aide pour`pcluster dcv connect`.

**-k *SSH\$1KEY\$1PATH*, --key-path *SSH\$1KEY\$1PATH***  
Chemin de la clé SSH à utiliser pour la connexion.  
La clé doit être celle spécifiée au moment de la création du cluster dans le paramètre de configuration [`key_name`](cluster-definition.md#key-name). Cet argument est facultatif, mais s'il n'est pas spécifié, la clé doit être disponible par défaut pour le client SSH. Par exemple, ajoutez-le à `ssh-agent` à l'aide de `ssh-add`.

**-r *REGION*, --region** *REGION*  
Spécifie le Région AWS à utiliser. La valeur par défaut est celle Région AWS spécifiée à l'aide de la [`pcluster configure`](pcluster.configure.md) commande.

**-s, --show-url**  
Affiche une URL à usage unique permettant de se connecter à la session Amazon DCV. Le navigateur par défaut n'est pas ouvert lorsque cette option est spécifiée.  
Support pour `--show-url` cet argument a été ajouté dans la AWS ParallelCluster version 2.5.1.

**Exemple utilisant AWS ParallelCluster la version 2.11.7 :**

```
$ pcluster dcv connect -k ~/.ssh/id_rsa mycluster
```

Ouvre le navigateur par défaut pour se connecter à la session Amazon DCV exécutée sur le nœud principal.

Une nouvelle session Amazon DCV est créée si ce n'est pas déjà fait.

 ![\[A screenshot of the DCV console.\]](http://docs.aws.amazon.com/fr_fr/parallelcluster/v2/ug/images/Dcv-image.png) 

# `pcluster delete`
<a name="pcluster.delete"></a>

Supprime un cluster.

```
pcluster delete [ -h ] [ -c CONFIG_FILE ] [ -r REGION ] [ -nw ] cluster_name
```

## Arguments positionnels
<a name="pcluster.delete.arg"></a>

***cluster\$1name***  
Spécifie le nom du cluster à supprimer.

## Arguments nommés
<a name="pcluster.delete.namedarg"></a>

**-h, --help**  
Affiche le texte d'aide pour`pcluster delete`.

**-c *CONFIG\$1FILE*, --config *CONFIG\$1FILE***  
Spécifie l'autre fichier de configuration à utiliser.  
La valeur par défaut est `~/.parallelcluster/config`.

**--keep-logs**  
Conservez les données des CloudWatch journaux après avoir supprimé le cluster. Le groupe de journaux est conservé jusqu'à ce que vous le supprimiez manuellement, mais les événements du journal expirent en fonction du [`retention_days`](cw-log-section.md#cw-log-section-retention-days) paramètre. Le paramètre par défaut est de 14 jours.  
Support pour **--keep-logs** cet argument a été ajouté dans la AWS ParallelCluster version 2.6.0.

**-r *REGION*, --region *REGION***  
Spécifie le Région AWS à utiliser. La valeur par défaut est celle Région AWS spécifiée à l'aide de la [`pcluster configure`](pcluster.configure.md) commande.

Lorsque la commande est appelée et commence à demander l'état de cet appel, vous pouvez utiliser « Ctrl-C » pour quitter l'appel en toute sécurité. Vous pouvez revenir à l'affichage du statut actuel en appelant `pcluster status mycluster`.

**Exemple utilisant AWS ParallelCluster la version 2.11.7 :**

```
$ pcluster delete -c path/to/config -r us-east-1 mycluster
Deleting: mycluster
Status: RootRole - DELETE_COMPLETE                                              
Cluster deleted successfully.
```

Pour supprimer les ressources réseau du VPC, vous pouvez supprimer la pile CloudFormation réseau. Le nom de la pile commence par »parallelclusternetworking-» et contient l'heure de création au format « YYYYMMDDHHMMSS ». Vous pouvez répertorier les piles à l'aide de la commande [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"
```

La pile peut être supprimée à l'aide de la commande [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
```

Le VPC [`pcluster configure`](pcluster.configure.md) créé pour vous n'est pas créé dans la pile CloudFormation réseau. Vous pouvez supprimer ce VPC manuellement dans la console ou à l'aide du. AWS CLI

```
$ aws --region us-east-1 ec2 delete-vpc --vpc-id vpc-0b4ad9c4678d3c7ad
```

# `pcluster instances`
<a name="pcluster.instances"></a>

Affiche la liste de toutes les instances d'un cluster.

```
pcluster instances [ -h ] [ -c CONFIG_FILE ] [ -r REGION ] cluster_name
```

## Arguments positionnels
<a name="pcluster.instances.arg"></a>

***cluster\$1name***  
Affiche les instances du cluster dont le nom est fourni.

## Arguments nommés
<a name="pcluster.instances.namedarg"></a>

**-h, --help**  
Affiche le texte d'aide pour`pcluster instances`.

**-c *CONFIG\$1FILE*, --config *CONFIG\$1FILE***  
Spécifie l'autre fichier de configuration à utiliser.  
La valeur par défaut est `~/.parallelcluster/config`.

**-r *REGION*, --region *REGION***  
Spécifie le Région AWS à utiliser. La valeur par défaut est celle Région AWS spécifiée à l'aide de la [`pcluster configure`](pcluster.configure.md) commande.

**Exemple utilisant AWS ParallelCluster la version 2.11.7 :**

```
$ pcluster instances -c path/to/config -r us-east-1 mycluster
MasterServer         i-1234567890abcdef0
ComputeFleet         i-abcdef01234567890
```

# `pcluster list`
<a name="pcluster.list"></a>

Affiche la liste des piles associées AWS ParallelClusterà.

```
pcluster list [ -h ] [ -c CONFIG_FILE ] [ -r REGION ]
```

## Arguments nommés
<a name="pcluster.list.namedarg"></a>

**-h, --help**  
Affiche le texte d'aide pour`pcluster list`.

**--color**  
Affiche le statut du cluster en couleur.  
La valeur par défaut est `False`.

**-c *CONFIG\$1FILE*, --config *CONFIG\$1FILE***  
Spécifie l'autre fichier de configuration à utiliser.  
La valeur par défaut est `c`.

**-r *REGION*, --region *REGION***  
Spécifie le Région AWS à utiliser. La valeur par défaut est celle Région AWS spécifiée à l'aide de la [`pcluster configure`](pcluster.configure.md) commande.

Répertorie le nom de toutes les AWS CloudFormation piles nommées`parallelcluster-*`.

**Exemple utilisant AWS ParallelCluster la version 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`
<a name="pcluster.ssh"></a>

Exécute une commande `ssh` avec le nom d'utilisateur et l'adresse IP du cluster préremplis. Des arguments arbitraires sont ajoutés à la fin de la commande `ssh`. Cette commande peut être personnalisée dans la section des alias du fichier de configuration.

```
pcluster ssh [ -h ] [ -d ] [ -r REGION ] cluster_name
```

## Arguments positionnels
<a name="pcluster.ssh.arg"></a>

***cluster\$1name***  
Spécifie le nom du cluster auquel se connecter.

## Arguments nommés
<a name="pcluster.ssh.namedarg"></a>

**-h, --help**  
Affiche le texte d'aide pour`pcluster ssh`.

**-d, --dryrun**  
Imprime la commande qui sera exécutée et quitte.  
La valeur par défaut est `False`.

**-r *REGION*, --region *REGION***  
Spécifie le Région AWS à utiliser. La valeur par défaut est la région spécifiée à l'aide de la commande [`pcluster configure`](pcluster.configure.md).

**Exemples utilisant AWS ParallelCluster la version 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
```

Exécute la `ssh` commande avec le nom d'utilisateur et l'adresse IP du cluster préremplis :

```
ssh ec2-user@1.1.1.1 -i ~/.ssh/id_rsa
```

La commande `ssh` est définie dans le fichier de configuration globale sous [`[aliases]` Section](aliases.md). Elle peut être personnalisée comme suit.

```
[ aliases ]
ssh = ssh {CFN_USER}@{MASTER_IP} {ARGS}
```

Variables substituées :

`CFN_USER`  
Nom d'utilisateur pour le [`base_os`](cluster-definition.md#base-os) sélectionné.

`MASTER_IP`  
Adresse IP du nœud principal.

`ARGS`  
Arguments facultatifs à transmettre à la commande `ssh`.

# `pcluster start`
<a name="pcluster.start"></a>

Démarre le parc d'instances de calcul pour un cluster qui a été arrêté.

```
pcluster start [ -h ] [ -c CONFIG_FILE ] [ -r REGION ] cluster_name
```

## Arguments positionnels
<a name="pcluster.start.arg"></a>

***cluster\$1name***  
Démarre le parc d'instances de calcul du nom de cluster fourni.

## Arguments nommés
<a name="pcluster.start.namedarg"></a>

**-h, --help**  
Affiche le texte d'aide pour`pcluster start`.

**-c *CONFIG\$1FILE*, --config *CONFIG\$1FILE***  
Spécifie l'autre fichier de configuration à utiliser.  
La valeur par défaut est `~/.parallelcluster/config`.

**-r *REGION*, --region *REGION***  
Spécifie le Région AWS à utiliser. La valeur par défaut est celle Région AWS spécifiée à l'aide de la [`pcluster configure`](pcluster.configure.md) commande.

**Exemple utilisant AWS ParallelCluster la version 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
```

Cette commande définit les paramètres du groupe Auto Scaling comme suit : 
+ Les valeurs de configuration initiale (`max_queue_size` et `initial_queue_size`) à partir du modèle qui a été utilisé pour créer le cluster.
+ Les valeurs de configuration qui ont été utilisées pour mettre à jour le cluster depuis sa première création.

# `pcluster status`
<a name="pcluster.status"></a>

Extrait le statut actuel du cluster.

```
pcluster status [ -h ] [ -c CONFIG_FILE ] [ -r REGION ] [ -nw ] cluster_name
```

## Arguments positionnels
<a name="pcluster.status.posarg"></a>

**cluster\$1name**  
Indique le statut du cluster dont le nom est fourni.

## Arguments nommés
<a name="pcluster.status.namedarg"></a>

**-h, --help**  
Affiche le texte d'aide pour`pcluster status`.

**-c *CONFIG\$1FILE*, `--config` *CONFIG\$1FILE***  
Spécifie l'autre fichier de configuration à utiliser.  
La valeur par défaut est `~/.parallelcluster/config`.

**-r *REGION*, --region *REGION***  
Spécifie le Région AWS à utiliser. La valeur par défaut est celle Région AWS spécifiée à l'aide de la [`pcluster configure`](pcluster.configure.md) commande.

**-nw, --nowait**  
Indique de ne pas attendre les événements de pile après le traitement d'une commande de pile.  
La valeur par défaut est `False`.

**Exemple utilisant AWS ParallelCluster la version 2.11.7 :**

```
$ pcluster status -c path/to/config -r us-east-1 mycluster
Status: ComputeFleetHITSubstack - CREATE_IN_PROGRESS
```

# `pcluster stop`
<a name="pcluster.stop"></a>

Arrête le parc informatique, laissant le nœud principal fonctionner.

```
pcluster stop [ -h ] [ -c CONFIG_FILE ] [ -r REGION ] cluster_name
```

## Arguments positionnels
<a name="pcluster.stop.posarg"></a>

***cluster\$1name***  
Arrête le parc d'instances de calcul du nom de cluster fourni.

**Exemple utilisant AWS ParallelCluster la version 2.11.7 :**

## Arguments nommés
<a name="pcluster.stop.namedarg"></a>

**-h, --help**  
Affiche le texte d'aide pour`pcluster stop`.

**-c *CONFIG\$1FILE*, --config *CONFIG\$1FILE***  
Spécifie l'autre fichier de configuration à utiliser.  
La valeur par défaut est `~/.parallelcluster/config`.

**-r *REGION*, --region *REGION***  
Spécifie le Région AWS à utiliser. La valeur par défaut est celle Région AWS spécifiée à l'aide de la [`pcluster configure`](pcluster.configure.md) commande.

```
$ 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
```

Définit les paramètres du groupe Auto Scaling sur min/max/desired = 0/0/0 et met fin au parc informatique. La tête continue de courir. Pour mettre fin à toutes les EC2 ressources et éviter EC2 des frais, pensez à supprimer le cluster.

# `pcluster update`
<a name="pcluster.update"></a>

Analyse le fichier de configuration pour déterminer si le cluster peut être mis à jour en toute sécurité. Si l'analyse détermine que le cluster peut être mis à jour, vous êtes invité à confirmer la modification. Si l'analyse montre que le cluster ne peut pas être mis à jour, les paramètres de configuration à l'origine des conflits sont énumérés avec des détails. Pour de plus amples informations, veuillez consulter [Utilisation de `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
```

## Arguments positionnels
<a name="pcluster.update.arg"></a>

***cluster\$1name***  
Spécifie le nom du cluster à mettre à jour.

## Arguments nommés
<a name="pcluster.update.namedarg"></a>

**-h, --help**  
Affiche le texte d'aide pour`pcluster update`.

**-c *CONFIG\$1FILE*, --config *CONFIG\$1FILE***  
Spécifie l'autre fichier de configuration à utiliser.  
La valeur par défaut est `~/.parallelcluster/config`.

**--force**  
Active une mise à jour même si un ou plusieurs paramètres présentent une modification bloquante ou si une action en suspens est requise (telle que l'arrêt du parc informatique) avant que la mise à jour ne puisse se poursuivre. Cela ne doit pas être combiné avec l'`--yes`argument.

**-r *REGION*, --region *REGION***  
Spécifie le Région AWS à utiliser. La valeur par défaut est celle Région AWS spécifiée à l'aide de la [`pcluster configure`](pcluster.configure.md) commande.

**-nr, --norollback**  
Désactive la restauration de la AWS CloudFormation pile en cas d'erreur.  
La valeur par défaut est `False`.

**-nw, --nowait**  
Indique de ne pas attendre les événements de pile après le traitement d'une commande de pile.  
La valeur par défaut est `False`.

**-t *CLUSTER\$1TEMPLATE*, --cluster-template *CLUSTER\$1TEMPLATE***  
Spécifie la section du modèle de cluster à utiliser.

**-p *EXTRA\$1PARAMETERS*, --extra-parameters *EXTRA\$1PARAMETERS***  
Ajoute des paramètres supplémentaires à une mise à jour de pile.

**-rd, --reset-desired**  
Réinitialise la capacité actuelle d'un groupe Auto Scaling sur les valeurs de configuration initiale.  
La valeur par défaut est `False`.

**--yes**  
Suppose automatiquement que la réponse à toutes les questions est « oui ». Cela ne doit pas être combiné avec l'`--force`argument.

```
$ 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
```

Lorsque la commande est appelée et commence à demander l'état de cet appel, vous pouvez utiliser « Ctrl-C » pour quitter l'appel en toute sécurité. Vous pouvez revenir à l'affichage du statut actuel en appelant `pcluster status mycluster`.

# `pcluster version`
<a name="pcluster.version"></a>

Affiche la AWS ParallelCluster version.

```
pcluster version [ -h ]
```

Pour les indicateurs spécifiques à la commande, exécutez : `pcluster [command] –-help`.

## Arguments nommés
<a name="pcluster.version.named.arguments"></a>

**-h, --help**  
Affiche le texte d'aide pour`pcluster version`.

Lorsque la commande est appelée et commence à demander l'état de cet appel, vous pouvez utiliser « Ctrl-C » pour quitter l'appel en toute sécurité. Vous pouvez revenir à l'affichage du statut actuel en appelant `pcluster status mycluster`.

```
$ pcluster version
2.11.7
```