커스텀 블루프린트 시작하기

블루프린트를 생성하는 과정에서 블루프린트를 구성하고 프로젝트 리소스의 미리보기를 생성할 수 있습니다. 각 사용자 지정 청사진은 CodeCatalyst 프로젝트에서 관리되며, 프로젝트에는 스페이스의 청사진 카탈로그에 게시하기 위한 워크플로가 기본적으로 포함되어 있습니다.

사용자 지정 청사진의 세부 정보를 구성하는 동안 청사진의 소스 코드를 타사 저장소에 저장하도록 선택할 수도 있습니다. 이 저장소에서는 사용자 지정 청사진을 관리하고 수명 주기 관리 기능을 활용하여 사용자 지정 청사진 수정 시 공간 프로젝트를 동기화된 상태로 유지할 수 있습니다. 자세한 내용은 확장 기능을 사용하여 프로젝트에 기능 추가 CodeCatalyst 및 블루프린트 작성자로서 라이프사이클 관리와 협력하기 섹션을 참조하세요.

표준화 및 모범 사례를 갖춘 소스 리포지토리가 이미 있는 경우 해당 소스 리포지토리를 사용자 지정 블루프린트로 변환할 수 있습니다. 자세한 정보는 소스 리포지토리를 커스텀 블루프린트로 전환을 참조하세요.

사전 조건

커스텀 블루프린트를 만들기 전에 다음 요구사항을 고려하세요.

• CodeCatalyst 공간은 엔터프라이즈 등급이어야 합니다. 자세한 내용은 Amazon CodeCatalyst 관리자 안내서의 청구 관리를 참조하십시오.

• 사용자 지정 블루프린트를 생성하려면 스페이스 관리자 또는 파워 사용자 역할이 있어야 합니다. 자세한 정보는 사용자 역할을 통한 액세스 권한 부여을 참조하세요.

1단계: 에서 사용자 지정 블루프린트 만들기 CodeCatalyst

스페이스 설정에서 사용자 지정 청사진을 만들면 저장소가 자동으로 생성됩니다. 저장소에는 스페이스의 청사진 카탈로그에 청사진을 게시하기 전에 청사진을 개발하는 데 필요한 모든 필수 리소스가 포함되어 있습니다.

사용자 지정 청사진을 만들려면

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

2. CodeCatalyst 콘솔에서 사용자 지정 블루프린트를 만들려는 공간으로 이동합니다.

3. 스페이스 대시보드에서 설정 탭을 선택한 다음 블루프린트를 선택합니다.

4. 블루프린트 생성을 선택합니다.

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

6. (선택 사항) 기본적으로 블루프린트로 만든 소스 코드는 리포지토리에 저장됩니다. CodeCatalyst 또는 블루프린트의 소스 코드를 타사 리포지토리에 저장하도록 선택할 수 있습니다. 자세한 정보는 확장 기능을 사용하여 프로젝트에 기능 추가 CodeCatalyst을 참조하세요.

   사용하려는 서드 파티 리포지토리 제공자에 따라 다음 중 하나를 수행하십시오.

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

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

     참고

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

   • 비트버킷 리포지토리: Bitbucket 작업 공간을 연결합니다.

     고급 드롭다운 메뉴를 선택하고 Bitbucket을 리포지토리 공급자로 선택한 다음 블루프린트로 만든 소스 코드를 저장할 Bitbucket 작업 공간을 선택합니다.

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

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

7. 블루프린트 디테일 아래에서 다음과 같이 하세요.

   1. 블루프린트 디스플레이 이름 텍스트 입력 필드에 스페이스의 블루프린트 카탈로그에 표시될 이름을 입력합니다.

   2. 설명 텍스트 입력 필드에 커스텀 블루프린트에 대한 설명을 입력합니다.

   3. 저자 이름 텍스트 입력 필드에 사용자 지정 블루프린트의 저자 이름을 입력합니다.

   4. (선택 사항) 고급 설정을 선택합니다.

      1. + 추가를 선택하여 package.json 파일에 추가된 태그를 추가합니다.

      2. 라이선스 드롭다운 메뉴를 선택한 다음 커스텀 블루프린트에 사용할 라이선스를 선택합니다.

      3. 블루프린트 패키지 이름 텍스트 입력 필드에 블루프린트 패키지를 식별할 이름을 입력합니다.

      4. 기본적으로 릴리스 워크플로는 블루프린트 빌더 (Blueprint Builder) 라는 프로젝트 내 퍼블리싱 블루프린트를 사용하여 생성됩니다. 릴리스 워크플로에서 퍼블리싱 권한이 활성화되었으므로, 워크플로는 변경사항을 푸시하면 스페이스에 최신 블루프린트 버전을 퍼블리시합니다. 워크플로우 생성을 끄려면 릴리스 워크플로 체크박스를 선택 취소하십시오.

8. (선택 사항) 블루프린트 프로젝트에는 스페이스의 블루프린트 카탈로그에 블루프린트를 게시할 수 있도록 지원하는 사전 정의된 코드가 함께 제공됩니다. 선택한 프로젝트 파라미터에 따라 업데이트된 정의 파일을 보려면, 블루프린트 미리 보기 생성에서 코드 보기 또는 워크플로 보기를 선택합니다.

9. 블루프린트 생성을 선택합니다.

커스텀 블루프린트의 워크플로 생성을 끄지 않은 경우, 블루프린트가 생성되면 워크플로가 자동으로 실행되기 시작합니다. 워크플로 실행이 완료되면 기본적으로 사용자 지정 청사진을 스페이스의 청사진 카탈로그에 추가할 수 있습니다. 최신 블루프린트 버전을 스페이스에 자동으로 게시하지 않으려면 게시 권한을 끌 수 있습니다. 자세한 내용은 커스텀 블루프린트에 대한 퍼블리싱 권한 설정 및 워크플로 실행 섹션을 참조하세요.

라는 blueprint-release 퍼블리싱 워크플로는 블루프린트를 사용하여 생성되므로, 블루프린트는 프로젝트에서 적용된 블루프린트로 찾을 수 있습니다. 자세한 내용은 프로젝트에 블루프린트를 추가하여 리소스를 통합하기 및 블루프린트를 프로젝트에서 분리하여 업데이트 중지 섹션을 참조하세요.

2단계: 구성 요소가 포함된 사용자 지정 블루프린트 개발

블루프린트 마법사는 커스텀 블루프린트를 생성할 때 생성되며, 커스텀 블루프린트를 개발할 때 컴포넌트로 수정할 수 있습니다. src/blueprints.js및 src/defaults.json 파일을 업데이트하여 마법사를 수정할 수 있습니다.

중요

외부 소스의 블루프린트 패키지를 사용하려는 경우 해당 패키지와 함께 발생할 수 있는 위험을 고려하세요. 공간에 추가하는 커스텀 블루프린트와 이를 통해 생성되는 코드에 대한 책임은 귀하에게 있습니다.

블루프린트 코드를 구성하기 전에 지원되는 통합 개발 환경 (IDE) 을 사용하여 CodeCatalyst 프로젝트에 개발 환경을 만드세요. 필수 도구 및 패키지를 사용하려면 개발 환경이 필요합니다.

개발 환경을 만들려면

1. 탐색 창에서 다음 중 하나를 수행하십시오.

   1. 개요를 선택한 다음 내 개발 환경 섹션으로 이동합니다.

   2. 코드를 선택한 다음 개발 환경을 선택합니다.

   3. 코드를 선택하고 소스 리포지토리를 선택한 다음 블루프린트를 만들 때 만든 리포지토리를 선택합니다.

2. 개발 환경 생성을 선택합니다.

3. 드롭다운 메뉴에서 지원되는 IDE를 선택합니다. 자세한 내용은 개발 환경에 지원되는 통합 개발 환경을 참조하십시오.

4. 기존 브랜치에서 작업을 선택하고 기존 브랜치 드롭다운 메뉴에서 생성한 기능 브랜치를 선택합니다.

5. (선택 사항) 별칭 - 선택적 텍스트 입력 필드에 개발 환경을 식별하는 별칭을 입력합니다.

6. 생성을 선택합니다. 개발 환경을 만드는 동안 개발 환경 상태 열에는 시작 중으로 표시되고, 상태 열에는 개발 환경이 생성되었을 때 실행 중으로 표시됩니다.

자세한 정보는 의 개발 환경을 사용하여 코드 작성 및 수정 CodeCatalyst을 참조하세요.

커스텀 블루프린트를 개발하려면

1. 작동하는 터미널에서 다음 yarn 명령어를 사용하여 종속성을 설치합니다.

   yarn

   필요한 도구와 패키지는 Yarn을 포함한 CodeCatalyst 개발 환경을 통해 사용할 수 있습니다. 개발자 환경 없이 커스텀 블루프린트를 작업하는 경우 먼저 Yarn을 시스템에 설치하세요. 자세한 내용은 Yarn의 설치 설명서를 참조하십시오.

2. 사용자 지정 블루프린트를 개발하여 원하는 대로 구성하세요. 컴포넌트를 추가하여 블루프린트 마법사를 수정할 수 있습니다. 자세한 내용은 프로젝트 요구 사항을 충족하는 맞춤형 청사진 개발, 프론트엔드 마법사로 블루프린트 기능 수정, 스페이스에 사용자 지정 청사진 게시 단원을 참조하세요.

3단계: 커스텀 블루프린트 미리 보기

커스텀 블루프린트를 설정하고 개발한 후, 블루프린트의 프리뷰 버전을 미리 보고 스페이스에 퍼블리시할 수 있습니다. 프리뷰 버전을 사용하면 새 프로젝트를 만드는 데 사용하거나 기존 프로젝트에 적용하기 전에 블루프린트가 원하는 것인지 확인할 수 있습니다.

커스텀 블루프린트를 미리 보려면

1. 작동 중인 터미널에서 다음 yarn 명령어를 사용하세요.

   yarn blueprint:preview

2. 제공된 See this blueprint at: 링크로 이동하여 커스텀 블루프린트를 미리 보세요.

3. 구성에 따라 텍스트를 포함한 UI가 예상대로 나타나는지 확인하세요. 커스텀 블루프린트를 변경하려면 blueprint.ts 파일을 편집하고 블루프린트를 재합성한 다음 프리뷰 버전을 다시 퍼블리시하면 됩니다. 자세한 정보는 재합성을 참조하세요.

(선택 사항) 4단계: 커스텀 블루프린트 프리뷰 버전 퍼블리시

사용자 지정 청사진을 스페이스의 청사진 카탈로그에 추가하려는 경우 사용자 지정 청사진의 미리보기 버전을 스페이스에 게시할 수 있습니다. 이렇게 하면 미리보기가 아닌 버전을 카탈로그에 추가하기 전에 사용자로 블루프린트를 볼 수 있습니다. 프리뷰 버전을 사용하면 실제 버전을 사용하지 않고도 퍼블리싱할 수 있습니다. 예를 들어, 버전을 작업하는 경우 미리 보기 0.0.1 버전을 게시하고 추가하여 두 번째 버전에 대한 새 업데이트를 게시하고 추가할 수 있습니다0.0.2.

커스텀 블루프린트의 프리뷰 버전을 퍼블리싱하려면

제공된 Enable version [version number] at: 링크로 이동하여 커스텀 블루프린트를 활성화하세요. 이 링크는 에서 yarn 3단계: 커스텀 블루프린트 미리 보기 명령을 실행할 때 제공됩니다.

사용자 지정 청사진을 만들고, 개발하고, 미리 보고, 게시한 후 최종 청사진 버전을 게시하고 스페이스의 청사진 카탈로그에 추가할 수 있습니다. 자세한 내용은 스페이스에 사용자 지정 청사진 게시 및 우주 청사진 카탈로그에 사용자 지정 청사진 추가 단원을 참조하세요.