View a markdown version of this page

在 AWS 架构完善的代理 中实施建议 - AWS Well-Architected
修复模型运行 SSM 运行手册进行修复开始指导式修复遵循指导性 SOP下载完整的 SOP完成修复

AWS 架构完善的代理 目前为预览版，可能会发生变化。

在 AWS 架构完善的代理 中实施建议

AWS WA 代理 提供多种实施选项，包括通过 AWS Systems Manager 自动修复、自助指导式操作以及 Premier Support 计划提供的人工介入支持。

修复模型

AWS WA 代理 根据建议的生成方式，使用两种修复模型：

  • SSM 运行手册自动化：从 AWS Trusted Advisor 检查中得出的建议具有预先构建的 SSM 运行手册。这些是经过测试的确定性自动化，可以直接运行或安排定期执行。在您同意的情况下，AWS WA 代理 可代表您触发一键修复。

  • 指导性操作（人工智能生成）：AWS WA 代理 人工智能引擎生成的建议（资源、应用程序和架构类型）包括分步指导操作。其中可能包括 AWS CLI 命令、SDK 代码、控制台演练或更新的 IaC 模板。指导性行动仅供参考，应在执行之前进行审查。

重要

AWS WA 代理 不会代表您执行人工智能生成的修复步骤。人工智能生成的指导性操作供您审查和验证。您负责在自己的环境中审查、测试和执行这些步骤。这符合 AWS 针对人工智能生成内容的共同责任模型。

运行 SSM 运行手册进行修复

如果未针对建议配置预先安排的自动修复，则可以查看 SSM 运行手册详细信息并运行 SSM 运行手册进行修复。

使用自动修复

  1. 导航到具体的建议详情页面。

  2. 转到“预先安排的自动修复”部分（如果有）。

  3. 查看 SSM 运行手册的详细信息，包括日程安排和下次运行时间。

  4. 选择 SSM 运行手册。

  5. 选择执行 SSM 运行手册以立即运行自动化。

  6. 监控执行状态和结果。

开始指导式修复

查看建议后，选择开始修复以开始指导式修正工作流程。AWS WA 代理 会生成一份针对您环境中的特定资源量身定制的分步标准操作流程（SOP）。该 SOP 具有资源感知能力：每个步骤都会引用您账户中的实际资源名称和 ARN，而非通用占位符。

开始修复

  1. 在建议详细信息页面上，选择开始修复。

  2. 选择修复方法：

    • 使用 AWS 管理控制台：分步控制台导航说明。

    • 使用 AWS CLI：可以复制和运行的 AWS CLI 命令。

    • 使用 SDK：可供您调整并执行的 SDK 代码（Python/boto3）。

AWS WA 代理 为所选方法生成分阶段 SOP。每种方法都会生成不同的 SOP，其中包含适用于该工具的说明。例如，控制台 SOP 将引导您完成 UI 导航，而 CLI SOP 则提供随时可以运行的命令。

遵循指导性 SOP

修复视图分为三个面板：

  • 左侧面板（阶段）：列出 SOP 中的所有阶段 [例如，第 1 阶段（共 10 个阶段），第 2 阶段（共 10 个阶段）]。当前阶段会高亮显示。阶段标题描述了相应操作（例如，“为 CloudTrail 日志存储桶启用 S3 存储桶密钥”）。

  • 中心面板（说明）：当前阶段的详细说明。根据补救方法，这可能包括控制台导航步骤、带有复制按钮的 CLI 命令或 SDK 代码片段。

  • 右侧面板（资源）：指向当前阶段相关 AWS 文档的链接。

继续完成 SOP：

  • 选择标记为完成以记录您已完成当前阶段，然后选择下一步继续。

  • 您可以通过在左侧面板中选择相应阶段来跳转至任何阶段。

  • 各阶段与您的资源相关。例如，如果某项建议涉及四个 S3 存储桶，则 SOP 会为每个存储桶设置一个单独的阶段，并按名称进行引用。

典型的 SOP 阶段包括：

  1. 先决条件（验证工具安装、凭证）

  2. 每个资源的修复步骤（每个受影响的资源有一个或多个阶段）

  3. 验证（确认更改已生效）

  4. 文档（记录更改以满足合规性和审计要求）

重要

补救 SOP 是利用 AWS 生成式人工智能功能生成的，可能包含错误或信息不完整。建议中可能涉及安全相关信息，这是一个较为复杂的议题。您有责任根据具体情况评估建议，并实施适当的监督和保障措施。在生产环境中执行之前，请查看所有步骤。有关 AWS 负责任的人工智能实践的更多信息，请参阅 https://aws.amazon.com/ai/responsible-ai/policy/。

下载完整的 SOP

选择下载完整 SOP 以导出当前所选修复方法的完整程序。下载文件将所有阶段、命令和资源参考整合到一份文档中。

每种修复方法（控制台、CLI、SDK）都有自己的可下载 SOP。使用修复页面顶部的单选按钮切换方法，下载所需的版本。

下载的 SOP 可用于：

  • 在无法访问控制台的环境中离线执行

  • 作为变更管理工单的附件提交审批

  • 将实施工作移交给其他团队成员

  • 存档以作为修复流程的记录

完成修复

控制台

完成所有阶段后，选择修复页面顶部的将建议标记为完成。该建议将移至您已存档的建议。如果基础问题在未来刷新周期中再次出现，AWS WA 代理 将生成新的建议。

CLI

将建议标记为已完成：

aws wellarchitected update-agent-recommendation-status \
    --recommendation-arn "arn:aws:wellarchitected:us-east-1:111122223333:agent-profile/my-profile/recommendation/rec-id" \
    --status COMPLETED

取消建议：

aws wellarchitected update-agent-recommendation-status \
    --recommendation-arn "arn:aws:wellarchitected:us-east-1:111122223333:agent-profile/my-profile/recommendation/rec-id" \
    --status SUPPRESSED \
    --update-reason "Not applicable to our environment"

重新打开之前关闭的建议：

aws wellarchitected update-agent-recommendation-status \
    --recommendation-arn "arn:aws:wellarchitected:us-east-1:111122223333:agent-profile/my-profile/recommendation/rec-id" \
    --status ACTIVE