将 AWS CloudFormation 堆栈迁移到启动模板

查找使用启动配置的自动扩缩组

• 使用以下 describe-auto-scaling-groups 命令列出在指定区域中使用启动配置的自动扩缩组的名称。包括 --filters 选项，将结果范围缩小到与 CloudFormation 堆栈关联的群组（按 aws:cloudformation:stack-name 标签键进行筛选）。

  aws autoscaling describe-auto-scaling-groups --region REGION \
    --filters Name=tag-key,Values=aws:cloudformation:stack-name \
    --query 'AutoScalingGroups[?LaunchConfigurationName!=`null`].AutoScalingGroupName'

  下面显示了示例输出。

  [
      "{stack-name}-group-1",
      "{stack-name}-group-2",
      "{stack-name}-group-3"
  ]

  您可以在 将自动扩缩组迁移到启动模板 中找到其他有用的 AWS CLI 命令，用于在查找要迁移的自动扩缩组和筛选输出。

修改堆栈模板并更新堆栈

1. 按照AWS CloudFormation用户指南中修改堆栈模板的中所述的修改堆栈模板一般步骤进行操作。

2. 将启动配置重写为启动模板。请参见以下示例：

   示例：简单的启动配置

   ---
   Resources:
     myLaunchConfig: 
       Type: AWS::AutoScaling::LaunchConfiguration
       Properties: 
         ImageId: ami-02354e95b3example
         InstanceType: t3.micro
         SecurityGroups:
           - !Ref EC2SecurityGroup
         KeyName: MyKeyPair
         BlockDeviceMappings: 
           - DeviceName: /dev/xvda
             Ebs: 
               VolumeSize: 150
               DeleteOnTermination: true
         UserData: 
           Fn::Base64: !Sub |
             #!/bin/bash -xe
             yum install -y aws-cfn-bootstrap
             /opt/aws/bin/cfn-signal -e $? --stack ${AWS::StackName} --resource myASG --region ${AWS::Region}

   示例：等效的启动模板

   ---
   Resources:
     myLaunchTemplate:
       Type: AWS::EC2::LaunchTemplate
       Properties:
         LaunchTemplateName: !Sub ${AWS::StackName}-launch-template
         LaunchTemplateData:
           ImageId: ami-02354e95b3example
           InstanceType: t3.micro
           SecurityGroupIds:
             - Ref! EC2SecurityGroup
           KeyName: MyKeyPair
           BlockDeviceMappings: 
             - DeviceName: /dev/xvda
               Ebs: 
                 VolumeSize: 150
                 DeleteOnTermination: true
           UserData: 
             Fn::Base64: !Sub |
               #!/bin/bash -x
               yum install -y aws-cfn-bootstrap
               /opt/aws/bin/cfn-signal -e $? --stack ${AWS::StackName} --resource myASG --region ${AWS::Region}

   有关 Amazon EC2 支持的所有属性的参考信息，请参阅AWS CloudFormation用户指南中的 AWS::EC2::LaunchTemplate。

   请注意启动模板如何包含值为 !Sub ${AWS::StackName}-launch-template 的 LaunchTemplateName 属性。如果您要在启动模板的名称中包含堆栈名称，则必须执行此操作。

3. 如果启动配置中存在 IamInstanceProfile 属性，则必须将其转换为结构并指定实例配置文件的名称或 ARN。有关示例，请参阅 AWS::EC2::LaunchTemplate。

4. 如果启动配置中存在 AssociatePublicIpAddress、InstanceMonitoring 或 PlacementTenancy 属性，则必须将其转换为结构。有关示例，请参阅 AWS::EC2::LaunchTemplate。

   一个例外情况是，当您用于自动扩缩组的子网上的 MapPublicIpOnLaunch 属性值与启动配置中的 AssociatePublicIpAddress 属性值相匹配时。在这种情况下，您可以忽略 AssociatePublicIpAddress 属性。该 AssociatePublicIpAddress 属性仅用于覆盖该 MapPublicIpOnLaunch 属性以更改实例在启动时是否接收公有 IPv4 地址。

5. 您可以将安全组从 SecurityGroups 属性复制到启动模板中的两个位置之一。通常，您可以将安全组复制到 SecurityGroupIds 属性。但是，如果您在启动模板中创建 NetworkInterfaces 结构来指定 AssociatePublicIpAddress 属性，则必须将安全组复制到网络接口的 Groups 属性中。

6. 如果您的启动配置中存在任何 NoDevice 设置为 true 的 BlockDeviceMapping 结构，则必须在启动模板中为 NoDevice 指定一个空字符串，才能让 Amazon EC2 省略该设备。

7. 如果您的启动配置中存在 SpotPrice 属性，我们建议您将其从启动模板中省略。您的竞价型实例将以当前的 Spot 价格启动。该价格永远不会超过按需价格。

   要请求竞价型实例，您有两个互斥的选项：

   • 第一种是在启动模板中使用 InstanceMarketOptions 结构（不推荐）。有关更多信息，请参阅AWS CloudFormation用户指南中的 AWS::EC2::LaunchTemplate InstanceMarketOptions。

   • 另一种方法是将 MixedInstancesPolicy 结构添加到自动扩缩组。这样做可以为你提供更多关于如何提出请求的选项。您的启动模板中的竞价型实例请求不支持每个自动扩缩组选择多个实例类型。但是，混合实例策略支持每个自动扩缩组选择多个实例类型。竞价型实例请求可以受益于有多个实例类型可供选择。有关更多信息，请参阅AWS CloudFormation用户指南中的 AWS::AutoScaling::AutoScalingGroup MixedInstancesPolicy。

8. 从 AWS::AutoScaling::AutoScalingGroup 资源中删除 LaunchConfigurationName 属性。将启动模板添加到其位置上。

   在以下示例中，Ref 内置函数获取带有逻辑 ID myLaunchTemplate 的 AWS::EC2::LaunchTemplate 资源。GetAtt 函数会获取 Version 属性的启动模板的最新版本号（例如 1）。

   示例：没有混合实例策略

   ---
   Resources:
     myASG:
       Type: AWS::AutoScaling::AutoScalingGroup
       Properties:
         LaunchTemplate:
           LaunchTemplateId: !Ref myLaunchTemplate
           Version: !GetAtt myLaunchTemplate.LatestVersionNumber
         ...

   示例：使用混合实例策略

   ---
   Resources:
     myASG:
       Type: AWS::AutoScaling::AutoScalingGroup
       Properties:        
         MixedInstancesPolicy:
           LaunchTemplate:
             LaunchTemplateSpecification:
               LaunchTemplateId: !Ref myLaunchTemplate
               Version: !GetAtt myLaunchTemplate.LatestVersionNumber
         ...

   有关 Amazon EC2 Auto Scaling 支持的所有属性的参考信息，请参阅AWS CloudFormation用户指南中的 AWS::AutoScaling::AutoScalingGroup。

9. 当您准备好部署这些更新时，请按照 CloudFormation 程序使用修改后的堆栈模板更新堆栈。有关更多信息，请参阅AWS CloudFormation用户指南中的修改堆栈模板。

跟踪迁移

1. 在CloudFormation控制台中，选择已更新的堆栈，然后单击事件选项卡，查看堆栈事件。

2. 要更新具有最新事件的事件列表，请选择 CloudFormation 控制台中的刷新按钮。

3. 在堆栈更新时，您会注意到每次资源更新都会发生多个事件。如果您在 “状态原因” 列中看到异常，表明在尝试创建启动模板时出现问题，请参阅 Amazon EC2 Auto Scaling 问题排查：启动模板 以了解潜在原因。

4. （可选）根据您对 UpdatePolicy 属性的使用情况，您可以从 Amazon EC2 控制台的自动扩缩组页面监控自动扩缩组的进度。选择 Auto Scaling 组。在 Activity（活动）选项卡的 Activity history（活动历史记录）下，Status（状态）列显示您的 Auto Scaling 组是否已成功启动或终止实例，或者扩展活动是否仍在进行中。

5. 堆栈更新完成后，CloudFormation 会启动 UPDATE_COMPLETE 堆栈事件。有关更多信息，请参阅AWS CloudFormation用户指南中的监控堆栈更新的进度。

6. 堆栈更新完成后，打开 Amazon EC2 控制台的启动模板页面和启动配置页面。您会注意到已创建新的启动模板，并且已删除启动配置。