Aktualisieren Sie einen AWS OpsWorks for Chef Automate Server auf Chef Automate 2

Wichtig

AWS OpsWorks for Chef Automate hat am 5. Mai 2024 das Lebensende erreicht und wurde sowohl für Neu- als auch für Bestandskunden deaktiviert. Wir empfehlen bestehenden Kunden, zu Chef SaaS oder einer alternativen Lösung zu migrieren. Wenn du Fragen hast, kannst du dich auf AWS re:POST oder über den AWS Premium-Support an das AWS Support Team wenden.

Voraussetzungen für das Upgraden auf Chef Automate 2

Bevor Sie beginnen, sollten Sie die neuen Funktionen kennen, die mit Chef Automate 2 hinzugefügt werden, und die Funktionen, die Chef Automate 2 nicht unterstützt. Informationen über die neuen und nicht unterstützten Funktionen in Chef Automate 2 finden Sie in der Dokumentation zu Chef Automate 2 auf der Chef-Website.

Ein Server, auf dem Chef Automate 1 läuft, muss nach dem 1. November 2019 mindestens einmal erfolgreich gewartet worden sein, um für ein Upgrade infrage zu kommen.

Wie bei allen Wartungsarbeiten auf Ihrem AWS OpsWorks for Chef Automate Server ist der Server während des Upgrades offline. Sie sollten während des Upgrade-Prozesses eine Ausfallzeit von bis zu drei Stunden einplanen.

Sie benötigen für die Chef Automate Dashboard-Website die Anmeldeinformationen für diesen Server. Wenn das Upgrade abgeschlossen ist, sollten Sie sich beim Chef Automate Dashboard anmelden und sich vergewissern, dass Ihre Knoten und Konfigurationsinformationen nicht verändert wurden.

Wichtig

Wenn Sie bereit sind, Ihren AWS OpsWorks for Chef Automate Server auf Chef Automate 2 zu aktualisieren, verwenden Sie zum Upgrade nur die Anweisungen hier. Da viele Upgrade-Prozesse, wie z. B. die Erstellung von Backups, AWS OpsWorks for Chef Automate automatisiert werden, sollten Sie die Upgrade-Anweisungen auf der Chef-Website nicht befolgen.

Informationen zum Upgrade-Prozess

Während des Upgrade-Prozesses wird Ihr Server vor Beginn und nach Abschluss des Upgrades gesichert. Folgende Sicherungen werden erstellt:

• Ein Sicherung des Servers, wenn auf ihm noch Chef Automate 1 (Version 12.17.33) ausgeführt wird.

• Eine Sicherung des Servers, nachdem das Upgrade abgeschlossen ist und auf dem Server Chef Automate 2 (Version 2019-08) ausgeführt wird.

Der Upgrade-Prozess beendet die Amazon EC2 EC2-Instance, die der Server verwendet hat, als er Chef Automate 1 ausgeführt hat. Es wird eine neue Instance wird erstellt, um den Chef Automate 2-Server auszuführen.

Upgrade auf Chef Automate 2 (Konsole)

1. Melden Sie sich bei der an AWS Management Console und öffnen Sie die AWS OpsWorks Konsole unter https://console.aws.amazon.com/opsworks/.

2. Wählen Sie im linken Navigationsbereich die Option AWS OpsWorks for Chef Automate aus.

3. Wählen Sie einen Server, um sich seine Eigenschaftenseite anzeigen zu lassen. Ein blaues Banner oben auf der Seite sollte anzeigen, ob der Server für ein Upgrade auf Chef Automate 2 infrage kommt.

   Anmerkung

   Ein Server, auf dem Chef Automate 1 läuft, muss nach dem 1. November 2019 mindestens einmal erfolgreich gewartet worden sein, um für ein Upgrade infrage zu kommen.

4. Wenn der Server für ein Upgrade infrage kommt, wählen Sie Start upgrade (Upgrade starten) aus.

5. Das Upgrade kann bis zu drei Stunden dauern. Während des Upgrade-Prozesses wird auf der Eigenschaftenseite der Serverstatus als Under maintenance (Wartungszustand) angezeigt.

6. Nach Abschluss des Upgrades werden auf der Eigenschaftenseite die folgenden beiden Meldungen angezeigt: Successfully upgraded to Automate 2 (Erfolgreiches Upgrade auf Automate 2) und Maintenance completed successfully (Wartung erfolgreich abgeschlossen). Der Serverstatus sollte HEALTHY (FEHLERFREI) lauten.

7. Melden Sie sich mit Ihren vorhandenen Anmeldeinformationen beim Chef Automate Dashboard an, und vergewissern Sie sich, ob Ihre Knoten korrekt melden.

Upgrade auf Chef Automate 2 (CLI)

1. (Optional) Wenn Sie nicht sicher sind, welche Ihrer AWS OpsWorks for Chef Automate Server für ein Upgrade in Frage kommen, führen Sie den folgenden Befehl aus. Achten Sie darauf, den --region Parameter hinzuzufügen, wenn Sie AWS OpsWorks for Chef Automate Server in einer AWS-Region auflisten möchten, die sich von Ihrer Standard-AWS-Region unterscheidet.

   aws opsworks-cm describe-servers

   Suchen Sie in den Ergebnissen nach dem a-Wert von true für das Attribut CHEF_MAJOR_UPGRADE_AVAILABLE. Dies zeigt an, dass der Server für ein Upgrade auf Chef Automate 2 infrage kommt. Notieren Sie sich die Namen der AWS OpsWorks for Chef Automate Server, die für ein Upgrade in Frage kommen.

2. Führen Sie den folgenden Befehl aus und ersetzen Sie server_name durch den Namen eines AWS OpsWorks for Chef Automate Servers. Um statt einer routinemäßigen Systemwartung das Upgrade auf Chef Automate 2 durchzuführen, fügen Sie wie im Befehl gezeigt das CHEF_MAJOR_UPGRADE Engine-Attribut hinzu. Fügen Sie den --region-Parameter hinzu, wenn sich der Zielserver nicht in Ihrer AWS-Standardregion befindet. Sie können nur einen Server pro Befehl upgraden.

   aws opsworks-cm start-maintenance --server-name server_name --engine-attributes Name=CHEF_MAJOR_UPGRADE,Value=true --region region

   Wenn der Server aus irgendeinem Grund AWS OpsWorks for Chef Automate nicht aktualisiert werden kann, führt dieser Befehl zu einer Validierungsausnahme.

3. Das Upgrade kann bis zu drei Stunden dauern. Sie können den Upgrade-Status regelmäßig überprüfen, indem Sie den folgenden Befehl ausführen.

   aws opsworks-cm describe-servers --server-name server_name

   Suchen Sie in den Ergebnissen nach dem Status-Wert. Ein Status von UNDER_MAINTENANCE bedeutet, dass das Upgrade noch im Gange ist. Ein erfolgreiches Upgrade gibt Meldungen ähnlich den folgenden zurück.

   2019/10/24 00:27:56 UTC           Successfully upgraded to Automate 2.
   2019/10/23 23:50:38 UTC           Upgrading Chef server from Automate 1 to Automate 2

   Wenn das Upgrade nicht erfolgreich war, AWS OpsWorks for Chef Automate wird Ihr Server automatisch auf Chef Automate 1 zurückgesetzt.

   Wenn das Upgrade erfolgreich war, der Server aber nicht mehr so funktioniert wie vor dem Upgrade (z. B. wenn verwaltete Knoten nicht melden), können Sie den Server manuell zurücksetzen. Informationen zum manuellen Zurücksetzen finden Sie unter Einen AWS OpsWorks for Chef Automate Server auf Chef Automate 1 (CLI) zurücksetzen.

Einen AWS OpsWorks for Chef Automate Server auf Chef Automate 1 (CLI) zurücksetzen

Wenn der Upgrade-Vorgang fehlschlägt, AWS OpsWorks for Chef Automate wird Ihr Server automatisch auf Chef Automate 1 zurückgesetzt. Wenn das Upgrade erfolgreich war, der Server jedoch nicht mehr so funktioniert wie vor dem Upgrade, können Sie Ihren AWS OpsWorks for Chef Automate Server manuell auf Chef Automate 1 zurücksetzen, indem Sie den verwenden AWS CLI.

1. Führen Sie den folgenden Befehl aus, um die BackupId der letzten Sicherung anzuzeigen, die auf Ihrem Server vor dem Upgrade-Versuch durchgeführt wurde. Fügen Sie den --region-Parameter hinzu, wenn sich Ihr Server in einer AWS-Region befindet, die sich von Ihrer AWS-Standardregion unterscheidet.

   aws opsworks-cm describe-backups server_name

   Backup-IDs haben das Format ServerName-yyyymmddhhmmsssss. Suchen Sie in den Ergebnissen nach den folgenden Eigenschaften von Chef Automate 1.

   "Engine": "Chef"
   "EngineVersion": "12.17.33"

2. Führen Sie den folgenden Befehl aus, wobei Sie die in Schritt 1 zurückgegebene Sicherungs-ID als Wert von --backup-id verwenden.

   aws opsworks-cm restore-server --server-name server_name --backup-id ServerName-yyyyMMddHHmmssSSS

   Je nach Menge der Daten, die Sie auf dem Server gespeichert haben, dauert die Wiederherstellung des Servers zwischen 20 Minuten und drei Stunden. Während des Wiederherstellungsvorgangs weist der Server den Status RESTORING auf. Dieser Status wird auf der Eigenschaftenseite des Servers im angezeigt und in den Ergebnissen des Befehls zurückgegeben AWS Management Console. describe-servers

3. Nach Abschluss der Wiederherstellung zeigt die Konsole die Meldung Restore completed successfully (Wiederherstellung erfolgreich abgeschlossen) an. Ihr AWS OpsWorks for Chef Automate Server ist online, und zwar genauso wie vor Beginn des Upgrade-Vorgangs.

Weitere Informationen finden Sie unter:

• Systemwartung in AWS OpsWorks for Chef Automate

• Einen AWS OpsWorks for Chef Automate Server aus einem Backup wiederherstellen

• DescribeServers in der AWS OpsWorks -API-Referenz

• StartMaintenance in der AWS OpsWorks -API-Referenz