Amazon CodeCatalyst は新規のお客様には提供されなくなりました。既存のお客様は、通常どおりサービスを引き続き使用できます。詳細については、「[CodeCatalyst から移行する方法](migration.md)」を参照してください。

翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。

# スペースへのカスタムブループリントの発行
<a name="publish-bp"></a>

スペースのブループリントカタログにカスタムブループリントを追加する前に、それをスペースに発行する必要があります。発行する前に CodeCatalyst コンソールでブループリントを表示することもできます。プレビューバージョンまたは通常のバージョンのブループリントを発行できます。

**重要**  
外部ソースからのブループリントパッケージを使用する場合は、それらのパッケージに伴うリスクを考慮してください。スペースに追加するカスタムブループリントとそれらが生成するコードは、お客様の責任となります。

**重要**  
CodeCatalyst スペースにカスタムブループリントを発行するには、**スペース管理者**または**パワーユーザー**ロールを持つアカウントでスペースにサインインする必要があります。

**Topics**
+ [カスタムブループリントのプレビューバージョンの表示と発行](#publish-preview-bp)
+ [カスタムブループリントの標準バージョンの表示と発行](#publish-normal-bp)
+ [指定されたスペースとプロジェクトにカスタムブループリントを発行して追加する](#publish-preview-existing-project-bp)

## カスタムブループリントのプレビューバージョンの表示と発行
<a name="publish-preview-bp"></a>

カスタムブループリントのプレビューバージョンをスペースに発行して、スペースのブループリントカタログに追加することができます。これにより、非プレビューバージョンをカタログに追加する前に、ブループリントをユーザーとして表示できます。プレビューバージョンでは、実際のバージョンを使わずに公開できます。例えば、`0.0.1` バージョンで作業する場合、プレビューバージョンを発行して追加できるため、2 番目のバージョンの新しい更新を `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)」を参照してください。

## カスタムブループリントの標準バージョンの表示と発行
<a name="publish-normal-bp"></a>

カスタムブループリントの開発とプレビューが完了したら、新しいバージョンを表示して発行し、スペースのブループリントカタログに追加できます。プロジェクトの作成時に生成されるリリースワークフローは、プッシュされた変更を自動的に発行します。ブループリント作成時のワークフロー生成をオフにすると、ブループリントはスペースのブループリントカタログに自動的には追加されません。`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)」を参照してください。

## 指定されたスペースとプロジェクトにカスタムブループリントを発行して追加する
<a name="publish-preview-existing-project-bp"></a>

デフォルトでは、`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
   ```