CodeCatalyst 소스 리포지토리 및 단일 페이지 애플리케이션 블루프린트 시작하기

블루프린트를 사용하여 프로젝트를 생성하려면

1. CodeCatalyst 콘솔에서 프로젝트를 생성하려는 스페이스로 이동합니다.

2. 스페이스 대시보드에서 프로젝트 생성을 선택합니다.

3. 블루프린트로 시작을 선택합니다.

   작은 정보

   Amazon Q가 블루프린트를 제안하도록 프로젝트 요구 사항을 Amazon Q에 제공하여 블루프린트를 추가하도록 선택할 수 있습니다. 자세한 내용은 Amazon Q를 사용하여 프로젝트를 생성하거나 기능을 추가할 때 블루프린트 선택 및 Amazon Q를 사용하여 프로젝트를 생성하거나 블루프린트를 사용하여 기능을 추가할 때의 모범 사례 섹션을 참조하세요. 이 기능은 미국 서부(오리건) 리전에서만 사용할 수 있습니다.

   이 기능을 사용하려면 스페이스에 생성형 AI 기능을 활성화해야 합니다. 자세한 내용은 생성형 AI 기능 관리를 참조하세요.

4. CodeCatalyst 블루프린트 또는 스페이스 블루프린트 탭에서 블루프린트를 선택한 다음 다음을 선택합니다.

5. 프로젝트 이름 지정에 프로젝트에 할당할 이름과 관련 리소스 이름을 입력합니다. 이름은 스페이스 내에서 고유해야 합니다.

6. (선택 사항) 기본적으로 블루프린트에서 생성된 소스 코드는 CodeCatalyst 리포지토리에 저장됩니다. 또는 블루프린트의 소스 코드를 타사 리포지토리에 저장하도록 선택할 수 있습니다. 자세한 내용은 CodeCatalyst에서 확장 프로그램이 있는 프로젝트에 기능 추가 섹션을 참조하세요.

   중요

   CodeCatalyst는 연결된 리포지토리에 대한 기본 브랜치의 변경 사항 감지를 지원하지 않습니다. 연결된 리포지토리의 기본 브랜치를 변경하려면 먼저 CodeCatalyst에서 연결을 해제하고 기본 브랜치를 변경한 다음 다시 연결해야 합니다. 자세한 내용은 CodeCatalyst에서 GitHub 리포지토리, Bitbucket 리포지토리, GitLab 프로젝트 리포지토리 및 Jira 프로젝트 연결 섹션을 참조하세요.

   리포지토리를 연결하기 전에 항상 최신 버전의 확장 프로그램을 사용하는 것이 좋습니다.

   사용하려는 타사 리포지토리 공급자에 따라 다음 중 하나를 수행합니다.

   • GitHub 리포지토리: GitHub 계정을 연결합니다.

     고급 드롭다운 메뉴를 선택하고 GitHub를 리포지토리 공급자로 선택한 다음 블루프린트에서 생성된 소스 코드를 저장할 GitHub 계정을 선택합니다.

     참고

     GitHub 계정을 연결하는 경우 CodeCatalyst ID와 GitHub ID 간에 ID 매핑을 설정하려면 개인 연결을 생성해야 합니다. 자세한 내용은 개인 연결 및 개인 연결을 사용하여 GitHub 리소스에 액세스 섹션을 참조하세요.

   • Bitbucket 리포지토리: Bitbucket 작업 영역을 연결합니다.

     고급 드롭다운 메뉴를 선택하고 Bitbucket을 리포지토리 공급자로 선택한 다음, 블루프린트에서 생성된 소스 코드를 저장할 Bitbucket 작업 영역을 선택합니다.

   • GitLab 리포지토리: GitLab 사용자를 연결합니다.

     고급 드롭다운 메뉴를 선택하고 GitLab을 리포지토리 공급자로 선택한 다음 블루프린트에서 생성된 소스 코드를 저장할 GitLab 사용자를 선택합니다.

7. 프로젝트 리소스에서 블루프린트 파라미터를 구성합니다. 블루프린트에 따라 소스 리포지토리의 이름을 지정할 수 있는 옵션이 있을 수 있습니다.

8. (선택 사항) 구성한 프로젝트 파라미터에 따라 업데이트가 포함된 정의 파일을 보려면 프로젝트 미리 보기 생성에서 코드 보기 또는 워크플로 보기를 선택합니다.

9. (선택 사항) 블루프린트의 아키텍처 개요, 필수 연결 및 권한, 블루프린트가 생성하는 리소스 유형 등 블루프린트에 대한 특정 세부 정보를 보려면 블루프린트 카드에서 세부 정보 보기를 선택합니다.

10. 프로젝트 만들기를 선택합니다.

프로젝트의 소스 리포지토리로 이동하려면

1. 프로젝트로 이동하여 다음 중 하나를 수행합니다.

   • 프로젝트의 요약 페이지에서 목록에서 원하는 리포지토리를 선택한 다음 리포지토리 보기를 선택합니다.

   • 탐색 창에서 코드를 선택한 다음 소스 리포지토리를 선택합니다. 소스 리포지토리의 경우 목록에서 리포지토리의 이름을 선택합니다. 필터 표시줄에 리포지토리 이름의 일부를 입력하여 리포지토리 목록을 필터링할 수 있습니다.

2. 리포지토리의 홈 페이지에서 리포지토리의 내용과 풀 요청 수 및 워크플로와 같은 관련 리소스에 대한 정보를 확인합니다. 기본적으로 기본 브랜치의 내용이 표시됩니다. 드롭다운 목록에서 다른 브랜치를 선택하여 보기를 변경할 수 있습니다.

새 브랜치로 개발 환경을 생성하려면

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

2. 개발 환경을 생성하려는 스페이스로 이동합니다.

3. 프로젝트의 소스 리포지토리 목록에서 리포지토리 이름을 선택합니다. 또는 탐색 창에서 코드를 선택하고 소스 리포지토리를 선택한 다음 개발 환경을 생성할 리포지토리를 선택합니다.

4. 리포지토리 홈 페이지에서 개발 환경 생성을 선택합니다.

5. 드롭다운 메뉴에서 지원되는 IDE를 선택합니다. 자세한 정보는 개발 환경에 지원되는 통합 개발 환경을 참조하세요.

6. 복제할 리포지토리를 선택하고, 새 브랜치에서 작업을 선택하고, 브랜치 이름 필드에 브랜치 이름을 입력하고, 다음에서 브랜치 생성 드롭다운 메뉴에서 새 브랜치를 만들 브랜치를 선택합니다.

7. 원하는 경우 개발 환경의 별칭을 추가할 수 있습니다.

8. 선택적으로 개발 환경 구성 편집 버튼을 선택하여 개발 환경의 컴퓨팅, 스토리지 또는 제한 시간 구성을 편집합니다.

9. 생성(Create)을 선택합니다. 개발 환경이 생성되는 동안 개발 환경 상태 열에 시작 중이 표시되고, 개발 환경이 생성되면 상태 열에 실행 중이 표시됩니다. 선택한 IDE의 개발 환경과 함께 새 탭이 열립니다. 코드를 편집하고 변경 사항을 커밋하고 푸시할 수 있습니다.

AWS Cloud9 개발 환경에서 변경 및 푸시

1. AWS Cloud9에서 사이드 탐색 메뉴를 확장하여 파일을 찾습니다. src를 확장하고 App.tsx를 엽니다.

2. <p> 태그 내부의 텍스트를 변경합니다.

3. 파일을 저장한 다음 Git 메뉴를 사용하여 변경 사항을 커밋하고 푸시합니다. 또는 터미널 창에서 git commit 및 git push 명령을 사용하여 변경 사항을 커밋하고 푸시합니다.

   git commit -am "Making an example change"
   git push

   작은 정보

   Git 명령을 성공적으로 실행하기 전에 터미널의 디렉터리를 Git 리포지토리 디렉터리로 변경해야 할 수 있습니다.

풀 요청을 생성하려면

1. 프로젝트로 이동합니다.

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

   • 탐색 창에서 코드를 선택하고 풀 요청을 선택한 다음 풀 요청 생성을 선택합니다.

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

   • 프로젝트 페이지에서 풀 요청 생성을 선택합니다.

3. 소스 리포지토리에서 지정된 소스 리포지토리가 커밋된 코드가 포함된 리포지토리인지 확인합니다. 이 옵션은 리포지토리의 메인 페이지에서 풀 요청을 생성하지 않은 경우에만 나타납니다.

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

5. 소스 브랜치에서 커밋된 코드가 포함된 브랜치를 선택합니다.

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

7. (선택 사항) 풀 요청 설명에서 문제에 대한 연결 또는 변경 사항에 대한 설명과 같은 정보를 제공합니다.

   작은 정보

   CodeCatalyst가 풀 요청에 포함된 변경 사항에 대한 설명을 자동으로 생성하도록 설명 쓰기를 선택할 수 있습니다. 자동으로 생성된 설명은 풀 요청에 추가한 후에 변경할 수 있습니다.

   이 기능을 사용하려면 스페이스에 생성형 AI 기능을 활성화해야 하며 연결된 리포지토리의 풀 요청에 사용할 수 없습니다. 자세한 내용은 생성형 AI 기능 관리를 참조하세요.

8. (선택 사항) 문제에서 문제 연결을 선택한 다음 목록에서 문제를 선택하거나 해당 ID를 입력합니다. 문제를 연결 해제하려면 연결 해제 아이콘을 선택합니다.

9. (선택 사항) 필수 검토자에서 필수 검토자 추가를 선택합니다. 프로젝트 멤버 목록에서 추가할 멤버를 선택합니다. 필수 검토자는 풀 요청을 대상 브랜치에 병합하기 전에 변경 사항을 승인해야 합니다.

   참고

   검토자를 추가할 때 필수 검토자이면서 동시에 선택적 검토자로 추가할 수 없습니다. 자신을 검토자로 추가할 수 없습니다.

10. (선택 사항) 선택적 검토자에서 선택적 검토자 추가를 선택합니다. 프로젝트 멤버 목록에서 추가할 멤버를 선택합니다. 선택적 검토자는 풀 요청을 대상 브랜치에 병합하기 전에 변경 사항을 요구 사항으로 승인할 필요가 없습니다.

11. 브랜치 간의 차이점을 검토합니다. 풀 요청에 표시되는 차이점은 소스 브랜치의 수정본과 풀 요청이 생성된 시점의 대상 브랜치의 헤드 커밋인 병합 기반 간의 변경 사항입니다. 변경 사항이 표시되지 않으면 브랜치가 동일하거나 소스와 대상 모두에 대해 동일한 브랜치를 선택했을 수 있습니다.

12. 풀 요청에 검토하려는 코드와 변경 사항이 포함되어 있다고 판단되면 생성을 선택합니다.

    참고

    풀 요청을 생성한 후 설명을 추가할 수 있습니다. 풀 요청 또는 파일의 개별 줄 및 풀 요청 전반에 설명을 추가할 수 있습니다. @ 기호와 파일 이름을 사용하여 파일과 같은 리소스에 대한 연결을 추가할 수 있습니다.

풀 요청 병합(콘솔)

1. 풀 요청에서 이전 단계에서 생성한 풀 요청을 선택합니다. 풀 요청에서 병합을 선택합니다.

2. 풀 요청에서 사용 가능한 병합 전략 중에서 선택합니다. 선택적으로 풀 요청을 병합한 후 소스 브랜치를 삭제하는 옵션을 선택하거나 선택 취소한 다음 병합을 선택합니다. 병합이 완료되면 풀 요청 상태가 병합됨으로 변경되고 풀 요청의 기본 보기에 더 이상 표시되지 않습니다. 기본 보기에는 상태가 미결인 풀 요청이 표시됩니다. 병합된 풀 요청은 계속 볼 수 있지만 승인하거나 상태를 변경할 수는 없습니다.

   참고

   병합 버튼이 활성화되지 않았거나 병합할 수 없음 레이블이 표시되면 필수 검토자가 아직 풀 요청을 승인하지 않았거나 CodeCatalyst 콘솔에서 풀 요청을 병합할 수 없습니다. 풀 요청을 승인하지 않은 검토자는 풀 요청 세부 정보 영역의 개요에 시계 아이콘으로 표시됩니다. 필요한 모든 검토자가 풀 요청을 승인했지만 병합 버튼이 여전히 활성화되어 있지 않은 경우 병합 충돌이 발생하거나 스페이스의 스토리지 할당량을 초과했을 수 있습니다. 개발 환경에서 대상 브랜치의 병합 충돌을 해결하고, 변경 사항을 푸시한 다음 풀 요청을 병합하거나, 충돌을 해결하고 로컬에서 병합한 다음 병합이 포함된 커밋을 CodeCatalyst에 푸시할 수 있습니다. 자세한 내용은 풀 요청 병합(Git) 섹션 및 Git 설명서를 참조하세요.

배포된 코드 보기

1. 워크플로의 onPushToMainDeployPipeline에서 최근 실행을 확장합니다.

   참고

   이 이름은 단일 페이지 애플리케이션 블루프린트로 생성된 프로젝트에 대한 워크플로의 기본 이름입니다.

2. 가장 최근의 실행은 병합된 풀 요청이 main 브랜치에 커밋된 것으로 시작되며, 진행 중 상태가 표시될 가능성이 높습니다. 목록에서 성공적으로 완료된 실행을 선택하여 해당 실행의 세부 정보를 엽니다.

3. 변수를 선택합니다. AppURL 값을 복사합니다. 배포된 단일 페이지 웹 애플리케이션의 URL입니다. 새 브라우저 탭을 열고 값을 붙여넣으면 빌드 및 배포된 코드를 볼 수 있습니다. 탭을 열어 둡니다.

4. 워크플로 실행 목록으로 돌아가서 가장 최근의 실행이 완료될 때까지 기다립니다. 이 경우 열었던 탭으로 돌아가 웹 애플리케이션을 보고 브라우저를 새로 고칩니다. 병합된 풀 요청에서 변경한 내용이 표시됩니다.