기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다.
# AI를 사용하여 실패한 빌드 문제 해결 - 미리 보기
**미리 보기 기능**
이 기능은 미리 보기이며 변경될 수 있습니다.
EC2 Image Builder 빌드가 실패하면 근본 원인은 시간이 많이 걸리고 식별하기 복잡할 수 있습니다. AWS DevOps 에이전트로 구동되는 Image Builder의 문제 해결 기능은 AI 기반 분석을 통해이 프로세스를 자동화합니다. 복잡한 빌드 실패의 원인을 신속하게 식별하거나 여러 실패한 파이프라인에서 패턴을 감지할 수 있습니다.
빌드가 실패하면 문제 해결을 사용하여 빌드 로그, Amazon CloudWatch logs, 워크플로 단계 실행 및 관련 AWS 리소스를 분석할 수 있습니다. 문제를 해결하기 위한 근본 원인 분석 및 해결 단계를 받게 됩니다.
실패한 단일 파이프라인 빌드 문제를 해결하거나 실패한 여러 파이프라인을 분석하여 일반적인 패턴과 공유된 근본 원인을 식별할 수 있습니다.
**Topics**
+ [사전 조건](#devops-agent-troubleshooting-prereqs)
+ [문제 해결 설정](#devops-agent-troubleshooting-setup)
+ [실패한 빌드 문제 해결](#devops-agent-troubleshooting-single)
+ [실패한 여러 파이프라인 문제 해결](#devops-agent-troubleshooting-aggregate)
+ [문제 해결에서 조사하는 내용](#devops-agent-troubleshooting-checks)
+ [고려 사항](#devops-agent-troubleshooting-considerations)
## 사전 조건
문제 해결 기능을 사용하기 전에 사용하는 IAM 사용자 또는 역할에 다음 권한이 있는지 확인합니다.
+ `aidevops:ListAgentSpaces` - 사용 가능한 에이전트 공간을 검색하는 데 필요합니다.
+ `aidevops:CreateChat` - 세션 문제 해결을 시작하는 데 필요합니다.
+ `aidevops:SendChatMessage` - 문제 해결 중에 메시지를 보내는 데 필요합니다.
+ `aidevops:CreateAgentSpace` - Image Builder가 에이전트 공간을 생성하도록 하려는 경우에만 필요합니다. 자체 에이전트 공간을 가져오는 경우이 권한을 생략할 수 있습니다.
IAM 정책에 대한 자세한 내용은 [IAM의 정책 및 권한을](https://docs.aws.amazon.com/IAM/latest/UserGuide/access_policies.html) 참조하세요.
## 문제 해결 설정
문제 해결 기능을 사용하려면 AWS DevOps 에이전트 공간이 필요합니다. 기존 에이전트 공간을 사용하거나 Image Builder가 자동으로 생성하도록 할 수 있습니다.
+ **자체 에이전트 공간 가져오기** - 이미 에이전트 공간이 있는 경우 Image Builder는 이를 문제 해결에 사용합니다.
+ **Image Builder에서 생성 **- 에이전트 공간이 없는 경우 첫 번째 조사를 시작할 때 Image Builder에서 생성 및 구성합니다. 이 옵션에는 `aidevops:CreateAgentSpace` 권한이 필요합니다.
문제 해결을 시작하려면 AWS Management Console 헤더에서 **문제 해결** 아이콘을 선택합니다.
**참고**
AWS DevOps 에이전트에 대한 자세한 내용은 [AWS DevOps 에이전트 사용 설명서를](https://docs.aws.amazon.com/devopsagent/latest/userguide/) 참조하세요.
## 실패한 빌드 문제 해결
이미지 빌드가 실패하면 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 파이프라인 빌드 문제 해결에 대한 자세한 내용은 섹션을 참조하세요[파이프라인 빌드 문제 해결](troubleshooting.md#troubleshooting-pipelines).