AWSPremiumSupport-ExtendVolumesOnWindows - AWS Systems Manager Referenz zum Automatisierungs-Runbook

Die vorliegende Übersetzung wurde maschinell erstellt. Im Falle eines Konflikts oder eines Widerspruchs zwischen dieser übersetzten Fassung und der englischen Fassung (einschließlich infolge von Verzögerungen bei der Übersetzung) ist die englische Fassung maßgeblich.

AWSPremiumSupport-ExtendVolumesOnWindows

Beschreibung

Das AWSPremiumSupport-ExtendVolumesOnWindows Runbook erweitert die Amazon Elastic Block Store (Amazon EBS) -Volumes, ihre Partitionen und Dateisysteme auf einer Amazon Elastic Compute Cloud (Amazon EC2) -Zielinstanz.

Wichtige Überlegungen

  • Auswirkungen auf den Betrieb und Volumenstatus: Änderungen des Amazon EBS-Volumens erfolgen in drei Phasen: modifyingoptimizing, undcompleted. Diese Automatisierung wird mit der Dateisystemerweiterung fortgesetzt, wenn das Volume den optimizing Status erreicht. Während des optimizing Zustands kann es zu vorübergehenden Leistungseinbußen und möglichen Störungen auf Dateisystemebene bei der Größenänderung von Partitionen kommen. Sie können den Fortschritt der Amazon EBS-Volumenänderungen überwachen.

  • Kosten und Einschränkungen: Die Erhöhung der Größe eines Amazon EBS-Volumes führt zu höheren monatlichen Speicherkosten. Weitere Informationen finden Sie in der Amazon EBS-Preisübersicht. Für das Backup-AMI und die zugehörigen Snapshots, die von diesem Runbook erstellt werden, fallen zusätzliche Gebühren an, die von ihrer Größe und der Dauer der Aufbewahrung abhängen. Wenn Sie bei einigen Volumetypen nach der Erweiterung das gleiche Verhältnis von IOPS pro GB beibehalten möchten, müssen Sie möglicherweise die bereitgestellten IOPS ändern.

  • Backup und Wiederherstellung: Das Runbook erstellt ein Backup-AMI, bevor Änderungen an den Volumes vorgenommen werden. Das AMI und die zugehörigen Snapshots werden nicht automatisch aus Ihrem Konto entfernt. Sie sollten diese Backups manuell entfernen, falls sie nicht mehr benötigt werden. Im Falle eines Fehlers können Volumes aus den Snapshots des zugehörigen AMI wiederhergestellt werden, wie unter Ersetzen eines Amazon EBS-Volumes mithilfe eines Snapshots beschrieben.

Wie funktioniert das?

Dieses Runbook führt die folgenden Operationen aus:

  • Überprüft, ob die Zielinstanz von Systems Manager verwaltet wird und Windows Server ausgeführt wird

  • Stellt sicher, dass dieses Runbook nur einmal ausgeführt wird, das auf die aktuelle Amazon EC2 EC2-Instance abzielt

  • Erstellt ein Backup-Amazon Machine Image (AMI) von der Ziel-Instance

  • Erweitert die Amazon EBS-Volumes, die für die Erweiterung spezifiziert wurden

  • Erweitert die Dateisysteme auf der Ziel-Instance mithilfe von Befehlen PowerShell

Wichtig

Für den Zugriff auf AWSPremiumSupport-* Runbooks ist ein Abonnement für Business + Support, Enterprise Support oder Unified Operations erforderlich. Weitere Informationen finden Sie unter AWS Support Tarife vergleichen.

Führen Sie diese Automatisierung aus (Konsole)

Erforderliche IAM-Berechtigungen

Der AutomationAssumeRole Parameter erfordert die folgenden Aktionen, um das Runbook erfolgreich zu verwenden.

  • ec2:DescribeInstances

  • ec2:CreateImage

  • ec2:DescribeImages

  • ec2:DescribeVolumes

  • ec2:ModifyVolume

  • ssm:SendCommand

  • ssm:ListCommandInvocations

  • ssm:DescribeInstanceInformation

Beispiel für eine IAM-Richtlinie:


 {
     "Version": "2012-10-17",
     "Statement": [
         {
             "Effect": "Allow",
             "Action": [
                 "ec2:DescribeInstances",
                 "ec2:CreateImage",
                 "ec2:DescribeImages",
                 "ec2:DescribeVolumes",
                 "ec2:ModifyVolume",
                 "ssm:SendCommand",
                 "ssm:DescribeInstanceInformation",
                 "ssm:ListCommandInvocations"
             ],
             "Resource": "*"
         }
     ]
 }

Anweisungen

Gehen Sie wie folgt vor, um die Automatisierung zu konfigurieren:

  1. Navigieren Sie AWSPremiumSupport-ExtendVolumesOnWindowsim Systems Manager unter Dokumente zu.

  2. Wählen Sie Execute automation (Automatisierung ausführen).

  3. Geben Sie für die Eingabeparameter Folgendes ein:

    • AutomationAssumeRole (Fakultativ):

      • Beschreibung: (Optional) Der Amazon-Ressourcenname (ARN) der IAM-Rolle, mit der Systems Manager Automation die Aktionen in Ihrem Namen ausführen kann. Wenn keine Rolle angegeben ist, verwendet Systems Manager Automation die Berechtigungen des Benutzers, der dieses Runbook startet.

      • Typ: AWS::IAM::Role::Arn

    • InstanceId (Erforderlich):

      • Beschreibung: (Erforderlich) Die ID der Amazon EC2-Instance.

      • Typ: String

      • Muster zulassen: ^i-[0-9a-f]{8,17}$

    • VolumeExpansionCapSize (Erforderlich):

      • Beschreibung: (Erforderlich) Maximale Größe (in GiB), mit der die Amazon EBS-Volumes erhöht werden.

      • Typ: String

      • Muster zulassen: ^[0-9]{1,4}$

    • DiagnosticResults (Erforderlich):

      • Beschreibung: (Erforderlich) Die Ergebnisse des Prechecks-Skripts aus dem DiagnoseDiskUsage Dokument, formatiert als einzeiliges CSV-Format. Die Zeichenfolge beginnt mit, EXTEND; gefolgt von kommagetrennten Volumeninformationen für jeden Datenträger, wobei die Volumen durch Semikolons getrennt sind. Zu den Informationen jedes Volumes gehören: Volume-ID, Laufwerksbuchstabe, Erweiterungskennzeichnung (1 zum Erweitern, 0 zum Überspringen), Neue Größe in GB, AWS Region und Grund/Aktion.

      • Typ: String

      • Muster zulassen: ^EXTEND;[0-9a-zA-Z\\.;_%:\\-\/,\\s]{7,5400}$

  4. Wählen Sie Ausführen aus.

  5. Die Automatisierung wird initiiert.

  6. Das Dokument führt die folgenden Schritte aus:

    • AssertInstanceIsManagedInstance:

      Überprüft, ob die Zielinstanz von Systems Manager verwaltet wird.

    • DescribeInstance:

      Ruft die Plattforminformationen der Amazon EC2 EC2-Zielinstanz ab.

    • BranchOnPlatform:

      Bestätigt, dass die Amazon EC2 EC2-Instance-Zielplattform Windows Server ist.

    • CheckConcurrency:

      Stellt sicher, dass dieses Runbook nur einmal ausgeführt wird, das auf die aktuelle Amazon EC2 EC2-Instance abzielt.

    • CreateImage:

      Erstellt ein Backup-Amazon Machine Image (AMI) von der Ziel-Instance.

    • WaitUntilImageReady:

      Wartet darauf, dass das Amazon Machine Image (AMI) die Erstellung abgeschlossen hat und den available Status erreicht hat.

    • Verlängern EBSVolume:

      Erweitert die Amazon EBS-Volumes der Ziel-Instance, die für die Erweiterung angegeben wurden.

    • DescribeVolumes:

      Beschreibt die Amazon EBS-Volumes der Ziel-Instance, die für die Erweiterung angegeben wurden.

    • ExtendFilesystem:

      Erweitert die Dateisysteme der Ziel-Instance mithilfe PowerShell von Befehlen.

  7. Nach Abschluss der Ausführung finden Sie im Abschnitt Ausgaben die detaillierten Ergebnisse der Ausführung.

Referenzen

Systems Manager Automation