使用 AWS CDK 在多个 AWS 区域、账户和 OU 中启用 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 配置文件配置。

验证 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

部署用于创建 IAM 角色的 AWS CDK 堆栈。

此模式使用 AWS CloudFormation StackSets 跨多个账户执行堆栈操作。如果您要创建第一个堆栈集，必须创建以下 IAM 角色才能在您的 Amazon Web Services account 中设置所需权限：

注意：角色必须具有这些确切名称。

有关更多信息，请参阅 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 Gur u 常见问题解答中列出的 AWS 区域中提供。

提取 OU ID。

在 AWS O rganizations 控制台上，确定要在其中启用 DevOps Guru 的组织单位的 ID。

支持 OU 的服务管理权限。

如果您使用 AWS Organizations 进行账户管理，则必须授予服务托管权限才能启用 DevOps Guru。与其手动创建 IAM 角色，不如使用基于组织的可信访问权限和服务相关角色 (SLR)。

部署 AWS CDK 堆栈以跨业务单元启用 DevOps Guru。

AWS CDK CdkDevopsguruStackOrgUnit 堆栈支持跨业务单元的 DevOps Guru 服务。若要部署堆栈，请使用指定参数运行以下命令：

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

部署用于创建 IAM 角色的 AWS CDK 堆栈。

如果您未创建第一个选项中显示的必需 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>"

注意：如果您此前对选项 1 部署了此堆栈，请更改 RegionIds 参数（确保从可用区选择）以避免出现堆栈已存在错误。

部署示例无服务器基础设施堆栈。

AWS CDK CdkInfrastructureStack 堆栈部署了无服务器组件，例如 API Gateway、Lambda 和 DynamoDB 表，以演示 Guru 的见解。 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 文件中的示例记录，请访问作为 AWS CDK 堆栈输出发布的 ListRestApiEndpointMonitorOperator API 的网址。您还可以在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 小时才能完成基准测试，具体取决于您选择在 Guru 中 DevOps 监控的资源数量。

更新 AWS CDK 基础设施堆栈。

要试用 DevOps Guru 见解，您可以进行一些配置更改以重现典型的操作问题。

在 API 注入 HTTP 请求。

在 ListRestApiMonitorOperatorEndpointxxxx API 上以 HTTP 请求形式注入入入口流量：

查看 DevOps Guru 的见解。

在标准条件下， 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