View a markdown version of this page

AWSSupport-RunEC2RescueForWindowsTool - AWS Systems Manager 自动化运行手册参考

本文属于机器翻译版本。若本译文内容与英语原文存在差异，则一律以英文原文为准。

AWSSupport-RunEC2RescueForWindowsTool

描述

该AWSSupport-RunEC2RescueForWindowsTool运行手册在目标亚马逊弹性计算云（亚马逊 EC2）Windows 托管实例上运行适用于 Windows 服务器的 Amazon EC2 Rescue 故障排除工具，以帮助解决常见问题。本运行手册支持三个主要操作：

  • ResetAccess：重置本地管理员密码。密码是随机生成的，并安全地存储在 AWS Systems Manager 参数存储库中/EC2Rescue/Password/<instance_id>。如果您未提供任何参数，则使用默认 AWS Key Management Service (AWS KMS) 密钥对密码进行加密alias/aws/ssm。或者，您可以指定 AWS KMS 密钥 ID 以使用自己的密钥加密密码。

  • CollectLogs：通过运行带有/collect:all选项的 Amazon EC2 Rescue，从操作系统收集日志和配置文件，并将它们上传到您账户中的亚马逊简单存储服务 (Amazon S3) 存储桶。

  • FixAll：尝试通过运行带有/rescue:all选项的 Amazon EC2 Rescue 来检测和解决连接到当前实例的离线 Windows 根卷上的问题。

重要

本运行手册要求目标实例是 PowerShell 安装了 Windows AWS 工具的 Windows 托管实例。该运行手册使用系统管理器分销商软件包AWSSupport-EC2Rescue安装适用于 Windows 服务器的亚马逊 EC2 救援工具。

如何工作？

运行手册执行以下步骤：

  • 使用系统管理器分销商软件包安装适用于 Windows 服务器的 Amazon EC2 Rescue 故障排除工具。

  • 使用提供的参数执行指定的操作（ResetAccessCollectLogs、或FixAll）。

  • 用于ResetAccess：生成安全密码并将其存储在参数存储中。

  • 用于CollectLogs：收集系统日志并将其上传到指定的 Amazon S3 存储桶。

  • 对于FixAll：尝试修复指定脱机卷上的问题。

运行此自动化（控制台）

文档类型

自动化

所有者

Amazon

平台

Windows

参数

所需的 IAM 权限

AutomationAssumeRole 参数需要执行以下操作才能成功使用运行手册。

  • ssm:SendCommand

  • ssm:ListCommandInvocations

  • ssm:DescribeInstanceInformation

  • ssm:GetCommandInvocation

  • ssm:PutParameter（供 ResetAccess 采取行动）

  • kms:Encrypt（用于使用自定义 AWS KMS 密钥进行 ResetAccess 操作）

  • s3:PutObject（供 CollectLogs 采取行动）

  • s3:GetBucketAcl（供 CollectLogs 采取行动）

  • s3:GetBucketPolicy（供 CollectLogs 采取行动）

  • s3:GetBucketPolicyStatus（供 CollectLogs 采取行动）

策略示例：


{
    "Version": "2012-10-17",
    "Statement": [
        {
            "Effect": "Allow",
            "Action": [
                "ssm:SendCommand",
                "ssm:ListCommandInvocations",
                "ssm:DescribeInstanceInformation",
                "ssm:GetCommandInvocation",
                "ssm:PutParameter",
                "kms:Encrypt",
                "s3:PutObject",
                "s3:GetBucketAcl",
                "s3:GetBucketPolicy",
                "s3:GetBucketPolicyStatus"
            ],
            "Resource": "*"
        }
    ]
}

说明

按照这些步骤对自动化进行配置：

  1. 导航到 AWSSupport-RunEC2RescueForWindowsTool “系统管理器” 下的 “文档”。

  2. 选择 Execute automation（执行自动化）。

  3. 对于输入参数，输入以下内容：

    • 命令（必填）：

      • 描述：（必需）要执行的操作。

      • 类型：String

      • 允许值：[ResetAccess, CollectLogs, FixAll]

      • 默认值：ResetAccess

    • 参数（必填）：

      • 描述：（必填）命令的参数：

        • 用于ResetAccess： AWS AWS KMS 密钥 ID 或别名（默认：alias/aws/ssm）

        • 用于CollectLogs：要将日志上传到的 Amazon S3 存储桶名称

        • 对于FixAll：离线修复的设备名称（例如，xvdf）

      • 类型：String

      • 允许图案：^[0-9a-z][a-z0-9-.]{3,63}$|^(dev\/[a-z0-9]{2,10}|xv[a-z0-9]{1,10})$|^(alias\\aws\\ssm|[a-zA-Z0-9-/_]{1,32})$

  4. 选择执行。

  5. 自动化启动。

  6. 文档将执行以下步骤：

    • 安装 EC2Rescue：

      使用系统管理器分销商软件包安装适用于 Windows 服务器的 Amazon EC2 Rescue 故障排除工具AWSSupport-EC2Rescue。

    • 运行 EC2RescueForWindows：

      使用 Command 参数中指定的操作运行 PowerShell 脚本以执行所请求的操作。

  7. 完成后，请查看 “输出” 部分，了解详细的执行结果。

参考

Systems Manager Automation