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

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

# カスタムブループリントの開始方法
<a name="getting-started-bp"></a>

ブループリントの作成プロセス中に、ブループリントを設定し、プロジェクトリソースのプレビューを生成できます。各カスタムブループリントは CodeCatalyst プロジェクトによって管理されます。このプロジェクトには、スペースのブループリントカタログに公開するためのワークフローがデフォルトで含まれています。

カスタムブループリントの詳細を設定するときに、ブループリントのソースコードをサードパーティーリポジトリに保存することもできます。ここでも、カスタムブループリントを管理し、ライフサイクル管理機能を使用して、カスタムブループリントが変更されてもスペースのプロジェクトを同期させることができます。詳細については、「[CodeCatalyst で拡張機能を持つプロジェクトに機能を追加する拡張機能を使用してプロジェクトに機能を追加する](extensions.md)」および「[ブループリント作成者としてライフサイクル管理を使用する](lifecycle-management-dev.md)」を参照してください。

標準化とベストプラクティスを備えたソースリポジトリが既にある場合は、そのソースリポジトリをカスタムブループリントに変換することを選択できます。詳細については、「[ソースリポジトリをカスタムブループリントに変換する](convert-bp.md)」を参照してください。

**Topics**
+ [前提条件](#prerequisites-bp)
+ [ステップ 1: CodeCatalyst でカスタムブループリントを作成する](#getting-started-create-bp)
+ [ステップ 2: コンポーネントを使用してカスタムブループリントを作成する](#getting-started-develop-bp)
+ [ステップ 3: カスタムブループリントをプレビューする](#getting-started-publish-bp)
+ [(オプション) ステップ 4: カスタムブループリントプレビューバージョンを公開する](#getting-started-add-bp)

## 前提条件
<a name="prerequisites-bp"></a>

カスタムブループリントを作成する前に、次の要件を考慮してください。
+ CodeCatalyst スペースは、**[Enterprise]** 階層である必要があります。詳細については、「Amazon CodeCatalyst Administrator Guide」の「[請求管理](https://docs.aws.amazon.com/codecatalyst/latest/adminguide/managing-billing-view-plan.html)」を参照してください。
+ カスタムブループリントを作成するには、**[スペース管理者]** または **[パワーユーザー]** ロールが必要です。詳細については、「[ユーザーロールによってアクセス権を付与する](ipa-roles.md)」を参照してください。

## ステップ 1: CodeCatalyst でカスタムブループリントを作成する
<a name="getting-started-create-bp"></a>

スペースの設定からカスタムブループリントを作成すると、リポジトリが作成されます。リポジトリには、スペースのブループリントカタログに公開する前にブループリントを開発するために必要なすべてのリソースが含まれています。

**カスタムブループリントを作成するには**

1. [https://codecatalyst.aws/](https://codecatalyst.aws/) で CodeCatalyst コンソールを開きます。

1. CodeCatalyst コンソールで、カスタムブループリントを作成するスペースに移動します。

1. スペースダッシュボードの **[設定]** タブで、**[ブループリント]** を選択します。

1. **[ブループリントを作成]** を選択します。

1. **[ブループリントに名前を付ける]** に、プロジェクトに割り当てる名前と、それに関連するリソース名を入力します。名前はスペース内で一意でなければなりません。

1. (オプション) デフォルトでは、ブループリントが作成したソースコードは CodeCatalyst リポジトリに保存されます。または、ブループリントのソースコードをサードパーティーリポジトリに保存することもできます。詳細については、「[CodeCatalyst で拡張機能を持つプロジェクトに機能を追加する拡張機能を使用してプロジェクトに機能を追加する](extensions.md)」を参照してください。

   使用するサードパーティーリポジトリプロバイダーに応じて、次のいずれかを実行します。
   + **GitHub リポジトリ**: GitHub アカウントを接続します。

     **[高度]** ドロップダウンメニューから、リポジトリプロバイダーとして GitHub を選択し、ブループリントによって作成されたソースコードを保存する GitHub アカウントを選択します。
**注記**  
GitHub アカウントへの接続を使用している場合は、CodeCatalyst ID と GitHub ID 間の ID マッピングを確立するための個人用接続を作成する必要があります。詳細については、「[個人用接続](concepts.md#personal-connection-concept)」および「[個人接続を使用して GitHub リソースにアクセスする](ipa-settings-connections.md)」を参照してください。
   + **Bitbucket リポジトリ**: Bitbucket ワークスペースを接続します。

     **[高度]** ドロップダウンメニューから、リポジトリプロバイダーとして Bitbucket を選択し、ブループリントによって作成されたソースコードを保存する Bitbucket ワークスペースを選択します。
   + **GitLab リポジトリ**: GitLab ユーザーを接続します。

     **[高度]** ドロップダウンメニューから、リポジトリプロバイダーとして GitLab を選択し、ブループリントによって作成されたソースコードを保存する GitLab アカウントを選択します。

1. **[ブループリントの詳細]** で、次の操作を行います。

   1. **[ブループリントの表示名]** テキスト入力フィールドに、スペースのブループリントカタログに表示される名前を入力します。

   1. **[説明文]** テキスト入力フィールドに、カスタムブループリントの説明を入力します。

   1. **[作成者名]** テキスト入力フィールドに、カスタムブループリント作成者名を入力します。

   1. (オプション) **[詳細設定]** を選択します。

      1. **[\$1 追加]** を選択して、`package.json` ファイルに追加されるタグを追加します。

      1. **[ライセンス]** ドロップダウンメニューを選択し、カスタムブループリントのライセンスを選択します。

      1. **[ブループリントパッケージ名]** テキスト入力フィールドに、ブループリントパッケージを識別する名前を入力します。

      1. デフォルトでは、リリースワークフローは、**[Blueprint Builder]** と呼ばれるプロジェクト内の公開ブループリントを使用して生成されます。ワークフローは、リリースワークフローで公開許可が有効になっているため、変更をプッシュすると、最新のブループリントバージョンをスペースに発行します。ワークフローの生成をオフにするには、**[ワークフローのリリース]** チェックボックスのチェックを外します。

1. (オプション) ブループリントプロジェクトには、スペースのブループリントカタログへのブループリントの公開をサポートする定義済みコードが付属しています。選択したプロジェクトパラメータに基づいて更新を含む定義ファイルを表示するには、**[ブループリントプレビューの生成]** から **[コードを表示]** または **[ワークフローを表示]** を選択します。

1. **[ブループリントを作成]** を選択します。

カスタムブループリントのワークフロー生成をオフにしなかった場合、ブループリントの作成時にワークフローが自動的に実行され始めます。ワークフローの実行が完了すると、カスタムブループリントをスペースのブループリントカタログにデフォルトで追加できます。最新のブループリントバージョンをスペースに自動的に公開しない場合は、パブリッシュ許可をオフにできます。詳細については、「[カスタムブループリントの公開アクセス許可を設定する](manage-permissions-bp.md)」および「[ワークフローの実行](workflows-working-runs.md)」を参照してください。

公開ワークフロー「`blueprint-release`」はブループリントを使用して作成されるため、ブループリントはプロジェクトに適用されたブループリントとして見つけることができます。詳細については、「[リソースを統合するためにプロジェクトにブループリントを追加する](apply-bp.md)」および「[更新を停止するためにプロジェクトからブループリントの関連付けを解除プロジェクトからブループリントの関連付けを解除](disassociate-bp.md)」を参照してください。

## ステップ 2: コンポーネントを使用してカスタムブループリントを作成する
<a name="getting-started-develop-bp"></a>

ブループリントウィザードは、カスタムブループリントの作成時に生成され、カスタムブループリントの開発時にコンポーネントで変更できます。`src/blueprints.js` および `src/defaults.json` ファイルを更新してウィザードを変更できます。

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

ブループリントコードを設定する前に、サポートされている統合開発環境 (IDE) を使用して CodeCatalyst プロジェクトに開発環境を作成します。必要なツールとパッケージを使用するには、開発環境が必要です。

**開発環境を作成するには**

1. ナビゲーションペインで、次のいずれかを実行します。

   1. **[概要]** を選択し、次に **[My 開発環境]** セクションに移動します。

   1. **[コード]** を選択してから、**[開発環境]** を選択します。

   1. **[コード]** を選択し、**[ソースリポジトリ]** を選択し、ブループリントの作成時に作成したリポジトリを選択します。

1. **[開発環境を作成]** を選択します。

1. ドロップダウンメニューからサポートされている IDE を選択します。詳細については、「[開発環境でサポートされている統合開発環境](https://docs.aws.amazon.com/codecatalyst/latest/userguide/devenvironment-create.html#devenvironment-supported-ide)」を参照してください。

1. **[既存のブランチで作業]** を選択し、**[既存のブランチ]** ドロップダウンメニューから、作成した機能ブランチを選択します。

1. (オプション) **エイリアス - *任意***テキスト入力フィールドにエイリアスを入力して、開発環境を識別します。

1. **[作成]** を選択します。開発環境の作成中は、開発環境のステータス列に **[開始中]** と表示され、開発環境が作成されると、ステータス列に **[実行中]** と表示されます。

詳細については、「[CodeCatalyst で開発環境を使用してコードを記述および変更する開発環境でコードを記述および変更する](devenvironment.md)」を参照してください。

**カスタムブループリントを開発するには**

1. 作業ターミナルで、次の `yarn` コマンドを使用して依存関係をインストールします。

   ```
   yarn
   ```

   必要なツールとパッケージは、Yarn を含む CodeCatalyst 開発環境を通じて利用できます。開発環境なしでカスタムブループリントを使用している場合は、まずシステムに Yarn をインストールします。詳細については、「[Yarn のインストールドキュメント](https://classic.yarnpkg.com/en/docs/install#mac-stable)」を参照してください。

1. カスタムブループリントを作成して、設定に合わせて構成します。コンポーネントを追加することで、ブループリントのウィザードを変更できます。詳細については[プロジェクト要件を満たすためのカスタムブループリントの作成](develop-bp.md)、[フロントエンドウィザードを使用したブループリント機能の変更](wizard-bp.md)、および[スペースへのカスタムブループリントの発行](publish-bp.md)を参照してください。

## ステップ 3: カスタムブループリントをプレビューする
<a name="getting-started-publish-bp"></a>

カスタムブループリントを設定および開発したら、ブループリントのプレビューバージョンをプレビューしてスペースに公開できます。プレビューバージョンを使用すると、新しいプロジェクトの作成や既存のプロジェクトへの適用に使用される前に、ブループリントが目的であることを確認することができます。

**カスタムブループリントをプレビューするには**

1. 作業ターミナルで、次の `yarn` コマンドを使用します。

   ```
   yarn blueprint:preview
   ```

1. 提供された `See this blueprint at:` リンクに移動して、カスタムブループリントをプレビューします。

1. 設定に基づいて、テキストを含む UI が想定どおりに表示されることを確認します。カスタムブループリントを変更する場合は、`blueprint.ts` ファイルを編集し、ブループリントを再合成してから、プレビューバージョンを再公開できます。詳細については、「[再合成](custom-bp-concepts.md#resynthesis-concept)」を参照してください。

## (オプション) ステップ 4: カスタムブループリントプレビューバージョンを公開する
<a name="getting-started-add-bp"></a>

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

**カスタムブループリントのプレビューバージョンを公開するには**

提供された `Enable version [version number] at:` リンクに移動して、カスタムブループリントを有効にします。このリンクは、[ステップ 3: カスタムブループリントをプレビューする](#getting-started-publish-bp) で `yarn` コマンドを実行するときに提供されます。

カスタムブループリントを作成、開発、プレビュー、公開した後、スペースのブループリントカタログに最終的なブループリントバージョンを公開して追加できます。詳細については、「[スペースへのカスタムブループリントの発行](publish-bp.md)」および「[スペースブループリントカタログへのカスタムブループリントの追加](add-bp.md)」を参照してください。