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`
`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`enregistre les journaux de vos commandes dans `pcluster.log.#` des fichiers`/home/user/.parallelcluster/`. Pour de plus amples informations, veuillez consulter [`pcluster`Journaux de la CLI](troubleshooting-v3-pc-cli-logs.md).
Pour l'utiliser`pcluster`, vous devez disposer d'un rôle IAM doté des [autorisations](iam-roles-in-parallelcluster-v3.md#iam-roles-in-parallelcluster-v3-example-user-policies) requises pour l'exécuter.
```
pcluster [-h]
```
## Arguments
**`pcluster command`**
Choix possibles : [`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`[`describe-cluster`](pcluster.describe-cluster-v3.md)](pcluster.delete-image-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)
**Sous-commandes :**
**Topics**
+ [Arguments](#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`
Créez une AWS ParallelCluster image personnalisée dans la région spécifiée.
```
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}]
```
## Arguments nommés
**-h, --help**
Affiche le texte d'aide pour`pcluster build-image`.
**--image-configuration, -c *IMAGE\$1CONFIGURATION***
Spécifie le fichier de configuration de l'image sous forme de document YAML.
**--image-id, -i *IMAGE\$1ID***
Spécifie l'identifiant de l'image qui sera créée.
**--debug**
Activation de la journalisation du débogage
**--dryrun *DRYRUN***
Lorsque`true`, la commande effectue la validation sans créer de ressources. Vous pouvez l'utiliser pour valider la configuration de l'image. (La valeur par défaut est`false`.)
**--query *QUERY***
JMESPath requête à exécuter en sortie.
**--region, -r *REGION***
Spécifie le Région AWS à utiliser. Région AWS Il doit être spécifié à l'aide du paramètre [Région](image-builder-configuration-file-v3.md#yaml-build-image-Region) du fichier de configuration de l'image, de la variable d'`AWS_DEFAULT_REGION`environnement, du `region` paramètre de la `[default]` section du `~/.aws/config` fichier ou du `--region` paramètre.
**--rollback-on-failure *ROLLBACK\$1ON\$1FAILURE***
Quand`true`, lance automatiquement une restauration de la pile d'images en cas d'échec. (La valeur par défaut est`false`.)
**--suppress-validators * SUPPRESS\$1VALIDATORS* [*SUPPRESS\$1VALIDATORS ...*]**
Identifie un ou plusieurs validateurs de configuration à supprimer.
Format : (`ALL`\$1`type:[A-Za-z0-9]+`)
**--validation-failure-level \$1`INFO`,`WARNING`,`ERROR`\$1**
Spécifie le niveau de validation minimal qui entraînera l'échec de la création. (La valeur par défaut est`ERROR`.)
**Exemple utilisant AWS ParallelCluster la version 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"
}
}
```
**Avertissement**
`pcluster build-image`utilise le VPC par défaut. Si le VPC par défaut a été supprimé, par exemple en utilisant AWS Control Tower ou AWS Landing Zone, l'ID du sous-réseau doit être spécifié dans le fichier de configuration de l'image. Pour de plus amples informations, veuillez consulter [SubnetId](HeadNode-v3.md#yaml-HeadNode-Networking-SubnetId).
# `pcluster configure`
Lance un assistant de configuration interactif pour AWS ParallelCluster la version 3. Pour de plus amples informations, veuillez consulter [Configuration et création d'un cluster à l'aide de l'interface de ligne de AWS ParallelCluster commande](install-v3-configuring.md).
```
pcluster configure [-h]
--config CONFIG
[--debug]
[--region REGION]
```
## Arguments nommés
**-h, --help**
Affiche le texte d'aide pour`pcluster configure`.
**--config *CONFIG***
Chemin de sortie du fichier de configuration généré.
**--debug**
Activation de la journalisation du débogage
**--region, -r *REGION***
Spécifie le Région AWS à utiliser. La région doit être spécifiée à l'aide du paramètre [Région](image-builder-configuration-file-v3.md#yaml-build-image-Region) du fichier de configuration de l'image, de la variable d'`AWS_DEFAULT_REGION`environnement, du `region` paramètre de la `[default]` section du `~/.aws/config` fichier ou du `--region` paramètre.
# `pcluster create-cluster`
Crée un 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}]
```
## Arguments nommés
**-h, --help**
Affiche le texte d'aide pour`pcluster create-cluster`.
**--cluster-configuration, -c *CLUSTER\$1CONFIGURATION***
Spécifie le fichier de configuration du cluster YAML.
**--cluster-name, -n *CLUSTER\$1NAME***
Spécifie le nom du cluster à créer.
Le nom doit commencer par un caractère alphabétique. Le nom peut comporter jusqu'à 60 caractères. Si la Slurm comptabilité est activée, le nom peut comporter jusqu'à 40 caractères.
Caractères valides : a-z, A-Z, 0-9 et - (tiret).
**--debug**
Active la journalisation du débogage.
**--dryrun *DRYRUN***
Lorsque`true`, la commande effectue la validation sans créer de ressources. Vous pouvez l'utiliser pour valider la configuration du cluster. (La valeur par défaut est`false`.)
**--query *QUERY***
Spécifie la JMESPath requête à exécuter sur la sortie.
**--region, -r *REGION***
Spécifie le Région AWS à utiliser. Le Région AWS doit être spécifié à l'aide du [`Region`](cluster-configuration-file-v3.md#yaml-Region)paramètre du fichier de configuration du cluster, de la variable d'`AWS_DEFAULT_REGION`environnement, du `region` paramètre de la `[default]` section du `~/.aws/config` fichier ou du `--region` paramètre.
**--rollback-on-failure *ROLLBACK\$1ON\$1FAILURE***
Quand`true`, lance automatiquement une restauration de la pile du cluster en cas de défaillance. (La valeur par défaut est`true`.)
**--suppress-validators *SUPPRESS\$1VALIDATORS* [*SUPPRESS\$1VALIDATORS* ...]**
Identifie un ou plusieurs validateurs de configuration à supprimer.
Format : (`ALL`\$1type :`[A-Za-z0-9]+`)
**--validation-failure-level \$1`INFO`,`WARNING`,`ERROR`\$1**
Spécifie le niveau de validation minimal qui entraînera l'échec de la création. (La valeur par défaut est`ERROR`.)
**Exemple utilisant AWS ParallelCluster la version 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`
Permet de se connecter au nœud principal via une session interactive à l'aide d'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]
```
## Arguments nommés
**-h, --help**
Affiche le texte d'aide pour`pcluster dcv-connect`.
**--cluster-name, -n *CLUSTER\$1NAME***
Spécifie le nom du cluster.
**--debug**
Active la journalisation du débogage.
**--key-path *KEY\$1PATH***
Spécifie le chemin de la clé SSH à utiliser pour la connexion.
**--login-node-ip**
Spécifie l'adresse IP publique ou privée d'un nœud de connexion dans le cluster. L'utilisation de cet argument permet de se connecter à un nœud de connexion du cluster avec le DCV activé.
Cet argument a été ajouté dans la AWS ParallelCluster version 3.11.0.
**--region, -r *REGION***
Spécifie le Région AWS à utiliser. Région AWS Il doit être spécifié à l'aide de la variable d'`AWS_DEFAULT_REGION`environnement, du `region` paramètre de la `[default]` section du `~/.aws/config` fichier ou du `--region` paramètre.
**--show-url**
Imprime l'URL qui sera utilisée pour la connexion DCV et quitte.
**Exemple utilisant la AWS ParallelCluster version 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/fr_fr/parallelcluster/latest/ug/images/Dcv-image.png)
# `pcluster delete-cluster`
Lance la suppression d'un cluster.
```
pcluster delete-cluster [-h]
--cluster-name CLUSTER_NAME
[--debug]
[--query QUERY]
[--region REGION]
```
## Arguments nommés
**-h, --help**
Affiche le texte d'aide pour`pcluster delete-cluster`.
**--cluster-name, -n *CLUSTER\$1NAME***
Spécifie le nom du cluster.
**--debug**
Active la journalisation du débogage.
**--query *QUERY***
Spécifie la JMESPath requête à exécuter sur la sortie.
**--region, -r *REGION***
Spécifie le Région AWS à utiliser. La région doit être spécifiée à l'aide de la variable d'`AWS_DEFAULT_REGION`environnement, du `region` paramètre de la `[default]` section du `~/.aws/config` fichier ou du `--region` paramètre.
**Exemple utilisant AWS ParallelCluster la version 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`
Initiez l'arrêt forcé de tous les nœuds de calcul du cluster. Cela ne fonctionne pas avec les AWS Batch clusters.
```
pcluster delete-cluster-instances [-h]
--cluster-name CLUSTER_NAME
[--debug]
[--force FORCE]
[--query QUERY]
[--region REGION]
```
## Arguments nommés
**-h, --help**
Affiche le texte d'aide pour`pcluster delete-cluster-instances`.
**--cluster-name, -n *CLUSTER\$1NAME***
Spécifie le nom du cluster.
**--debug**
Active la journalisation du débogage.
**--force *FORCE***
Quand`true`, force la suppression en ignorant les erreurs de validation. (La valeur par défaut est`false`.)
**--query *QUERY***
Spécifie la JMESPath requête à exécuter sur la sortie.
**--region, -r *REGION***
Spécifie le Région AWS à utiliser. Région AWS Il doit être spécifié à l'aide de la variable d'`AWS_DEFAULT_REGION`environnement, du `region` paramètre de la `[default]` section du `~/.aws/config` fichier ou du `--region` paramètre.
```
$ pcluster delete-cluster-instances -n cluster-v3
```
# `pcluster delete-image`
Lance la suppression de l' AWS ParallelCluster image personnalisée.
```
pcluster delete-image [-h]
--image-id IMAGE_ID
[--debug]
[--force FORCE]
[--query QUERY]
[--region REGION]
```
## Arguments nommés
**-h, --help**
Affiche le texte d'aide pour`pcluster delete-image`.
**--image-id, -i *IMAGE\$1ID***
Spécifie l'identifiant de l'image qui sera supprimée.
**--debug**
Active la journalisation du débogage.
**--force *FORCE***
Lorsque`true`, force la suppression si certaines instances utilisent l'AMI ou si l'AMI est partagée. (La valeur par défaut est`false`.)
**--query *QUERY***
Spécifie la JMESPath requête à exécuter sur la sortie.
**--region, -r *REGION***
Spécifie le Région AWS à utiliser. Région AWS Il doit être spécifié à l'aide de la variable d'`AWS_DEFAULT_REGION`environnement, du `region` paramètre de la `[default]` section du `~/.aws/config` fichier ou du `--region` paramètre.
**Exemple utilisant AWS ParallelCluster la version 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`
Obtenez des informations détaillées sur un cluster.
```
pcluster describe-cluster [-h]
--cluster-name CLUSTER_NAME
[--debug]
[--query QUERY]
[--region REGION]
```
## Arguments nommés
**-h, --help**
Affiche le texte d'aide pour`pcluster describe-cluster`.
**--cluster-name, -n *CLUSTER\$1NAME***
Spécifie le nom du cluster.
**--debug**
Active la journalisation du débogage.
**--query *QUERY***
Spécifie la JMESPath requête à exécuter sur la sortie.
**--region, -r *REGION***
Spécifie le Région AWS à utiliser. Région AWS Il doit être spécifié à l'aide de la variable d'`AWS_DEFAULT_REGION`environnement, du `region` paramètre de la `[default]` section du `~/.aws/config` fichier ou du `--region` paramètre.
**Exemples utilisant AWS ParallelCluster la version 3.1.4 :**
Décrivez les détails du 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"
}
```
`describe-cluster`À utiliser pour récupérer la configuration du 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`
Décrivez les instances d'un 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]
```
## Arguments nommés
**-h, --help**
Affiche le texte d'aide pour`pcluster describe-cluster-instances`.
**--cluster-name, -n *CLUSTER\$1NAME***
Spécifie le nom du cluster.
**--debug**
Active la journalisation du débogage.
**--next-token *NEXT\$1TOKEN***
Jeton de l'ensemble de résultats suivant.
**--node-type \$1`HeadNode`,`ComputeNode`,`LoginNode`\$1**
Spécifie les types de nœuds à répertorier. Les valeurs prises en charge sont`HeadNode`, `ComputeNode` et`LoginNode`. Si ce paramètre n'est pas spécifié, les instances`HeadNode`, `ComputeNode` et `LoginNode` a sont décrites.
**--query *QUERY***
Spécifie la JMESPath requête à exécuter sur la sortie.
**--queue-name *QUEUE\$1NAME***
Spécifie le nom de la file d'attente à répertorier. Si ce paramètre n'est pas spécifié, les instances de toutes les files d'attente sont décrites.
**--region, -r *REGION***
Spécifie le Région AWS à utiliser. Région AWS Il doit être spécifié à l'aide de la variable d'`AWS_DEFAULT_REGION`environnement, du `region` paramètre de la `[default]` section du `~/.aws/config` fichier ou du `--region` paramètre.
**Exemple utilisant AWS ParallelCluster la version 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`
Décrivez l'état du parc informatique.
```
pcluster describe-compute-fleet [-h]
--cluster-name CLUSTER_NAME
[--debug]
[--query QUERY]
[--region REGION]
```
## Arguments nommés
**-h, --help**
Affiche le texte d'aide pour`pcluster describe-compute-fleet`.
**--cluster-name, -n *CLUSTER\$1NAME***
Spécifie le nom du cluster.
**--debug**
Active la journalisation du débogage.
**--query *QUERY***
Spécifie la JMESPath requête à exécuter sur la sortie.
**--region, -r *REGION***
Spécifie le Région AWS à utiliser. Région AWS Il doit être spécifié à l'aide de la variable d'`AWS_DEFAULT_REGION`environnement, du `region` paramètre de la `[default]` section du `~/.aws/config` fichier ou du `--region` paramètre.
**Exemple utilisant AWS ParallelCluster la version 3.1.4 :**
```
$ pcluster describe-compute-fleet -n pcluster-v3
{
"status": "RUNNING",
"lastStatusUpdatedTime": "2022-07-12T17:24:26.000Z"
}
```
# `pcluster describe-image`
Obtenez des informations détaillées sur une image.
```
pcluster describe-image [-h]
--image-id IMAGE_ID
[--debug]
[--query QUERY]
[--region REGION]
```
## Arguments nommés
**-h, --help**
Affiche le texte d'aide pour`pcluster describe-image`.
**--image-id, -i *IMAGE\$1ID***
Spécifie l'ID de l'image.
**--debug**
Active la journalisation du débogage.
**--query *QUERY***
Spécifie la JMESPath requête à exécuter sur la sortie.
**--region, -r *REGION***
Spécifie le Région AWS à utiliser. Région AWS Il doit être spécifié à l'aide de la variable d'`AWS_DEFAULT_REGION`environnement, du `region` paramètre de la `[default]` section du `~/.aws/config` fichier ou du `--region` paramètre.
**Exemple utilisant AWS ParallelCluster la version 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`
Exportez les journaux du cluster vers une `tar.gz` archive locale en les faisant passer par un compartiment 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]
```
**Note**
La `export-cluster-logs` commande attend que CloudWatch Logs termine l'exportation des journaux. On s'attend donc à ce qu'elle passe un certain temps sans aucune sortie.
## Arguments nommés
**-h, --help**
Affiche le texte d'aide pour`pcluster export-cluster-logs`.
**--bucket *BUCKET\$1NAME***
Spécifie le nom du compartiment Amazon S3 vers lequel exporter les données des journaux du cluster. Il doit se trouver dans la même région que le cluster.
+ Vous devez ajouter des autorisations à la politique du compartiment Amazon S3 pour accorder CloudWatch l'accès. Pour plus d'informations, consultez la section [Définir des autorisations sur un compartiment Amazon S3](https://docs.aws.amazon.com/AmazonCloudWatch/latest/logs/S3ExportTasks.html#S3Permissions) dans le *Guide de l'utilisateur CloudWatch des journaux*.
+ **À partir de AWS ParallelCluster la version **3.12.0**, l'`--bucket`option est facultative.** Si l'option n'est pas spécifiée, soit le compartiment AWS ParallelCluster régional par défaut (`parallelcluster-hash-v1-DO-NOT-DELETE`) sera utilisé, soit si le compartiment Amazon S3 pointé par `CustomS3Bucket` est spécifié dans la configuration du cluster, il sera utilisé. Si vous ne spécifiez pas `--bucket` cette option et que vous utilisez le AWS ParallelCluster compartiment par défaut, vous ne pouvez pas exporter les journaux vers le `parallelcluster/` dossier, car il s'agit d'un dossier protégé réservé à un usage interne.
Si le bucket AWS ParallelCluster par défaut est utilisé, pcluster se chargera de configurer la politique du bucket. Si vous avez personnalisé la politique de compartiment puis effectuez une mise à niveau vers la AWS ParallelCluster version **3.12.0**, la politique de compartiment sera remplacée et vous devrez réappliquer vos modifications.
**--cluster-name, -n *CLUSTER\$1NAME***
Spécifie le nom du cluster.
**--bucket-prefix *BUCKET\$1PREFIX***
Spécifie le chemin dans le compartiment Amazon S3 où les données des journaux exportés doivent être stockées.
Par défaut, le préfixe du bucket est :
```
cluster-name-logs-202209061743.tar.gz
```
`202209061743`est un exemple de `%Y%m%d%H%M` format de l'heure.
À partir de AWS ParallelCluster la version **3.12.0**, si vous ne spécifiez pas l'`--bucket`option et que vous utilisez le AWS ParallelCluster bucket par défaut, vous ne pouvez pas exporter les journaux vers le `parallelcluster/` dossier, car il s'agit d'un dossier protégé réservé à un usage interne.
**--debug**
Active la journalisation du débogage.
**--end-time *END\$1TIME***
Spécifie la fin de la plage de temps pour collecter les événements du journal, exprimée au format ISO 8601 (`YYYY-MM-DDThh:mm:ssZ`par exemple `2021-01-01T20:00:00Z` '). Les événements dont l'horodatage est égal ou supérieur à cette heure ne sont pas inclus. Les éléments temporels (minutes et secondes, par exemple) peuvent être omis. La valeur par défaut est l'heure actuelle.
**--filters *FILTER* [*FILTER* ...]**
Spécifie les filtres pour le journal. Format :`Name=a,Values=1 Name=b,Values=2,3`. Les filtres pris en charge sont les suivants :
`private-dns-name`
Spécifie la forme abrégée du nom DNS privé de l'instance (par exemple`ip-10-0-0-101`).
`node-type`
Spécifie le type de nœud, la seule valeur acceptée pour ce filtre est`HeadNode`.
**--keep-s3-objects *KEEP\$1S3\$1OBJECTS***
Dans `true` ce cas, les objets exportés exportés vers Amazon S3 sont conservés. (La valeur par défaut est`false`.)
**--output-file *OUTPUT\$1FILE***
Spécifie le chemin du fichier dans lequel enregistrer l'archive du journal. Si cela est fourni, les journaux sont enregistrés localement. Sinon, ils sont chargés sur Amazon S3 avec l'URL renvoyée dans la sortie. Par défaut, le téléchargement vers Amazon S3 est effectué.
**--region, -r *REGION***
Spécifie le Région AWS à utiliser. Région AWS Il doit être spécifié à l'aide de la variable d'`AWS_DEFAULT_REGION`environnement, du `region` paramètre de la `[default]` section du `~/.aws/config` fichier ou du `--region` paramètre.
**--start-time *START\$1TIME***
Spécifie le début de la plage horaire, exprimé au format ISO 8601 (`YYYY-MM-DDThh:mm:ssZ`par exemple`2021-01-01T20:00:00Z`). Les événements du journal dont l'horodatage est égal ou supérieur à cette heure sont inclus. Si ce n'est pas spécifié, la valeur par défaut est l'heure à laquelle le cluster a été créé.
**Exemple utilisant AWS ParallelCluster la version 3.1.4 :**
```
$ pcluster export-cluster-logs --bucket cluster-v3-bucket -n cluster-v3
{
"url": "https://cluster-v3-bucket..."
}
```
## Impossible de récupérer les journaux ?
Si vous ne parvenez pas à récupérer les journaux à l'aide de la `export-cluster-logs` commande, effectuez l'une des opérations suivantes :
+ Récupérez les journaux manuellement à partir du groupe de CloudWatch journaux du cluster.
+ Si le groupe de journaux est vide, connectez-vous en SSH aux nœuds du cluster et récupérez les journaux répertoriés dans[Résolution des problèmes d'initialisation des nœuds](troubleshooting-v3-scaling-issues.md#troubleshooting-v3-node-init).
+ Si les nœuds du cluster ne sont pas accessibles parce que le cluster n'a pas pu être créé, recréez le cluster avec l'option `--rollback-on-failure false` et récupérez les journaux des nœuds.
# `pcluster export-image-logs`
Exportez les journaux de la pile du générateur d'images vers une `tar.gz` archive locale en les faisant passer par un compartiment 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]
```
**Note**
La `export-image-logs` commande attend que CloudWatch Logs termine l'exportation des journaux. On s'attend donc à ce qu'elle passe un certain temps sans aucune sortie.
## Arguments nommés
**-h, --help**
Affiche le texte d'aide pour`pcluster export-image-logs`.
**--bucket *BUCKET\$1NAME***
Spécifie le nom du compartiment Amazon S3 vers lequel exporter les journaux de création d'images. Il doit se trouver dans la même région que l'image.
+ Vous devez ajouter des autorisations à la politique du compartiment Amazon S3 pour accorder CloudWatch l'accès. Pour plus d'informations, consultez la section [Définir des autorisations sur un compartiment Amazon S3](https://docs.aws.amazon.com/AmazonCloudWatch/latest/logs/S3ExportTasks.html#S3Permissions) dans le *Guide de l'utilisateur CloudWatch des journaux*.
+ **À partir de AWS ParallelCluster la version **3.12.0**, l'`--bucket`option est facultative.** Si l'option n'est pas spécifiée, soit le compartiment AWS ParallelCluster régional par défaut (`parallelcluster-hash-v1-DO-NOT-DELETE`) sera utilisé, soit s'il `CustomS3Bucket` est spécifié dans la configuration de l'image, il sera utilisé.
Si le bucket AWS ParallelCluster par défaut est utilisé, pcluster se chargera de configurer la politique du bucket. Si vous personnalisez la politique de compartiment avant de passer à la AWS ParallelCluster version **3.12.0**, la politique de compartiment sera remplacée et vous devrez réappliquer les modifications.
**--image-id, -i *IMAGE\$1ID***
ID de l'image dont les journaux seront exportés.
**--bucket-prefix *BUCKET\$1PREFIX***
Spécifie le chemin dans le compartiment Amazon S3 où les données des journaux exportés doivent être stockées.
Par défaut, le préfixe du bucket est :
```
ami-id-logs-202209061743.tar.gz
```
`202209061743`est l'heure actuelle au `%Y%m%d%H%M` format.
À partir de AWS ParallelCluster la version **3.12.0**, si vous ne spécifiez pas l'`--bucket`option et n'utilisez pas le AWS ParallelCluster bucket par défaut, vous ne pouvez pas exporter les journaux vers le `parallelcluster/` dossier, car il s'agit d'un dossier protégé réservé à un usage interne.
**--debug**
Active la journalisation du débogage.
**--end-time *END\$1TIME***
Spécifie la fin de la plage de temps pour collecter les événements du journal, exprimée au format ISO 8601 (`YYYY-MM-DDThh:mm:ssZ`par exemple `2021-01-01T20:00:00Z` '). Les événements dont l'horodatage est égal ou supérieur à cette heure ne sont pas inclus. Les éléments temporels (minutes et secondes, par exemple) peuvent être omis. La valeur par défaut est l'heure actuelle.
**--keep-s3-objects *KEEP\$1S3\$1OBJECTS***
Dans `true` ce cas, les objets exportés exportés vers Amazon S3 sont conservés. (La valeur par défaut est`false`.)
**--output-file *OUTPUT\$1FILE***
Spécifie le chemin du fichier dans lequel enregistrer l'archive du journal. Si cela est fourni, les journaux sont enregistrés localement. Sinon, ils sont chargés sur Amazon S3 avec l'URL renvoyée dans la sortie. Par défaut, le téléchargement vers Amazon S3 est effectué.
**--region, -r *REGION***
Spécifie le Région AWS à utiliser. Région AWS Il doit être spécifié à l'aide de la variable d'`AWS_DEFAULT_REGION`environnement, du `region` paramètre de la `[default]` section du `~/.aws/config` fichier ou du `--region` paramètre.
**--start-time *START\$1TIME***
Spécifie le début de la plage horaire, exprimé au format ISO 8601 (`YYYY-MM-DDThh:mm:ssZ`par exemple`2021-01-01T20:00:00Z`). Les événements du journal dont l'horodatage est égal à cette heure ou à une date ultérieure sont inclus. Si ce n'est pas spécifié, la valeur par défaut est l'heure à laquelle le cluster a été créé.
**Exemple utilisant AWS ParallelCluster la version 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`
Récupérez les événements associés à un flux de log.
```
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]
```
## Arguments nommés
**-h, --help**
Affiche le texte d'aide pour`pcluster get-cluster-log-events`.
**--cluster-name, -n *CLUSTER\$1NAME***
Spécifie le nom du cluster.
**--log-stream-name *LOG\$1STREAM\$1NAME***
Spécifie le nom du flux de journal. Vous pouvez utiliser la `list-cluster-log-streams` commande pour récupérer un flux de journal associé à un ou plusieurs événements.
**--debug**
Active la journalisation du débogage.
**--end-time *END\$1TIME***
Spécifie la fin de la plage de temps, exprimée au format ISO 8601 (`YYYY-MM-DDThh:mm:ssZ`par exemple`2021-01-01T20:00:00Z`). Les événements dont l'horodatage est égal ou supérieur à cette heure ne sont pas inclus.
**--limit *LIMIT***
Spécifie le nombre maximum d'événements de journal renvoyés. Si aucune valeur n'est spécifiée, le maximum est le nombre maximal d'événements de journal que peut contenir une taille de réponse de 1 Mo, jusqu'à 10 000 événements de journal.
**--next-token *NEXT\$1TOKEN***
Jeton de l'ensemble de résultats suivant.
**--query *QUERY***
Spécifie la JMESPath requête à exécuter sur la sortie.
**--region, -r *REGION***
Spécifie le Région AWS à utiliser. Région AWS Il doit être spécifié à l'aide de la variable d'`AWS_DEFAULT_REGION`environnement, du `region` paramètre de la `[default]` section du `~/.aws/config` fichier ou du `--region` paramètre.
**--start-from-head *START\$1FROM\$1HEAD***
Si la valeur est égale à cette valeur`true`, les premiers événements du journal sont renvoyés en premier. Si la valeur est égale à `false` 1, les événements du journal les plus récents sont renvoyés en premier. (La valeur par défaut est`false`.)
**--start-time *START\$1TIME***
Spécifie le début de la plage horaire, exprimé au format ISO 8601 (`YYYY-MM-DDThh:mm:ssZ`par exemple`2021-01-01T20:00:00Z`). Les événements dont l'horodatage est égal ou supérieur à cette heure sont inclus.
**Exemple utilisant AWS ParallelCluster la version 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`
Récupérez les événements associés à la pile pour le cluster spécifié.
**Note**
À partir de la version 3.6.0, AWS ParallelCluster utilise des piles imbriquées pour créer les ressources associées aux files d'attente et aux ressources de calcul. L'`GetClusterStackEvents`API et la `pcluster get-cluster-stack-events` commande renvoient uniquement les événements de la pile principale du cluster. Vous pouvez consulter les événements de la pile de clusters, y compris ceux liés aux files d'attente et aux ressources de calcul, dans la CloudFormation console.
```
pcluster get-cluster-stack-events [-h]
--cluster-name CLUSTER_NAME
[--debug]
[--next-token NEXT_TOKEN]
[--query QUERY]
[--region REGION]
```
## Arguments nommés
**-h, --help**
Affiche le texte d'aide pour`pcluster get-cluster-stack-events`.
**--cluster-name, -n *CLUSTER\$1NAME***
Spécifie le nom du cluster.
**--debug**
Active la journalisation du débogage.
**--next-token *NEXT\$1TOKEN***
Jeton de l'ensemble de résultats suivant.
**--query *QUERY***
Spécifie la JMESPath requête à exécuter sur la sortie.
**--region, -r *REGION***
Spécifie le Région AWS à utiliser. Région AWS Il doit être spécifié à l'aide de la variable d'`AWS_DEFAULT_REGION`environnement, du `region` paramètre de la `[default]` section du `~/.aws/config` fichier ou du `--region` paramètre.
**Exemple utilisant AWS ParallelCluster la version 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`
Récupérez les événements du journal associés à la création d'une image.
```
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]
```
## Arguments nommés
**-h, --help**
Affiche le texte d'aide pour`pcluster get-image-log-events`.
**--image-id, -i *IMAGE\$1ID***
Spécifie l'ID de l'image.
**--log-stream-name *LOG\$1STREAM\$1NAME***
Spécifie le nom du flux de journal. Vous pouvez utiliser la `list-image-log-streams` commande pour récupérer un flux de journal associé à un ou plusieurs événements.
**--debug**
Active la journalisation du débogage.
**--end-time *END\$1TIME***
Spécifie la fin de la plage de temps, exprimée au format ISO 8601 (`YYYY-MM-DDThh:mm:ssZ`par exemple`2021-01-01T20:00:00Z`). Les événements dont l'horodatage est égal ou supérieur à cette heure ne sont pas inclus.
**--limit *LIMIT***
Spécifie le nombre maximum d'événements de journal renvoyés. Si aucune valeur n'est spécifiée, le maximum est le nombre maximal d'événements de journal que peut contenir une taille de réponse de 1 Mo, jusqu'à 10 000 événements de journal.
**--next-token *NEXT\$1TOKEN***
Jeton de l'ensemble de résultats suivant.
**--query *QUERY***
Spécifie la JMESPath requête à exécuter sur la sortie.
**--region, -r *REGION***
Spécifie le Région AWS à utiliser. Région AWS Il doit être spécifié à l'aide de la variable d'`AWS_DEFAULT_REGION`environnement, du `region` paramètre de la `[default]` section du `~/.aws/config` fichier ou du `--region` paramètre.
**--start-from-head *START\$1FROM\$1HEAD***
Si la valeur est égale à cette valeur`true`, les premiers événements du journal sont renvoyés en premier. Si la valeur est égale à `false` 1, les événements du journal les plus récents sont renvoyés en premier. (La valeur par défaut est`false`.)
**--start-time *START\$1TIME***
Spécifie le début de la plage horaire, exprimé au format ISO 8601 (`YYYY-MM-DDThh:mm:ssZ`par exemple`2021-01-01T20:00:00Z`). Les événements dont l'horodatage est égal ou supérieur à cette heure sont inclus.
**Exemple utilisant AWS ParallelCluster la version 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`
Récupérez les événements associés à la pile pour la génération d'image spécifiée.
```
pcluster get-image-stack-events [-h]
--image-id IMAGE_ID
[--debug]
[--next-token NEXT_TOKEN]
[--query QUERY]
[--region REGION]
```
## Arguments nommés
**-h, --help**
Affiche le texte d'aide pour`pcluster get-image-stack-events`.
**--image-id, -i *IMAGE\$1ID***
Spécifie l'ID de l'image.
**--debug**
Active la journalisation du débogage.
**--next-token *NEXT\$1TOKEN***
Jeton de l'ensemble de résultats suivant.
**--query *QUERY***
Spécifie la JMESPath requête à exécuter sur la sortie.
**--region, -r *REGION***
Spécifie le Région AWS à utiliser. Région AWS Il doit être spécifié à l'aide de la variable d'`AWS_DEFAULT_REGION`environnement, du `region` paramètre de la `[default]` section du `~/.aws/config` fichier ou du `--region` paramètre.
**Exemple utilisant AWS ParallelCluster la version 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`
Récupérez la liste des clusters existants.
```
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]
```
## Arguments nommés
**-h, --help**
Affiche le texte d'aide pour`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 ...]**
Spécifie la liste des états de cluster à filtrer. (La valeur par défaut est`all`.)
**--debug**
Active la journalisation du débogage.
**--next-token *NEXT\$1TOKEN***
Jeton de l'ensemble de résultats suivant.
**--query *QUERY***
Spécifie la JMESPath requête à exécuter sur la sortie.
**--region, -r *REGION***
Spécifie le Région AWS à utiliser. Région AWS Il doit être spécifié à l'aide de la variable d'`AWS_DEFAULT_REGION`environnement, du `region` paramètre de la `[default]` section du `~/.aws/config` fichier ou du `--region` paramètre.
**Exemple utilisant AWS ParallelCluster la version 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`
Récupérez la liste des flux de journaux associés à un cluster.
```
pcluster list-cluster-log-streams [-h]
--cluster-name CLUSTER_NAME
[--filters FILTERS [FILTERS ...]]
[--next-token NEXT_TOKEN] [--debug]
[--query QUERY]
[--region REGION]
```
## Arguments nommés
**-h, --help**
Affiche le texte d'aide pour`pcluster list-cluster-log-streams`.
**--cluster-name, -n *CLUSTER\$1NAME***
Spécifie le nom du cluster.
**--debug**
Active la journalisation du débogage.
**--filters *FILTERS* [*FILTERS* ...]**
Spécifie les filtres pour les flux de journaux. Format :`Name=a,Values=1 Name=b,Values=2,3`. Les filtres pris en charge sont les suivants :
`private-dns-name`
Spécifie la forme abrégée du nom DNS privé de l'instance (par exemple`ip-10-0-0-101`).
`node-type`
Spécifie le type de nœud, la seule valeur acceptée pour ce filtre est`HeadNode`.
**--next-token *NEXT\$1TOKEN***
Jeton de l'ensemble de résultats suivant.
**--query *QUERY***
Spécifie la JMESPath requête à exécuter sur la sortie.
**--region, -r *REGION***
Spécifie le Région AWS à utiliser. Région AWS Il doit être spécifié à l'aide de la variable d'`AWS_DEFAULT_REGION`environnement, du `region` paramètre de la `[default]` section du `~/.aws/config` fichier ou du `--region` paramètre.
**Exemple utilisant AWS ParallelCluster la version 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`
Récupérez la liste des images personnalisées existantes.
```
pcluster list-images [-h]
--image-status {AVAILABLE,PENDING,FAILED}
[--debug]
[--next-token NEXT_TOKEN]
[--query QUERY]
[--region REGION]
```
## Arguments nommés
**-h, --help**
Affiche le texte d'aide pour`pcluster list-images`.
**--image-status \$1`AVAILABLE`,`PENDING`,`FAILED`\$1**
Filtrez les images renvoyées en fonction du statut fourni.
**--debug**
Active la journalisation du débogage.
**--next-token *NEXT\$1TOKEN***
Jeton de l'ensemble de résultats suivant.
**--query *QUERY***
Spécifie la JMESPath requête à exécuter sur la sortie.
**--region, -r *REGION***
Spécifie le Région AWS à utiliser. Région AWS Il doit être spécifié à l'aide de la variable d'`AWS_DEFAULT_REGION`environnement, du `region` paramètre de la `[default]` section du `~/.aws/config` fichier ou du `--region` paramètre.
**Exemple utilisant AWS ParallelCluster la version 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`
Récupérez la liste des flux de journaux associés à une image.
```
pcluster list-image-log-streams [-h]
--image-id IMAGE_ID
[--next-token NEXT_TOKEN] [--debug]
[--query QUERY]
[--region REGION]
```
## Arguments nommés
**-h, --help**
Affiche le texte d'aide pour`pcluster list-image-log-streams`.
**--image-id, -i *IMAGE\$1ID***
Spécifie l'ID de l'image.
**--debug**
Active la journalisation du débogage.
**--next-token *NEXT\$1TOKEN***
Jeton de l'ensemble de résultats suivant.
**--query *QUERY***
Spécifie la JMESPath requête à exécuter sur la sortie.
**--region, -r *REGION***
Spécifie le Région AWS à utiliser. Région AWS Il doit être spécifié à l'aide de la variable d'`AWS_DEFAULT_REGION`environnement, du `region` paramètre de la `[default]` section du `~/.aws/config` fichier ou du `--region` paramètre.
**Exemple utilisant AWS ParallelCluster la version 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`
Décrivez « officiel AWS ParallelCluster AMIs ».
```
pcluster list-official-images [-h]
[--architecture ARCHITECTURE]
[--debug]
[--os OS]
[--query QUERY]
[--region REGION]
```
## Arguments nommés
**-h, --help**
Affiche le texte d'aide pour`pcluster list-official-images`.
**--architecture *ARCHITECTURE***
Spécifie l'architecture à utiliser pour filtrer les résultats. Si ce paramètre n'est pas spécifié, toutes les architectures sont renvoyées.
**--debug**
Active la journalisation du débogage.
**--os *OS***
Spécifie le système d'exploitation à utiliser pour filtrer les résultats. Si ce paramètre n'est pas spécifié, tous les systèmes d'exploitation sont renvoyés.
**--query *QUERY***
Spécifie la JMESPath requête à exécuter sur la sortie.
**--region, -r *REGION***
Spécifie le Région AWS à utiliser. Région AWS Il doit être spécifié à l'aide du paramètre [Région](image-builder-configuration-file-v3.md#yaml-build-image-Region) du fichier de configuration de l'image, de la variable d'`AWS_DEFAULT_REGION`environnement, du `region` paramètre de la `[default]` section du `~/.aws/config` fichier ou du `--region` paramètre.
**Exemple utilisant AWS ParallelCluster la version 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`
Exécute une `ssh` commande avec le nom d'utilisateur et l'adresse IP du cluster préremplis. Des arguments arbitraires sont ajoutés à la fin de la ligne de `ssh` commande.
```
pcluster ssh [-h]
--cluster-name CLUSTER_NAME
[--debug]
[--dryrun DRYRUN]
[--region REGION]
```
## Arguments nommés
**-h, --help**
Affiche le texte d'aide pour`pcluster ssh`.
**--cluster-name, -n *CLUSTER\$1NAME***
Spécifie le nom du cluster auquel se connecter.
**--debug**
Active la journalisation du débogage.
**--dryrun *DRYRUN***
Quand`true`, imprime la ligne de commande qui doit être exécutée et s'arrête. (La valeur par défaut est`false`.)
**--region, -r *REGION***
Spécifie le Région AWS à utiliser. Région AWS Il doit être spécifié à l'aide de la variable d'`AWS_DEFAULT_REGION`environnement, du `region` paramètre de la `[default]` section du `~/.aws/config` fichier ou du `--region` paramètre.
Exemple :
```
$ pcluster ssh --cluster-name mycluster -i ~/.ssh/id_rsa
```
Exécute une `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
```
# `pcluster update-cluster`
Met à jour un cluster existant pour qu'il corresponde aux paramètres d'un fichier de configuration spécifié.
**Note**
La mise à jour du cluster ne réussit que si tous les nœuds du cluster ont correctement appliqué la mise à jour. Si la mise à jour échoue, reportez-vous à la [Voir `clusterStatus` c'est `UPDATE_FAILED` avec `pcluster describe-cluster` commande](troubleshooting-fc-v3-update-cluster.md#update-cluster-failure-v3) section pour obtenir des conseils de dépannage.
```
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}]
```
## Arguments nommés
**-h, --help**
Affiche le texte d'aide pour`pcluster update-cluster`.
**--cluster-configuration, -c *CLUSTER\$1CONFIGURATION***
Spécifie le fichier de configuration du cluster YAML.
**--cluster-name, -n *CLUSTER\$1NAME***
Spécifie le nom du cluster.
**--debug**
Active la journalisation du débogage.
**--dryrun *DRYRUN***
Quand`true`, effectue la validation sans mettre à jour le cluster ni créer de ressources. Il peut être utilisé pour valider la configuration de l'image et les exigences de mise à jour. (La valeur par défaut est`false`.)
**--force-update *FORCE\$1UPDATE***
Quand`true`, force la mise à jour en ignorant les erreurs de validation de mise à jour. (La valeur par défaut est`false`.)
**--query *QUERY***
Spécifie la JMESPath requête à exécuter sur la sortie.
**--region, -r *REGION***
Spécifie le Région AWS à utiliser. Le Région AWS doit être spécifié à l'aide du [`Region`](cluster-configuration-file-v3.md#yaml-Region)paramètre du fichier de configuration du cluster, de la variable d'`AWS_DEFAULT_REGION`environnement, du `region` paramètre de la `[default]` section du `~/.aws/config` fichier ou du `--region` paramètre.
**--suppress-validators * SUPPRESS\$1VALIDATORS* [*SUPPRESS\$1VALIDATORS ...*]**
Identifie un ou plusieurs validateurs de configuration à supprimer.
Format : (`ALL`\$1`type:[A-Za-z0-9]+`)
**--validation-failure-level *\$1INFO,WARNING,ERROR\$1***
Spécifie le niveau d'échecs de validation signalés pour la mise à jour.
**Exemple utilisant AWS ParallelCluster la version 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`
Met à jour l'état du parc informatique du cluster.
```
pcluster update-compute-fleet [-h]
--cluster-name CLUSTER_NAME
--status {START_REQUESTED,STOP_REQUESTED,ENABLED,DISABLED}
[--debug]
[--query QUERY]
[--region REGION]
```
## Arguments nommés
**-h, --help**
Affiche le texte d'aide pour`pcluster update-compute-fleet`.
**--cluster-name, -n *CLUSTER\$1NAME***
Spécifie le nom du cluster.
**--status \$1START\$1REQUESTED,STOP\$1REQUESTED,ENABLED,DISABLED\$1**
Spécifie le statut appliqué au parc de calcul du cluster. Les statuts `START_REQUESTED` et C `STOP_REQUESTED` correspondent au Slurm planificateur tandis que les statuts `ENABLED` `DISABLED` correspondent au planificateur. AWS Batch
**--debug**
Active la journalisation du débogage.
**--query *QUERY***
Spécifie la JMESPath requête à exécuter sur la sortie.
**--region, -r *REGION***
Spécifie le Région AWS à utiliser. Région AWS Il doit être spécifié à l'aide de la variable d'`AWS_DEFAULT_REGION`environnement, du `region` paramètre de la `[default]` section du `~/.aws/config` fichier ou du `--region` paramètre.
**Exemple utilisant AWS ParallelCluster la version 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`
Affiche la version de AWS ParallelCluster.
```
pcluster version [-h] [--debug]
```
## Arguments nommés
**-h, --help**
Affiche le texte d'aide pour`pcluster version`.
**--debug**
Active la journalisation du débogage.
**Exemple utilisant AWS ParallelCluster la version 3.1.4 :**
```
$ pcluster version
{
"version": "3.1.4"
}
```