튜토리얼: 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.”

(선택 사항) Try examples에서 블루프린트를 선택하여 미리 작성된 프롬프트를 사용할 수 있습니다. 예를 들어 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.”

[Send] 를 선택하여 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. 프롬프트를 완전히 지우려면 [Start over] 를 선택합니다.

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

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

2. 현재 블루프린트 구성을 수정하지 않으려면 스킵을 선택하세요.

블루프린트를 구성하기로 선택한 경우, 프로젝트 리소스를 수정한 후 Continue를 선택하세요.

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

Create project (프로젝트 만들기) 를 선택하여 블루프린트로 프로젝트를 생성합니다. 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.”

(선택 사항) Try examples에서 블루프린트를 선택하여 미리 작성된 프롬프트를 사용할 수 있습니다. 예를 들어 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.”

[Send] 를 선택하여 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. 프롬프트를 완전히 지우려면 [Start over] 를 선택합니다.

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

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

2. 현재 블루프린트 구성을 수정하지 않으려면 스킵을 선택하세요.

블루프린트를 구성하기로 선택한 경우, 프로젝트 리소스를 수정한 후 Continue를 선택하세요.

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

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

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

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

브랜치를 만들려는 리포지토리를 선택합니다.

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

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

브랜치를 만들 브랜치를 선택한 다음 [Create] 를 선택합니다.

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

파일에서 편집하려는 파일을 탐색합니다. 예를 들어 test_endpoint.py 파일을 편집하려면 테스트를 확장하고 integ를 확장한 다음 선택하십시오test_endpoint.py.

편집을 선택합니다.

7행에서 모든 테스트를 재시도할 횟수를 다음과 같이 변경합니다.

def test_list_all(retry=3):

변경 후:

def test_list_all(retry=5):

Commit을 선택하고 변경 내용을 브랜치에 커밋합니다.

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

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

소스 브랜치에서 방금 test_endpoint.py 파일에 커밋한 변경 내용이 들어 있는 브랜치를 선택합니다.

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

풀 리퀘스트 설명에서 나를 위한 설명 작성을 선택하면 Amazon Q에서 풀 리퀘스트에 포함된 변경 사항에 대한 설명을 생성하도록 할 수 있습니다.

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

코드에서 변경한 내용을 더 잘 반영하도록 요약을 수정할 수도 있습니다. 이 풀 리퀘스트에 리뷰어를 추가하거나 이슈를 연결하도록 선택할 수도 있습니다. 원하는 추가 변경을 마쳤으면 [Create] 를 선택합니다.

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

풀 리퀘스트에 아직 댓글이 없는 경우 변경사항에서 풀 리퀘스트에 코멘트를 몇 개 추가하세요.

개요에서 댓글 요약 만들기를 선택합니다. 완료되면 댓글 요약 섹션이 확장됩니다.

풀 리퀘스트 수정 시 코드 변경에 대해 남긴 주석의 요약을 검토하고 이를 풀 리퀘스트의 주석과 비교하십시오.

탐색 창에서 이슈를 선택하고 보드 뷰에 있는지 확인합니다.

이슈 만들기를 선택합니다.

수행하려는 작업을 평이한 언어로 설명하는 제목을 이슈에 붙이세요. 예를 들어, 이 문제의 경우 제목을 입력합니다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에 할당을 선택합니다.

소스 리포지토리에서 프로젝트 코드가 들어 있는 소스 리포지토리를 선택합니다.

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

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

Allow 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에 댓글을 남길 때는 구체적으로 작성하세요.

예를 들어, 생성된 pull 요청을 검토할 때 Create another mysfit named Quokkapus 설명에 오타가 있는 것을 확인할 수 있습니다. Amazon Q에 “" needs"와 “a” 사이에 공백을 추가하여 “needsa”의 오타를 수정하려면 설명을 변경하십시오.” 라는 댓글을 남길 수 있습니다. 또는 설명을 업데이트하고 설명이 포함되도록 수정된 전체 설명을 제공하라는 설명을 Amazon Q에 남길 수도 있습니다.

웹사이트에 새 mysfit 이미지를 업로드한 경우 Amazon Q에 댓글을 남기면 이미지에 대한 포인터와 새 mysfit에 사용할 썸네일로 mysfit을 업데이트할 수 있습니다.

(선택 사항) 귀하와 다른 프로젝트 사용자가 코드 변경을 원하는 모든 코멘트를 남긴 후, Create revision을 선택하여 Amazon Q가 코멘트에 요청한 변경 내용을 포함하는 풀 리퀘스트의 개정판을 생성하도록 합니다. Amazon Q는 변경 내용이 아닌 개요에서 수정 버전 생성 진행 상황을 보고합니다. 수정 버전 생성에 대한 Amazon Q의 최신 업데이트를 보려면 브라우저를 새로 고침해야 합니다.

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

풀 리퀘스트의 최신 버전에 만족하면 Merge를 선택합니다.

탐색 창에서 이슈를 선택하고 보드 뷰에 있는지 확인합니다.

이슈 만들기를 선택합니다.

수행하려는 작업을 평이한 언어로 설명하는 제목을 이슈에 붙이세요. 예를 들어, 이 문제의 경우 제목을 입력합니다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.

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

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

이슈 생성을 선택합니다. 보기가 이슈 게시판으로 바뀝니다.

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

문제의 코드가 들어 있는 소스 리포지토리를 선택합니다. 작업 추천 시작을 선택합니다.