使用 C# 和 AWS CDK 在孤立模型的 SaaS 架構中加入租用戶

驗證 Node.js 安裝。

若要確認您的本機電腦上已安裝 Node.js，請執行下列命令。

node --version

安裝 AWS CDK Toolkit。

若要在本機電腦上安裝 AWS CDK Toolkit，請執行下列命令。

npm install -g aws-cdk

如果未安裝 npm，您可以從 Node.js 網站安裝。

驗證 AWS CDK Toolkit 版本。

若要確認 AWS CDK Toolkit 版本已正確安裝在您的機器上，請執行下列命令。 

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 資料表擷取的租戶名稱進行補充。

範本會佈建租戶特定的基礎設施。在此範例中，它會佈建 AWS KMS 金鑰、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專案的相依性：

建置解決方案。

若要建置解決方案，請執行下列步驟：

引導 AWS CDK 環境。

開啟 Windows 命令提示字元，並導覽至可使用 cdk.json 檔案的 AWS CDK 應用程式根資料夾 (\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 CDK 部署所有 AWS 資源。

若要部署所有 AWS 資源，請執行下列命令。

cdk deploy --all --require-approval never

如果您已為登入資料建立 AWS 設定檔，請使用 命令搭配您的設定檔。

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

部署完成後，請從命令提示中的輸出區段複製 API URL，如下列範例所示。

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"}'

將預留位置變更為 AWS CDK <TenantOnboardingAPIEndpoint* from CDK Output>的實際值，如下列範例所示。

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>

將預留位置<TenantOnboardingAPIEndpoint* from CDK Output>變更為 AWS CDK 的實際值，並將 <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"}

驗證現有租用戶的堆疊刪除。

若要確認現有租用戶堆疊已刪除，請執行下列步驟：

銷毀環境。

在清除堆疊之前，請確定下列事項：

測試完成後，AWS CDK 可以透過執行下列命令來銷毀所有堆疊和相關資源。

cdk destroy --all;

如果您已為登入資料建立 AWS 設定檔，請使用該設定檔。

確認堆疊刪除提示以刪除堆疊。

清除 Amazon CloudWatch Logs。

堆疊刪除程序不會清除堆疊產生的 CloudWatch Logs （日誌群組和日誌）。使用 CloudWatch 主控台或 API 手動清除 CloudWatch 資源。