View a markdown version of this page

journaux d'exportation d'images de pcluster - AWS ParallelCluster
Arguments nommés

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.

journaux d'exportation d'images de pcluster

Exportez les journaux de la pile du générateur d'images vers une tar.gz archive locale en passant 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. Elle devrait donc rencontrer un certain temps sans aucune sortie.

Arguments nommés

-h, --help

Affiche le texte d'aide pourpcluster export-image-logs.

--bucket BUCKET_NAME

Spécifie le nom du compartiment Amazon S3 vers lequel exporter les journaux de génération d'images. Elle doit se trouver dans la même région que l'image.

Note

  • Vous devez ajouter des autorisations à la politique de 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 dans le Guide de l'utilisateur CloudWatch des journaux.

  • À partir de AWS ParallelCluster la version 3.12.0, l'--bucketoption 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é.

Important

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, elle sera remplacée et vous devrez réappliquer les modifications.

--image-id, -i IMAGE_ID

L'identifiant de l'image dont les journaux seront exportés.

--bucket-prefix BUCKET_PREFIX

Spécifie le chemin dans le compartiment Amazon S3 où les données de journaux exportées doivent être stockées.

Par défaut, le préfixe du compartiment est le suivant :

ami-id-logs-202209061743.tar.gz

202209061743est l'heure actuelle au %Y%m%d%H%M format.

Note

À partir de AWS ParallelCluster la version 3.12.0, si vous ne spécifiez pas l'--bucketoption et utilisez le AWS ParallelCluster compartiment par défaut, vous ne pouvez pas exporter les journaux vers ce 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_TIME

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:ssZpar exemple 2021-01-01T20:00:00Z '). Les événements dont l'horodatage est égal ou postérieur à cette heure ne sont pas inclus. Les éléments temporels (par exemple les minutes et les secondes) peuvent être omis. La valeur par défaut est l'heure actuelle.

--keep-s3-objects KEEP_S3_OBJECTS

Sitrue, les objets exportés sont exportés vers Amazon S3 sont conservés. (La valeur par défaut estfalse.)

--output-file OUTPUT_FILE

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 est effectué sur Amazon S3.

--region, -r REGION

Spécifie les Région AWS éléments à utiliser. Région AWS Il doit être spécifié à l'aide de la variable d'AWS_DEFAULT_REGIONenvironnement, du region réglage de la [default] section du ~/.aws/config fichier ou du --region paramètre.

--start-time START_TIME

Spécifie le début de la plage horaire, exprimée au format ISO 8601 (YYYY-MM-DDThh:mm:ssZpar exemple2021-01-01T20:00:00Z). Les événements du journal dont l'horodatage est égal à cette heure ou postérieur à cette heure sont inclus. Si elle n'est pas spécifiée, la valeur par défaut est l'heure de création du cluster.

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..."
}