사용자 지정 블루프린트를 스페이스에 게시 - Amazon CodeCatalyst
사용자 지정 블루프린트의 미리 보기 버전 보기 및 게시사용자 지정 블루프린트의 일반 버전 보기 및 게시지정된 스페이스 및 프로젝트에 사용자 지정 블루프린트 게시 및 추가

사용자 지정 블루프린트를 스페이스에 게시

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

중요

외부 소스의 블루프린트 패키지를 사용하려면, 해당 패키지로 인해 발생할 수 있는 위험을 고려하세요. 스페이스에 추가하는 사용자 지정 블루프린트와 해당 블루프린트가 생성하는 코드는 사용자의 책임입니다.

중요

사용자 지정 블루프린트를 CodeCatalyst 스페이스에 게시하려면, 스페이스에 스페이스 관리자 또는 파워 유저 역할이 있는 계정으로 로그인해야 합니다.

사용자 지정 블루프린트의 미리 보기 버전 보기 및 게시

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

변경한 후 package.json 파일을 실행하여 사용자 지정 블루프린트 패키지를 다시 빌드하고 변경 내용을 미리 봅니다.

사용자 지정 블루프린트의 미리 보기 버전을 보고 게시하려면

  1. 개발 환경을 재개합니다. 자세한 내용은 개발 환경 재개 섹션을 참조하세요.

  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. 개발 환경을 재개합니다. 자세한 내용은 개발 환경 재개 섹션을 참조하세요.

  2. 개발 환경에서 작업 중인 터미널을 엽니다.

    • 블루프린트를 생성할 때 릴리스 워크플로 생성을 옵트아웃한 경우 다음 명령을 사용합니다.

      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 스페이스에 게시됩니다. 엔터프라이즈 스페이스가 여러 개 있는 경우, 해당 스페이스에도 동일한 블루프린트를 미리 보고 게시할 수 있습니다. 다른 스페이스의 기존 프로젝트에 블루프린트를 추가할 수도 있습니다.

지정된 스페이스에 사용자 지정 블루프린트를 게시하거나 추가하려면

  1. 개발 환경을 재개합니다. 자세한 내용은 개발 환경 재개 섹션을 참조하세요.

  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