`AWSSupport-StartEC2RescueWorkflow`

描述

AWSSupport-StartEC2RescueWorkflow 运行手册在创建的帮助程序实例上运行提供 base64 编码脚本（Bash 或 Powershell）以修复实例。您的实例的根卷已连接并挂载到辅助实例（也称为EC2Rescue实例）。如果实例是 Windows，请提供 Powershell 脚本。否则，请使用 Bash。运行手册会设置一些可供脚本使用的环境变量。环境变量包含有关您提供的输入的信息，以及有关离线根卷的信息。离线卷已挂载，可供使用。例如，您可以将 Desired State Configuration 文件保存到离线 Windows 根卷，或 chroot 到一个离线 Linux 根卷并执行离线修复。

运行此自动化（控制台）

重要

此自动化不支持从 Marketplace 亚马逊系统映像 (AMIs) 创建的亚马逊EC2实例。

附加信息

要对脚本进行 base64 编码，可以使用 Powershell 或 Bash。Powershell：


[System.Convert]::ToBase64String([System.Text.Encoding]::ASCII.GetBytes([System.IO.File]::ReadAllText('PATH_TO_FILE')))

Bash：


base64 PATH_TO_FILE

下面是您可以在离线脚本中使用的环境变量列表，具体视目标操作系统而定

Windows:

Variable	描述	示例值
$env: _ _ID EC2RESCUE ACCOUNT	{{全局：ACCOUNT_ID}}	123456789012
$env: _ EC2RESCUE DATE	{{全球:DATE}}	2018-09-07
$env: _ _ EC2RESCUE DATE TIME	{{全局:DATE_TIME}}	2018-09-07_18.09.59
$env: _ _ EC2RESCUE EC2RW DIR	EC2Rescue适用于 Windows 的安装路径	C:\Program Files\ Amazon\ EC2Rescue
$env: _ _ EC2RESCUE EC2RW DIR	EC2Rescue适用于 Windows 的安装路径	C:\Program Files\ Amazon\ EC2Rescue
$env: _ _ID EC2RESCUE EXECUTION	{{自动化：EXECUTION_ID}}	7ef8008e-219b-4aca-8bb5-65e2e898e20b
$env: EC2RESCUE _ _ _ OFFLINE _ CURRENT CONTROL SET	离线 Windows 目前控制设置路径	`HKLM:\AWSTempSystem\ControlSet001`
$env: _ _ EC2RESCUE OFFLINE DRIVE	离线 Windows 驱动器号	D:\
$env: EC2RESCUE _ _ _ OFFLINE EBS DEVICE	离线根卷EBS设备	xvdf
$env: EC2RESCUE _ _ _ OFFLINE KERNEL VER	离线 Windows 内核版本	6.1.7601.24214
$env: EC2RESCUE _ _OS_ OFFLINE ARCHITECTURE	离线 Windows 架构	AMD64
$env: EC2RESCUE _ _OS_ OFFLINE CAPTION	离线 Windows 标题	Windows Server 2008 R2（数据中心版）
$env: EC2RESCUE _ _OS_ OFFLINE TYPE	离线 Windows 操作系统类型	Server
$env: EC2RESCUE _ _ _ OFFLINE _ PROGRAM FILES DIR	离线 Windows 程序文件目录路径	D:\Program Files
$env: EC2RESCUE _ _ _ _x86 OFFLINE _ PROGRAM FILES DIR	离线 Windows 程序文件 x86 目录路径	D:\Program Files (x86)
$env: EC2RESCUE _ _ _ OFFLINE REGISTRY DIR	离线 Windows 注册表目录路径	D:\Windows\System32\config
$env: EC2RESCUE _ _ _ OFFLINE SYSTEM ROOT	离线 Windows 系统根目录路径	D:\Windows
$env: _ EC2RESCUE REGION	{{全球:REGION}}	us-west-1
$env: _S3_ EC2RESCUE BUCKET	{{S3BucketName }}	amzn-s3 demo-bucket
$env: _S3_ EC2RESCUE PREFIX	{{ S3Prefix }}	myprefix/
$env: _ _ EC2RESCUE SOURCE INSTANCE	{{ InstanceId }}	i-abcdefgh123456789
$script: EC2RESCUE _ _ OFFLINE _ WINDOWS INSTALL	离线 Windows 安装元数据	客户 Powershell 对象

Linux：

Variable	描述	示例值
EC2RESCUE_ ACCOUNT _ID	{{全局：ACCOUNT_ID}}	123456789012
EC2RESCUE_DATE	{{全球:DATE}}	2018-09-07
EC2RESCUE_DATE_TIME	{{全局:DATE_TIME}}	2018-09-07_18.09.59
EC2RESCUE_EC2RL_DIR	EC2Rescue适用于 Linux 安装路径	/usr/local/ec2rl-1.1.3
EC2RESCUE_ EXECUTION _ID	{{自动化：EXECUTION_ID}}	7ef8008e-219b-4aca-8bb5-65e2e898e20b
EC2RESCUE_OFFLINE_DEVICE	离线设备名称	/dev/xvdf1
EC2RESCUE_OFFLINE_EBS_DEVICE	离线根卷EBS设备	/dev/sdf
EC2RESCUE_OFFLINE_SYSTEM_ROOT	离线根卷挂载点	/mnt/mount
EC2RESCUE_PYTHON	Python 版本	python2.7
EC2RESCUE_REGION	{{全球:REGION}}	us-west-1
EC2RESCUE_S3_ BUCKET	{{S3BucketName }}	amzn-s3 demo-bucket
EC2RESCUE_S3_ PREFIX	{{ S3Prefix }}	myprefix/
EC2RESCUE_SOURCE_INSTANCE	{{ InstanceId }}	i-abcdefgh123456789

文档类型

自动化

所有者

Amazon

平台

Linux、macOS、Windows

参数

AMIPrefix

类型：字符串

默认：AWSSupport-EC2Rescue

描述：（可选）备份AMI名称的前缀。
AutomationAssumeRole

类型：字符串

描述：（可选）允许 Systems ARN Manager Automation 代表您执行操作的 AWS Identity and Access Management (IAM) 角色的亚马逊资源名称 ()。如果未指定角色，Systems Manager Automation 将使用启动此运行手册的用户的权限。
CreatePostEC2RescueBackup

类型：字符串

有效值：true | false

默认：false

描述：（可选）将其设置true为 InstanceId在运行脚本之后、启动脚本之前创建。AMI自动化完成后仍AMI将保留。您有责任保护对的AMI访问权限或将其删除。
CreatePreEC2RescueBackup

类型：字符串

有效值：true | false

默认：false

描述：（可选）将其设置true为 InstanceId在运行脚本之前创建。AMI自动化完成后仍AMI将保留。您有责任保护对的AMI访问权限或将其删除。
EC2RescueInstanceType

类型：字符串

有效值：t2.small | t2.medium | t2.large

默认值：t2.small

描述：（可选）EC2实例的EC2Rescue实例类型。
InstanceId

类型：字符串

描述：（必填）您的EC2实例的 ID。IMPORTANT: AWS Systems Manager 自动化会停止此实例。存储在实例存储卷中的数据将丢失。如果不使用弹性 IP，则公有 IP 地址将发生更改。
OfflineScript

类型：字符串

描述：（必需）将对帮助程序实例运行的 Base64 编码的脚本。如果你的源实例是 Linux，如果是 Windows， PowerShell 则使用 Bash。
S3 BucketName

类型：字符串

描述：（可选）您账户中用于上传故障排除日志的 S3 存储桶的名称。请确保存储桶策略不会向不需要访问收集的日志的各方授予不必要的读/写权限。
S3Prefix

类型：字符串

默认：AWSSupport-EC2Rescue

描述：（可选）S3 日志的前缀。
SubnetId

类型：字符串

默认： SelectedInstanceSubnet

描述：（可选）EC2Rescue实例的子网 ID。默认情况下，使用提供的实例所在的同一子网。IMPORTANT：如果您提供自定义子网，则该子网必须与位于同一个可用区中 InstanceId，并且必须允许访问SSM终端节点。
UniqueId

类型：字符串

默认：{{自动化：EXECUTION_ID}}

描述：（可选）用于自动化的唯一标识符。

所需IAM权限

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

建议运行自动化的用户附加 A Rol mazonSSMAutomation e IAM 托管策略。除了此策略以外，用户还必须：


{
                "Version": "2012-10-17",
                "Statement": [
                   {
                      "Action": [
                         "lambda:InvokeFunction",
                         "lambda:DeleteFunction",
                         "lambda:GetFunction"
                      ],
                      "Resource": "arn:aws:lambda:*:An-AWS-Account-ID:function:AWSSupport-EC2Rescue-*",
                      "Effect": "Allow"
                   },
                   {
                      "Action": [
                         "s3:GetObject",
                         "s3:GetObjectVersion"
                      ],
                      "Resource": [
                         "arn:aws:s3:::awssupport-ssm.*/*.template",
                         "arn:aws:s3:::awssupport-ssm.*/*.zip"
                      ],
                      "Effect": "Allow"
                   },
                   {
                      "Action": [
                         "iam:CreateRole",
                         "iam:CreateInstanceProfile",
                         "iam:GetRole",
                         "iam:GetInstanceProfile",
                         "iam:PutRolePolicy",
                         "iam:DetachRolePolicy",
                         "iam:AttachRolePolicy",
                         "iam:PassRole",
                         "iam:AddRoleToInstanceProfile",
                         "iam:RemoveRoleFromInstanceProfile",
                         "iam:DeleteRole",
                         "iam:DeleteRolePolicy",
                         "iam:DeleteInstanceProfile"
                      ],
                      "Resource": [
                         "arn:aws:iam::An-AWS-Account-ID:role/AWSSupport-EC2Rescue-*",
                         "arn:aws:iam::An-AWS-Account-ID:instance-profile/AWSSupport-EC2Rescue-*"
                      ],
                      "Effect": "Allow"
                   },
                   {
                      "Action": [
                         "lambda:CreateFunction",
                         "ec2:CreateVpc",
                         "ec2:ModifyVpcAttribute",
                         "ec2:DeleteVpc",
                         "ec2:CreateInternetGateway",
                         "ec2:AttachInternetGateway",
                         "ec2:DetachInternetGateway",
                         "ec2:DeleteInternetGateway",
                         "ec2:CreateSubnet",
                         "ec2:DeleteSubnet",
                         "ec2:CreateRoute",
                         "ec2:DeleteRoute",
                         "ec2:CreateRouteTable",
                         "ec2:AssociateRouteTable",
                         "ec2:DisassociateRouteTable",
                         "ec2:DeleteRouteTable",
                         "ec2:CreateVpcEndpoint",
                         "ec2:DeleteVpcEndpoints",
                         "ec2:ModifyVpcEndpoint",
                         "ec2:Describe*"
                      ],
                      "Resource": "*",
                      "Effect": "Allow"
                   }
                ]
             }

文档步骤

aws:executeAwsApi - 描述提供的实例
aws:executeAwsApi - 描述提供的实例的根卷
aws:assertAwsResourceProperty-检查根卷设备类型是否为 EBS
aws:assertAwsResourceProperty - 检查根卷是否未加密
aws:assertAwsResourceProperty - 检查提供的子网 ID
1. （使用当前实例子网）-如果 SelectedInstanceSubnet * SubnetId = * 则运行aws:createStack部署EC2Rescue CloudFormation堆栈
2. （新建VPC）-如果 CreateNew VPC * SubnetId = * 则运行aws:createStack部署EC2Rescue CloudFormation堆栈
3. （使用自定义子网）- 在所有其他情况下：
  
  aws:assertAwsResourceProperty - 检查提供的子网是否与提供的实例位于同一可用区中
  
  aws:createStack-部署EC2Rescue CloudFormation堆栈
aws:invokeLambdaFunction - 执行额外输入验证
aws:executeAwsApi-更新EC2Rescue CloudFormation 堆栈以创建EC2Rescue帮助器实例
aws:waitForAwsResourceProperty-等待EC2Rescue CloudFormation 堆栈更新完成
aws:executeAwsApi-描述用于获取EC2Rescue帮助程序实例 ID 的EC2Rescue CloudFormation 堆栈输出
aws:waitForAwsResourceProperty-等待EC2Rescue帮助程序实例变为托管实例
aws:changeInstanceState - 停止提供的实例
aws:changeInstanceState - 停止提供的实例
aws:changeInstanceState - 强制停止提供的实例
aws:assertAwsResourceProperty-检查 CreatePreEC2RescueBackup输入值
1. （创建预EC2Rescue备份）-如果 * CreatePre EC2RescueBackup = true*
2. aws:executeAwsApi-创建所提供实例的AMI备份
3. aws:createTags-标记备AMI份
aws:runCommand-安装EC2Rescue在EC2Rescue帮助程序实例上
aws:executeAwsApi - 从提供的实例分离根卷
aws:assertAwsResourceProperty - 检查提供的实例平台
1. （实例为 Windows）：
  
  aws:executeAwsApi-将根卷作为 *xvdf* 附加到EC2Rescue辅助实例
  
  aws:sleep - 休眠 10 秒
  
  aws:runCommand - 在 Powershell 中运行提供的离线脚本
2. （实例为 Linux）：
  
  aws:executeAwsApi-将根卷作为 */dev/sdf* 附加到EC2Rescue辅助实例
  
  aws:sleep - 休眠 10 秒
  
  aws:runCommand - 在 Bash 中运行提供的离线脚本
aws:changeInstanceState-停止EC2Rescue帮助器实例
aws:changeInstanceState-强制停止EC2Rescue辅助实例
aws:executeAwsApi-将根卷与EC2Rescue辅助实例分离
aws:executeAwsApi - 将根卷附加回提供的实例
aws:assertAwsResourceProperty-检查 CreatePostEC2RescueBackup输入值
1. （创建后EC2Rescue备份）-如果 * CreatePost EC2RescueBackup = true*
2. aws:executeAwsApi-创建所提供实例的AMI备份
3. aws:createTags-标记备AMI份
aws:executeAwsApi - 为提供的实例的根卷恢复初始的终止时删除状态
aws:changeInstanceState - 将提供的实例恢复为初始状态（运行/停止）
aws:deleteStack-删除EC2Rescue CloudFormation 堆栈

输出

runScriptForLinux.Outp

runScriptForWindows. Output

preScriptBackup.ImageId

postScriptBackup.ImageId

Javascript 在您的浏览器中被禁用或不可用。

要使用 Amazon Web Services 文档，必须启用 Javascript。请参阅浏览器的帮助页面以了解相关说明。

文档惯例

AWSSupport-SendLogBundleToS3Bucket

AWSPremiumSupport-TroubleshootEC2DiskUsage