자습서: CodeCatalyst 생성형 AI 기능을 사용하여 개발 작업 속도 향상

https://codecatalyst.aws/에서 CodeCatalyst 콘솔을 엽니다.

CodeCatalyst 콘솔에서 블루프린트를 생성할 스페이스로 이동합니다.

스페이스 대시보드에서 Amazon Q로 생성을 선택합니다.

Amazon Q 프롬프트 텍스트 입력 필드에서 빌드하려는 프로젝트에 대한 간략한 설명을 작성하여 지침을 제공합니다. 예시: “I want to create a project in Python that has a presentation layer responsible for how the data is presented, an application layer that contains the core logic and functionality of the application, and a data layer that manages the storage and retrieval of the data.”

(선택 사항) 연습 예시에서 블루프린트를 선택하여 미리 작성된 프롬프트를 사용할 수 있습니다. 예를 들어 React 앱을 선택하면 다음 프롬프트가 제공됩니다. “I want to create a project in Python that has a presentation layer responsible for how the data is presented, an application layer that contains the core logic and functionality of the application, and a data layer that manages the storage and retrieval of the data. I also want to add authentication and authorization mechanisms for security and allowable actions.”

전송을 선택하여 Amazon Q에 지침을 제출하세요. 생성형 AI 어시스턴트는 블루프린트에서 충족할 수 없는 요구 사항을 제안하고 간략하게 설명합니다. 예를 들어 Amazon Q는 사용자의 기준에 따라 다음을 제안할 수 있습니다.

I recommend using the Modern three-tier web application blueprint based on 
                    your requirements. Blueprints are dynamic and can always be updated and edited later.

Modern three-tier web application
By Amazon Web Services

This blueprint creates a Mythical Mysfits 3-tier web application with a modular presentation, application, and data layers. 
The application leverages containers, infrastructure as code (IaC), continuous integration and continuous delivery (CI/CD), 
and serverless code functions.

Version: 0.1.163

View details

The following requirements could not be met so I will create issues for you.
• Add authentication and authorization mechanisms for security and allowable actions.

(선택 사항) 제안된 블루프린트의 세부 정보를 보려면 세부 정보 보기를 선택합니다.

다음 중 하나를 수행합니다.

1. 제안에 만족하는 경우 예, 이 블루프린트를 사용합니다를 선택합니다.

2. 프롬프트를 수정하려면 프롬프트 편집을 선택합니다.

3. 프롬프트를 완전히 지우려면 다시 시작을 선택합니다.

다음 중 하나를 수행합니다.

1. 제안된 블루프린트를 구성하려면 구성을 선택합니다. 나중에 블루프린트를 구성할 수도 있습니다.

2. 현재 블루프린트 구성을 수정하지 않으려면 건너뛰기를 선택합니다.

블루프린트를 구성하기로 선택한 경우 프로젝트 리소스를 수정한 후 계속을 선택합니다.

메시지가 표시되면 프로젝트에 할당할 이름과 관련 리소스 이름을 입력합니다. 이름은 스페이스 내에서 고유해야 합니다.

프로젝트 생성을 선택하여 블루프린트로 프로젝트를 생성합니다. Amazon Q는 블루프린트를 사용하여 리소스를 생성합니다. 예를 들어 단일 페이지 애플리케이션 블루프린트로 프로젝트를 생성하면 CI/CD에 대한 관련 코드 및 워크플로에 대한 소스 리포지토리가 생성됩니다.

(선택 사항) 기본적으로 Amazon Q는 블루프린트에 부합하지 않는 요구 사항에 대한 문제도 생성합니다. 문제를 생성하지 않으려는 항목을 선택할 수 있습니다. Amazon Q에서 문제를 생성하도록 선택한 후 Amazon Q에도 문제를 할당할 수 있습니다. 지정된 소스 리포지토리의 컨텍스트에서 문제를 분석하여 관련 소스 파일 및 코드의 요약을 제공합니다. 자세한 내용은 문제 찾기 및 보기, 문제를 생성하고 Amazon Q에 할당, Amazon Q에 할당된 문제를 생성하고 작업할 때의 모범 사례 섹션을 참조하세요.

https://codecatalyst.aws/에서 CodeCatalyst 콘솔을 엽니다.

CodeCatalyst 콘솔에서 블루프린트를 추가하려는 프로젝트로 이동합니다.

Amazon Q로 추가를 선택합니다.

Amazon Q 프롬프트 텍스트 입력 필드에서 빌드하려는 프로젝트에 대한 간략한 설명을 작성하여 지침을 제공합니다. 예시: “I want to create a project in Python that has a presentation layer responsible for how the data is presented, an application layer that contains the core logic and functionality of the application, and a data layer that manages the storage and retrieval of the data.”

(선택 사항) 연습 예시에서 블루프린트를 선택하여 미리 작성된 프롬프트를 사용할 수 있습니다. 예를 들어 React 앱을 선택하면 다음 프롬프트가 제공됩니다. “I want to create a project in Python that has a presentation layer responsible for how the data is presented, an application layer that contains the core logic and functionality of the application, and a data layer that manages the storage and retrieval of the data. I also want to add authentication and authorization mechanisms for security and allowable actions.”

전송을 선택하여 Amazon Q에 지침을 제출하세요. 생성형 AI 어시스턴트는 블루프린트에서 충족할 수 없는 요구 사항을 제안하고 간략하게 설명합니다. 예를 들어 Amazon Q는 사용자의 기준에 따라 다음을 제안할 수 있습니다.

I recommend using the Single-page application blueprint based on your requirements. Blueprints are dynamic and can always be updated and edited later.

Single-page application
By Amazon Web Services

This blueprint creates a SPA (single-page application) using React, Vue, or Angular frameworks and deploys to AWS Amplify Hosting.

Version: 0.2.15
View details

The following requirements could not be met so I will create issues for you.
• The application should have reusable UI components
• The application should support for client-side routing
• The application may require server-side rendering for improved performance and SEO

(선택 사항) 제안된 블루프린트의 세부 정보를 보려면 세부 정보 보기를 선택합니다.

다음 중 하나를 수행합니다.

1. 제안에 만족하는 경우 예, 이 블루프린트를 사용합니다를 선택합니다.

2. 프롬프트를 수정하려면 프롬프트 편집을 선택합니다.

3. 프롬프트를 완전히 지우려면 다시 시작을 선택합니다.

다음 중 하나를 수행합니다.

1. 제안된 블루프린트를 구성하려면 구성을 선택합니다. 나중에 블루프린트를 구성할 수도 있습니다.

2. 현재 블루프린트 구성을 수정하지 않으려면 건너뛰기를 선택합니다.

블루프린트를 구성하기로 선택한 경우 프로젝트 리소스를 수정한 후 계속을 선택합니다.

프로젝트에 추가를 선택하여 블루프린트로 프로젝트에 리소스를 추가합니다. Amazon Q는 블루프린트를 사용하여 리소스를 생성합니다. 예를 들어 단일 페이지 애플리케이션 블루프린트를 사용하여 프로젝트에 를 추가하면 CI/CD에 대한 관련 코드 및 워크플로에 대한 소스 리포지토리가 생성됩니다.

(선택 사항) 기본적으로 Amazon Q는 블루프린트에 부합하지 않는 요구 사항에 대한 문제도 생성합니다. 문제를 생성하지 않으려는 항목을 선택할 수 있습니다. Amazon Q에서 문제를 생성하도록 선택한 후 Amazon Q에도 문제를 할당할 수 있습니다. 지정된 소스 리포지토리의 컨텍스트에서 문제를 분석하여 관련 소스 파일 및 코드의 요약을 제공합니다. 자세한 내용은 문제를 생성하고 Amazon Q에 할당 및 Amazon Q에 할당된 문제를 생성하고 작업할 때의 모범 사례 섹션을 참조하세요.

CodeCatalyst 콘솔에서 소스 리포지토리가 있는 프로젝트로 이동합니다.

프로젝트의 소스 리포지토리 목록에서 리포지토리 이름을 선택합니다. 아니면 탐색 창에서 코드를 선택한 다음 소스 리포지토리를 선택합니다.

브랜치를 생성하려는 리포지토리의 이름을 선택합니다.

리포지토리의 개요 페이지에서 추가를 선택한 다음 브랜치 생성을 선택합니다.

브랜치의 이름을 입력합니다.

브랜치를 생성할 브랜치를 선택한 다음 생성을 선택합니다.

mysfits 소스 리포지토리의 개요 페이지에서 브랜치 드롭다운을 선택하고 이전 절차에서 생성한 브랜치를 선택합니다.

파일에서 편집하려는 파일로 이동합니다. 예를 들어 test_endpoint.py 파일을 편집하려면 테스트를 확장하고 통합을 확장한 다음 test_endpoint.py를 선택합니다.

편집을 선택합니다.

7번 줄에서 모든 테스트를 다시 시도할 횟수를 변경합니다. 변경 전:

def test_list_all(retry=3):

변경 후:

def test_list_all(retry=5):

커밋을 선택하고 변경 사항을 브랜치에 커밋합니다.

리포지토리의 개요 페이지에서 추가를 선택한 다음 풀 요청 생성을 선택합니다.

대상 브랜치에서 코드를 검토한 후 병합할 브랜치를 선택합니다.

소스 브랜치에서 test_endpoint.py 파일에 방금 커밋한 변경 사항이 포함된 브랜치를 선택합니다.

풀 요청 제목에 다른 사용자가 검토해야 할 사항과 이유를 이해하는 데 도움이 되는 제목을 입력합니다.

풀 요청 설명에서 설명 쓰기를 선택하여 Amazon Q가 풀 요청에 포함된 변경 사항에 대한 설명을 생성하도록 합니다.

변경 사항 요약이 나타납니다. 제안된 텍스트를 검토한 다음 수락을 선택하고 설명에 추가합니다.

선택적으로 코드에 대한 변경 사항을 더 잘 반영하도록 요약을 수정합니다. 검토자를 추가하거나 이 풀 요청에 문제를 연결하도록 선택할 수도 있습니다. 원하는 추가 변경을 완료했으면 생성을 선택합니다.

이전 절차에서 생성한 풀 요청으로 이동합니다.

풀 요청에 아직 주석이 없는 경우 변경 사항의 풀 요청에 몇 가지 주석을 추가합니다.

개요에서 의견 요약 생성을 선택합니다. 완료되면 주석 요약 섹션이 확장됩니다.

풀 요청 개정의 코드 변경에 대해 남아 있는 의견 요약을 검토하고 풀 요청의 의견과 비교합니다.

탐색 창에서 문제를 선택하고 보드 보기에 있는지 확인합니다.

문제 생성을 선택합니다.

문제에 일반적인 언어로 하려는 작업을 설명하는 제목을 지정합니다. 예를 들어 이 문제에는 Create another mysfit named Quokkapus 제목을 입력합니다. 설명에 다음 세부 정보를 제공합니다.

Expand the table of mysfits to 13, and give the new mysfit the following characteristics:

Name: Quokkapus

Species: Quokka-Octopus hybrid

Good/Evil: Good

Lawful/Chaotic: Chaotic

Age: 216

Description: Australia is full of amazing marsupials, but there's nothing there quite like the Quokkapus. 
She's always got a friendly smile on her face, especially when she's using her eight limbs to wrap you up 
in a great big hug. She exists on a diet of code bugs and caffeine. If you've got some gnarly code that needsa
assistance, adopt Quokkapus and put her to work - she'll love it! Just make sure you leave enough room for 
her to grow, and keep that coffee coming.

(선택 사항) mysfit을 위한 축소판 그림 및 프로파일 사진으로 사용할 이미지를 문제에 연결합니다. 이렇게 하면 설명을 업데이트하여 사용하려는 이미지와 그 이유에 대한 세부 정보를 포함합니다. 예를 들어 설명에 'mysfit을 사용하려면 웹 사이트에 이미지 파일을 배포해야 합니다. 이 문제에 연결된 이미지를 작업의 일부로 소스 리포지토리에 추가하고 웹 사이트에 이미지를 배포합니다.'

설명을 검토하고 다음 단계로 진행하기 전에 필요할 수 있는 모든 세부 정보가 포함되어 있는지 확인합니다.

담당자에서 Amazon Q에 할당을 선택합니다.

소스 리포지토리의 경우 소스 코드가 포함된 리포지토리의 이름을 선택합니다.

필요한 경우 각 단계 후 중지하고 작업 검토를 대기하도록 Amazon Q에 요구 선택기를 활성 상태로 합니다.

Amazon Q가 워크플로 파일을 수정하도록 허용 선택기를 비활성 상태로 둡니다.

Amazon Q가 작업을 제안하도록 허용을 활성 상태로 설정합니다.

문제 생성을 선택합니다. 보기가 문제 보드로 변경됩니다.

문제 생성을 선택하여 이번에는 제목이 Change the get_all_mysfits() API to return mysfits sorted by the Age attribute인 다른 문제를 생성합니다. 이 문제를 Amazon Q에 할당하고 문제를 생성합니다.

문제 생성을 선택하여 이번에는 제목이 Update the OnPullRequest workflow to include a branch named test in its triggers인 다른 문제를 생성합니다. 선택적으로 설명의 워크플로에 연결합니다. 이 문제를 Amazon Q에 할당하되 이번에는 Amazon Q가 워크플로 파일을 수정하도록 허용 선택기가 활성 상태로 설정되어 있는지 확인합니다. 문제를 생성하여 문제 보드로 돌아갑니다.

문제에서 진행 중인 Amazon Q에 할당된 문제를 선택합니다. 의견을 검토하여 Amazon Q의 진행 상황을 모니터링합니다. 의견이 있는 경우 배경을 검토하고 문제에 대한 설명에 있는 레코드에 접근합니다. Amazon Q가 작업을 제안하도록 허용하기로 선택한 경우 제안된 작업을 검토하고 필요한 조치를 취합니다. 예를 들어 Amazon Q에서 태스크를 제안하고 순서를 변경하거나 특정 사용자에게 태스크를 할당하려는 경우 태스크 변경, 추가 또는 재정렬을 선택하고 필요한 업데이트를 수행합니다. 문제 보기를 완료했으면 X를 선택하여 문제 창을 닫습니다.

이제 검토 중인 Amazon Q에 할당된 문제를 선택합니다. 배경을 검토하고 문제에 대한 설명에서 기록으로 접근합니다. 설명을 검토하여 수행한 작업을 이해합니다. 진행 상황, 취해야 할 조치, 의견을 포함하여 이 문제와 관련된 작업을 위해 생성된 모든 작업을 검토합니다. 풀 요청에서 오픈 레이블 옆의 풀 요청에 대한 연결을 선택하여 코드를 검토합니다.

풀 요청에서 코드 변경 사항을 검토합니다. 자세한 내용은 풀 요청 검토 섹션을 참조하십시오. Amazon Q가 제안된 코드를 변경하도록 하려면 풀 요청에 대한 설명을 남겨 둡니다. 최상의 결과를 얻으려면 Amazon Q에 대한 의견을 남길 때 구체적으로 설명하세요.

예를 들어, Create another mysfit named Quokkapus에 대해 생성된 풀 요청을 검토할 때 설명에 오타가 있음을 확인할 수 있습니다. "'needsa'라는 오타를 'needs'와 'a' 사이에 공백을 추가하여 수정하도록 설명을 변경하라"고 Amazon Q에 대한 주석을 남길 수 있습니다. 또는 Amazon Q에 설명을 업데이트하고 통합하도록 수정된 전체 설명을 제공하도록 지시하는 주석을 남길 수 있습니다.

새 mysfit에 대한 이미지를 웹 사이트에 업로드한 경우 Amazon Q에 대한 주석을 남겨 새 mysfit에 사용할 이미지 및 축소판에 대한 포인터로 mysfit을 업데이트할 수 있습니다.

(선택 사항) 사용자와 다른 프로젝트 사용자가 코드 변경에 필요한 모든 설명을 남긴 후 리비전 생성을 선택하여 Amazon Q가 요청한 변경 사항을 설명에 통합하는 풀 요청의 개정을 생성하도록 합니다. 기비전 생성 진행 상황은 변경 사항이 아닌 개요에서 Amazon Q에 보고됩니다. 리비전 생성 시 Amazon Q의 최신 업데이트를 보려면 브라우저를 새로 고쳐야 합니다.

이 예시 프로젝트의 각 풀 요청에 대해 워크플로가 실행됩니다. 풀 요청을 병합하기 전에 워크플로가 성공적으로 실행되었는지 확인합니다. 코드를 병합하기 전에 코드를 테스트할 추가 워크플로 및 환경을 생성하도록 선택할 수도 있습니다. 자세한 내용은 워크플로 시작하기 섹션을 참조하십시오.

풀 요청의 최신 개정에 만족하면 병합을 선택합니다.

탐색 창에서 문제를 선택하고 보드 보기에 있는지 확인합니다.

문제 생성을 선택합니다.

문제에 일반적인 언어로 하려는 작업을 설명하는 제목을 지정합니다. 예를 들어 이 문제에는 Change the get_all_mysfits() API to return mysfits sorted by the Good/Evil attribute 제목을 입력합니다. 설명에 다음 세부 정보를 제공합니다.

Update the API to allow sorting of mysfits by whether they are Good, Neutral, or Evil. Add a button on the website that allows users to quickly choose this sort and to exclude alignments that they don't want to see.

설명을 검토하고 다음 단계로 진행하기 전에 필요할 수 있는 모든 세부 정보가 포함되어 있는지 확인합니다.

담당자에서 문제를 자신에게 할당하도록 선택합니다.

문제 생성을 선택합니다. 보기가 문제 보드로 변경됩니다.

방금 생성한 문제를 선택하여 엽니다. 작업 추천을 선택합니다.

리포지토리의 경우 소스 코드가 포함된 리포지토리의 이름을 선택합니다. 작업 추천 시작을 선택합니다.