Abschließen eines Upgrades

Nach dem Durchführen des Upgrades eines Automation Suite-Clusters sind einige Änderungen erforderlich, um sicherzustellen, dass ein neuer Knoten durch Scale-out-Vorgänge korrekt dem Cluster beitritt. Um die Änderungen zu automatisieren, empfehlen wir die Verwendung des Skripts upgrade_wrapper.py.

Vorbereitung

Voraussetzungen

Stellen Sie sicher, dass Sie die folgenden Anforderungen erfüllen:

• Python 3.8 oder höher muss auf der Maschine installiert sein, auf der Sie das Skript ausführen. Weitere Informationen finden Sie in der Python-Dokumentation.
• Für das Skript sind Python-Pakete erforderlich. Sie können diese Pakete mit dem folgenden BiB-Befehl installieren. Weitere Informationen finden Sie in der BiB-Dokumentation.

  pip install wget requests boto3

• boto3-Clients müssen sich bei AWS authentifizieren können, da über sie Bereitstellungsänderungen erfolgen. Sie können Anmeldeinformationen als Umgebungsvariablen oder über ein Standardprofil mit einer gemeinsam genutzten Anmeldeinformationsdatei bereitstellen. Der Benutzer muss über die Berechtigung zum Ausführen der im Abschnitt Skriptverhalten beschriebenen Aktionen verfügen.

• Stellen Sie sicher, dass Ihre RHEL-Version für die automatische Skalierungsgruppe (Server, Agent usw.) aktualisiert ist und mit der Version übereinstimmt, auf die Sie ein Upgrade durchführen.

• Überprüfen Sie die Datei cluster_config.json und ändern Sie alle booleschen Werte, die als String ("true"/"false") markiert sind, in tatsächliche boolesche Werte (true/false). Zum Beispiel:
  • Um die Widerstandsfähigkeit von Zonen zu aktivieren, verwenden Sie "zone_resilience": true.
  • Damit das Installationsprogramm die Datenbanken erstellen kann, verwenden Sie "sql.create_db": true.
• Wenn Sie ein Upgrade von der Automation Suite 2022.10 auf die Automation Suite 2023.4 oder höher durchführen und der Orchestrator sowohl auf der alten als auch auf der neuen Version aktiviert ist, müssen Sie das Flag orchestrator.block_classic_executions in der cluster_config.json-Datei auf true festlegen. Die Verwendung des Flags zeigt, dass Sie mit dem Blockieren klassischer Ordnerausführungen einverstanden sind. Wenn das Flag in diesem Szenario nicht verwendet wird, schlägt der Upgradevorgang fehl. Dieser Parameter ist bei Neuinstallationen nicht erforderlich.
• Wenn Sie auf die Automation Suite 2023.10 oder höher aktualisieren und Insights sowohl in der alten als auch in der neuen Umgebung aktiviert ist, müssen Sie das Flag insights.external_object_storage.bucket_name auf denselben Bucket festlegen, der für platform in der cluster_config.json-Datei verwendet wird. Wenn das Flag in diesem Szenario nicht verwendet wird, schlägt der Upgradevorgang fehl. Dieser Parameter ist bei Neuinstallationen nicht erforderlich.
• Wenn Sie auf die Automation Suite 2023.10 oder neuer aktualisieren, stellen Sie sicher, dass Sie die folgenden Felder in cluster_config.json ausfüllen, wenn sql.create_db auf true festgelegt ist:

  sql.server_url = "<db_endpoint>"
  sql.port = "1433"
  sql.username = <SQL Username>
  sql.password = <SQL password>

Überlegungen zum Skript

Berücksichtigen Sie beim Ausführen des Skripts upgrade_wrapper.py, dass es die folgenden Vorgänge ausführt:

• Lädt die erforderlichen Abhängigkeiten in den aktuellen Ordner herunter;
• Extrahiert Informationen aus dem Automation Suite-Bereitstellungsstack;

• Erstellt einen neuen Stack mit:

  • Eine neue Startvorlage für jede automatische Skalierungsgruppe, die bei der ursprünglichen Bereitstellung vorhanden war, mit den für den Installationsablauf der neuen Version erforderlichen Änderungen;
  • Eine IAM-Richtlinie, die an die IAM-Rolle angefügt ist, die von den Automation Suite-Knoten verwendet wird und den Vorgang DescribeStackResource auf dem aktuellen Stack zulässt;
    Hinweis: Die Richtlinie wird nur bereitgestellt, wenn zum Zeitpunkt der Bereitstellung keine benutzerdefinierte IAM-Rolle bereitgestellt wurde.Andernfalls sollten Sie der IAM-Rolle, die von den Automation Suite-Knoten verwendet wird, die Berechtigung cloudformation:DescribeStackResource für den neu bereitgestellten Stack erteilen.
• Aktualisiert die automatische Skalierungsgruppe, um die im neuen Stack erstellten Startvorlagen zu verwenden;
• Aktualisiert den SSM-Parameter, der die Installations-URL enthält (optional, abhängig von der ursprünglichen Version der Bereitstellungsvorlage);

• Überschreibt das alte Installationsprogramm, das bei der Erstinstallation verwendet wurde, mit dem Programm, das für die Aktualisierung auf allen Knoten durch einen SSM-Ausführungsbefehl verwendet wird. Dies ist erforderlich, um die Funktionalität der SSM-Dokumente beizubehalten, die bereits in der ursprünglichen Bereitstellung vorhanden sind.

  Hinweis: Das SSM-Dokument zur AMI-Aktualisierung funktioniert nach der Aktualisierung der Startvorlage möglicherweise nicht mehr.Die von den SSM-Dokumenten verwendete IAM-Rolle sollte mit den Berechtigungen ec2:CreateLaunchTemplateVersion und ec2:RunInstances für die neu erstellten Startvorlagen aktualisiert werden.
• Bereinigt die heruntergeladenen Dateien.

Ausführung

Führen Sie die folgenden Schritte aus, um ein Upgrade erfolgreich abzuschließen:

1. Laden Sie das upgrade_wrapper.py-Skript hier herunter.
2. Führen Sie das Skript in einem interaktiven oder nicht interaktiven Modus aus:
   • Option 1: Wenn Sie das Skript in einem interaktiven Modus ausführen, verwenden Sie den folgenden Befehl: python3 upgrade_wrapper.py

   • Option 2: Wenn Sie das Skript in einem nicht interaktiven Modus ausführen, füllt es automatisch die folgenden Umgebungsvariablen aus:

     • Die Variable AS_VERSION wird mit der Automation Suite-Version ausgefüllt, die Sie für das Upgrade verwendet haben;
     • Die Parameternamen in Großbuchstaben, die für eine bestimmte Version erforderlich sind. Sie können die Parameter im Objekt upgrade_matrix.json überprüfen, die die für diesen Prozess erforderlichen Abhängigkeiten definieren. Um beispielsweise die Bereitstellungsregion zu übergeben, die von der Version 2022.10.1 benötigt wird, müssen Sie die Umgebungsvariable AS_DEPLOYMENT_REGION festlegen.