pcluster export-image-logs - AWS ParallelCluster
Argumentos con nombre

Las traducciones son generadas a través de traducción automática. En caso de conflicto entre la traducción y la version original de inglés, prevalecerá la version en inglés.

pcluster export-image-logs

Exporte los registros de la pila del generador de imágenes en un archivo tar.gz local pasándolos por un bucket de 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

El export-image-logs comando espera a que CloudWatch Logs complete la exportación de los registros, por lo que se espera que pase un período de tiempo sin ningún resultado.

Argumentos con nombre

-h, --help

Muestra el texto de ayuda de pcluster export-image-logs.

--bucket BUCKET_NAME

Especifica el nombre del bucket de Amazon S3 al que se exportarán los registros de la creación de imágenes. Tiene que estar en la misma región que la imagen.

nota

  • Debe añadir permisos a la política de buckets de Amazon S3 para conceder el CloudWatch acceso. Para obtener más información, consulte Establecer permisos en un bucket de Amazon S3 en la Guía del usuario de CloudWatch Logs.

  • A partir de AWS ParallelCluster la versión 3.12.0, la --bucket opción es opcional. Si no se especifica la opción, se utilizará el bucket AWS ParallelCluster regional predeterminado (parallelcluster-hash-v1-DO-NOT-DELETE) o, si CustomS3Bucket se especifica en la configuración de la imagen, se utilizará ese bucket.

importante

Si se usa el bucket AWS ParallelCluster predeterminado, pcluster se encargará de configurar la política del bucket. Si personaliza la política de bucket antes de actualizar a la AWS ParallelCluster versión 3.12.0, la política de bucket se anulará y tendrá que volver a aplicar los cambios.

--image-id, -i IMAGE_ID

El identificador de la imagen cuyos registros se exportarán.

--bucket-prefix BUCKET_PREFIX

Especifica la ruta en el bucket de Amazon S3 donde se almacenará la información de los registros exportados.

De forma predeterminada, el prefijo del bucket es:

ami-id-logs-202209061743.tar.gz

202209061743 es la hora actual en formato %Y%m%d%H%M.

nota

A partir de la AWS ParallelCluster versión 3.12.0, si no especificas la --bucket opción y utilizas el AWS ParallelCluster depósito predeterminado, no podrás exportar los registros a la parallelcluster/ carpeta, ya que se trata de una carpeta protegida reservada para uso interno.

--debug

Habilita del registro de depuración.

--end-time END_TIME

Especifica el final del intervalo de tiempo para recopilar los eventos del registro, expresado en formato ISO 8601 (YYYY-MM-DDThh:mm:ssZ, por ejemplo 2021-01-01T20:00:00Z). No se incluyen los eventos con una marca de tiempo igual o posterior a esta hora. Se pueden omitir los elementos de tiempo (por ejemplo, minutos y segundos). El valor predeterminado es la hora actual.

--keep-s3-objects KEEP_S3_OBJECTS

Si se establece en true, se conservan las exportaciones de objetos exportados a Amazon S3. (el valor predeterminado es false).

--output-file OUTPUT_FILE

Especifica la ruta del archivo en la que se guardará el archivo de registro. Si se proporciona, los registros se guardan localmente. De lo contrario, se cargan en Amazon S3 con la URL devuelta en la salida. De forma predeterminada, se cargan en Amazon S3.

--region, -r REGION

Especifica el que se va Región de AWS a utilizar. Región de AWS Debe especificarse mediante la variable de AWS_DEFAULT_REGION entorno, la region configuración de la [default] sección del ~/.aws/config archivo o el --region parámetro.

--start-time START_TIME

Especifica el inicio del intervalo de tiempo, expresado en formato ISO 8601 (YYYY-MM-DDThh:mm:ssZ, por ejemplo 2021-01-01T20:00:00Z). Se incluyen los eventos de registro con una marca de tiempo igual o posterior a esta hora. Si no se especifica, el valor predeterminado es la hora en que se creó el clúster.

Ejemplo que utiliza AWS ParallelCluster la versión 3.1.4:

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