pcluster export-image-logs - AWS ParallelCluster

本文属于机器翻译版本。若本译文内容与英语原文存在差异,则一律以英文原文为准。

pcluster export-image-logs

通过 Amazon S3 存储桶,将映像生成器的日志导出到本地 tar.gz 存档。

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]

命名的参数

-h, --help

显示 pcluster export-image-logs 的帮助文本。

--bucket BUCKET_NAME

指定要将映像构建日志导出到的 Amazon S3 存储桶的名称。它必须与映像位于相同的区域。

注意

您必须向 Amazon S3 存储桶策略添加权限才能授予 CloudWatch 访问权限。有关更多信息,请参阅CloudWatch 日志用户指南中的对 Amazon S3 存储桶设置权限

--image-id, -i IMAGE_ID

要导出其日志的映像 ID。

--bucket-prefix BUCKET_PREFIX

指定导出的日志数据在 Amazon S3 存储桶中的存储位置的路径。

默认情况下,存储桶前缀为:

ami-id-logs-202209061743.tar.gz

202209061743%Y%m%d%H%M 格式的当前时间。

--debug

启用调试日志记录。

--end-time END_TIME

指定用于收集日志事件的时间范围的结束时间,以 ISO 8601 格式(YYYY-MM-DDThh:mm:ssZ,例如 2021-01-01T20:00:00Z)表示。不包括时间戳等于或晚于该时间的事件。可以省略时间元素(例如分和秒)。默认值为当前时间。

--keep-s3-objects KEEP_S3_OBJECTS

如果为 true,则会保留导出到 Amazon S3 的导出对象。(默认值为 false。)

--output-file OUTPUT_FILE

指定要将日志存档保存到的文件路径。如果提供此参数,则在本地保存日志。否则会通过输出中返回的 URL 将日志上传到 Amazon S3。默认为上传到 Amazon S3。

--region, -r REGION

指定 AWS 区域 要使用的。 AWS 区域 必须使用AWS_DEFAULT_REGION环境变量、~/.aws/config文件[default]部分中的region设置或--region参数来指定。

--start-time START_TIME

指定时间范围的开始时间,以 ISO 8601 格式(YYYY-MM-DDThh:mm:ssZ,例如 2021-01-01T20:00:00Z)表示。包括时间戳等于或晚于该时间的日志事件。如果未指定,则默认为集群的创建时间。

使用 AWS ParallelCluster 版本 3.1.4 的示例:

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