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.
Installieren oder aktualisieren Distributor Pakete
Sie können Pakete auf Ihren AWS Systems Manager verwalteten Knoten bereitstellen, indem Sie Distributor, ein Tool in AWS Systems Manager. Um die Pakete bereitzustellen, verwenden Sie entweder das 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 empfehlen die Verwendung State Manager, ein Tool in AWS Systems Manager, um Pakete zu installieren. Die Verwendung von State Manager hilft sicherzustellen, dass auf Ihren verwalteten Knoten immer die neueste up-to-date Version Ihres Pakets ausgeführt wird.
Wichtig
Pakete, die Sie mit Distributor installieren, sollten nur mithilfe von Distributor deinstalliert werden. Andernfalls kann Systems Manager die Anwendung immer noch als registrieren INSTALLED
und zu anderen unbeabsichtigten Ergebnissen führen.
Präferenz | AWS Systems Manager Aktion | Weitere Informationen |
---|---|---|
Installieren oder aktualisieren Sie ein Paket sofort. |
Run Command |
|
Installieren Sie ein Paket nach einem Zeitplan, sodass die Installation immer die Standardversion enthält. |
State Manager |
|
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, dies zu tun, besteht darin, Tags auf neue verwaltete Knoten anzuwenden und die Tags dann als Ziele in Ihrem State Manager Assoziation. State Manager installiert das Paket automatisch in einer Assoziation auf verwalteten Knoten, die über passende Tags verfügen. Siehe Grundlegendes zu Zielen und Ratenkontrollen in State Manager Verbände. |
Themen
- Einmaliges Installieren oder Aktualisieren eines Pakets mithilfe der Konsole
- Planen einer Paketinstallation oder -aktualisierung mithilfe der Konsole
- Einmaliges Installieren eines Pakets mit dem AWS CLI
- Einmaliges Aktualisieren eines Pakets mit dem AWS CLI
- Planung einer Paketinstallation mit dem AWS CLI
- Planung einer Paket-Aktualisierung mit dem AWS CLI
Einmaliges Installieren oder Aktualisieren eines Pakets mithilfe der 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, Distributor verwendetAWS Systems Manager Run Command, ein Tool in AWS Systems Manager, um die Installation durchzuführen.
So installieren oder aktualisieren Sie ein Paket einmalig mithilfe der Konsole
Öffnen Sie die AWS Systems Manager Konsole unter https://console.aws.amazon.com/systems-manager/
. -
Wählen Sie im Navigationsbereich Distributor.
-
Auf dem Distributor Wählen Sie auf der Startseite das Paket aus, das Sie installieren möchten.
-
Wählen Sie Install one time (Einmal installieren) aus.
Dieser Befehl wird geöffnet Run Command mit dem Befehlsdokument
AWS-ConfigureAWSPackage
und Ihrem Distributor Paket wurde bereits ausgewählt. -
Wählen Sie unter Document version (Dokumentversion) die Version des
AWS-ConfigureAWSPackage
-Dokuments aus, das Sie ausführen möchten. -
Wählen Sie für Action (Aktion) die Option Install (Installieren).
-
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 demAWSEC2Launch-Agent
Paket nicht unterstützt.
-
-
Überprüfen Sie, ob unter Name der Name des ausgewählten Pakets angegeben ist.
-
(Optional) Geben Sie unter Version den Versionsnamen des Pakets ein. Wenn Sie dieses Feld leer lassen, Run Command installiert die Standardversion, die Sie in ausgewählt haben Distributor.
-
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.
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.
-
-
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.
-
(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
Bei den S3-Berechtigungen, die das Schreiben von Daten in einen S3-Bucket ermöglichen, handelt es sich um die Berechtigungen des Instanzprofils (für EC2 Instances) oder der IAM-Servicerolle (hybridaktivierte Maschinen), die der Instanz zugewiesen wurden, nicht um die 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 befindet, stellen Sie außerdem sicher AWS-Konto, dass das dem verwalteten Knoten zugeordnete Instanzprofil oder die IAM-Dienstrolle über die erforderlichen Berechtigungen verfügt, um in diesen Bucket zu schreiben.
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 zur Konfiguration von Amazon SNS SNS-Benachrichtigungen für Run Command, finden Sie unter Überwachung von Systems Manager-Statusänderungen mit Amazon SNS-Benachrichtigungen.
-
Wenn Sie bereit sind, das Paket zu installieren, klicken Sie auf Run (Ausführen).
-
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.
-
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.
-
(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 mithilfe der Konsole
Sie können die AWS Systems Manager Konsole verwenden, um die Installation oder Aktualisierung eines Pakets zu planen. Wenn Sie die Installation oder Aktualisierung eines Pakets planen, Distributor verwendet AWS Systems Manager State Manager zur Installation oder Aktualisierung.
So planen Sie eine Paketinstallation mithilfe der Konsole
Öffnen Sie die AWS Systems Manager Konsole unter https://console.aws.amazon.com/systems-manager/
. -
Wählen Sie im Navigationsbereich Distributor.
-
Auf dem Distributor Wählen Sie auf der Startseite das Paket aus, das Sie installieren oder aktualisieren möchten.
-
Wählen Sie unter Package (Paket) die Option Install on a schedule (Nach Plan installieren) aus.
Dieser Befehl wird geöffnet State Manager zu einer neuen Assoziation, die für Sie erstellt wurde.
-
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. -
In der Liste Document (Dokument) ist der Dokumentname
AWS-ConfigureAWSPackage
bereits ausgewählt. -
Überprüfen Sie unter Action (Aktion), ob Install (Installieren) ausgewählt ist.
-
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.
-
-
Überprüfen Sie unter Name, ob der Name Ihres Pakets angegeben ist.
-
Geben Sie unter Version die Versionskennung ein, wenn Sie eine andere Paketversion als die zuletzt veröffentlichte Version installieren möchten.
-
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.
-
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. -
Wählen Sie Zuordnung erstellen.
-
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 mit dem AWS CLI
Sie können das ausführen send-command AWS CLI , um ein zu installieren Distributor Paket einmal. Wenn das Paket bereits installiert ist, wird die Anwendung offline geschaltet, während das Paket deinstalliert und stattdessen die neue Version installiert wird.
Um ein Paket einmal zu installieren, verwenden Sie 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
istUninstall 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 mit dem AWS CLI
Sie können das ausführen send-command AWS CLI , um ein zu aktualisieren Distributor Paket, ohne die zugehörige Anwendung offline zu schalten. Nur neue oder aktualisierte Dateien im Paket werden ersetzt.
Um ein Paket einmal zu aktualisieren, verwenden Sie 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.
Planung einer Paketinstallation mit dem AWS CLI
Sie können das ausführen create-association AWS CLI , um ein zu installieren Distributor Paket nach einem Zeitplan. 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.
Planung einer Paket-Aktualisierung mit dem AWS CLI
Sie können das ausführen create-association AWS CLI , um ein zu aktualisieren Distributor Paket nach einem Zeitplan, ohne die zugehörige Anwendung offline zu schalten. 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.