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

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

1. CodeCatalyst 콘솔에서 프로젝트를 생성할 공간으로 이동합니다.

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

3. 청사진으로 시작을 선택합니다.

   작은 정보

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

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

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

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

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

   중요

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

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

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

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

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

     참고

     GitHub 계정을 연결하는 경우 개인 연결을 생성하여 자격 증명과 자격 증명 간의 GitHub 자격 CodeCatalyst 증명 매핑을 설정해야 합니다. 자세한 내용은 개인 연결 및 개인 연결을 사용하여 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 메뉴에서 지원되는 을 선택합니다. 자세한 내용은 Dev Environments에 지원되는 통합 개발 환경 섹션을 참조하세요.

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

   참고

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

배포된 코드를 보려면

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

   참고

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

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

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

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