透過 AWS CDK 啟用跨多個 AWS 區域、帳戶和作業單位的 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 文config件中的設定credentials和檢視組態設定中的指示，驗證和檔案中的 AWS 設定檔組態。

驗證 AWS CDK 版本。

執行下列命令來驗證 AWS CDK 工具組的版本：

$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>

您可以在檔案的Dependencies區段中找到套/amazon-devopsguru-cdk-samples/package.json件名稱和版本的清單。如需詳細資訊，請參閱 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 大師。

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 大師可在大DevOps 師常見問答集中列出的 AWS 區域使用。

擷取 OU 識別碼。

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

啟用 OU 的服務管理權限。

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

部署 AWS CDK 堆疊以啟用跨 OU 的 DevOps 大師。

AWS CDK CdkDevopsguruStackOrgUnit 堆疊可在整個 OU 中提供 DevOps 大師服務。若要部署堆疊，請使用指定的參數執行下列命令：

$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 大師處理多個帳戶的特定堆疊資源。若要部署堆疊，請執行下列命令：

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

注意：如果您先前為選項 1 部署了此堆疊，請變更RegionIds參數 (確定從可用的區域中選擇)，以避免堆疊已存在的錯誤。

部署範例無伺服器基礎架構堆疊。

AWS CDK CdkInfrastructureStack 堆疊可部署無伺服器元件，例如 API Gateway、Lambda 和 DynamoDB 表格，以展示大師深入分析資訊。 DevOps 若要部署堆疊，請執行下列命令： 

$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，該 URL 會以 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 要求。

在 ListRestApiMonitorOperatorEndpointxxxx API 上以 HTTP 要求的形式插入輸入流量：

檢閱 DevOps 大師見解。

在標準條件下， DevOps Guru 儀表板會在進行中的見解計數器中顯示零。如果偵測到異常，就會以深入解析的形式提出警示。在導覽窗格中，選擇「深入解析」以查看異常的詳細資料，包括概觀、彙總量度、相關事件和建議。如需有關檢閱見解的詳細資訊，請參閱使用 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