Enterprise Blueprint Factory の使用

このガイドの「エンタープライズブループリントファクトリーのセットアップ」の指示に従って、エンタープライズブループリントファクトリーをセットアップしていることを確認します。

ServiceCataloglogLaunchConstraintRole ロールのポリシーで、ブループリントで定義されたリソースをプロビジョニングできることを確認します。

製品リポジトリ (ServiceCatalog-BlueprintProductRepo) で、新しいブループリントのフォルダを作成します。

IaC テンプレート (CloudFormation テンプレートまたは AWS CDK コンストラクト) を、作成したフォルダに貼り付けます。

作成したフォルダに product_config.json という名前のファイルを作成します。

product_config.json ファイルを開き、ファイルに以下を貼り付けます。

{
    "SchemaVersion": "1.0",
    "ProductVersionName": "1.0.1",
    "Deprecated_Versions" : [],
    "ProductVersionDescription": "<description>",
    "ProductType": "CLOUD_FORMATION_TEMPLATE",
    "Properties": {
        "TemplateFilePath": "./<folder name>/<file name>"
    }
}

コードの説明は以下のとおりです。

product_config.json ファイルを保存して閉じます。

次のコマンドを入力して、変更を製品リポジトリにマージします。

cd ServiceCatalog-BlueprintProductRepo
git add <folder name>/<file name> <folder name>\product_config.json
git commit -m "The first version of <file name> blueprint"
git push origin main

設定リポジトリ (ServiceCatalog-ConfigRepo) で、config.yml ファイルを開きます。

新しいブループリントに必要な portfolios セクションと productsセクションを編集します。詳細については、このガイドの「設定ファイル」を参照してください。

config.yml ファイルを保存して閉じます。

次のコマンドを入力して、変更を設定リポジトリにマージします。

cd ServiceCatalog-ConfigRepo
git add config.yml
git commit -m "<description of change>"
git push origin main

このプルリクエストを承認すると、設定パイプラインが開始されます。設定パイプラインは、製品のリリースパイプラインを作成します。

Enterprise Blueprint Factory 管理アカウントにサインインします。

AWS CodePipeline コンソールを開きます。

Name で、製品のリリースパイプラインを選択します。デフォルトでは、パイプライン名は ですBluePrint_<Product-Name>-<CloudFormation-Stack-Name>。

[View history (履歴の表示)] を選択します。

パイプラインとステージ実行のステータスを表示します。ステータスの詳細については、CodePipeline ドキュメントの「実行ステータスの表示」を参照してください。

パイプラインが失敗した場合、失敗の原因を確認します。パイプラインのモニタリングを設定する方法については、CodePipeline ドキュメントの「パイプラインのモニタリング」を参照してください。cfn-lint または cfn_nag チェックが原因でリリースパイプラインが失敗した場合は、テンプレートのエラーを修正します。別のプルリクエストを製品リポジトリに送信します。これにより、リリースパイプラインが再起動されます。テンプレートエラーの修正の詳細については、このガイドの「トラブルシューティング」セクションを参照してください。

リリースパイプラインのステータスが になるまで待ちますSucceeded。

組織内のコンシューマーアカウントにサインインします。

IAM ServiceCatalogEndUserRole ロールを引き受けます。

Service Catalog コンソールを開きます。

ナビゲーションペインで、[Products] (製品) を選択します。

新製品が製品リストで使用可能であることを確認します。

製品リポジトリで、製品の フォルダに移動します。

更新された IaC テンプレートを貼り付けます。ファイル名が以前のバージョンと同じであることを確認します。

product_config.json ファイルを開きます。

ではProductVersionName、バージョン番号を更新します。

以前の製品バージョンが将来デプロイされないようにするには、 にDeprecated_Versions以前のバージョン番号をカンマ区切りリストに入力します。

次のコマンドを入力して、変更を製品リポジトリにマージします。

cd ServiceCatalog-BlueprintProductRepo
git add <folder name>/<file name> <folder name>\product_config.json
git commit -m "Version <number> of <file name> blueprint"
git push origin main

このプルリクエストを承認すると、製品のリリースパイプラインが開始されます。

Enterprise Blueprint Factory 管理アカウントにサインインします。

AWS CodePipeline コンソールを開きます。

Name で、リリースパイプラインを選択します。デフォルトでは、パイプライン名は ですBluePrint_<Product-Name>-<CloudFormation-Stack-Name>。

[View history (履歴の表示)] を選択します。

パイプラインとステージ実行のステータスを表示します。ステータスの詳細については、CodePipeline ドキュメントの「実行ステータスの表示」を参照してください。

パイプラインが失敗した場合、失敗の原因を確認します。パイプラインのモニタリングを設定する方法については、CodePipeline ドキュメントの「パイプラインのモニタリング」を参照してください。cfn-lint または cfn_nag チェックが原因でリリースパイプラインが失敗した場合は、テンプレートのエラーを修正します。別のプルリクエストを製品リポジトリに送信します。これにより、リリースパイプラインが再起動されます。テンプレートエラーの修正の詳細については、このガイドの「トラブルシューティング」セクションを参照してください。

リリースパイプラインのステータスが になるまで待ちますSucceeded。

組織内のコンシューマーアカウントにサインインします。

IAM ServiceCatalogEndUserRole ロールを引き受けます。

Service Catalog コンソールを開きます。

ナビゲーションペインで、[Products] (製品) を選択します。

新しい製品バージョンが製品リストで使用可能であることを確認します。

設定リポジトリで、config.yml ファイルを開きます。

製品セクションを編集し、削除する製品を削除またはコメントアウトします。

config.yml ファイルを保存して閉じます。

次のコマンドを入力して、変更を設定リポジトリにマージします。

cd ServiceCatalog-ConfigRepo
git add config.yml
git commit -m "<description of change>"
git push origin main

このプルリクエストを承認すると、設定パイプラインが開始されます。設定パイプラインは、製品とそのリリースパイプラインを削除します。

製品リポジトリで、製品の内容を含む製品のフォルダを削除します。

次のコマンドを入力して、変更を製品リポジトリにマージします。

cd ServiceCatalog-BlueprintProductRepo
git add .
git commit -m "Delete <file name> blueprint"
git push origin main

組織内のコンシューマーアカウントにサインインします。

IAM ServiceCatalogEndUserRole ロールを引き受けます。

Service Catalog コンソールを開きます。

ナビゲーションペインで、[Products] (製品) を選択します。

削除した製品が使用できなくなったことを確認します。