Migrieren Sie AWS CloudFormation Stacks zu Startvorlagen

So finden Sie Auto-Scaling-Gruppen, die eine Startkonfiguration verwenden

• Verwenden Sie den folgenden describe-auto-scaling-groupsBefehl, um die Namen der Auto Scaling Scaling-Gruppen aufzulisten, die Startkonfigurationen in der angegebenen Region verwenden. Fügen Sie die --filters Option hinzu, die Ergebnisse auf Gruppen einzugrenzen, die einem CloudFormation Stack zugeordnet sind (durch Filtern nach dem aws:cloudformation:stack-name Tag-Schlüssel).

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

  Das folgende Beispiel zeigt eine Ausgabe.

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

  Sie finden weitere nützliche AWS CLI Befehle, um Auto Scaling Scaling-Gruppen für die Migration zu finden und die Ausgabe zu filternMigrieren Sie Ihre Auto Scaling Scaling-Gruppen, um Vorlagen zu starten.

So ändern Sie die Stack-Vorlage und aktualisieren den Stack

1. Folgen Sie den gleichen allgemeinen Verfahren zum Ändern der Stack-Vorlage, die im AWS CloudFormation Benutzerhandbuch unter Ändern einer Stack-Vorlage beschrieben sind.

2. Schreiben Sie die Startkonfiguration in eine Startvorlage um. Sehen Sie sich das folgende Beispiel an:

   Beispiel: Eine einfache Startkonfiguration

   ---
   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}

   Beispiel: Das Äquivalent zur Startvorlage

   ---
   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}

   Referenzinformationen zu allen von Amazon EC2 unterstützten Eigenschaften finden Sie unter AWS::EC2:: LaunchTemplate AWS im AWS CloudFormation Benutzerhandbuch.

   Beachten Sie, dass die Startvorlage die Eigenschaft LaunchTemplateName mit einem Wert von !Sub ${AWS::StackName}-launch-template enthält. Dies ist erforderlich, wenn der Name der Startvorlage den Namen des Stacks enthalten soll.

3. Wenn die IamInstanceProfile Eigenschaft in Ihrer Startkonfiguration vorhanden ist, müssen Sie sie in eine Struktur konvertieren und entweder den Namen oder den Namen ARN des Instance-Profils angeben. Ein Beispiel finden Sie unter AWS:EC2:: LaunchTemplate AWS .

4. Wenn die Eigenschaften AssociatePublicIpAddress, InstanceMonitoring oder PlacementTenancy in Ihrer Startkonfiguration vorhanden sind, müssen Sie diese in eine Struktur umwandeln. Beispiele finden Sie unter AWS::EC2:: LaunchTemplate AWS .

   Eine Ausnahme besteht, wenn der Wert für die Eigenschaft MapPublicIpOnLaunch in den Teilnetzen, die Sie für Ihre Auto-Scaling-Gruppe verwendet haben, mit dem Wert für die Eigenschaft AssociatePublicIpAddress in Ihrer Startkonfiguration übereinstimmt. In diesem Fall können Sie die AssociatePublicIpAddress-Eigenschaft ignorieren. Die AssociatePublicIpAddress Eigenschaft wird nur verwendet, um die MapPublicIpOnLaunch Eigenschaft zu überschreiben, um zu ändern, ob Instances beim Start eine öffentliche IPv4 Adresse erhalten.

5. Sie können Sicherheitsgruppen aus der SecurityGroups-Eigenschaft an eine von zwei Stellen in Ihrer Startvorlage kopieren. Normalerweise kopieren Sie die Sicherheitsgruppen in die SecurityGroupIds-Eigenschaft. Wenn Sie jedoch in Ihrer Startvorlage eine NetworkInterfaces-Struktur erstellen, um die AssociatePublicIpAddress-Eigenschaft anzugeben, müssen Sie stattdessen die Sicherheitsgruppen in die Groups-Eigenschaft der Netzwerkschnittstelle kopieren.

6. Wenn in Ihrer Startkonfiguration BlockDeviceMapping Strukturen mit der NoDevice Einstellung auf vorhanden sindtrue, müssen Sie NoDevice in Ihrer Startvorlage eine leere Zeichenfolge für angeben, damit Amazon das Gerät EC2 auslässt.

7. Wenn die Eigenschaft SpotPrice in Ihrer Startkonfiguration vorhanden ist, empfehlen wir Ihnen, sie in Ihrer Startvorlage wegzulassen. Ihre Spot Instance wird zum aktuellen Spot-Preis gestartet. Dieser Preis wird niemals den On-Demand-Preis überschreiten.

   Um Spot-Instances anzufordern, haben Sie zwei Optionen, die sich gegenseitig ausschließen:

   • Die erste Möglichkeit besteht darin, die InstanceMarketOptions-Struktur in Ihrer Startvorlage zu verwenden (nicht empfohlen). Weitere Informationen finden Sie unter AWS::EC2:: LaunchTemplate InstanceMarketOptions AWS im AWS CloudFormation Benutzerhandbuch.

   • Die andere besteht darin, Ihrer Auto-Scaling-Gruppe eine MixedInstancesPolicy-Struktur hinzuzufügen. Auf diese Weise stehen Ihnen mehr Optionen zur Verfügung, wie Sie die Anfrage stellen können. Eine Spot-Instance-Anfrage in Ihrer Startvorlage unterstützt nicht mehr als eine Instance-Typauswahl pro Auto-Scaling-Gruppe. Eine Richtlinie für gemischte Instances unterstützt jedoch die Auswahl von mehr als einem Instance-Typ pro Auto-Scaling-Gruppe. Spot-Instance-Anfragen profitieren davon, dass mehr als ein einziger Instance-Typ zur Auswahl steht. Weitere Informationen finden Sie unter AWS::AutoScaling: AutoScalingGroup MixedInstancesPolicy AWS im AWS CloudFormation Benutzerhandbuch.

8. Entfernen Sie die LaunchConfigurationName Eigenschaft aus der AutoScalingGroup Ressource AWSAutoScaling:: AutoScalingGroup AWS . Fügen Sie stattdessen die Startvorlage hinzu.

   In den folgenden Beispielen ruft die intrinsische Funktion Ref die ID der AWS::::EC2:: LaunchTemplate AWS Ressource mit der logischen ID ab. myLaunchTemplate Die GetAttFunktion ruft die neueste Versionsnummer (z. B.1) der Startvorlage für die Version Eigenschaft ab.

   Beispiel: Ohne eine Richtlinie für gemischte Instances

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

   Beispiel: Mit einer Richtlinie für gemischte Instances

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

   Referenzinformationen zu allen Eigenschaften, die Amazon EC2 Auto Scaling unterstützt, finden Sie unter AWSAutoScaling:: AutoScalingGroup AWS im AWS CloudFormation Benutzerhandbuch.

9. Wenn Sie bereit sind, diese Updates bereitzustellen, folgen Sie den CloudFormation Verfahren, um den Stack mit Ihrer geänderten Stack-Vorlage zu aktualisieren. Weitere Informationen finden Sie unter Ändern einer Stack-Vorlage im AWS CloudFormation Benutzerhandbuch.

So verfolgen Sie die Migration

1. Wählen Sie in der AWS CloudFormation -Konsole den Stack aus, den Sie aktualisiert haben, und klicken Sie dann auf die Registerkarte Events (Ereignisse), um die Stack-Ereignisse anzuzeigen.

2. Um die Ereignisliste mit den neuesten Ereignissen zu aktualisieren, klicken Sie in der CloudFormation Konsole auf die Schaltfläche „Aktualisieren“.

3. Während Ihr Stack aktualisiert wird, werden Sie mehrere Ereignisse für jede Ressourcenaktualisierung feststellen. Wenn Sie in der Spalte Statusgrund eine Ausnahme sehen, die auf ein Problem beim Erstellen der Startvorlage hinweist, finden Sie weitere Informationen Problembehandlung bei Amazon EC2 Auto Scaling: Vorlagen starten zu möglichen Ursachen.

4. (Optional) Je nachdem, wie Sie das UpdatePolicy Attribut verwenden, können Sie den Fortschritt Ihrer Auto Scaling Scaling-Gruppe auf der Seite Auto Scaling Scaling-Gruppen der EC2 Amazon-Konsole überwachen. Wählen Sie die Auto-Scaling-Gruppe aus. Auf der Registerkarte Activity (Aktivität) unter Activity history (Aktivitätsverlauf) zeigt die Spalte Status an, ob Ihre Auto-Scaling-Gruppe-Instances erfolgreich gestartet oder beendet hat oder ob die Skalierungsaktivität noch im Gange ist.

5. Wenn das Stack-Update abgeschlossen ist, wird CloudFormation ein UPDATE_COMPLETE Stack-Ereignis ausgelöst. Weitere Informationen finden Sie unter Überwachung des Fortschritts einer Stack-Aktualisierung im AWS CloudFormation Benutzerhandbuch.

6. Nachdem das Stack-Update abgeschlossen ist, öffnen Sie die Seite Startvorlagen und Startkonfigurationen der EC2 Amazon-Konsole. Sie werden feststellen, dass eine neue Startvorlage erstellt und die Startkonfiguration gelöscht wurde.