View a markdown version of this page

pcluster export-image-logs - AWS ParallelCluster
Argomenti denominati

Le traduzioni sono generate tramite traduzione automatica. In caso di conflitto tra il contenuto di una traduzione e la versione originale in Inglese, quest'ultima prevarrà.

pcluster export-image-logs

Esporta i log dello stack di image builder in un tar.gz archivio locale passando attraverso un bucket 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]
Nota

Il export-image-logs comando attende che CloudWatch Logs completi l'esportazione dei log, quindi è previsto un periodo di tempo senza alcun output.

Argomenti denominati

-h, --help

Mostra il testo di aiuto perpcluster export-image-logs.

--bucket BUCKET_NAME

Specifica il nome del bucket Amazon S3 in cui esportare i log di creazione delle immagini. Deve trovarsi nella stessa regione dell'immagine.

Nota

  • È necessario aggiungere autorizzazioni alla policy del bucket Amazon S3 per concedere l'accesso. CloudWatch Per ulteriori informazioni, consulta Impostare le autorizzazioni su un bucket Amazon S3 nella Logs User Guide. CloudWatch

  • A partire dalla AWS ParallelCluster versione 3.12.0, l'opzione è opzionale. --bucket Se l'opzione non è specificata, verrà utilizzato il bucket (parallelcluster-hash-v1-DO-NOT-DELETE) predefinito AWS ParallelCluster regionale oppure, se CustomS3Bucket è specificato nella configurazione dell'immagine, verrà utilizzato quello.

Importante

Se viene utilizzato il bucket AWS ParallelCluster predefinito, pcluster si occuperà della configurazione della policy del bucket. Se personalizzi la policy del bucket prima di eseguire l'aggiornamento alla AWS ParallelCluster versione 3.12.0, la policy del bucket verrà sovrascritta e dovrai riapplicare le modifiche.

--image-id, -i IMAGE_ID

L'ID dell'immagine i cui log verranno esportati.

--bucket-prefix BUCKET_PREFIX

Specifica il percorso nel bucket Amazon S3 in cui archiviare i dati di log esportati.

Per impostazione predefinita, il prefisso del bucket è:

ami-id-logs-202209061743.tar.gz

202209061743è l'ora corrente nel formato. %Y%m%d%H%M

Nota

A partire dalla AWS ParallelCluster versione 3.12.0, se non si specifica l'--bucketopzione e si utilizza il AWS ParallelCluster bucket predefinito, non è possibile esportare i log nella parallelcluster/ cartella, poiché si tratta di una cartella protetta riservata all'uso interno.

--debug

Abilita la registrazione del debug.

--end-time END_TIME

Specifica la fine dell'intervallo di tempo per la raccolta degli eventi di registro, espressa nel formato ISO 8601 (YYYY-MM-DDThh:mm:ssZad esempio '). 2021-01-01T20:00:00Z Gli eventi con un timestamp uguale o successivo a questo orario non sono inclusi. Gli elementi temporali (ad esempio minuti e secondi) possono essere omessi. Il valore predefinito è l'ora corrente.

--keep-s3-objects KEEP_S3_OBJECTS

In tal casotrue, gli oggetti esportati esportati in Amazon S3 vengono mantenuti. (Il valore predefinito è.) false

--output-file OUTPUT_FILE

Specifica il percorso del file in cui salvare l'archivio del registro. Se viene fornito, i log vengono salvati localmente. Altrimenti vengono caricati su Amazon S3 con l'URL restituito nell'output. L'impostazione predefinita è il caricamento su Amazon S3.

--region, -r REGION

Specifica il tipo Regione AWS da utilizzare. Regione AWS Deve essere specificato utilizzando la variabile di AWS_DEFAULT_REGION ambiente, l'regionimpostazione nella [default] sezione del ~/.aws/config file o il --region parametro.

--start-time START_TIME

Specifica l'inizio dell'intervallo di tempo, espresso nel formato ISO 8601 (ad YYYY-MM-DDThh:mm:ssZ esempio2021-01-01T20:00:00Z). Sono inclusi gli eventi di registro con un timestamp uguale a questa ora o successivo a questa ora. Se non è specificato, l'impostazione predefinita è l'ora di creazione del cluster.

Esempio di utilizzo AWS ParallelCluster della versione 3.1.4: 

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