AEM 개발 에이전트를 사용한 CI/CD 파이프라인 문제 해결

다음과 같이 BylineImpl.java 파일에 단위 테스트 오류가 도입되었습니다. 자체 AEM 프로젝트를 사용하는 경우 유사한 단위 테스트 실패를 도입할 수 있습니다.

...
@Override
public String getName() {
    if (name != null) {
        return "Author: " + name; // This line is intentionally incorrect to introduce a unit test failure.
    }
    return name;
}
...

WKND Sites 프로젝트를 로컬 컴퓨터에 복제하고 프로젝트 디렉터리로 이동한 다음 tutorial/dev-agent/unit-test-failure 분기로 전환합니다.

git clone https://github.com/adobe/aem-guides-wknd.git
cd aem-guides-wknd
git checkout tutorial/dev-agent/unit-test-failure

WKND Sites 프로젝트용 새 Cloud Manager Git 저장소를 생성하고 로컬 Git 저장소에 원격으로 추가합니다.

• Adobe Cloud Manager​(으)로 이동하여 프로그램을 선택합니다.

• 왼쪽 사이드바에서 저장소​를 클릭합니다.

• 오른쪽 상단 모서리에서 저장소 추가​를 클릭합니다.

• 저장소 이름(예: "wknd-site-tutorial")을 입력하고 저장​을 클릭합니다. 저장소가 생성될 때까지 기다립니다.

  

• 오른쪽 상단의 저장소 정보 액세스​를 클릭하고 저장소 URL을 복사합니다.

  

• 새로 만든 Cloud Manager Git 저장소를 로컬 Git 저장소에 원격으로 추가합니다.

  code language-shell
  git remote add adobe https://git.cloudmanager.adobe.com/<your-adobe-organization>/wknd-site-tutorial/

로컬 Git 저장소를 Cloud Manager Git 저장소로 푸시합니다.

git push adobe

자격 증명을 입력하라는 메시지가 뜨면 Cloud Manager의 저장소 정보 양식에서 사용자 이름 및 암호​을(를) 제공하세요.

Cloud Manager에서 파이프라인 섹션으로 이동한 다음 추가 > 비프로덕션 파이프라인 추가​를 선택합니다.

비프로덕션 파이프라인 추가 대화 상자에서 다음을 구성합니다.

• 구성 단계:

  • 파이프라인 유형​을(를) Code Quality Pipeline(으)로, 배포 트리거​를 Manual(으)로 유지합니다.
  • 비프로덕션 파이프라인 이름​에 대해 Code Quality::Fullstack을(를) 입력하십시오.

  

• Source 코드 단계:

  • 전체 스택 코드 선택
  • 저장소​에 대해 새로 만든 Cloud Manager Git 저장소를 선택합니다.
  • Git 분기​에 대해 tutorial/dev-agent/unit-test-failure을(를) 선택합니다.
  • 저장 클릭

  

파이프라인 항목의 세 점 메뉴에서 실행​을 클릭하여 새로 만든 코드 품질 파이프라인을 실행합니다.

오른쪽 상단의 AI Assistant 아이콘을 클릭합니다.

Prompt​이라는 자연어로 파이프라인 실패 세부 정보를 입력하십시오. 예:

I have a failed pipeline execution on %PROGRAM-NAME% program, help me to troubleshoot and fix it.

실패한 파이프라인 실행 문제를 해결하고 해결하기 위해 AEM 개발 에이전트​이(가) 호출됩니다.

추론이 완료되면 전체 화면으로 열기 아이콘을 클릭하여 자세한 문제 해결 프로세스를 확인합니다.

결과에는 오류 세부 정보, 원본 파일, 줄 번호 및 문제 해결 단계가 명확한 해결 방법 섹션을 포함한 중요한 통찰력이 포함되어 있습니다.

이 경우 에이전트는 문제를 해결하기 위해 구현(getName() 메서드)을 변경하거나 단위 테스트(getNameTest() 메서드)를 업데이트할 것을 올바르게 제안했습니다. 개발자에게 실행 가능한 코드 변경 사항을 제공하면서 환각을 피하고 수동 루프 접근 방식을 사용했습니다.

제안된 코드 변경 내용으로 BylineImpl.java 파일을 업데이트한 다음 변경 내용을 커밋하고 Cloud Manager Git 저장소에 푸시합니다.

...
@Override
public String getName() {
    return name;
}
...

파이프라인을 다시 실행하고 성공적인 실행을 확인합니다.