pcluster export-image-logs - AWS ParallelCluster
이름 지정된 인수

기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다.

pcluster export-image-logs

Amazon S3 버킷을 통과하여 이미지 빌더 스택의 로그를 로컬 tar.gz 아카이브로 내보냅니다.

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]
참고

export-image-logs 명령은 CloudWatch 로그 내보내기가 완료될 때까지 기다리므로 출력 없이 일정 시간이 걸릴 것으로 예상됩니다.

이름 지정된 인수

-h, --help

pcluster export-image-logs에 대한 도움말 텍스트를 표시합니다.

--bucket BUCKET_NAME

이미지 빌드 로그를 내보낼 Amazon S3 버킷 이름을 지정합니다. 그것은 이미지와 같은 리전에 있어야 합니다.

참고

  • CloudWatch 액세스 권한을 부여하려면 Amazon S3 버킷 정책에 권한을 추가해야 합니다. 자세한 내용은 로그 사용 설명서의 Amazon S3 버킷에 대한 권한 설정을 참조하세요. CloudWatch

  • AWS ParallelCluster 버전 3.12.0부터 --bucket 옵션은 선택 사항입니다. 옵션을 지정 AWS ParallelCluster 하지 않으면 리전 기본 버킷(parallelcluster-hash-v1-DO-NOT-DELETE)이 사용되거나 CustomS3Bucket가 이미지 구성에 지정된 경우이 사용됩니다.

중요

AWS ParallelCluster 기본 버킷을 사용하는 경우 pcluster가 버킷 정책을 구성합니다. AWS ParallelCluster 버전 3.12.0으로 업그레이드하기 전에 버킷 정책을 사용자 지정하면 버킷 정책이 재정의되며 변경 사항을 다시 적용해야 합니다.

--image-id, -i IMAGE_ID

로그를 내보낼 이미지 ID입니다.

--bucket-prefix BUCKET_PREFIX

내보낸 로그 데이터가 저장되는 Amazon S3 버킷의 경로를 지정합니다.

기본적으로 버킷 접두사는 다음과 같습니다.

ami-id-logs-202209061743.tar.gz

202209061743는 현재 시간을 %Y%m%d%H%M 형식으로 나타낸 것입니다.

참고

AWS ParallelCluster 버전 3.12.0부터는 --bucket 옵션을 지정하지 않고 기본 AWS ParallelCluster 버킷을 사용하는 경우 내부용으로 예약된 보호 parallelcluster/ 폴더이므로 로그를 폴더로 내보낼 수 없습니다.

--debug

디버깅 로깅을 활성화합니다.

--end-time END_TIME

로그 이벤트를 수집할 시간 범위의 끝을 ISO 8601 형식(YYYY-MM-DDThh:mm:ssZ예: 2021-01-01T20:00:00Z')으로 지정합니다. 타임스탬프가 이 시간 이후인 이벤트는 포함되지 않습니다. 시간 요소(예: 분 및 초)는 생략될 수 있습니다. 기본값은 현재 시간입니다.

--keep-s3-objects KEEP_S3_OBJECTS

true면 내보낸 객체를 아마존 S3로 내보낸 것을 보관합니다. (false로 디폴트됩니다.)

--output-file OUTPUT_FILE

로그 아카이브를 저장할 파일 경로를 지정합니다. 이 정보가 제공되면 로그가 로컬에 저장됩니다. 그렇지 않으면 출력에 URL 반환된와 함께 Amazon S3에 업로드됩니다. Amazon S3로 업로드하는 것이 기본값입니다.

--region, -r REGION

사용할 AWS 리전 를 지정합니다. AWS_DEFAULT_REGION 환경 변수, ~/.aws/config 파일 [default] 섹션의 region 설정 또는 --region 파라미터를 사용하여를 지정해야 AWS 리전 합니다.

--start-time START_TIME

8601 형식(YYYY-MM-DDThh:mm:ssZ예: ISO )으로 표현되는 시간 범위의 시작을 지정합니다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..."
}