Installieren oder Aktualisieren von Distributor-Paketen

So installieren oder aktualisieren Sie ein Paket einmalig mithilfe der Konsole

1. Öffnen Sie die AWS Systems Manager-Konsole unter https://console.aws.amazon.com/systems-manager/.

2. Wählen Sie im Navigationsbereich Distributor aus.

3. Wählen Sie auf der Distributor-Startseite das Paket aus, das Sie installieren möchten.

4. Wählen Sie Install one time (Einmal installieren) aus.

   Dieser Befehl öffnet Run Command mit dem Befehlsdokument AWS-ConfigureAWSPackage. Ihr Distributor-Paket ist vorausgewählt.

5. Wählen Sie unter Document version (Dokumentversion) die Version des AWS-ConfigureAWSPackage-Dokuments aus, das Sie ausführen möchten.

6. Wählen Sie für Action (Aktion) die Option Install (Installieren).

7. Wählen Sie unter Installation type (Installationstyp) eine der folgenden Optionen aus:

   • Uninstall and reinstall (Deinstallieren und neu installieren): Das Paket wird vollständig deinstalliert und dann neu installiert. Die Anwendung ist bis zum Abschluss der Neuinstallation nicht verfügbar.

   • In-place update (Direkte Aktualisierung): Der vorhandenen Installation werden entsprechend den Anweisungen, die Sie in einem update-Skript angeben, nur neue oder geänderte Dateien hinzugefügt. Die Anwendung ist während des Aktualisierungsprozesses weiterhin verfügbar. Diese Option wird nicht für AWS veröffentlichte Pakete mit Ausnahme des AWSEC2Launch-Agent-Pakets unterstützt.

8. Überprüfen Sie, ob unter Name der Name des ausgewählten Pakets angegeben ist.

9. (Optional) Geben Sie unter Version den Versionsnamen des Pakets ein. Wenn Sie dieses Feld leer lassen, installiert Run Command die von Ihnen in Distributor ausgewählte Standardversion.

10. Wählen Sie im Abschnitt Targets (Ziele) die verwalteten Knoten, auf denen Sie diese Operation ausführen möchten, indem Sie Tags angeben, Instances oder Geräte manuell auswählen oder eine Ressourcengruppe angeben.

    Anmerkung

    Wenn kein verwalteter Knoten in der Liste angezeigt wird, lesen Sie Problembehandlung bei der Verfügbarkeit verwalteter Knoten.

11. Für Weitere Parameter:

    • Geben Sie im Feld Kommentar Informationen zu diesem Befehl ein.

    • Geben Sie für Timeout (Sekunden) in Sekunden an, wie lange gewartet werden soll, bis für die gesamte Befehlsausführung ein Fehler auftritt.

12. Für Rate control (Temposteuerung):

    • Geben Sie unter Concurrency (Nebenläufigkeit) entweder eine Zahl oder einen Prozentsatz von Zielen an, auf denen der Befehl gleichzeitig ausgeführt werden soll.

      Anmerkung

      Wenn Sie Ziele ausgewählt haben, indem Sie Tags oder Ressourcengruppen angeben, und Sie noch nicht sicher sind, wie viele verwaltete Knoten anvisiert sind, sollten Sie die Anzahl von Zielen, die das Dokument gleichzeitig ausführen können, beschränken, indem Sie einen Prozentsatz angeben.

    • Geben Sie unter Error threshold (Fehlerschwellenwert) an, wann die Ausführung des Befehls auf anderen Zielen beendet werden soll, nachdem dafür entweder auf einer bestimmten Anzahl oder einem Prozentsatz von verwalteten Knoten ein Fehler aufgetreten ist. Falls Sie beispielsweise drei Fehler angeben, sendet Systems Manager keinen Befehl mehr, wenn der vierte Fehler empfangen wird. Von verwalteten Knoten, auf denen der Befehl noch verarbeitet wird, werden unter Umständen ebenfalls Fehler gesendet.

13. (Optional) Wenn Sie im Abschnitt Ausgabeoptionen die Befehlsausgabe in einer Datei speichern möchten, aktivieren Sie das Kontrollkästchen Schreiben in einen S3-Bucket aktivieren. Geben Sie die Namen für den Bucket und das Präfix (Ordner) in die Textfelder ein.

    Anmerkung

    Die S3-Berechtigungen zum Schreiben von Daten in einen S3-Bucket sind diejenigen des Instance-Profils (für EC2-Instances) oder der IAM-Servicerolle (hybrid-aktivierte Maschinen), die der Instance zugewiesen sind, und nicht diejenigen des IAM-Benutzers, der diese Aufgabe ausführt. Weitere Informationen finden Sie unter Instance-Berechtigungen für Systems Manager konfigurieren oder Eine IAM-Servicerolle für eine Hybrid-Umgebung erstellen. Wenn sich der angegebene S3-Bucket in einem anderen AWS-Konto befindet, stellen Sie außerdem sicher, dass das Instance-Profil oder die IAM-Servicerolle, die dem verwalteten Knoten zugeordnet ist, über die erforderlichen Berechtigungen zum Schreiben in diesen Bucket verfügt.

14. Aktivieren Sie das Kontrollkästchen SNS-Benachrichtigungen aktivieren im Abschnitt SNS-Benachrichtigungen, wenn Sie über den Status der Befehlsausführung benachrichtigt werden möchten,

    Weitere Informationen zum Konfigurieren von Amazon-SNS-Benachrichtigungen für Run Command finden Sie unter Überwachung von Systems Manager-Statusänderungen mit Amazon SNS-Benachrichtigungen.

15. Wenn Sie bereit sind, das Paket zu installieren, klicken Sie auf Run (Ausführen).

16. Im Bereich Command status (Befehlsstatus) wird der Fortschritt der Installation angezeigt. Wenn der Befehl noch ausgeführt wird, klicken Sie oben links in der Konsole auf das Aktualisierungssymbol, bis in der Spalte Overall status (Gesamtstatus) oder Detailed status (Detailstatus) der Status Success (Erfolgreich) oder Failed (Fehlgeschlagen) angezeigt wird.

17. Klicken Sie im Bereich Targets and outputs (Ziele und Ausgaben) auf die Schaltfläche neben dem Namen eines verwalteten Knotens und wählen Sie dann View output (Ausgabe anzeigen).

    Der Befehlsausgabeseite zeigt die Ergebnisse der Befehlsausführung an.

18. (Optional) Wenn Sie die Befehlsausgabe in einen Amazon S3-Bucket schreiben möchten, wählen Sie Amazon S3, um die Ausgabeprotokolldaten anzuzeigen.

So planen Sie eine Paketinstallation mithilfe der Konsole

1. Öffnen Sie die AWS Systems Manager-Konsole unter https://console.aws.amazon.com/systems-manager/.

2. Wählen Sie im Navigationsbereich Distributor aus.

3. Wählen Sie auf der Distributor-Startseite das Paket aus, das Sie installieren oder aktualisieren möchten.

4. Wählen Sie unter Package (Paket) die Option Install on a schedule (Nach Plan installieren) aus.

   Dieser Befehl öffnet State Manager zu einer neuen Zuordnung, die für Sie erstellt wurde.

5. Geben Sie unter Name einen Namen ein (z. B. Deploy-test-agent-package). Dies ist zwar optional, wird aber empfohlen. Der Name darf keine Leerzeichen enthalten.

6. In der Liste Document (Dokument) ist der Dokumentname AWS-ConfigureAWSPackage bereits ausgewählt.

7. Überprüfen Sie unter Action (Aktion), ob Install (Installieren) ausgewählt ist.

8. Wählen Sie unter Installation type (Installationstyp) eine der folgenden Optionen aus:

   • Uninstall and reinstall (Deinstallieren und neu installieren): Das Paket wird vollständig deinstalliert und dann neu installiert. Die Anwendung ist bis zum Abschluss der Neuinstallation nicht verfügbar.

   • In-place update (Direkte Aktualisierung): Der vorhandenen Installation werden entsprechend den Anweisungen, die Sie in einem update-Skript angeben, nur neue oder geänderte Dateien hinzugefügt. Die Anwendung ist während des Aktualisierungsprozesses weiterhin verfügbar.

9. Überprüfen Sie unter Name, ob der Name Ihres Pakets angegeben ist.

10. Geben Sie unter Version die Versionskennung ein, wenn Sie eine andere Paketversion als die zuletzt veröffentlichte Version installieren möchten.

11. Wählen Sie unter Targets (Ziele) die Optionen Selecting all managed instances in this account (Alle verwalteten Instances in diesem Konto auswählen), Specifying tags (Tags angeben) oder Manually Selecting Instance (Instance manuell auswählen) aus. Wenn Sie die Zielressourcen mithilfe von Tags ausgewählt haben, geben Sie einen Tag-Schlüssel und einen Tag-Wert in die entsprechenden Felder ein.

    Anmerkung

    Sie können verwaltete AWS IoT Greengrass-Core-Geräte auswählen, indem Sie entweder Alle verwaltete Instances in diesem Konto auswählen oder eine Instance manuell auswählen.

12. Wählen Sie unter Specify schedule (Plan angeben) die Option On Schedule (Nach Plan) aus, um die Zuordnung nach einem regelmäßigen Zeitplan auszuführen, oder No Schedule (Kein Plan), um die Zuordnung einmalig auszuführen. Weitere Informationen zu diesen Optionen finden Sie unter Arbeiten mit Zuordnungen in Systems Manager. Verwenden Sie die Steuerelemente, um einen cron- oder Rate-Zeitplan für die Zuordnung zu erstellen.

13. Wählen Sie Zuordnung erstellen.

14. Klicken Sie auf der Seite Association (Zuordnung) auf die Schaltfläche neben der von Ihnen erstellten Zuordnung und wählen Sie dann Apply association now (Zuordnung jetzt anwenden) aus.

    State Manager erstellt die Zuordnung und führt sie sofort auf den angegebenen Zielen aus. Weitere Informationen zu den Ergebnissen der Ausführung von Zuordnungen finden Sie unter Arbeiten mit Zuordnungen in Systems Manager in diesem Handbuch.

Einmaliges Installieren eines Pakets mithilfe der AWS CLI

• Führen Sie in der AWS CLI den folgenden aus.

  aws ssm send-command \
      --document-name "AWS-ConfigureAWSPackage" \
      --instance-ids "instance-IDs" \
      --parameters '{"action":["Install"],"installationType":["Uninstall and reinstall"],"name":["package-name (in same account) or package-ARN (shared from different account)"]}'

  Anmerkung

  Das Standardverhalten für installationType ist Uninstall and reinstall. Sie können "installationType":["Uninstall and reinstall"] im Befehl weglassen, wenn Sie ein komplettes Paket installieren.

  Im Folgenden wird ein Beispiel gezeigt.

  aws ssm send-command \
      --document-name "AWS-ConfigureAWSPackage" \
      --instance-ids "i-00000000000000" \
      --parameters '{"action":["Install"],"installationType":["Uninstall and reinstall"],"name":["ExamplePackage"]}'

Einmaliges Aktualisieren eines Pakets mithilfe der AWS CLI

• Führen Sie in der AWS CLI den folgenden aus.

  aws ssm send-command \
      --document-name "AWS-ConfigureAWSPackage" \
      --instance-ids "instance-IDs" \
      --parameters '{"action":["Install"],"installationType":["In-place update"],"name":["package-name (in same account) or package-ARN (shared from different account)"]}'

  Anmerkung

  Wenn Sie neue oder geänderte Dateien hinzufügen, müssen Sie "installationType":["In-place update"] in den Befehl einschließen.

  Im Folgenden wird ein Beispiel gezeigt.

  aws ssm send-command \
      --document-name "AWS-ConfigureAWSPackage" \
      --instance-ids "i-02573cafcfEXAMPLE" \
      --parameters '{"action":["Install"],"installationType":["In-place update"],"name":["ExamplePackage"]}'