Amazon CodeCatalyst는 더 이상 신규 고객에게 공개되지 않습니다. 기존 고객은 정상적으로 서비스를 계속 이용할 수 있습니다. 자세한 내용은 [CodeCatalyst에서 마이그레이션하는 방법](migration.md) 단원을 참조하십시오.
기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다.
# 사용자 지정 블루프린트를 스페이스에 게시
사용자 지정 블루프린트를 스페이스의 블루프린트 카탈로그에 추가하려면 먼저 스페이스에 게시해야 합니다. 게시하기 전에 CodeCatalyst 콘솔에서 블루프린트를 볼 수도 있습니다. 미리 보기 버전 또는 일반 버전의 블루프린트를 게시할 수 있습니다.
**중요**
외부 소스의 블루프린트 패키지를 사용하려면, 해당 패키지로 인해 발생할 수 있는 위험을 고려하세요. 스페이스에 추가하는 사용자 지정 블루프린트와 해당 블루프린트가 생성하는 코드는 사용자의 책임입니다.
**중요**
사용자 지정 블루프린트를 CodeCatalyst 스페이스에 게시하려면, 스페이스에 **스페이스 관리자** 또는 **파워 유저** 역할이 있는 계정으로 로그인해야 합니다.
**Topics**
+ [사용자 지정 블루프린트의 미리 보기 버전 보기 및 게시](#publish-preview-bp)
+ [사용자 지정 블루프린트의 일반 버전 보기 및 게시](#publish-normal-bp)
+ [지정된 스페이스 및 프로젝트에 사용자 지정 블루프린트 게시 및 추가](#publish-preview-existing-project-bp)
## 사용자 지정 블루프린트의 미리 보기 버전 보기 및 게시
사용자 지정 블루프린트의 미리 보기 버전을 스페이스의 블루프린트 카탈로그에 추가하려는 경우 스페이스에 게시할 수 있습니다. 이렇게 하면 미리 보기가 아닌 버전을 카탈로그에 추가하기 전에 사용자로서 블루프린트를 볼 수 있습니다. 미리 보기 버전을 사용하면 실제 버전을 사용하지 않고 게시할 수 있습니다. 예를 들어, `0.0.1` 버전에서 작업하는 경우 미리 보기 버전을 게시하고 추가할 수 있으므로 두 번째 버전에 대한 새 업데이트를 게시하고 `0.0.2`로 추가할 수 있습니다.
변경한 후 `package.json` 파일을 실행하여 사용자 지정 블루프린트 패키지를 다시 빌드하고 변경 내용을 미리 봅니다.
**사용자 지정 블루프린트의 미리 보기 버전을 보고 게시하려면**
1. 개발 환경을 재개합니다. 자세한 내용은 [개발 환경 재개](devenvironment-resume.md) 섹션을 참조하세요.
1. 개발 환경에서 작업 중인 터미널을 엽니다.
1. (선택 사항) 아직 설치하지 않은 경우 작동 중인 터미널에서 프로젝트에 필요한 종속성을 설치합니다. 다음 명령을 사용합니다.
```
yarn
```
1. (선택 사항) `.projenrc.ts` 파일을 변경한 경우, 블루프린트를 빌드하고 미리 보기 전에 프로젝트의 구성을 다시 생성합니다. 다음 명령을 사용합니다.
```
yarn projen
```
1. 다음 명령을 사용하여 사용자 지정 블루프린트를 다시 빌드하고 미리 봅니다. 다음 명령을 사용합니다.
```
yarn blueprint:preview
```
제공된 `See this blueprint at:` 링크로 이동하여 사용자 지정 블루프린트를 미리 봅니다. 텍스트를 포함한 UI가 구성에 따라 예상대로 표시되는지 확인합니다. 사용자 지정 블루프린트를 변경하려면 `blueprint.ts` 파일을 편집하고 블루프린트를 재합성한 다음 미리 보기 버전을 다시 게시할 수 있습니다. 자세한 내용은 [재합성](custom-bp-concepts.md#resynthesis-concept) 섹션을 참조하세요.
1. (선택 사항) 사용자 지정 블루프린트의 미리 보기 버전을 게시한 다음 스페이스의 블루프린트 카탈로그에 추가할 수 있습니다. `Enable version [preview version number] at:` 링크로 이동하여 미리 보기 버전을 스페이스에 게시합니다.
CodeCatalyst에서 프로젝트를 생성할 필요 없이 프로젝트 생성을 에뮬레이션할 수 있습니다. 프로젝트를 재합성하려면 다음 명령을 사용합니다.
```
yarn blueprint:synth
```
`synth/synth.[options-name]/proposed-bundle/` 폴더에 블루프린트가 생성됩니다. 자세한 내용은 [합성](custom-bp-concepts.md#synthesis-concept) 섹션을 참조하세요.
사용자 지정 블루프린트를 업데이트하는 경우 대신 다음 명령을 사용하여 프로젝트를 재합성합니다.
```
yarn blueprint:resynth
```
`synth/synth.[options-name]/proposed-bundle/` 폴더에 블루프린트가 생성됩니다. 자세한 내용은 [재합성](custom-bp-concepts.md#resynthesis-concept) 섹션을 참조하세요.
미리 보기 버전을 게시한 후 블루프린트를 추가하여 스페이스 멤버가 해당 블루프린트를 사용하여 새 프로젝트를 생성하거나 기존 프로젝트에 추가할 수 있습니다. 자세한 내용은 [스페이스 블루프린트 카탈로그에 사용자 지정 블루프린트 추가](add-bp.md) 섹션을 참조하세요.
## 사용자 지정 블루프린트의 일반 버전 보기 및 게시
사용자 지정 블루프린트를 개발하고 미리 본 후에는 스페이스의 블루프린트 카탈로그에 추가하려는 해당 새 버전을 보고 게시할 수 있습니다. 프로젝트를 생성할 때 생성된 릴리스 워크플로는 푸시된 변경 사항을 자동으로 게시합니다. 블루프린트를 생성할 때 워크플로 생성을 끄면 스페이스의 블루프린트 카탈로그에 해당 블루프린트를 자동으로 추가할 수 없습니다. `yarn` 명령을 실행한 후에도 사용자 지정 블루프린트를 스페이스에 게시할 수 있습니다.
**사용자 지정 블루프린트을 보고 게시하려면**
1. 개발 환경을 재개합니다. 자세한 내용은 [개발 환경 재개](devenvironment-resume.md) 섹션을 참조하세요.
1. 개발 환경에서 작업 중인 터미널을 엽니다.
1.
+ 블루프린트를 생성할 때 릴리스 워크플로 생성을 옵트아웃한 경우 다음 명령을 사용합니다.
```
yarn blueprint:release
```
제공된 `See this blueprint at:` 링크로 이동하여 사용자 지정 블루프린트를 볼 수 있습니다.
사용자 지정 블루프린트의 업데이트된 버전을 게시하면 스페이스의 블루프린트 카탈로그에 추가할 수 있습니다. `Enable version [release version number] at:` 링크로 이동하여 최신 버전을 스페이스에 게시합니다.
+ 블루프린트를 생성할 때 릴리스 워크플로에 옵트인한 경우 변경 사항을 푸시하면 최신 블루프린트 버전이 자동으로 게시됩니다. 다음 명령을 사용합니다.
```
git add .
```
```
git commit -m "commit message"
```
```
git push
```
일반 버전을 게시한 후 블루프린트를 추가하여 스페이스 멤버가 해당 블루프린트를 사용하여 새 프로젝트를 생성하거나 기존 프로젝트에 추가할 수 있습니다. 자세한 내용은 [스페이스 블루프린트 카탈로그에 사용자 지정 블루프린트 추가](add-bp.md) 섹션을 참조하세요.
## 지정된 스페이스 및 프로젝트에 사용자 지정 블루프린트 게시 및 추가
기본적으로 `blueprint:preview` 및 `blueprint:release` 명령은 블루프린트를 생성한 CodeCatalyst 스페이스에 게시됩니다. 엔터프라이즈 스페이스가 여러 개 있는 경우, 해당 스페이스에도 동일한 블루프린트를 미리 보고 게시할 수 있습니다. 다른 스페이스의 기존 프로젝트에 블루프린트를 추가할 수도 있습니다.
**지정된 스페이스에 사용자 지정 블루프린트를 게시하거나 추가하려면**
1. 개발 환경을 재개합니다. 자세한 내용은 [개발 환경 재개](devenvironment-resume.md) 섹션을 참조하세요.
1. 개발 환경에서 작업 중인 터미널을 엽니다.
1. (선택 사항) 아직 설치하지 않은 경우 프로젝트에 필요한 종속성을 설치합니다. 다음 명령을 사용합니다.
```
yarn
```
1. `--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
```