Installieren oder Aktualisieren von Paketen

Sie können Pakete auf Ihren AWS Systems Manager verwalteten Knoten bereitstellenDistributor, indem Sie eine Funktion von verwenden AWS Systems Manager. Um die Pakete bereitzustellen, verwenden Sie entweder AWS Management Console oder AWS Command Line Interface (AWS CLI). Sie können pro Befehl eine Version eines Pakets bereitstellen. Sie können neue Pakete installieren oder vorhandene Installationen direkt aktualisieren. Sie können wählen, ob Sie eine bestimmte Version oder stets die aktuelle Version eines Pakets bereitstellen möchten. Wir empfehlenState Manager, für die Installation von Paketen eine Funktion von AWS Systems Manager zu verwenden. Durch die Verwendung wird State Manager sichergestellt, dass auf Ihren verwalteten Knoten immer die neueste up-to-date Version Ihres Pakets ausgeführt wird.

Präferenz	AWS Systems Manager Aktion	Weitere Informationen
Installieren oder aktualisieren Sie ein Paket sofort.	Run Command	Einmaliges Installieren oder Aktualisieren eines Pakets (Konsole) Einmaliges Installieren eines Pakets (AWS CLI) Einmaliges Aktualisieren eines Pakets (AWS CLI)
Installieren Sie ein Paket nach einem Zeitplan, sodass die Installation immer die Standardversion enthält.	State Manager	Planen einer Paketinstallation oder -aktualisierung (Konsole) Planen einer Paketinstallation (AWS CLI) Planen einer Paketaktualisierung (AWS CLI)
Installieren Sie ein Paket automatisch auf neuen verwalteten Knoten, die ein bestimmtes Tag oder einen bestimmten Satz von Tags besitzen. Zum Beispiel die Installation des CloudWatch Amazon-Agenten auf neuen Instances.	State Manager	Eine Möglichkeit besteht in der Anwendung von Tags auf neue verwaltete Knoten und die anschließende Auflistung der Tags als Ziele in der State Manager-Zuordnung. State Manager installiert automatisch das Paket in einer Zuordnung auf verwalteten Knoten, deren Tags übereinstimmen. Siehe Ziele und Tarifkontrollen in State Manager Verbänden verstehen.

Einmaliges Installieren oder Aktualisieren eines Pakets (Konsole)

Sie können die AWS Systems Manager Konsole verwenden, um ein Paket einmal zu installieren oder zu aktualisieren. Wenn Sie eine einmalige Installation konfigurieren, verwendet Distributor AWS Systems Manager Run Command, eine Funktion von AWS Systems Manager, zum Ausführen der Installation.

So installieren oder aktualisieren Sie ein Paket einmal (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 für AWS veröffentlichte Pakete außer dem AWSEC2Launch-Agent Paket nicht 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 Other parameters (Weitere Parameter):

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

    • Geben Sie für Timeout (seconds) (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 Output options (Ausgabeoptionen) die Befehlsausgabe in einer Datei speichern möchten, aktivieren Sie das Kontrollkästchen Enable writing to a S3 bucket (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, die das Schreiben der Daten in einen S3-Bucket ermöglichen, sind diejenigen des Instanzprofils (für EC2 Instances) oder der IAM Servicerolle (hybridaktivierte Maschinen), die der Instanz zugewiesen wurden, nicht die des IAM Benutzers, der diese Aufgabe ausführt. Weitere Informationen finden Sie unter Konfigurieren der für Systems Manager erforderlichen Instanzberechtigungen oder Erstellen einer IAM Servicerolle für eine Hybridumgebung. Wenn sich der angegebene S3-Bucket in einem anderen befindet, stellen Sie außerdem sicher AWS-Konto, dass das Instanzprofil oder die IAM Servicerolle, die dem verwalteten Knoten zugeordnet sind, über die erforderlichen Berechtigungen verfügt, um in diesen Bucket zu schreiben.

14. Wenn Sie möchten, dass SNSBenachrichtigungen über den Status der Befehlsausführung gesendet werden, aktivieren Sie im Abschnitt Benachrichtigungen das Kontrollkästchen SNSBenachrichtigungen aktivieren.

    Weitere Informationen zur Konfiguration von SNS Amazon-Benachrichtigungen für Run Command finden Sie unterÜberwachung von Systems Manager Manager-Statusänderungen mithilfe von SNS Amazon-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.

Planen einer Paketinstallation oder -aktualisierung (Konsole)

Sie können die AWS Systems Manager Konsole verwenden, um die Installation oder Aktualisierung eines Pakets zu planen. Wenn Sie die Paketinstallation oder -aktualisierung planen, verwendet Distributor AWS Systems Manager State Manager zum Installieren oder Aktualisieren.

So planen Sie eine Paketinstallation (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 Kerngeräte auswählen, indem Sie entweder Alle verwalteten Instanzen in diesem Konto auswählen oder Instanz manuell auswählen wä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 Create Association.

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.

Weitere Informationen zur Verwendung der Optionen unter Advanced Options (Erweiterte Optionen), Rate control (Ratensteuerung) und Output options (Ausgabeoptionen) finden Sie unter Arbeiten mit Zuordnungen in Systems Manager.

Einmaliges Installieren eines Pakets (AWS CLI)

Sie können send-command den ausführen AWS CLI , um ein Distributor Paket einmal zu installieren. Wenn das Paket bereits installiert ist, wird die Anwendung offline geschaltet, während das Paket deinstalliert und stattdessen die neue Version installiert wird.

So installieren Sie ein Paket einmalig (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"]}'

Informationen zu anderen Optionen, die Sie mit dem send-command Befehl verwenden können, finden Sie send-commandim AWS Systems Manager Abschnitt der AWS CLI Befehlsreferenz.

Einmaliges Aktualisieren eines Pakets (AWS CLI)

Sie können das Programm ausführen send-command AWS CLI , um ein Distributor Paket zu aktualisieren, ohne die zugehörige Anwendung offline zu schalten. Nur neue oder aktualisierte Dateien im Paket werden ersetzt.

So aktualisieren Sie ein Paket einmal (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"]}'

Informationen zu anderen Optionen, die Sie mit dem send-command Befehl verwenden können, finden Sie send-commandim AWS Systems Manager Abschnitt der AWS CLI Befehlsreferenz.

Planen einer Paketinstallation (AWS CLI)

Sie können create-association den ausführen AWS CLI , um ein Distributor Paket nach einem Zeitplan zu installieren. Der Wert für --name, d. h. der Name des Dokuments, ist stets AWS-ConfigureAWSPackage. Der folgende Befehl verwendet den Schlüssel InstanceIds zur Angabe von verwalteten Knoten als Ziel. Wenn das Paket bereits installiert ist, wird die Anwendung offline geschaltet, während das Paket deinstalliert und stattdessen die neue Version installiert wird.

aws ssm create-association \
    --name "AWS-ConfigureAWSPackage" \
    --parameters '{"action":["Install"],"installationType":["Uninstall and reinstall"],"name":["package-name (in same account) or package-ARN (shared from different account)"]}' \
    --targets [{\"Key\":\"InstanceIds\",\"Values\":[\"instance-ID1\",\"instance-ID2\"]}]

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 create-association \
    --name "AWS-ConfigureAWSPackage" \
    --parameters '{"action":["Install"],"installationType":["Uninstall and reinstall"],"name":["Test-ConfigureAWSPackage"]}' \
    --targets [{\"Key\":\"InstanceIds\",\"Values\":[\"i-02573cafcfEXAMPLE\",\"i-0471e04240EXAMPLE\"]}]

Informationen zu anderen Optionen, die Sie mit dem create-association Befehl verwenden können, finden Sie create-associationim AWS Systems Manager Abschnitt der AWS CLI Befehlsreferenz.

Planen einer Paketaktualisierung (AWS CLI)

Sie können den ausführen create-association AWS CLI , um ein Distributor Paket nach einem Zeitplan zu aktualisieren, ohne die zugehörige Anwendung offline zu nehmen. Nur neue oder aktualisierte Dateien im Paket werden ersetzt. Der Wert für --name, d. h. der Name des Dokuments, ist stets AWS-ConfigureAWSPackage. Der folgende Befehl verwendet den Schlüssel InstanceIds zur Angabe von Ziel-Instances.

aws ssm create-association \
    --name "AWS-ConfigureAWSPackage" \
    --parameters '{"action":["Install"],"installationType":["In-place update"],"name":["package-name (in same account) or package-ARN (shared from different account)"]}' \
    --targets [{\"Key\":\"InstanceIds\",\"Values\":[\"instance-ID1\",\"instance-ID2\"]}]

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 create-association \
    --name "AWS-ConfigureAWSPackage" \
    --parameters '{"action":["Install"],"installationType":["In-place update"],"name":["Test-ConfigureAWSPackage"]}' \
    --targets [{\"Key\":\"InstanceIds\",\"Values\":[\"i-02573cafcfEXAMPLE\",\"i-0471e04240EXAMPLE\"]}]

Informationen zu anderen Optionen, die Sie mit dem create-association Befehl verwenden können, finden Sie create-associationim AWS Systems Manager Abschnitt der AWS CLI Befehlsreferenz.