pcluster export-image-logs

Exportieren Sie die Protokolle des Image Builder-Stacks in ein lokales tar.gz Archiv, indem Sie sie durch einen Amazon S3 S3-Bucket leiten.

pcluster export-image-logs [-h]
                 --bucket BUCKET
                 --image-id IMAGE_ID
                [--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]

Benannte Argumente

-h, --help

Zeigt den Hilfetext fürpcluster export-image-logs.

--bucket BUCKET_NAME

Gibt den Amazon S3 S3-Bucket-Namen an, in den Image-Build-Logs exportiert werden sollen. Er muss sich in derselben Region wie das Image befinden.

Anmerkung

Sie müssen der Amazon S3 S3-Bucket-Richtlinie Berechtigungen hinzufügen, um CloudWatch Zugriff zu gewähren. Weitere Informationen finden Sie unter Berechtigungen für einen Amazon S3 S3-Bucket festlegen im CloudWatch Logs-Benutzerhandbuch.

--image-id, -i IMAGE_ID

Die Bild-ID, deren Protokolle exportiert werden.

--bucket-prefix BUCKET_PREFIX

Gibt den Pfad im Amazon S3 S3-Bucket an, in dem exportierte Protokolldaten gespeichert werden sollen.

Standardmäßig lautet das Bucket-Präfix:

ami-id-logs-202209061743.tar.gz

202209061743ist die aktuelle Uhrzeit im %Y%m%d%H%M Format.

--debug

Aktiviert die Debug-Protokollierung.

--end-time END_TIME

Gibt das Ende des Zeitbereichs für die Erfassung von Protokollereignissen an, ausgedrückt im ISO 8601-Format (YYYY-MM-DDThh:mm:ssZz. B. 2021-01-01T20:00:00Z '). Ereignisse mit einem Zeitstempel, der diesem Zeitpunkt entspricht oder später liegt, sind nicht enthalten. Zeitelemente (z. B. Minuten und Sekunden) können weggelassen werden. Der Standardwert ist die aktuelle Zeit.

--keep-s3-objects KEEP_S3_OBJECTS

Fallstrue, werden die exportierten Objekte, die nach Amazon S3 exportiert werden, beibehalten. (Die Standardeinstellung istfalse.)

--output-file OUTPUT_FILE

Gibt den Dateipfad an, in dem das Log-Archiv gespeichert werden soll. Wenn dies angegeben ist, werden die Protokolle lokal gespeichert. Andernfalls werden sie mit der in der Ausgabe zurückgegebenen URL auf Amazon S3 hochgeladen. Standardmäßig wird auf Amazon S3 hochgeladen.

--region, -r REGION

Gibt an AWS-Region , welche verwendet werden soll. Der AWS-Region muss mithilfe der AWS_DEFAULT_REGION Umgebungsvariablen, der region Einstellung im [default] Abschnitt der ~/.aws/config Datei oder des --region Parameters angegeben werden.

--start-time START_TIME

Gibt den Beginn des Zeitbereichs an, ausgedrückt im ISO 8601-Format (zum YYYY-MM-DDThh:mm:ssZ Beispiel2021-01-01T20:00:00Z). Protokollereignisse mit einem Zeitstempel, der diesem Zeitpunkt oder einem späteren Zeitpunkt entspricht, sind enthalten. Wenn nicht angegeben, ist die Standardeinstellung die Uhrzeit, zu der der Cluster erstellt wurde.

Beispiel mit AWS ParallelCluster Version 3.1.4:

$ pcluster export-image-logs --bucket image-v3-bucket --image-id ami-1234abcd5678efgh
{
  "url": "https://image-v3-bucket..."
}