내용으로 건너뛰기

EC2 Image Builder의 파이프라인 오류 문제를 해결하려면 어떻게 해야 합니까?

4분 분량
0

EC2 Image Builder의 파이프라인 오류 문제를 해결하고 싶습니다.

간략한 설명

Image Builder 파이프라인이 실패하면 워크플로 실행 ID가 반환되고 파이프라인 실패 이유를 설명하는 다음과 같은 오류가 표시됩니다.

"Workflow Execution ID: example-workflow-id failed with reason: example-reason"

프로세스의 각 빌드 및 테스트 스테이지에는 관련 워크플로가 있습니다.컨테이너 이미지에는 배포 중에 실행되는 추가 워크플로가 있습니다. 또한 각 워크플로에 골든 Amazon Machine Image를 구축하는 데 필요한 단계가 있습니다.

해결 방법

참고: AWS Command Line Interface(AWS CLI) 명령 실행 시 오류가 발생하는 경우, AWS CLI 오류 문제 해결을 참고하세요. 또한 최신 AWS CLI 버전을 사용하고 있는지 확인하십시오.

Image Builder 파이프라인 오류 문제를 해결하려면 다음 단계를 완료하십시오.

파이프라인 오류를 일으킨 워크플로 스테이지 및 단계 확인

파이프라인 오류를 일으킨 워크플로 스테이지 및 단계를 확인하려면 다음 방법 중 하나를 사용하십시오.

API 사용
파이프라인 오류를 일으킨 워크플로 스테이지 및 단계를 확인하려면 GetWorkflowExecution 및 ListWorkflowStepExecution API 명령을 워크플로 실행 ID와 함께 사용합니다.

AWS Management Console 사용
AWS Management Console을 사용하여 파이프라인 오류를 일으킨 워크플로 스테이지 및 단계를 확인하려면 다음 단계를 완료하십시오.

  1. Image Builde 콘솔을 엽니다.
  2. 왼쪽 창에서 **Image Pipelines(이미지 파이프라인)**을 선택합니다. 그런 다음 파이프라인을 선택합니다.
  3. **Output Images(출력 이미지)**에서 실패한 **Output Image Version(출력 이미지 버전)**을 선택합니다.
  4. **Workflow(워크플로)**에서 워크플로 드롭다운 목록을 선택한 다음 실패한 **stage(스테이지)**를 선택합니다. 실패한 **stage(스테이지)**의 **steps(단계)**목록이 표시됩니다.

파이프라인 오류를 일으킨 워크플로 stage(스테이지) 및 **steps(단계)**를 식별하면 다음 방법을 이용하여 추가 문제를 해결합니다.

CloudWatch 로그로 전송된 로그를 확인합니다.

Image Builder는 /aws/imagebuilder/ImageName 로그 그룹과 ImageVersion/ImageBuildVersion 로그 스트림에 자세한 워크플로 로그를 게시했습니다. Amazon CloudWatch 콘솔 또는 Image Builder 콘솔에서 이러한 로그 스트림을 확인할 수 있습니다.

Image Builder 콘솔에서 CloudWatch 로그로 전송된 로그를 확인하려면 다음 단계를 완료하십시오.

  1. Image Builde 콘솔을 엽니다.
  2. 왼쪽 창에서 **Image Pipelines(이미지 파이프라인)**을 선택합니다. 그런 다음 파이프라인을 선택합니다.
  3. **Output Images(출력 이미지)**에서 실패한 **Output Image Version(출력 이미지 버전)**을 선택합니다.
  4. **Workflow(워크플로)**에서 워크플로 드롭다운 목록을 선택한 다음 실패한 **stage(스테이지)**를 선택합니다.
  5. 실패한 **step(단계)**의 **Step ID(단계 ID)**를 선택합니다.
  6. **Application logs(애플리케이션 로그)**를 선택합니다
  7. 추가 문제 해결을 위해 **Application logs(애플리케이션 로그)**를 검토합니다.

**참고:**이전 단계를 완료한 후에도 문제를 해결할 수 없는 경우 다음 방법을 계속 진행하십시오.

Amazon S3로 전송된 로그를 확인합니다.

Amazon Simple Storage Service(Amazon S3) 로그는 빌드 프로세스 중 Amazon Elastic Compute Cloud(Amazon EC2) 인스턴스 활동에 대한 단계와 오류를 보여줍니다. Amazon S3 로그에는 구성 요소 관리자의 로그 출력, 구성 요소 정의가 포함됩니다. 이러한 로그는 Amazon EC2 인스턴스에서 수행한 단계에 대한 자세한 JSON 출력을 제공합니다.

인프라 구성에서 Amazon S3 버킷 이름과 키 접두사를 지정한 경우 S3://S3BucketName/KeyPrefix/ImageName/ImageVersion/ImageBuildVersion/WorkflowExecutionId/StepName에서 워크플로 단계 로그 경로를 찾을 수 있습니다.

Amazon S3 버킷 이름과 키 접두사를 지정하지 않은 경우 Image Builder 콘솔을 열고 **Troubleshooting settings(문제 해결 설정)**으로 이동합니다. 그런 다음 **Logs(로그)**에서 Image Builder가 로그를 쓸 수 있는 Amazon S3 버킷을 지정합니다. Amazon S3 버킷을 지정한 후 파이프라인을 다시 실행하여 로그를 수집하고 버킷에 저장합니다.

Amazon EC2 인스턴스 로그 확인

AWS 작업 오케스트레이터 및 실행기 구성 요소 관리자(AWSTOE)는 인스턴스에 새 이미지를 구축하고 테스트하는 데 사용되는 로그 폴더를 생성합니다. 이러한 로그 폴더는 구성 요소가 실행될 때마다 생성됩니다. 컨테이너 이미지의 경우 로그 폴더가 컨테이너에 저장됩니다.

**참고:**기본적으로 Image Builder는 파이프라인 빌드가 실패하면 빌드 또는 테스트 인스턴스를 종료합니다. 문제 해결을 위해 빌드 또는 테스트 인스턴스를 유지하려면 파이프라인 인프라 구성 리소스의 인스턴스 설정을 수정하십시오. 인스턴스 설정을 수정하려면 Image Builder 콘솔을 열고 인프라 구성 리소스의 **Troubleshooting settings(문제 해결 설정)**으로 이동합니다. 그런 다음 Terminate instance on failure(실패 시 인스턴스 종료) 옵션을 비활성화합니다.

또한 update-infrastructure-configuration 명령을 사용하여 인스턴스 설정을 수정할 수 있습니다. TerminateInstanceOnFailure 값을 false로 설정했는지 확인합니다. 자세한 내용은 인프라 구성 업데이트를 참조하십시오.

빌드 또는 테스트 인스턴스에 연결하고 다음 위치에서 런타임 로그를 찾습니다.

  • Linux의 경우 /var/lib/amazon/toe/file_prefix_runtime_executionID 디렉터리를 확인합니다.

  • Windows의 경우 env:ProgramFiles\Amazon\TaskOrchestratorAndExecutor\file_prefix_run time_executionID 디렉터리를 확인합니다.

    로그 파일 예시: /var/lib/amazon/toe/TOE_2021-07-01_12-34-56_UTC-0_a1bcd2e3-45f6-789a-bcde-0fa1b2c3def4

이전 로그 디렉터리에서 다음 파일을 확인하여 추가적인 파이프라인 오류 문제를 해결합니다.

  • application.log - 구성 요소 실행 시 발생하는 활동과 관련된 AWSTOE의 타임스탬프 디버그 레벨 정보를 포함합니다.
  • detailedoutput.json - 구성 요소 실행 시 해당 구성 요소에 적용되는 모든 문서, 단계(phase) 및 단계(step)의 실행 상태, 입력, 출력 및 오류에 대한 세부 정보를 포함합니다.
  • console.log - 구성 요소가 실행될 때 AWSTOE가 콘솔에 기록하는 표준 출력(stdout) 및 표준 오류(stderr) 정보를 포함합니다.
  • chaining.json - AWSTOE가 체인 표현식을 해결하기 위해 적용하는 최적화를 나타냅니다.

Check CloudTrail 이벤트

계정에서 AWS CloudTrail이 활성화되어 있으면 모든 빌드 활동이 로깅됩니다. CloudTrail 이벤트를 필터링하려면 source: imagebuilder.amazonaws.com으로 필터링하거나, username: Image Builder로 필터링하거나, 연결된 Amazon EC2 인스턴스 ID를 검색합니다. 이 필터는 파이프라인에 대한 추가 상세 정보를 보여주는 로그를 반환합니다.

배포 프로세스 중 API 추적 문제를 해결하려면, CloudTrail 이벤트를 username: Ec2ImageBuilderIntegrationService으로 필터링해서 Distribution(배포) 프로세스 중의 API 추적 문제를 해결할 수 있습니다. 이 방법을 사용하여 Image Builder의 API 직접 호출 오류와 관련된 정보를 검색할 수 있습니다.

관련 정보

EC2 Image Builder에서 빌드 파이프라인 시간 초과 오류를 해결하려면 어떻게 해야 합니까?

FAILED 수명 주기 정책 또는 완료되었지만 EC2 Image Builder 수명 주기 정책에서 이미지를 계속 사용할 수 있는 정책 문제를 해결하려면 어떻게 해야 합니까?

EC2 Image Builder의 이미지 빌드 파이프라인에 대한 403 Access Denied 오류를 해결하려면 어떻게 해야 합니까?

AWS 공식업데이트됨 2년 전