View a markdown version of this page

AI를 사용하여 실패한 빌드 문제 해결 - 미리 보기 - EC2 Image Builder
사전 조건문제 해결 설정실패한 빌드 문제 해결실패한 여러 파이프라인 문제 해결문제 해결에서 조사하는 내용고려 사항

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

AI를 사용하여 실패한 빌드 문제 해결 - 미리 보기

미리 보기 기능

이 기능은 미리 보기이며 변경될 수 있습니다.

EC2 Image Builder 빌드가 실패하면 근본 원인은 시간이 많이 걸리고 식별하기 복잡할 수 있습니다. AWS DevOps 에이전트로 구동되는 Image Builder의 문제 해결 기능은 AI 기반 분석을 통해이 프로세스를 자동화합니다. 복잡한 빌드 실패의 원인을 신속하게 식별하거나 여러 실패한 파이프라인에서 패턴을 감지할 수 있습니다.

빌드가 실패하면 문제 해결을 사용하여 빌드 로그, Amazon CloudWatch logs, 워크플로 단계 실행 및 관련 AWS 리소스를 분석할 수 있습니다. 문제를 해결하기 위한 근본 원인 분석 및 해결 단계를 받게 됩니다.

실패한 단일 파이프라인 빌드 문제를 해결하거나 실패한 여러 파이프라인을 분석하여 일반적인 패턴과 공유된 근본 원인을 식별할 수 있습니다.

사전 조건

문제 해결 기능을 사용하기 전에 사용하는 IAM 사용자 또는 역할에 다음 권한이 있는지 확인합니다.

  • aidevops:ListAgentSpaces - 사용 가능한 에이전트 공간을 검색하는 데 필요합니다.

  • aidevops:CreateChat - 세션 문제 해결을 시작하는 데 필요합니다.

  • aidevops:SendChatMessage - 문제 해결 중에 메시지를 보내는 데 필요합니다.

  • aidevops:CreateAgentSpace - Image Builder가 에이전트 공간을 생성하도록 하려는 경우에만 필요합니다. 자체 에이전트 공간을 가져오는 경우이 권한을 생략할 수 있습니다.

IAM 정책에 대한 자세한 내용은 IAM의 정책 및 권한을 참조하세요.

문제 해결 설정

문제 해결 기능을 사용하려면 AWS DevOps 에이전트 공간이 필요합니다. 기존 에이전트 공간을 사용하거나 Image Builder가 자동으로 생성하도록 할 수 있습니다.

  • 자체 에이전트 공간 가져오기 - 이미 에이전트 공간이 있는 경우 Image Builder는 이를 문제 해결에 사용합니다.

  • Image Builder에서 생성 - 에이전트 공간이 없는 경우 첫 번째 조사를 시작할 때 Image Builder에서 생성 및 구성합니다. 이 옵션에는 aidevops:CreateAgentSpace 권한이 필요합니다.

문제 해결을 시작하려면 AWS Management Console 헤더에서 문제 해결 아이콘을 선택합니다.

참고

AWS DevOps 에이전트에 대한 자세한 내용은 AWS DevOps 에이전트 사용 설명서를 참조하세요.

실패한 빌드 문제 해결

이미지 빌드가 실패하면 Image Builder의 여러 진입점에서 AI 기반 조사를 시작할 수 있습니다 AWS Management Console.

문제 해결 조사 시작

다음 방법 중 하나를 사용하여 실패한 빌드 문제 해결을 시작합니다.

  • 파이프라인 테이블 - 이미지 파이프라인 목록에서 실패한 파이프라인 상태 옆에 있는 문제 해결 아이콘을 선택합니다.

  • 출력 이미지 테이블 - 출력 이미지 목록에서 실패한 이미지 빌드 옆에 있는 문제 해결 아이콘을 선택합니다.

  • 문제 해결 드로어 - AWS Management Console 헤더에서 문제 해결 아이콘을 선택한 다음 조사할 파이프라인을 선택합니다.

조사 중

문제 해결을 시작하면 문제 해결에서 실패를 조사합니다. 로그와 리소스가 분석될 때 드로어에서 실시간 진행 상황을 추적할 수 있습니다. 조사는 일반적으로 몇 분 내에 완료됩니다. 분석이 실행되는 동안 다른 AWS Management Console 영역에서 계속 작업할 수 있습니다. 조사가 완료되면 다음을 받게 됩니다.

  • 빌드가 실패한 이유를 식별하는 근본 원인 분석

  • 문제 해결을 위한 문제 해결 단계

  • 문제 해결을 위한 명령 또는 구성 변경

결과를 검토한 후 응답 품질에 대한 피드백을 제공할 수 있습니다. 동일한 실패한 빌드에 대해 분석을 다시 실행하려면 문제 해결을 다시 선택합니다.

실패한 여러 파이프라인 문제 해결

실패한 파이프라인이 여러 개 있는 경우 파이프라인을 함께 분석하여 일반적인 패턴과 공유된 근본 원인을 식별할 수 있습니다.

집계 조사 시작

다음 방법 중 하나를 사용하여 여러 파이프라인의 문제를 해결합니다.

  • 이미지 파이프라인 테이블에서 실패한 여러 파이프라인을 선택하고 선택한 문제 해결을 선택합니다.

  • 문제 해결 드로어를 열고 모두 문제 해결을 선택하여 실패한 모든 파이프라인을 분석합니다.

분석 결과 집계

근본 원인별로 구성된 그룹화된 분석을 받게 됩니다. 각 그룹에 대해 다음을 얻을 수 있습니다.

  • 공유된 근본 원인에 대한 설명

  • 해당 근본 원인의 영향을 받는 파이프라인

  • 그룹의 문제 해결 단계

집계 분석 후 드릴다운 프롬프트를 선택하여 특정 파이프라인을 자세히 조사할 수 있습니다.

문제 해결에서 조사하는 내용

실패한 빌드 문제를 해결할 때 분석은 다음 영역을 다룹니다.

  • 빌드 로그 및 Amazon CloudWatch logs - 오류, 0이 아닌 종료 코드, 제한 시간 및 스택 추적이 있는지 확인합니다.

  • 워크플로 단계 실행 - 실패한 단계를 식별하고 세부 정보를 검사합니다.

  • 네트워킹 및 권한 - IAM 인스턴스 프로파일 권한, 보안 그룹, 서브넷 라우팅, NAT 게이트웨이, 인터넷 게이트웨이 및 VPC 엔드포인트를 검토합니다.

  • 구성 요소 및 레시피 구성 - 스크립트 오류, 누락된 종속성, 손상된 URLs 및 기본 AMI 유효성을 확인합니다.

  • 네트워크 연결 - AWS Systems Manager (Systems Manager) 에이전트 연결성, DNS 확인 및 프록시 구성을 확인합니다.

  • 빌드 기록 - 최근 빌드를 검토하여 지속적인 실패와 간헐적인 문제를 구분합니다.

고려 사항

문제 해결 기능을 사용할 때는 다음 사항에 유의하세요.

  • 문제 해결은 읽기 전용 분석을 수행합니다. 리소스는 수정되지 않습니다.

  • 문제 해결은 Image Builder 빌드 실패 및 IAM, VPC, Systems Manager Agent와 같은 관련 인프라로 범위가 지정됩니다.

참고

AI는 이러한 응답을 생성합니다. 리소스를 수정하기 전에 분석 및 권장 사항을 확인합니다.

Image Builder 파이프라인 빌드 문제 해결에 대한 자세한 내용은 섹션을 참조하세요파이프라인 빌드 문제 해결.