Die vorliegende Übersetzung wurde maschinell erstellt. Im Falle eines Konflikts oder eines Widerspruchs zwischen dieser übersetzten Fassung und der englischen Fassung (einschließlich infolge von Verzögerungen bei der Übersetzung) ist die englische Fassung maßgeblich.
pcluster export-image-logs
Exportieren Sie die Protokolle des Image Builder-Stacks in ein lokales tar.gz
Archiv, indem Sie einen Amazon S3 S3-Bucket durchlaufen.
pcluster export-image-logs [-h] --image-id
IMAGE_ID
[--bucketBUCKET
] [--bucket-prefixBUCKET_PREFIX
] [--debug] [--end-timeEND_TIME
] [--keep-s3-objectsKEEP_S3_OBJECTS
] [--output-fileOUTPUT_FILE
] [--regionREGION
] [--start-timeSTART_TIME
]
Anmerkung
Der export-image-logs
Befehl wartet darauf, dass CloudWatch Logs den Export der Logs abgeschlossen hat. Es wird also davon ausgegangen, dass es eine gewisse Zeit ohne Ausgabe geben wird.
Benannte Argumente
-h, --help
-
Zeigt den Hilfetext für
pcluster 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.
-
Ab AWS ParallelCluster Version 3.12.0 ist
--bucket
diese Option optional. Wenn die Option nicht angegeben ist, wird entweder der AWS ParallelCluster regionale Standard-Bucket (parallelcluster-hash-v1-DO-NOT-DELETE
) verwendet, oder wenn der in der Image-Konfiguration angegebenCustomS3Bucket
ist, wird dieser verwendet.
Wichtig
Wenn der AWS ParallelCluster Standard-Bucket verwendet wird, kümmert sich pcluster um die Konfiguration der Bucket-Richtlinie. Wenn Sie die Bucket-Richtlinie anpassen, bevor Sie auf AWS ParallelCluster Version 3.12.0 aktualisieren, wird die Bucket-Richtlinie außer Kraft gesetzt und Sie müssen die Änderungen erneut anwenden.
-
--image-id, -i
IMAGE_ID
-
Die Image-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
ist die aktuelle Uhrzeit im202209061743
%Y%m%d%H%M
Format.Anmerkung
Ab AWS ParallelCluster Version 3.12.0 können Sie keine Protokolle in den Ordner exportieren, wenn Sie die
--bucket
Option nicht angeben und den AWS ParallelCluster Standard-Bucket verwenden, da es sich um einen geschütztenparallelcluster/
Ordner handelt, der für den internen Gebrauch reserviert ist. --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:ssZ
z. 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
-
Falls
true
, 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, derregion
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-idami-1234abcd5678efgh
{ "url": "https://image-v3-bucket..." }