스페이스에 사용자 지정 청사진 게시

스페이스의 청사진 카탈로그에 사용자 정의 청사진을 만들려면 먼저 스페이스에 게시해야 합니다. 게시하기 전에 CodeCatalyst 콘솔에서 청사진을 볼 수도 있습니다. 블루프린트의 프리뷰 버전 또는 일반 버전을 게시할 수 있습니다.

중요

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

중요

사용자 지정 청사진을 스페이스에 게시하려면 스페이스에서 CodeCatalyst 스페이스 관리자 또는 고급 사용자 역할을 가진 계정으로 로그인해야 합니다.

사용자 지정 청사진의 미리 보기 및 게시

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

변경한 후에는 package.json 파일을 실행하여 커스텀 블루프린트 패키지를 다시 빌드하고 변경 내용을 미리 보세요.

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

1. 개발 환경을 재개하세요. 자세한 정보는 Dev Environment 재개섹션을 참조하십시오.

2. 개발 환경에서 작동하는 터미널을 엽니다.

3. (선택 사항) 프로젝트에 필요한 종속 항목을 아직 설치하지 않았다면 제대로 작동하는 터미널에서 설치하세요. 다음 명령을 사용합니다.

   yarn

4. (선택 사항) .projenrc.ts 파일을 변경했다면, 블루프린트를 빌드하고 미리 보기 전에 프로젝트 구성을 다시 생성하세요. 다음 명령을 사용합니다.

   yarn projen

5. 다음 명령어를 사용하여 커스텀 블루프린트를 다시 빌드하고 미리 보세요. 다음 명령어를 사용하세요.

   yarn blueprint:preview

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

6. (선택 사항) 커스텀 블루프린트의 프리뷰 버전을 퍼블리시한 다음 스페이스의 블루프린트 카탈로그에 추가할 수 있습니다. Enable version [preview version number] at:링크를 탐색하여 프리뷰 버전을 스페이스에 게시하세요.

에서 프로젝트를 만들지 않고도 프로젝트 생성을 에뮬레이션할 수 있습니다. CodeCatalyst 프로젝트를 합성하려면 다음 명령어를 사용하세요.

yarn blueprint:synth

폴더에 블루프린트가 생성됩니다. synth/synth.[options-name]/proposed-bundle/ 자세한 정보는 종합을 참조하세요.

커스텀 블루프린트를 업데이트하는 경우, 대신 다음 명령어를 사용하여 프로젝트를 재합성하세요.

yarn blueprint:resynth

폴더에 블루프린트가 생성됩니다. synth/synth.[options-name]/proposed-bundle/ 자세한 정보는 재합성을 참조하세요.

미리 보기 버전을 게시한 후 청사진을 추가하여 스페이스 구성원이 이를 사용하여 새 프로젝트를 만들거나 기존 프로젝트를 추가할 수 있습니다. 자세한 정보는 우주 청사진 카탈로그에 사용자 지정 청사진 추가을 참조하세요.

커스텀 블루프린트의 일반 버전 보기 및 게시

사용자 지정 청사진을 개발하고 미리 본 후 스페이스의 청사진 카탈로그에 추가하려는 새 버전을 보고 게시할 수 있습니다. 프로젝트 생성 시 생성되는 릴리스 워크플로는 푸시된 변경 사항을 자동으로 게시합니다. 블루프린트를 만들 때 워크플로우 생성을 끄면 블루프린트가 스페이스의 블루프린트 카탈로그에 자동으로 추가되지 않습니다. 커맨드를 실행한 후에도 사용자 정의 블루프린트를 스페이스에 퍼블리시할 수 있습니다. yarn

사용자 지정 블루프린트 보기 및 게시하기

1. 개발 환경을 재개하세요. 자세한 정보는 Dev Environment 재개섹션을 참조하십시오.

2. 개발 환경에서 작동하는 터미널을 엽니다.

3. • 블루프린트를 만들 때 릴리스 워크플로 생성을 옵트아웃한 경우 다음 명령어를 사용하세요.

     yarn blueprint:release

     여전히 제공된 See this blueprint at: 링크로 이동하여 커스텀 블루프린트를 볼 수 있습니다.

     사용자 지정 청사진의 업데이트된 버전을 게시한 다음 스페이스의 청사진 카탈로그에 추가할 수 있습니다. Enable version [release version number] at:링크를 탐색하여 최신 버전을 스페이스에 게시하세요.

   • 블루프린트를 만들 때 릴리스 워크플로를 선택한 경우, 변경 사항이 푸시되면 최신 블루프린트 버전이 자동으로 게시됩니다. 다음 명령을 사용합니다.

     git add .

     git commit -m "commit message"

     git push

일반 버전을 게시한 후, 스페이스 구성원이 블루프린트를 사용하여 새 프로젝트를 만들거나 기존 프로젝트를 추가할 수 있도록 블루프린트를 추가할 수 있습니다. 자세한 정보는 우주 청사진 카탈로그에 사용자 지정 청사진 추가을 참조하세요.

지정된 공간 및 프로젝트에 커스텀 블루프린트 게시 및 추가

기본적으로 blueprint:preview 및 blueprint:release 명령은 청사진을 만든 CodeCatalyst 공간에 게시됩니다. Enterprise 스페이스가 여러 개 있는 경우 해당 스페이스에서 동일한 블루프린트를 미리 보고 게시할 수도 있습니다. 다른 공간의 기존 프로젝트에 청사진을 추가할 수도 있습니다.

지정된 공간에 사용자 정의 청사진을 게시하거나 추가하려면

1. 개발 환경을 재개하세요. 자세한 정보는 Dev Environment 재개을 참조하세요.

2. 개발 환경에서 작동하는 터미널을 엽니다.

3. (선택 사항) 프로젝트에 필요한 종속 항목을 아직 설치하지 않았다면 설치하세요. 다음 명령을 사용합니다.

   yarn

4. --space태그를 사용하여 미리 보기 또는 일반 버전을 지정된 공간에 게시할 수 있습니다. 예:

   • yarn blueprint:preview --space my-awesome-space # publishes under a "preview" version tag to 'my-awesome-space'

     출력 예제:

     Enable version 0.0.1-preview.0 at: https://codecatalyst.aws/spaces/my-awesome-space/blueprints
     Blueprint applied to [NEW]: https://codecatalyst.aws/spaces/my-awesome-space/blueprints/%40amazon-codecatalyst%2Fmyspace.my-blueprint/publishers/1524817d-a69b-4abe-89a0-0e4a9a6c53b2/versions/0.0.1-preview.0/projects/create

   • yarn blueprint:release --space my-awesome-space # publishes normal version to 'my-awesome-space'

     출력 예제:

     Enable version 0.0.1 at: https://codecatalyst.aws/spaces/my-awesome-space/blueprints
     Blueprint applied to [NEW]: https://codecatalyst.aws/spaces/my-awesome-space/blueprints/%40amazon-codecatalyst%2Fmyspace.my-blueprint/publishers/1524817d-a69b-4abe-89a0-0e4a9a6c53b2/versions/0.0.1/projects/create

   --project를 사용하여 사용자 지정 블루프린트의 미리 보기 버전을 지정된 공간에 있는 기존 프로젝트에 추가할 수 있습니다. 예:

   yarn blueprint:preview --space my-awesome-space --project my-project # previews blueprint application to an existing project

   출력 예제:

   Enable version 0.0.1-preview.1 at: https://codecatalyst.aws/spaces/my-awesome-space/blueprints
   Blueprint applied to [my-project]: https://codecatalyst.aws/spaces/my-awesome-space/projects/my-project/blueprints/%40amazon-codecatalyst%2FmySpace.my-blueprint/publishers/1524817d-a69b-4abe-89a0-0e4a9a6c53b2/versions/0.0.1-preview.1/add