使用 AWS CDK 在多個 AWS 區域、帳戶和 OUs 中啟用 Amazon DevOps Guru，以改善營運效能

設定名為 的 AWS 設定檔。

如下所示設定您的 AWS 命名設定檔，以在多帳戶環境中部署堆疊。

對於管理員帳戶：

$aws configure --profile administrator
AWS Access Key ID [****]: <your-administrator-access-key-ID>
AWS Secret Access Key [****]: <your-administrator-secret-access-key>
Default region name [None]: <your-administrator-region>
Default output format [None]: json

對於目標帳戶：

$aws configure --profile target
AWS Access Key ID [****: <your-target-access-key-ID>
AWS Secret Access Key [****]: <your-target-secret-access-key>
Default region name [None]: <your-target-region>
Default output format [None]: json

如需詳細資訊，請參閱 AWS CLI 文件中的使用具名設定檔。

驗證 AWS 設定檔組態。

（選用） 您可以依照設定和檢視 AWS CLI 文件中的組態設定中的指示，來驗證 credentials和 config 檔案中的 AWS 設定檔組態。 https://docs.aws.amazon.com/cli/latest/userguide/cli-configure-files.html#cli-configure-files-methods

驗證 AWS CDK 版本。

執行下列命令來驗證 AWS CDK Toolkit 的版本：

$cdk --version

此模式需要 1.107.0 版或更新版本。如果您有舊版的 AWS CDK，請遵循 AWS CDK 文件中的指示進行更新。

複製專案程式碼。

使用 命令複製此模式的 GitHub 儲存庫：

$git clone https://github.com/aws-samples/amazon-devopsguru-cdk-samples.git

安裝套件相依性並編譯 TypeScript 檔案。

安裝套件相依性，並執行下列命令編譯 TypeScript 檔案：

$cd amazon-devopsguru-cdk-samples
$npm install
$npm fund

這些命令會從範例儲存庫安裝所有套件。

$npm ci

—或—

$npm install -g @aws-cdk/<package-name>

您可以在 /amazon-devopsguru-cdk-samples/package.json 檔案的 Dependencies區段中找到套件名稱和版本的清單。如需詳細資訊，請參閱 npm 文件中的 npm ci 和 npm 安裝。

設定 Amazon SNS 通知的電子郵件地址。

請依照下列步驟提供 Amazon SNS 通知的電子郵件地址：

建置專案程式碼。

執行 命令來建置專案程式碼並合成堆疊：

npm run build && cdk synth 

您應該會看到類似下列的輸出： 

$npm run build && cdk synth
> cdk-devopsguru@0.1.0 build
> tsc
Successfully synthesized to ~/amazon-devopsguru-cdk-samples/cdk.out
Supply a stack id (CdkDevopsGuruStackMultiAccReg,CdkDevopsGuruStackMultiAccRegSpecStacks, CdkDevopsguruStackOrgUnit, CdkInfrastructureStack, CdkStackSetAdminRole, CdkStackSetExecRole) to display its template.

如需詳細資訊和步驟，請參閱 AWS CDK 文件中的您的第一個 AWS CDK 應用程式。

列出 AWS CDK 堆疊。

執行下列命令來列出所有 AWS CDK 堆疊：

$cdk list

命令會顯示下列清單：

CdkDevopsGuruStackMultiAccReg
CdkDevopsGuruStackMultiAccRegSpecStacks
CdkDevopsguruStackOrgUnit
CdkInfrastructureStack
CdkStackSetAdminRole
CdkStackSetExecRole

部署 AWS CDK 堆疊以建立 IAM 角色。

此模式使用 AWS CloudFormation StackSets 跨多個帳戶執行堆疊操作。如果您要建立第一個堆疊集，則必須建立下列 IAM 角色，才能在 AWS 帳戶中設定必要的許可：

如需詳細資訊，請參閱 AWS CloudFormation 文件中的授予自我管理許可。

部署 AWS CDK 堆疊，以便在多個帳戶中啟用 DevOps Guru。

AWS CDK CdkDevopsGuruStackMultiAccReg堆疊會建立堆疊集，以跨多個帳戶和區域部署堆疊執行個體。若要部署堆疊，請使用指定的參數執行下列 CLI 命令：

$cdk deploy CdkDevopsGuruStackMultiAccReg \
  --profile administrator \
  --parameters AdministratorAccountId=<administrator-account-ID> \
  --parameters TargetAccountId=<target-account-ID> \
  --parameters RegionIds="<region-1>,<region-2>"

Amazon DevOps Guru 目前可在 DevOps Guru 常見問答集中列出的 AWS 區域中使用。

擷取 OU IDs。

在 AWS Organizations 主控台上，識別您要啟用 DevOps Guru 之組織單位IDs。

啟用 OUs 的服務管理許可。

如果您使用 AWS Organizations 進行帳戶管理，則必須授予服務管理許可以啟用 DevOps Guru。使用組織型受信任存取和服務連結角色 (SLRs)，而不是手動建立 IAM 角色。

部署 AWS CDK 堆疊以跨 OUs 啟用 DevOps Guru。

AWS CDK CdkDevopsguruStackOrgUnit堆疊可跨 OUs 啟用 DevOps Guru 服務。若要部署堆疊，請使用指定的參數執行下列命令：

$cdk deploy CdkDevopsguruStackOrgUnit \
  --profile administrator \ 
  --parameters RegionIds="<region-1>,<region-2>" \
  --parameters OrganizationalUnitIds="<OU-1>,<OU-2>"

部署 AWS CDK 堆疊以建立 IAM 角色。

如果您尚未建立第一個選項中顯示的必要 IAM 角色，請先執行此操作：

如需詳細資訊，請參閱 AWS CloudFormation 文件中的授予自我管理許可。

刪除現有的堆疊。

如果您已使用第一個選項來為所有堆疊資源啟用 DevOps Guru，您可以使用下列命令刪除舊堆疊：

$cdk destroy CdkDevopsGuruStackMultiAccReg --profile administrator 

或者，您可以在重新部署堆疊時變更 RegionIds 參數，以避免堆疊已存在錯誤。

使用堆疊清單更新 AWS CDK 堆疊。

部署 AWS CDK 堆疊，讓 DevOps Guru 能夠跨多個帳戶使用特定的堆疊資源。

AWS CDK CdkDevopsGuruStackMultiAccRegSpecStacks堆疊可讓 DevOps Guru 跨多個帳戶進行特定堆疊資源。若要部署堆疊，請執行下列命令：

$cdk deploy CdkDevopsGuruStackMultiAccRegSpecStacks \
  --profile administrator  \
  --parameters AdministratorAccountId=<administrator-account-ID> \
  --parameters TargetAccountId=<target-account-ID> \
  --parameters RegionIds="<region-1>,<region-2>"

部署範例無伺服器基礎設施堆疊。

AWS CDK CdkInfrastructureStack堆疊部署無伺服器元件，例如 API Gateway、Lambda 和 DynamoDB 資料表，以示範 DevOps Guru 洞見。若要部署堆疊，請執行下列命令： 

$cdk deploy CdkInfrastructureStack --profile administrator

在 DynamoDB 中插入範例記錄。

執行下列命令，將範例記錄填入 DynamoDB 資料表。提供populate-shops-dynamodb-table.json指令碼的正確路徑。

$aws dynamodb batch-write-item \
  --request-items file://scripts/populate-shops-dynamodb-table.json \
  --profile administrator

該命令會顯示下列輸出：

{
    "UnprocessedItems": {}
}

驗證 DynamoDB 中的插入記錄。

若要驗證 DynamoDB 資料表是否包含 populate-shops-dynamodb-table.json 檔案的範例記錄，請存取 ListRestApiEndpointMonitorOperator API 的 URL，該 API 會發佈為 AWS CDK 堆疊的輸出。您也可以在CdkInfrastructureStack堆疊 AWS CloudFormation 主控台的輸出索引標籤中找到此 URL。AWS CDK 輸出看起來會類似以下內容：

CdkInfrastructureStack.CreateRestApiMonitorOperatorEndpointD1D00045 = https://oure17c5vob.execute-api.<your-region>.amazonaws.com/prod/

CdkInfrastructureStack.ListRestApiMonitorOperatorEndpointABBDB8D8 = https://cdff8icfrn4.execute-api.<your-region>.amazonaws.com/prod/

等待資源完成底線。

此無伺服器堆疊有幾個資源。建議您等待 2 小時，再執行後續步驟。如果您在生產環境中部署此堆疊，可能需要長達 24 小時才能完成基準，具體取決於您在 DevOps Guru 中選取要監控的資源數量。

更新 AWS CDK 基礎設施堆疊。

若要試用 DevOps Guru 洞見，您可以進行一些組態變更，以重現典型的操作問題。

在 API 上注入 HTTP 請求。

在 ListRestApiMonitorOperatorEndpointxxxxAPI 上以 HTTP 請求的形式注入輸入流量：

檢閱 DevOps Guru 洞見。

在標準條件下，DevOps Guru 儀表板會在持續洞察計數器中顯示零。如果偵測到異常，它會以洞見的形式發出提醒。在導覽窗格中，選擇 Insights 以查看異常的詳細資訊，包括概觀、彙總指標、相關事件和建議。如需檢閱洞見的詳細資訊，請參閱使用 Amazon DevOps Guru 部落格文章透過 AIOps 取得營運洞見。

清除和刪除資源。

完成此模式之後，您應該移除您建立的資源，以避免產生任何進一步的費用。執行這些命令：

$cdk destroy CdkDevopsGuruStackMultiAccReg --profile administrator
$cdk destroy CdkDevopsguruStackOrgUnit --profile administrator
$cdk destroy CdkDevopsGuruStackMultiAccRegSpecStacks --profile administrator
$cdk destroy CdkInfrastructureStack --profile administrator
$cdk destroy CdkStackSetAdminRole --profile administrator
$cdk destroy CdkStackSetExecRole --profile administrator
$cdk destroy CdkStackSetExecRole --profile target