View a markdown version of this page

AWSPremiumSupport-ExtendVolumesOnLinux - AWS Systems Manager Runbook-Referenz für Automation

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

Beschreibung

Das AWSPremiumSupport-ExtendVolumesOnLinux 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 am Amazon EBS-Volume erfolgen in drei Phasen:, und. modifying optimizing completed Diese Automatisierung wird mit der Erweiterung des Dateisystems fortgesetzt, wenn das Volume den optimizing Status erreicht. Während dieses optimizing Zustands kann es beim Ändern der Partitionsgröße zu vorübergehenden Leistungseinbußen und potenziellen Störungen auf Dateisystemebene kommen. Sie können den Fortschritt der Änderungen am Amazon EBS-Volume überwachen.

  • Kosten und Einschränkungen: Eine Erhöhung der Größe eines Amazon EBS-Volumes führt zu höheren monatlichen Speicherkosten. Weitere Informationen finden Sie in den Amazon EBS-Preisen. Für das Backup-AMI und die zugehörigen Snapshots, die von diesem Runbook erstellt wurden, fallen je nach Größe und Aufbewahrungsdauer zusätzliche Gebühren an. Wenn Sie bei einigen Volume-Typen nach der Erweiterung das gleiche IOPS-Verhältnis pro GB beibehalten müssen, müssen Sie möglicherweise die bereitgestellten IOPS ändern. RAID-Geräte und LVM-Volumes werden nicht unterstützt.

  • Sicherung 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, wenn 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 Linux ausgeführt wird

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

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

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

  • Erweitert die Dateisysteme auf der Ziel-Instance mithilfe von Shell-Skriptbefehlen

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 https://aws.amazon.com/premiumsupport/plans/ vergleichen.

Führen Sie diese Automatisierung aus (Konsole)

Art des Dokuments

Automatisierung

Eigentümer

Amazon

Plattformen

Linux

Parameter

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:DescribeVolumesModifications

  • ec2:ModifyVolume

  • ssm:SendCommand

  • ssm:ListCommandInvocations

  • ssm:DescribeInstanceInformation

  • ssm:DescribeAutomationExecutions

  • ssm:GetAutomationExecution

Beispiel für eine IAM-Richtlinie:


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

Anweisungen

Folgen Sie diesen Schritten, um die Automatisierung zu konfigurieren:

  1. Öffnen Sie AWSPremiumSupport-ExtendVolumesOnLinux im Systems Manager unter Dokumente.

  2. Wählen Sie Automatisierung ausführen.

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

    • AutomationAssumeRole (Fakultativ):

      • Beschreibung: (Optional) Der Amazon-Ressourcenname (ARN) der AWS Identity and Access Management (IAM) -Rolle, die es Systems Manager Automation ermöglicht, die Aktionen in Ihrem Namen auszuführen. 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-[a-z0-9]{8,17}$

    • VolumeExpansionCapSize (Erforderlich):

      • Beschreibung: (Erforderlich) Maximale Größe (in GiB), auf die 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 einzeilige CSV-Datei. Die Zeichenfolge beginnt mit, EXTEND; gefolgt von kommagetrennten Volumeninformationen für jedes Volume, wobei die Volumes durch Semikolons getrennt sind. Zu den Informationen jedes Volumes gehören: Volume-ID, Partition, Erweiterungskennzeichnung (1 zum Erweitern, 0 zum Überspringen), Neue Größe in GB, Region und. AWS Reason/Action

      • Typ: String

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

  4. Wählen Sie Ausführen.

  5. Die Automatisierung wird initiiert.

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

    • AssertInstanceIsManagedInstance:

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

    • DescribeInstance:

      Ruft die Platform Informationen der Amazon EC2-Zielinstanz ab.

    • BranchOnPlatform:

      Bestätigt, dass es sich bei der Amazon EC2-Zielinstanzplattform um Linux handelt.

    • CheckConcurrency:

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

    • CreateImage:

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

    • WaitUntilImageReady:

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

    • ExtendeBS-Volume:

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

    • DescribeVolumes:

      Beschreibt die Amazon EBS-Volumes, die an die Ziel-Instance angehängt sind.

    • ExtendFilesystem:

      Erweitert die Dateisysteme der Zielinstanz mithilfe von Shell-Skriptbefehlen.

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

Referenzen

Systems Manager Automation