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

驗證 Node.js 安裝。

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

node --version

安裝 AWS CDK Toolkit。

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

npm install -g aws-cdk

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

驗證 AWS CDK 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專案的相依性：

建置解決方案。

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

注意：建置解決方案之前，請務必將Amazon.CDK.Lib NuGet套件更新至\tenant-onboarding-in-saas-architecture-for-silo-model-apg-example\src\TenantOnboardingInfra專案的最新版本。

啟動AWSCDK環境。

開啟 Windows 命令提示，然後導覽至可使用 cdk.json 檔案AWSCDK的應用程式根資料夾 （\tenant-onboarding-in-saas-architecture-for-silo-model-apg-example）。執行下列命令進行引導。

cdk bootstrap 

如果您已為憑證建立AWS設定檔，請將 命令與設定檔搭配使用。

cdk bootstrap --profile <profile name>
  

列出AWSCDK堆疊。

若要列出要建立作為此專案一部分的所有堆疊，請執行下列命令。

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

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

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>變更為 的實際值AWSCDK，並將 <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 日誌 （日誌群組和日誌）。使用 CloudWatch 主控台或 手動清除 CloudWatch 資源API。