C# と を使用したサイロモデルの SaaS アーキテクチャでのテナントオンボーディング AWS CDK

Node.js がインストールされていることを確認してください。

Node.js がローカルマシンにインストールされていることを確認するには、次のコマンドを実行します。

node --version

Toolkit AWSCDKをインストールします。

ローカルマシンに AWS CDK Toolkit をインストールするには、次のコマンドを実行します。

npm install -g aws-cdk

npm がインストールされていない場合は、「Node.js サイト」からインストールできます。

AWS CDK Toolkit のバージョンを確認します。

Toolkit AWSCDKのバージョンがマシンに正しくインストールされていることを確認するには、次のコマンドを実行します。 

cdk --version

リポジトリをクローン作成します。

「リポジトリ」をクローンし、\tenant-onboarding-in-saas-architecture-for-silo-model-apg-example フォルダに移動します。

Visual Studio 2022 で \src\TenantOnboardingInfra.sln ソリューションファイルを開きます。TenantOnboardingInfraStack.cs ファイルを開き、コードを確認します。

このスタックの一部として、以下のリソースが作成されます。

CloudFormation テンプレートを確認します。

\tenant-onboarding-in-saas-architecture-for-silo-model-apg-example\template フォルダで を開きinfra.yaml、 CloudFormation テンプレートを確認します。このテンプレートは、テナントオンボーディング DynamoDB テーブルから取得したテナント名でハイドレイトされます。

このテンプレートはテナント固有のインフラストラクチャをプロビジョニングします。この例では、 AWSKMSキー、Amazon SNS 、Amazon 、SQSおよび CloudWatch アラームをプロビジョニングします。

テナントオンボーディング機能を確認してください。

を開きFunction.cs、Visual Studio AWS Lambda プロジェクト () で作成されたテナントオンボーディング関数のコードを確認します。NET Core - C#) テンプレート。NET 6 (コンテナイメージ) の設計図。

Dockerfile を開き、コードを確認します。Dockerfile は、Lambda コンテナイメージを構築するための手順を含むテキストファイルです。

次の NuGet パッケージが依存関係としてTenantOnboardingFunctionプロジェクトに追加されることに注意してください。

テナント InfraProvisioning 関数を確認します。

\tenant-onboarding-in-saas-architecture-for-silo-model-apg-example\src\InfraProvisioningFunction に移動します。

を開きFunction.cs、Visual Studio AWS Lambda プロジェクト () で作成されたテナントインフラストラクチャプロビジョニング関数のコードを確認します。NET Core - C#) テンプレート。NET 6 (コンテナイメージ) の設計図。

Dockerfile を開き、コードを確認します。

次の NuGet パッケージが依存関係としてInfraProvisioningFunctionプロジェクトに追加されることに注意してください。

ソリューションをビルドします。

ソリューションを構築するには、以下のステップを実行します。

注:ソリューションをビルドする前に、必ず \tenant-onboarding-in-saas-architecture-for-silo-model-apg-example\src\TenantOnboardingInfra プロジェクト内の Amazon.CDK.Lib NuGet パッケージを最新バージョンに更新してください。

AWS CDK 環境をブートストラップします。

Windows コマンドプロンプトを開き、cdk.jsonファイルが利用可能なAWSCDKアプリルートフォルダに移動します (\tenant-onboarding-in-saas-architecture-for-silo-model-apg-example）。ブートストラップの場合は、次のコマンドを実行します。

cdk bootstrap 

認証情報のAWSプロファイルを作成した場合は、 プロファイルで コマンドを使用します。

cdk bootstrap --profile <profile name>
  

AWS CDK スタックを一覧表示します。

このプロジェクトの一部として作成されるスタックをすべて一覧表示するには、次のコマンドを実行します。

cdk ls
cdk ls --profile <profile name>

認証情報のAWSプロファイルを作成した場合は、プロファイルで コマンドを使用します。

cdk ls --profile <profile name>

作成するAWSリソースを確認します。

このプロジェクトの一部として作成されるすべてのAWSリソースを確認するには、次のコマンドを実行します。

cdk diff

認証情報のAWSプロファイルを作成した場合は、プロファイルで コマンドを使用します。

cdk diff --profile <profile name>

を使用してすべてのAWSリソースをデプロイしますAWSCDK。

すべてのAWSリソースをデプロイするには、次のコマンドを実行します。

cdk deploy --all --require-approval never

認証情報のAWSプロファイルを作成した場合は、プロファイルで コマンドを使用します。

cdk deploy --all --require-approval never --profile <profile name>

デプロイが完了したら、次の例に示すコマンドプロンプトの出力セクションAPIURLから をコピーします。

Outputs:
TenantOnboardingInfraStack.TenantOnboardingAPIEndpoint42E526D7 = https://j2qmp8ds21i1i.execute-api.us-west-2.amazonaws.com/prod/

新しいテナントを作成する。

新しいテナントを作成するには、次の curl リクエストを送信します。

curl -X POST <TenantOnboardingAPIEndpoint* from CDK Output>tenant -d '{"Name":"Tenant123", "Description":"Stack for Tenant123"}'

次の例に示すようにCDK、プレースホルダー<TenantOnboardingAPIEndpoint* from CDK Output>を AWS から実際の値に変更します。

curl -X POST https://j2qmp8ds21i1i.execute-api.us-west-2.amazonaws.com/prod/tenant -d '{"Name":"Tenant123", "Description":"test12"}'

以下の例は出力を示しています。

{"message": "A new tenant added - 5/4/2022 7:11:30 AM"}

DynamoDB で新しく作成されたテナントの詳細を確認します。

DynamoDB で新しく作成されたテナントの詳細を確認するには、次のステップを実行します。

新しいテナントのスタックの作成を確認します。

テンプレートに従って、新しいスタックが正常に作成され、新しく作成されたテナントのインフラストラクチャでプロビジョニングされたことを確認します CloudFormation 。

テナントスタックを削除します。

テナントスタックを削除するには、次の curl リクエストを送信します。

curl -X DELETE <TenantOnboardingAPIEndpoint* from CDK Output>tenant/<Tenant Name from previous step>

次の例に示すようにCDK、プレースホルダー<TenantOnboardingAPIEndpoint* from CDK Output>を AWS から実際の値<Tenant Name from previous step>に変更し、前のテナント作成ステップの実際の値に変更します。

curl -X DELETE https://j2qmp8ds21i1i.execute-api.us-west-2.amazonaws.com/prod/tenant/Tenant123

以下の例は出力を示しています。

{"message": "Tenant destroyed - 5/4/2022 7:14:48 AM"}

既存のテナントのスタックの削除を確認します。

既存のテナントスタックが削除されたことを確認するには、次のステップを実行します。

環境を破壊する。

スタックをクリーンアップする前に、次の点を確認してください。

テストが完了したら、次のコマンドを実行して、 を使用してすべてのスタックおよび関連リソースを破棄AWSCDKできます。

cdk destroy --all;

認証情報のAWSプロファイルを作成した場合は、 プロファイルを使用します。

スタックの削除プロンプトを確認して、スタックを削除します。

Amazon CloudWatch Logs をクリーンアップします。

スタックの削除プロセスでは、スタックによって生成された CloudWatch ログ (ロググループとログ) はクリーンアップされません。 CloudWatch コンソールまたは を使用して CloudWatch 、リソースを手動でクリーンアップしますAPI。