• Das AWS Systems Manager CloudWatch Dashboard wird nach dem 30. April 2026 nicht mehr verfügbar sein. Kunden können weiterhin die CloudWatch Amazon-Konsole verwenden, um ihre CloudWatch Amazon-Dashboards anzusehen, zu erstellen und zu verwalten, so wie sie es heute tun. Weitere Informationen finden Sie in der [Amazon CloudWatch Dashboard-Dokumentation](https://docs.aws.amazon.com/AmazonCloudWatch/latest/monitoring/CloudWatch_Dashboards.html).
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.
# AWS Systems Manager Distributor
Distributor, ein Tool in AWS Systems Manager, hilft Ihnen dabei, Software zu verpacken und auf AWS Systems Manager verwalteten Knoten zu veröffentlichen. Sie können Ihre eigene Software verpacken und veröffentlichen oder Distributor zum Suchen und Veröffentlichen AWS bereitgestellter Agentensoftwarepakete (z. **AmazonCloudWatchAgent**B.) oder Pakete von Drittanbietern wie **Trend Micro** verwenden.Durch die Veröffentlichung eines Pakets werden bestimmte Versionen des Paketdokuments auf verwalteten Knoten angekündigt, die Sie anhand von Knoten IDs AWS-Konto IDs, Tags oder einem identifizieren. AWS-Region Um mit Distributor zu beginnen, öffnen Sie die [Systems-Manager-Konsole](https://console.aws.amazon.com//systems-manager/distributor). Wählen Sie im Navigationsbereich **Distributor** aus.
Nachdem Sie in Distributor ein Paket erstellt haben, können Sie das Paket auf eine der folgenden Weisen installieren:
+ Einmalig mithilfe von [AWS Systems Manager Run Command](run-command.md)
+ Anhand eines Zeitplans mithilfe von [AWS Systems Manager State Manager](systems-manager-state.md)
**Wichtig**
Pakete, die von Drittanbietern vertrieben werden, werden nicht vom Anbieter des Pakets verwaltet AWS und von diesem veröffentlicht. Wir empfehlen Ihnen, zusätzliche Sorgfaltsprüfungen durchzuführen, um die Einhaltung Ihrer internen Sicherheitskontrollen sicherzustellen. Sicherheit ist eine gemeinsame Verantwortung von Ihnen AWS und Ihnen. Dies wird als Modell der geteilten Verantwortung beschrieben. Weitere Informationen hierzu finden Sie in [Modell der geteilten Verantwortung](https://aws.amazon.com/compliance/shared-responsibility-model/).
## Welche Vorteile bietet Distributor meiner Organisation?
Distributor bietet die folgenden Vorteile:
+ **Ein Paket, viele Plattformen**
Wenn Sie ein Paket in Distributor erstellen, erstellt das System ein AWS Systems Manager -Dokument (SSM-Dokument). Sie können ZIP-Dateien an dieses Dokument anfügen. Wenn Sie Distributor ausführen, verarbeitet das System die Anweisungen im SSM-Dokument und installiert das Softwarepaket in der ZIP-Datei auf den angegebenen Zielen. Distributor unterstützt mehrere Betriebssysteme, darunter Windows, Ubuntu Server, Debian Server und Red Hat Enterprise Linux. Weitere Informationen zu unterstützten Plattformen finden Sie unter [Unterstützte Paketplattformen und -architekturen](#what-is-a-package-platforms).
+ **Kontrolle über den Paketzugriff über mehrere Gruppen verwalteter Instances hinweg**
Sie können Run Command oder State Manager verwenden, um zu steuern, welche Ihrer verwalteten Knoten ein Paket erhalten und welche Version dieses Paket haben soll. Run Command und State Manager sind Tools in AWS Systems Manager. Verwaltete Knoten können nach Instanz oder Gerät IDs, AWS-Konto Nummern, Tags oder gruppiert AWS-Regionen werden. Mithilfe von State Manager-Zuordnungen können Sie verschiedene Versionen eines Pakets für verschiedene Gruppen von Instances bereitstellen.
+ **Viele AWS Agentenpakete sind im Lieferumfang enthalten und sofort einsatzbereit**
Distributorenthält viele AWS Agentenpakete, die Sie sofort auf verwalteten Knoten bereitstellen können. Suchen Sie auf der Distributor `Packages`-Listenseite nach Paketen, die von `Amazon` veröffentlicht werden. Beispiele hierfür sind `AmazonCloudWatchAgent` und `AWSPVDriver`.
+ **Automatische Bereitstellung **
Um Ihre Umgebung auf dem aktuellen Stand zu halten, verwenden Sie State Manager, um Pakete für die automatische Bereitstellung auf ausgesuchten verwalteten Knoten zu planen, wenn diese Maschinen zum ersten Mal gestartet werden.
## An wen richtet sich Distributor?
+ Jeder AWS Kunde, der neue Softwarepakete erstellen oder bestehende Softwarepakete, einschließlich AWS veröffentlichter Pakete, auf mehreren von Systems Manager verwalteten Knoten gleichzeitig bereitstellen möchte.
+ Softwareentwickler, die Softwarepakete erstellen.
+ Administratoren, die dafür verantwortlich sind, die von Systems Manager verwalteten Knoten mit den meisten up-to-date Softwarepaketen auf dem neuesten Stand zu halten.
## Über welche Features verfügt Distributor?
+ **Bereitstellung von Paketen auf Windows- ebenso wie auf Linux-Instances**
Mit Distributor können Sie Softwarepakete auf Amazon Elastic Compute Cloud (Amazon EC2) -Instances und AWS IoT Greengrass Kerngeräten für Linux und Windows Server bereitstellen. Eine Liste der unter den jeweiligen Betriebssystemen unterstützten Instance-Typen finden Sie unter [Unterstützte Paketplattformen und -architekturen](#what-is-a-package-platforms).
**Anmerkung**
Distributor wird auf dem macOS-Betriebssystem unterstützt.
+ **Einmalige Bereitstellung von Paketen oder nach automatisiertem Zeitplan**
Sie können wählen, ob die Pakete einmalig, nach einem regelmäßigen Zeitplan oder immer dann, wenn die Standardpaketversion auf eine andere umgestellt wird, aktualisiert werden sollen.
+ **Vollständige Neuinstallation von Paketen oder Durchführen von direkten Aktualisierungen**
Um eine neue Paketversion zu installieren, können Sie die aktuelle Version vollständig deinstallieren und stattdessen eine neue Version installieren oder die aktuelle Version nur entsprechend einem von Ihnen bereitgestellten *Aktualisierungsskript* mit neuen und aktualisierten Komponenten aktualisieren. Ihre Paketanwendung ist während einer Neuinstallation nicht verfügbar, kann aber während einer direkten Aktualisierung weiterhin verfügbar bleiben. Direkte Aktualisierungen sind besonders nützlich für Anwendungen zur Sicherheitsüberwachung oder andere Szenarien, in denen Sie Anwendungsausfälle vermeiden müssen.
+ **Konsolen- PowerShell, CLI- und SDK-Zugriff auf Distributor Funktionen**
Sie können mit Distributor der Systems Manager Manager-Konsole AWS Command Line Interface (AWS CLI) oder dem AWS SDK Ihrer Wahl arbeiten. AWS -Tools für PowerShell
+ **IAM-Zugriffskontrolle**
Mithilfe von AWS Identity and Access Management (IAM-) Richtlinien können Sie steuern, welche Mitglieder Ihrer Organisation Pakete oder Paketversionen erstellen, aktualisieren, bereitstellen oder löschen können. Beispiel: Sie möchten einem Administrator Berechtigungen zum Bereitstellen von Paketen gewähren, nicht jedoch zum Ändern von Paketen oder zum Erstellen neuer Paketversionen.
+ **Support für Protokollierungs- und Prüfungsfunktionen**
AWS-Konto Durch die Integration mit anderen AWS-Services können Sie Distributor Benutzeraktionen in Ihrem System prüfen und protokollieren. Weitere Informationen finden Sie unter [Prüfen und Protokollieren von Distributor-Aktivitäten](distributor-logging-auditing.md).
## Was ist ein Paket in Distributor?
Ein *Paket* ist eine Sammlung installierbarer Software oder Komponenten. Beispiele hierfür sind:
+ Eine ZIP-Datei mit Software pro Ziel-Betriebssystemplattform. Jede ZIP-Datei muss Folgendes enthalten:
+ Ein **install** und ein **uninstall** Skript. Windows Serverbasierte verwaltete Knoten benötigen PowerShell Skripten (Skripten mit dem Namen `install.ps1` und`uninstall.ps1`). Linux-basierte verwaltete Knoten benötigen Shell-Skripten (Skripten mit dem Namen `install.sh` und`uninstall.sh`). AWS Systems Manager SSM Agentliest die Anweisungen in den **uninstall** UND-Skripten **install** und führt sie aus.
+ Eine ausführbare Datei. Diese muss SSM Agent finden, um das Paket auf den anvisierten verwalteten Knoten installieren zu können.
+ Eine Manifestdatei im JSON-Format, die den Paketinhalt beschreibt. Das Manifest ist nicht in der ZIP-Datei enthalten, aber im selben Amazon Simple Storage Service (Amazon S3)-Bucket gespeichert wie die ZIP-Dateien, aus denen das Paket besteht. Das Manifest identifiziert die Paketversion und ordnet die ZIP-Dateien im Paket den Attributen des anvisierten verwalteten Knotens zu (z. B. die Version oder Architektur des Betriebssystems). Informationen zum Erstellen des Manifests finden Sie unter [Schritt 2: Erstellen des JSON-Paketmanifests](distributor-working-with-packages-create.md#packages-manifest).
Wenn Sie **Einfache** Paketerstellung in der Distributor-Konsole wählen, generiert Distributor die Installations- und Deinstallationsskripts, sowie die Datei-Hashes und das Manifest des JSON-Pakets, basierend auf dem Dateinamen der ausführbaren Software sowie den Zielplattformen und -Architekturen.
### Unterstützte Paketplattformen und -architekturen
Sie können Distributor verwenden, um Pakete auf den folgenden Plattformen verwalteter Knoten von Systems Manager zu veröffentlichen. Ein Versionswert muss genau mit der Version des Betriebssystems-Amazon Machine Image (AMI) übereinstimmen. Weitere Informationen zum Ermitteln dieser Version finden Sie in Schritt 4 unter [Schritt 2: Erstellen des JSON-Paketmanifests](distributor-working-with-packages-create.md#packages-manifest).
**Anmerkung**
Systems Manager unterstützt nicht alle der folgenden Betriebssysteme für AWS IoT Greengrass Kerngeräte. Weitere Informationen finden Sie im *AWS IoT Greengrass Version 2 Entwicklerhandbuch* unter [Einrichten von AWS IoT Greengrass Kerngeräten](https://docs.aws.amazon.com/greengrass/v2/developerguide/setting-up.html).
| Plattform | Codewert in der Manifestdatei | Unterstützte Architekturen |
| --- | --- | --- |
| AlmaLinux | almalinux | x86\$164 ARM64 |
| Amazon Linux 2 und Amazon Linux 2023 | `amazon` | x86\$164 oder x86 ARM64(Amazon Linux 2- und AL2023 A1-Instance-Typen) |
| Debian Server | `debian` | x86\$164 oder x86 |
| openSUSE | `opensuse` | x86\$164 |
| openSUSE Leap | `opensuseleap` | x86\$164 |
| Oracle Linux | `oracle` | x86\$164 |
| Red Hat Enterprise Linux (RHEL) | `redhat` | x86\$164 ARM64 (RHEL 7.6 und neuer, A1-Instance-Typen) |
| Rocky Linux | rocky | x86\$164 ARM64 |
| SUSE Linux Enterprise Server (SLES) | `suse` | x86\$164 |
| Ubuntu Server | `ubuntu` | x86\$164 oder x86 ARM64 (Ubuntu Server 16 und neuer, A1-Instance-Typen) |
| Windows Server | `windows` | x86\$164 |
**Topics**
+ [Welche Vorteile bietet Distributor meiner Organisation?](#distributor-benefits)
+ [An wen richtet sich Distributor?](#distributor-who)
+ [Über welche Features verfügt Distributor?](#distributor-features)
+ [Was ist ein Paket in Distributor?](#what-is-a-package)
+ [Einrichten von Distributor](distributor-getting-started.md)
+ [Mit Distributor-Paketen arbeiten](distributor-working-with.md)
+ [Prüfen und Protokollieren von Distributor-Aktivitäten](distributor-logging-auditing.md)
+ [Problembehebung AWS Systems ManagerDistributor](distributor-troubleshooting.md)
# Einrichten von Distributor
Bevor Sie ein Tool zum Erstellen AWS Systems Manager, Verwalten und Bereitstellen von Softwarepaketen verwendenDistributor, gehen Sie wie folgt vor.
## Erfüllen von Distributor-Voraussetzungen
Stellen Sie vor der Verwendung Distributor eines Tools sicher AWS Systems Manager, dass Ihre Umgebung die folgenden Anforderungen erfüllt.
**Distributor-Voraussetzungen**
| Anforderung | Description |
| --- | --- |
| SSM Agent | AWS Systems Manager SSM AgentVersion 2.3.274.0 oder höher muss auf den verwalteten Knoten installiert sein, auf denen Sie Pakete bereitstellen oder von denen Sie Pakete entfernen möchten. Informationen zum Installieren oder Aktualisieren von SSM Agent finden Sie unter [Arbeiten mit SSM Agent](ssm-agent.md). |
| AWS CLI | (Optional) Um die AWS Command Line Interface (AWS CLI) anstelle der Systems Manager Manager-Konsole zum Erstellen und Verwalten von Paketen zu verwenden, installieren Sie die neueste Version von AWS CLI auf Ihrem lokalen Computer. Weitere Informationen zum Installieren oder Upgraden der CLI finden Sie unter [Installieren der AWS Command Line Interface](https://docs.aws.amazon.com/cli/latest/userguide/installing.html) um *AWS Command Line Interface -Benutzerhandbuch*. |
| AWS -Tools für PowerShell | (Optional) Um die Tools für PowerShell anstelle der Systems Manager Manager-Konsole zum Erstellen und Verwalten von Paketen zu verwenden, installieren Sie die neueste Version von Tools für PowerShell auf Ihrem lokalen Computer. Weitere Informationen zur Installation oder zum Upgrade der Tools für PowerShell finden Sie AWS Tools for PowerShell Core im *AWS -Tools für PowerShell Benutzerhandbuch* unter [Einrichten von AWS Tools for Windows PowerShell oder](https://docs.aws.amazon.com/powershell/latest/userguide/pstools-getting-set-up.html). |
**Anmerkung**
Systems Manager unterstützt nicht die Verteilung von Paketen an von Oracle Linux verwaltete Knoten mit Distributor.
## Überprüfen oder Erstellen eines IAM-Instance-Profils mit Distributor-Berechtigungen
Hat standardmäßig AWS Systems Manager keine Berechtigung, Aktionen auf Ihren Instances durchzuführen. Sie müssen den Zugriff mithilfe eines AWS Identity and Access Management (IAM-) Instanzprofils gewähren. Ein Instance-Profil ist ein Container, der Informationen zur IAM-Rolle beim Start an eine Amazon Elastic Compute Cloud (Amazon EC2)-Instance übergibt. Diese Anforderung gilt für Berechtigungen für alle Systems-Manager-Tools, nicht nur Distributor.
**Anmerkung**
Wenn Sie Ihre Edge-Geräte für die Ausführung der AWS IoT Greengrass Core-Software und konfigurierenSSM Agent, geben Sie eine IAM-Servicerolle an, die es Systems Manager ermöglicht, Aktionen darauf auszuführen. Sie müssen keine verwalteten Edge-Geräte mit einem Instance-Profil konfigurieren.
Wenn Sie bereits andere Systems-Manager-Tools verwenden, z. B. Run Command und State Manager, ist ein Instance-Profil mit den erforderlichen Berechtigungen für Distributor bereits Ihren Instances zugeordnet. Die einfachste Methode, um sicherzustellen, dass Sie über Berechtigungen zur Ausführung von Distributor Aufgaben verfügen, besteht darin, die **SSMManagedInstanceCoreAmazon-Richtlinie** an Ihr Instance-Profil anzuhängen. Weitere Informationen finden Sie unter [Erforderliche Instance-Berechtigungen für Systems Manager konfigurieren](setup-instance-permissions.md).
## Kontrolle des Benutzerzugriffs auf Pakete
Mithilfe von AWS Identity and Access Management (IAM-) Richtlinien können Sie steuern, wer Pakete erstellen, bereitstellen und verwalten darf. Sie können auch steuern, welche Run Command- und State Manager-API-Operationen auf verwalteten Knoten ausgeführt werden können. Zum Distributor Beispiel sind Run Command sowohl State Manager als auch Tools in AWS Systems Manager.
**ARN-Format**
Benutzerdefinierte Pakete sind dem Dokument Amazon Resource Names (ARNs) zugeordnet und haben das folgende Format.
```
arn:aws:ssm:region:account-id:document/document-name
```
Im Folgenden wird ein -Beispiel gezeigt.
```
arn:aws:ssm:us-west-1:123456789012:document/ExampleDocumentName
```
Sie können zwei AWS mitgelieferte Standard-IAM-Richtlinien verwenden, eine für Endbenutzer und eine für Administratoren, um Berechtigungen für Distributor Aktivitäten zu erteilen. Sie können auch benutzerdefinierte IAM-Richtlinien erstellen, die an Ihre Berechtigungsanforderungen angepasst sind.
Weitere Informationen zur Verwendung von Variablen in IAM-Richtlinien finden Sie unter [IAM-Richtlinienelemente: Variablen](https://docs.aws.amazon.com/IAM/latest/UserGuide/reference_policies_variables.html).
Informationen zum Erstellen von Richtlinien und zum Anfügen an Benutzer oder Gruppen finden Sie unter [Erstellen von IAM-Richtlinien](https://docs.aws.amazon.com/IAM/latest/UserGuide/access_policies_create.html) und [Hinzufügen und Entfernen von IAM-Richtlinien](https://docs.aws.amazon.com/IAM/latest/UserGuide/access_policies_manage-attach-detach.html) im *IAM-Benutzerhandbuch*.
## Erstellen oder Auswählen eines Amazon-S3-Buckets Distributor
Wenn Sie ein Paket erstellen, indem Sie die in der AWS Systems Manager -Konsole den Workflow **Einfach** auswählen, wählen Sie einen vorhandenen Amazon Simple Storage Service (Amazon S3)-Bucket aus, an den Distributor Ihre Software hochlädt. Distributor ist ein Tool in AWS Systems Manager Wenn Sie den Workflow **Advanced (Erweitert)** auswählen, müssen Sie Ihre Software oder Komponenten als ZIP-Dateien in einen Amazon-S3-Bucket hochladen, bevor Sie beginnen. Unabhängig davon, ob Sie ein Paket mit dem Workflow **Simple (Einfach)** oder **Advanced (Erweitert)** in der Konsole erstellen, oder aber ob Sie die API verwenden, Sie benötigen einen Amazon-S3-Bucket, bevor Sie mit der Erstellung Ihres Paket beginnen. Bei der Paketerstellung kopiert Distributor Ihre installierbare Software und die Komponenten aus diesem Bucket in einen internen Systems Manager-Speicher. Da die Komponenten in einen internen Speicher kopiert werden, können Sie Ihren Amazon-S3-Bucket löschen oder wiederverwenden, wenn die Paketerstellung abgeschlossen ist.
Weitere Informationen zur Erstellung eines Buckets finden Sie unter [Erstellen eines Buckets](https://docs.aws.amazon.com/AmazonS3/latest/userguide/CreatingABucket.html) im *Amazon Simple Storage Service Getting Started Guide*. Weitere Informationen zum Ausführen eines AWS CLI Befehls zum Erstellen eines Buckets finden Sie [https://docs.aws.amazon.com/cli/latest/reference/s3/mb.html](https://docs.aws.amazon.com/cli/latest/reference/s3/mb.html)in der *AWS CLI Befehlsreferenz.*
# Mit Distributor-Paketen arbeiten
Sie können die AWS Systems Manager-Konsole, die AWS-Befehlszeilen-Tools (AWS CLI und AWS -Tools für PowerShell) und die AWS-SDKs zum Hinzufügen, Verwalten oder Bereitstellen von Paketen in Distributor verwenden. Distributor ist ein Tool in AWS Systems Manager. Vor dem Hinzufügen eines Pakets zu Distributor:
+ Erstellen und zippen Sie die zu installierbaren Komponenten.
+ (Optional) Erstellen Sie eine JSON-Manifestdatei für das Paket. Dies ist nicht erforderlich, um den Prozess der **einfachen** Paketerstellung in der Distributor-Konsole zu nutzen. Bei der einfachen Paketerstellung wird die JSON-Manifestdatei automatisch generiert.
Sie können zum Erstellen der Manifestdatei die AWS Systems Manager-Konsole oder einen Text- oder JSON-Editor verwenden.
+ Halten Sie einen Amazon Simple Storage Service (Amazon S3)-Bucket bereit, um Ihre installierbaren Komponenten oder Software zu speichern. Wenn Sie die den **Advanced (Erweitert)**-Workflow zur Paketerstellung verwenden, laden Sie Ihre Komponenten an den Amazon-S3-Bucket herunter, bevor Sie beginnen.
**Anmerkung**
Sie können diesen Bucket nach Abschluss der Erstellung Ihres Pakets löschen oder anderweitig verwenden, weil Distributor im Rahmen des Paketerstellungsprozesses die Paketinhalte in einen internen Systems Manager-Bucket verschiebt.
Von AWS veröffentlichte Pakete sind bereits verpackt und können sofort bereitgestellt werden. Informationen zum Bereitstellen eines von AWS veröffentlichten Pakets an verwalteten Knoten finden Sie unter [Installieren oder Aktualisieren von Distributor-Paketen](distributor-working-with-packages-deploy.md).
Sie können Distributor-Pakete zwischen AWS-Konten tauschen. Wenn Sie ein Paket verwenden, das von einem anderen Konto in AWS CLI-Befehlen geteilt wird, verwenden Sie das Paket Amazon Resource Name (ARN) anstelle des Paketnamens.
**Topics**
+ [Pakete anzeigen in Distributor](distributor-view-packages.md)
+ [Erstellen eines Pakets in Distributor](distributor-working-with-packages-create.md)
+ [Bearbeiten von Distributor-Paketberechtigungen in der Konsole](distributor-working-with-packages-ep.md)
+ [Bearbeiten von Distributor-Paket-Tags in der Konsole](distributor-working-with-packages-tags.md)
+ [Hinzufügen einer Version zu einem Distributor-Paket](distributor-working-with-packages-version.md)
+ [Installieren oder Aktualisieren von Distributor-Paketen](distributor-working-with-packages-deploy.md)
+ [Deinstallieren eines Distributor-Pakets](distributor-working-with-packages-uninstall.md)
+ [Löschen eines Distributor-Pakets](distributor-working-with-packages-dpkg.md)
# Pakete anzeigen in Distributor
Um Pakete anzuzeigen, die zur Installation verfügbar sind, können Sie die AWS Systems Manager Konsole oder Ihr bevorzugtes AWS Befehlszeilentool verwenden. Distributorist ein Tool in AWS Systems Manager. Um darauf zuzugreifenDistributor, öffnen Sie die AWS Systems Manager Konsole und wählen Sie **Distributor**im linken Navigationsbereich. Sie werden alle Pakete sehen, die Ihnen zur Verfügung stehen.
Im folgenden Abschnitt wird beschrieben, wie Sie Ihre Distributor-Pakete mithilfe Ihrer bevorzugten Befehlszeilen-Tools anzeigen.
## Anzeigen des Pakets per Befehlszeile
Dieser Abschnitt enthält Informationen dazu, wie Sie Ihr bevorzugtes Befehlszeilen-Tool verwenden können, um Distributor-Pakete mit den bereitgestellten Befehlen anzuzeigen.
------
#### [ Linux & macOS ]
**Um Pakete mit dem unter AWS CLI Linux anzuzeigen**
+ Führen Sie den folgenden Befehl aus, um alle Pakete anzuzeigen, mit der Ausnahme freigegebener Pakete.
```
aws ssm list-documents \
--filters Key=DocumentType,Values=Package
```
+ Führen Sie den folgenden Befehl aus, um alle Pakete anzuzeigen, die Amazon gehören.
```
aws ssm list-documents \
--filters Key=DocumentType,Values=Package Key=Owner,Values=Amazon
```
+ Führen Sie den folgenden Befehl aus, um alle Pakete anzuzeigen, die Drittanbietern gehören.
```
aws ssm list-documents \
--filters Key=DocumentType,Values=Package Key=Owner,Values=ThirdParty
```
------
#### [ Windows ]
**Um Pakete mit dem AWS CLI unter Windows anzuzeigen**
+ Führen Sie den folgenden Befehl aus, um alle Pakete anzuzeigen, mit der Ausnahme freigegebener Pakete.
```
aws ssm list-documents ^
--filters Key=DocumentType,Values=Package
```
+ Führen Sie den folgenden Befehl aus, um alle Pakete anzuzeigen, die Amazon gehören.
```
aws ssm list-documents ^
--filters Key=DocumentType,Values=Package Key=Owner,Values=Amazon
```
+ Führen Sie den folgenden Befehl aus, um alle Pakete anzuzeigen, die Drittanbietern gehören.
```
aws ssm list-documents ^
--filters Key=DocumentType,Values=Package Key=Owner,Values=ThirdParty
```
------
#### [ PowerShell ]
**Um Pakete mit den Tools für anzuzeigen PowerShell**
+ Führen Sie den folgenden Befehl aus, um alle Pakete anzuzeigen, mit der Ausnahme freigegebener Pakete.
```
$filter = New-Object Amazon.SimpleSystemsManagement.Model.DocumentKeyValuesFilter
$filter.Key = "DocumentType"
$filter.Values = "Package"
Get-SSMDocumentList `
-Filters @($filter)
```
+ Führen Sie den folgenden Befehl aus, um alle Pakete anzuzeigen, die Amazon gehören.
```
$typeFilter = New-Object Amazon.SimpleSystemsManagement.Model.DocumentKeyValuesFilter
$typeFilter.Key = "DocumentType"
$typeFilter.Values = "Package"
$ownerFilter = New-Object Amazon.SimpleSystemsManagement.Model.DocumentKeyValuesFilter
$ownerFilter.Key = "Owner"
$ownerFilter.Values = "Amazon"
Get-SSMDocumentList `
-Filters @($typeFilter,$ownerFilter)
```
+ Führen Sie den folgenden Befehl aus, um alle Pakete anzuzeigen, die Drittanbietern gehören.
```
$typeFilter = New-Object Amazon.SimpleSystemsManagement.Model.DocumentKeyValuesFilter
$typeFilter.Key = "DocumentType"
$typeFilter.Values = "Package"
$ownerFilter = New-Object Amazon.SimpleSystemsManagement.Model.DocumentKeyValuesFilter
$ownerFilter.Key = "Owner"
$ownerFilter.Values = "ThirdParty"
Get-SSMDocumentList `
-Filters @($typeFilter,$ownerFilter)
```
------
# Erstellen eines Pakets in Distributor
Um ein Paket zu erstellen, bereiten Sie Ihre installierbare Software oder Komponenten vor, immer eine Datei pro Betriebssystem-Plattform. Zur Erstellung eines Pakets ist mindestens eine Datei erforderlich.
Manchmal verwenden unterschiedliche Plattformen dieselbe Datei. Alle Ihrem Paket hinzugefügten Dateien müssen jedoch im Abschnitt `Files` des Manifests aufgelistet sein. Wenn Sie ein Paket in der Konsole über den einfachen Workflow erstellen, wird das Manifest automatisch generiert. Die maximale Anzahl von Dateien, die Sie einem einzelnen Dokument anfügen können, beträgt 20. Die maximale Größe der einzelnen Dateien beträgt 1 GB. Weitere Informationen zu unterstützten Plattformen finden Sie unter [Unterstützte Paketplattformen und -architekturen](distributor.md#what-is-a-package-platforms).
Wenn Sie ein neues Paket erstellen, erstellt das System ein neues [SSM-Dokument](documents.md). Mit diesem Dokument können Sie das Paket an verwaltete Knoten bereitstellen.
Nur zu Demonstrationszwecken steht Ihnen ein Beispielpaket, [ExamplePackage.zip](https://docs.aws.amazon.com/systems-manager/latest/userguide/samples/ExamplePackage.zip), zum Herunterladen von unserer Website zur Verfügung. Das Beispielpaket enthält ein vollständiges JSON-Manifest und drei .zip-Dateien mit Installationsprogrammen für Version 7.0.0. PowerShell Die Installations- und Deinstallationsskripts enthalten keine gültigen Befehle. Wenn Sie ein Paket im Workflow **Advanced (Erweitert)** erstellen, müssen Sie alle installierbaren Softwaredateien und Skripts in einer ZIP-Datei komprimieren, beim Workflow **Simple (Einfach)** ist es jedoch nicht notwendig, installierbare Komponenten zu zippen.
**Topics**
+ [Erstellen Sie ein Paket mithilfe des einfachen Workflows](#distributor-working-with-packages-create-simple)
+ [Erstellen Sie ein Paket mithilfe des erweiterten Workflows](#distributor-working-with-packages-create-adv)
## Erstellen Sie ein Paket mithilfe des einfachen Workflows
In diesem Abschnitt wird beschrieben, wie Sie ein Paket in Distributor erstellen, wenn Sie das Paket über den **Einfach**-Workflow in der Distributor-Konsole erstellen. Distributor ist ein Tool in AWS Systems Manager. Um ein Paket zu erstellen, bereiten Sie Ihre zu installierenden Komponenten vor, eine Datei pro Betriebssystemplattform. Zur Erstellung eines Pakets ist mindestens eine Datei erforderlich. Bei der **einfachen** Paketerstellung werden die Installations- und Deinstallationsskripts generiert, sowie die Datei-Hashes und eine Manifest-Datei im JSON-Format. Der **Simple (Einfach)**-Workflow übernimmt das Hochladen und Komprimieren Ihrer installierbaren Dateien sowie das Erstellen eines neuen Pakets und des zugehörigen [SSM-Dokuments](documents.md). Weitere Informationen zu unterstützten Plattformen finden Sie unter [Unterstützte Paketplattformen und -architekturen](distributor.md#what-is-a-package-platforms).
Wenn Sie die Methode „Simple (Einfach)“ verwenden, um ein Paket zu erstellen, erstellt Distributor die `install`- und `uninstall`-Skripts für Sie. Wenn Sie jedoch ein Paket für ein direktes Update erstellen, müssen Sie Ihren eigenen `update`-Skript-Inhalt in der Registerkarte **Update script ** bereitstellen.. Wenn Sie Eingabebefehle für ein `update`-Skript hinzufügen, schließt Distributor dieses Skript zusammen mit den `install`- und `uninstall`-Skripts in das für Sie erstellte ZIP-Paket ein.
**Anmerkung**
Verwenden Sie die Aktualisierungsoption `In-place` zum Hinzufügen neuer oder aktualisierter Dateien einer vorhandenen Paketinstallation, ohne die zugehörige Anwendung offline zu schalten.
**Erstellen Sie ein Paket mithilfe des einfachen Workflows**
1. Öffnen Sie die Konsole unter. AWS Systems Manager [https://console.aws.amazon.com/systems-manager/](https://console.aws.amazon.com/systems-manager/)
1. Wählen Sie im Navigationsbereich **Distributor** aus.
1. Wählen Sie auf der Distributor-Startseite die Option **Create package (Paket erstellen)** aus und wählen Sie dann die Option **Simple (Einfach)**.
1. Geben Sie auf der Seite **Create package (Paket erstellen)** einen Namen für Ihr Paket ein. Paketnamen können Buchstaben, Zahlen, Punkte, Bindestriche und Unterstriche enthalten. Der Name sollte allgemein genug sein, um auf alle Versionen der Paketanhänge angewendet werden zu können, jedoch spezifisch genug, um den Zweck des Pakets zu identifizieren.
1. (Optional) Geben Sie unter **Version name (Versionsname)** einen Versionsnamen ein. Versionsnamen dürfen maximal 512 Zeichen lang sein und dürfen keine Sonderzeichen enthalten.
1. Wählen Sie unter **Location (Speicherort)** einen Bucket aus. Verwenden Sie dazu den Namen und das Präfix des Buckets oder die Bucket-URL.
1. Wählen Sie unter **Upload software** (Software hochladen) die Option **Add software** (Software hinzufügen) aus und navigieren Sie dann zu installierbaren Softwaredateien mit den Erweiterungen `.rpm`, `.msi`, oder `.deb`. Wenn der Dateiname Leerzeichen enthält, schlägt der Upload fehl. Sie können mehrere Softwaredateien in einer einzigen Aktion hochladen.
1. Überprüfen Sie unter Für **Target platform (Ziel-Plattform** für jede Plattform, ob das Ziel-Betriebssystem für die installierbare Datei korrekt ist. Wenn das angezeigte Betriebssystem nicht korrekt ist, wählen Sie das richtige Betriebssystem aus der Dropdown-Liste aus.
Beim Workflow **Simple (Einfach)** zur Paketerstellung sind zusätzliche Schritte erforderlich, wenn Distributor nur eine Datei für mehrere Betriebssysteme verwenden soll, da installierbare Dateien nur einmal hochgeladen werden. Wenn Sie zum Beispiel eine installierbare Softwaredatei mit dem Namen `Logtool_v1.1.1.rpm` hochladen, müssen Sie einige Standardeinstellungen für den **Einfach**-Workflow ändern, um unter Amazon-Linux- und Ubuntu Server-Betriebssystemen dieselbe Software als Ziel festzulegen. Führen Sie bei Verwendung mehrerer Zielplattformen einen der folgenden Schritte aus.
+ Verwenden Sie stattdessen den Workflow **Advanced** (Erweitert), zippen Sie jede installierbare Datei, bevor Sie beginnen, und richten Sie das Manifest manuell so ein, dass eine installierbare Datei für mehrere Betriebssystemplattformen oder -versionen verwendet werden kann. Weitere Informationen finden Sie unter [Erstellen Sie ein Paket mithilfe des erweiterten Workflows](#distributor-working-with-packages-create-adv).
+ Bearbeiten Sie die Manifestdatei im Workflow **Simple (Einfach)** so, dass Ihre ZIP-Datei für mehrere Betriebssystemplattformen oder -versionen verwendet wird. Weitere Informationen zu diesem Verfahren finden Sie am Ende von Schritt 4 in [Schritt 2: Erstellen des JSON-Paketmanifests](#packages-manifest).
1. Stellen Sie unter **Platform version (Plattformversion)**sicher, dass als Betriebssystem-Plattformversion **\$1any**, eine Hauptversionsnummer, gefolgt von einem Platzhalter (7.\$1), angezeigt wird, oder genau die spezifische Betriebssystemversion, die Sie als Plattformversion für Ihre Softwareinstallation verwenden möchten. Weitere Informationen zur Angabe der Betriebssystem-Plattformversion finden Sie unter Schritt 4 in [Schritt 2: Erstellen des JSON-Paketmanifests](#packages-manifest).
1. Wählen Sie unter **Architecture (Architektur)** für jeden installierbare Datei die richtige Prozessorarchitektur aus der Dropdown-Liste aus. Weitere Informationen zu unterstützten Prozessorarchitekturen finden Sie unter [Unterstützte Paketplattformen und -architekturen](distributor.md#what-is-a-package-platforms).
1. (Optional) Erweitern Sie **Scripts (Skripts)** und überprüfen Sie die Skripts, die Distributor für Ihre installierbare Software generiert hat.
1. (Optional) Um ein Aktualisierungsskript für direkte Aktualisierungen bereitzustellen, erweitern Sie **Scripts (Skripts)**, wählen Sie die Registerkarte **Update script (Aktualisierungsskript)** aus und geben Sie die Befehle für das Aktualisierungsskript ein.
Systems Manager generiert keine Aktualisierungsskripts für Sie.
1. Zum Hinzufügen weiterer installierbaren Softwaredateien wählen Sie **Add Software (Software hinzufügen)**. Andernfalls fahren Sie mit dem nächsten Schritt fort.
1. (Optional) Erweitern Sie **Manifest** und überprüfen Sie das JSON-Manifest des Pakets, das Distributor für Ihre installierbare Software generiert hat. Wenn Sie Informationen über Ihre Software geändert haben, nachdem Sie mit dieser Prozedur begonnen haben, beispielsweise die Plattformversion oder die Zielplattform, wählen Sie **Generate Manifest (Manifest erzeugen)**, um das Paketmanifest zu aktualisieren.
Sie können das Manifest manuell bearbeiten, wenn Sie möchten, dass für eine installierbare Software mehr als ein Betriebssystem als Ziel festgelegt wird, wie in Schritt 8 beschrieben. Weitere Informationen zum Bearbeiten des Manifests finden Sie unter [Schritt 2: Erstellen des JSON-Paketmanifests](#packages-manifest).
1. Wählen Sie **Create package (Paket erstellen)** aus.
Warten Sie, bis Distributor das Hochladen Ihrer Software und das Erstellen Ihres Pakets abgeschlossen hat. Distributor zeigt den Uploadstatus für jede installierbare Datei einzeln an. Abhängig von der Anzahl und Größe der Pakete, die Sie hinzufügen, kann dies einige Minuten dauern. Distributor leitet Sie automatisch auf die Seite **Package details (Paketdetails)** für das neue Paket weiter, Sie können diese Seite aber jederzeit selbst öffnen, nachdem die Software hochgeladen ist. Auf der Seite **Package details (Paketdetails)** werden erst dann alle Informationen zu Ihrem Paket angezeigt, wenn Distributor den Paketerstellungsprozess abgeschlossen hat. Um den Upload- und Paketerstellungsprozess abzubrechen, wählen Sie **Cancel (Abbrechen)**.
Wenn Distributor keine installierbaren Softwaredateien hochladen kann, wird eine Fehlermeldung **Upload failed (Upload fehlgeschlagen)** angezeigt. Um den Uploadversuch zu wiederholen, wählen Sie **Retry Upload (Uploadversuch wiederholen)**. Weitere Informationen zur Fehlerbehebung bei der Paketerstellung finden Sie unter [Problembehebung AWS Systems ManagerDistributor](distributor-troubleshooting.md).
## Erstellen Sie ein Paket mithilfe des erweiterten Workflows
In diesem Abschnitt erfahren Sie, wie fortgeschrittene Benutzer ein Paket in Distributor erstellen können, nachdem sie die installierbaren Komponenten mit den Skripts zur Installation und Deinstallation, sowie eine JSON-Manifestdatei als ZIP-Archiv an einen Amazon S3-Bucket hochgeladen haben.
Um ein Paket zu erstellen, bereiten Sie Ihre ZIP-Dateien mit den zu installierenden Komponenten vor (eine ZIP-Datei pro Betriebssystemplattform). Zur Erstellung eines Pakets ist mindestens eine ZIP-Datei erforderlich. Erstellen Sie als Nächstes ein JSON-Manifest. Das Manifest enthält Verweise auf Ihre Paketcodedateien. Wenn Sie die erforderlichen Codedateien zu einem Ordner oder Verzeichnis hinzugefügt haben und das Manifest mit den korrekten Werten ausgefüllt ist, laden Sie Ihr Paket an einen S3-Bucket hoch.
Ein Beispielpaket, [ExamplePackage.zip](https://docs.aws.amazon.com/systems-manager/latest/userguide/samples/ExamplePackage.zip), steht für Sie zum Herunterladen von unserer Website zur Verfügung. Das Beispielpaket enthält ein fertiges JSON-Manifest und drei ZIP-Dateien.
**Topics**
+ [Schritt 1: Erstellen der ZIP-Dateien](#packages-zip)
+ [Schritt 2: Erstellen des JSON-Paketmanifests](#packages-manifest)
+ [Schritt 3: Hochladen von Paket und Manifest zu einem Amazon S3-Bucket](#packages-upload-s3)
+ [Schritt 4: Hinzufügen eines Pakets zu Distributor](#distributor-working-with-packages-add)
### Schritt 1: Erstellen der ZIP-Dateien
Die Grundlage Ihres Pakets ist mindestens eine ZIP-Datei mit Softwaredateien oder zu installierenden Komponenten. Ein Paket enthält eine ZIP-Datei pro Betriebssystem, das Sie unterstützen möchten, es sei denn, eine ZIP-Datei kann auf mehreren Betriebssystemen installiert werden. Beispielsweise können unterstützte Versionen von Red Hat Enterprise Linux- und Amazon-Linux-Instances in der Regel dieselben ausführbaren RPM-Dateien ausführen. Daher müssen Sie Ihrem Paket nur eine ZIP-Datei anfügen, um beide Betriebssysteme zu unterstützen.
**Erforderliche Dateien**
Die folgenden Elemente müssen in jeder ZIP-Datei enthalten sein:
+ Ein **install** und ein **uninstall** Skript. Windows Serverbasierte verwaltete Knoten benötigen PowerShell Skripten (Skripten mit dem Namen `install.ps1` und`uninstall.ps1`). Linux-basierte verwaltete Knoten benötigen Shell-Skripts (Skripts mit dem Namen `install.sh` und `uninstall.sh`). SSM Agent führt die Anweisungen in den **install**- und **uninstall**-Skripts aus.
Ihre Installationsskripts können beispielsweise ein Installationsprogramm ausführen (z. B. eine RPM- oder MSI-Datei), Dateien kopieren oder Konfigurationseinstellungen festlegen.
+ Eine ausführbare Datei, Installationsprogrammpakete (.rpm, .deb, .msi usw.), weitere Skripts oder Konfigurationsdateien.
**Optionale Dateien**
Die folgenden Elemente können optional in jeder ZIP-Datei enthalten sein:
+ Ein **update**-Skript. Die Angabe eines Aktualisierungsskripts ermöglicht es Ihnen, die Option `In-place update` zum Installieren eines Pakets zu verwenden. Wenn Sie einer vorhandenen Paketinstallation neue oder aktualisierte Dateien hinzufügen möchten, wird die Paketanwendung bei dieser `In-place update` Option nicht offline geschaltet, während das Update ausgeführt wird. Windows Serverbasierte verwaltete Knoten benötigen ein PowerShell Skript (mit dem Namen`update.ps1`). Linux-basierte verwaltete Knoten benötigen ein Shell-Skript (Skript mit dem Namen `update.sh`). SSM Agent führt die Anweisungen im **update**-Skript aus.
Weitere Informationen zum Installieren oder Aktualisieren von Paketen finden Sie unter [Installieren oder Aktualisieren von Distributor-Paketen](distributor-working-with-packages-deploy.md).
Für Beispiele für ZIP-Dateien, einschließlich Beispiel **install** - und **uninstall** Skripten, laden Sie das Beispielpaket ([ExamplePackage.zip](https://docs.aws.amazon.com/systems-manager/latest/userguide/samples/ExamplePackage.zip)) herunter.
### Schritt 2: Erstellen des JSON-Paketmanifests
Nachdem Sie die zu installierenden Dateien vorbereitet und gezippt haben, erstellen Sie ein JSON-Manifest. Im Folgenden finden Sie eine Vorlage. Die einzelnen Teile der Manifestvorlage werden im Verfahren in diesem Abschnitt beschrieben. Sie können einen JSON-Editor verwenden, um dieses Manifest in einer eigenen Datei zu erstellen. Alternativ können Sie das Manifest in der AWS Systems Manager Konsole erstellen, wenn Sie ein Paket erstellen.
```
{
"schemaVersion": "2.0",
"version": "your-version",
"publisher": "optional-publisher-name",
"packages": {
"platform": {
"platform-version": {
"architecture": {
"file": ".zip-file-name-1.zip"
}
}
},
"another-platform": {
"platform-version": {
"architecture": {
"file": ".zip-file-name-2.zip"
}
}
},
"another-platform": {
"platform-version": {
"architecture": {
"file": ".zip-file-name-3.zip"
}
}
}
},
"files": {
".zip-file-name-1.zip": {
"checksums": {
"sha256": "checksum"
}
},
".zip-file-name-2.zip": {
"checksums": {
"sha256": "checksum"
}
}
}
}
```
**So erstellen Sie ein JSON-Paket-Manifest**
1. Fügen Sie Ihrem Manifest die Schemaversion hinzu. In dieser Version ist die Schemaversion stets `2.0`.
```
{ "schemaVersion": "2.0",
```
1. Fügen Sie Ihrem Manifest eine benutzerdefinierte Paketversion hinzu. Dies ist auch der Wert in **Version name (Versionsname)**, den Sie angeben, wenn Sie Ihr Paket zu Distributor hinzufügen. Er wird Teil des AWS Systems Manager -Dokuments, das Distributor erstellt, wenn Sie Ihr Paket hinzufügen. Sie stellen diesen Wert auch als Eingabewert im Dokument `AWS-ConfigureAWSPackage` bereit, um eine andere als die aktuelle Version des Pakets zu installieren. Ein `version`-Wert kann Buchstaben, Zahlen, Unterstriche, Bindestriche und Punkte enthalten. Er darf jedoch höchstens 128 Zeichen enthalten. Sie sollten eine von Menschen lesbare Paketversion verwenden, um bei Bereitstellungen die Angabe der genauen Paketversionen für Sie und andere Administratoren einfacher zu machen. Im Folgenden wird ein -Beispiel gezeigt.
```
"version": "1.0.1",
```
1. (Optional) Fügen Sie den Namen des Publishers hinzu. Im Folgenden wird ein -Beispiel gezeigt.
```
"publisher": "MyOrganization",
```
1. Fügen Sie Pakete hinzu. Der Abschnitt `"packages"` beschreibt die von den ZIP-Dateien in Ihrem Paket unterstützten Plattformen, Versionen und Architekturen. Weitere Informationen finden Sie unter [Unterstützte Paketplattformen und -architekturen](distributor.md#what-is-a-package-platforms).
Das *platform-version* kann der Platzhalterwert sein,`_any`. Sie verwenden den Platzhalterwert, um anzugeben, dass eine ZIP-Datei eine beliebige Version der Plattform unterstützt. Sie können auch eine Hauptversion und gefolgt von einem Platzhalter angeben, sodass alle Nebenversionen unterstützt werden, z. B. 7.\$1. Wenn Sie einen *platform-version* Wert für eine bestimmte Betriebssystemversion angeben möchten, stellen Sie sicher, dass er genau der Release-Version des Betriebssystems entspricht, auf AMI das Sie abzielen. Im Folgenden werden Ressourcen empfohlen, mit denen Sie den richtigen Wert für das Betriebssystem ermitteln können.
+ Auf einem Windows Server-basierten verwalteten Knoten ist die Version in Form von Windows Management Instrumentation (WMI)-Daten verfügbar. Sie können den folgenden Befehl im Prompt ausführen, um Versionsinformationen zu erhalten. Anschließend müssen Sie die Ergebnisse nach `version` durchsuchen.
```
wmic OS get /format:list
```
+ Auf einem Linux-basierten verwalteten Knoten erhalten Sie die Version, indem Sie zunächst nach der Betriebssystemversion scannen (der folgende Befehl). Suchen Sie den Wert von `VERSION_ID`.
```
cat /etc/os-release
```
Wenn die ausgegebene Zeichenfolge nicht die benötigten Informationen enthält, führen Sie den folgenden Befehl aus, um die LSB-Versionsinformationen aus der Datei `/etc/lsb-release` abzurufen, und suchen den Wert von `DISTRIB_RELEASE`.
```
lsb_release -a
```
Wenn diese Methoden nicht zum Erfolg führen, finden Sie die Version in der Regel anhand der verwendeten Distribution. In Debian Server können Sie beispielsweise die Datei `/etc/debian_version` und in Red Hat Enterprise Linux die Datei `/etc/redhat-release` scannen.
```
hostnamectl
```
```
"packages": {
"platform": {
"platform-version": {
"architecture": {
"file": ".zip-file-name-1.zip"
}
}
},
"another-platform": {
"platform-version": {
"architecture": {
"file": ".zip-file-name-2.zip"
}
}
},
"another-platform": {
"platform-version": {
"architecture": {
"file": ".zip-file-name-3.zip"
}
}
}
}
```
Im Folgenden wird ein -Beispiel gezeigt. In diesem Beispiel ist die Betriebssystemplattform `amazon`, die unterstützte Version `2016.09`, die Architektur `x86_64` und die ZIP-Datei, die diese Plattform unterstützt, `test.zip`.
```
{
"amazon": {
"2016.09": {
"x86_64": {
"file": "test.zip"
}
}
}
},
```
Sie können mit dem Platzhalterwert (`_any`) angeben, dass das Paket alle Versionen des übergeordneten Elements unterstützt. Um beispielsweise anzugeben, dass das Paket in jeder Version von Amazon Linuxs unterstützt wird, sollte Ihre Paketanweisung ähnlich wie folgt aussehen. Sie können den Platzhalter `_any` auf Versions- oder Architekturebene verwenden, um alle Versionen einer Plattform, alle Architekturen in einer Version oder alle Versionen und alle Architekturen einer Plattform zu unterstützen.
```
{
"amazon": {
"_any": {
"x86_64": {
"file": "test.zip"
}
}
}
},
```
Das folgende Beispiel fügt `_any` hinzu, um zu zeigen, dass das erste Paket `data1.zip` für alle Architekturen von Amazon Linux 2016.09 unterstützt wird. Das zweite Paket (`data2.zip`) wird für alle Versionen von Amazon Linux unterstützt, jedoch nur für verwaltete Knoten mit `x86_64`-Architektur. Sowohl die Version mit `2023.8` als auch die Version mit `_any` sind Einträge unter `amazon`. Es handelt sich um eine einzige Plattform (Amazon Linux), aber verschiedene unterstützte Versionen und Architekturen sowie zugehörige ZIP-Dateien.
```
{
"amazon": {
"2023.8": {
"_any": {
"file": "data1.zip"
}
},
"_any": {
"x86_64": {
"file": "data2.zip"
}
}
}
}
```
Sie können im Abschnitt `"packages"` des Manifests mehrmals auf eine ZIP-Datei verweisen, wenn diese mehrere Plattformen unterstützt. Wenn Sie beispielsweise eine ZIP-Datei haben, die sowohl Red Hat Enterprise Linux 8.x-Versionen als auch Amazon Linux unterstützt, haben Sie zwei Einträge in dem `"packages"` Abschnitt, die auf dieselbe .zip-Datei verweisen, wie im folgenden Beispiel gezeigt.
```
{
"amazon": {
"2023.8.20250715 ": {
"x86_64": {
"file": "test.zip"
}
}
},
"redhat": {
"8.*": {
"x86_64": {
"file": "test.zip"
}
}
}
},
```
1. Fügen Sie die Liste mit den zu diesem Paket gehörenden ZIP-Dateien aus Schritt 4 hinzu. Für jeden Dateieintrag sind der Dateiname und die Prüfsumme des `sha256`-Hash-Werts erforderlich. Die Prüfsummenwerte im Manifest müssen mit dem `sha256`-Hash-Wert in den gezippten Ressourcen übereinstimmen, um zu verhindern, dass die Paketinstallation fehlschlägt.
Um die korrekte Prüfsumme aus den zu installierenden Dateien zu erhalten, können Sie die folgenden Befehle ausführen. In Linux führen Sie `shasum -a 256 file-name.zip` oder `openssl dgst -sha256 file-name.zip` aus. Führen Sie unter Windows das Cmdlet in aus. `Get-FileHash -Path path-to-.zip-file` [PowerShell](https://docs.microsoft.com/en-us/powershell/module/microsoft.powershell.utility/get-filehash?view=powershell-6)
Der Abschnitt `"files"` des Manifests enthält einen Verweis auf jede ZIP-Datei in Ihrem Paket.
```
"files": {
"test-agent-x86.deb.zip": {
"checksums": {
"sha256": "EXAMPLE2706223c7616ca9fb28863a233b38e5a23a8c326bb4ae241dcEXAMPLE"
}
},
"test-agent-x86_64.deb.zip": {
"checksums": {
"sha256": "EXAMPLE572a745844618c491045f25ee6aae8a66307ea9bff0e9d1052EXAMPLE"
}
},
"test-agent-x86_64.nano.zip": {
"checksums": {
"sha256": "EXAMPLE63ccb86e830b63dfef46995af6b32b3c52ce72241b5e80c995EXAMPLE"
}
},
"test-agent-rhel8-x86.nano.zip": {
"checksums": {
"sha256": "EXAMPLE13df60aa3219bf117638167e5bae0a55467e947a363fff0a51EXAMPLE"
}
},
"test-agent-x86.msi.zip": {
"checksums": {
"sha256": "EXAMPLE12a4abb10315aa6b8a7384cc9b5ca8ad8e9ced8ef1bf0e5478EXAMPLE"
}
},
"test-agent-x86_64.msi.zip": {
"checksums": {
"sha256": "EXAMPLE63ccb86e830b63dfef46995af6b32b3c52ce72241b5e80c995EXAMPLE"
}
},
"test-agent-rhel8-x86.rpm.zip": {
"checksums": {
"sha256": "EXAMPLE13df60aa3219bf117638167e5bae0a55467e947a363fff0a51EXAMPLE"
}
}
}
```
1. Nachdem Sie die Paketinformationen hinzugefügt haben, speichern und schließen Sie die Manifestdatei.
Im Folgenden finden Sie ein Beispiel für ein fertiges Manifest. In diesem Beispiel haben Sie eine ZIP-Datei `NewPackage_LINUX.zip`, die mehrere Plattformen unterstützt, jedoch nur einmal im Abschnitt `"files"` referenziert wird.
```
{
"schemaVersion": "2.0",
"version": "1.7.1",
"publisher": "Amazon Web Services",
"packages": {
"windows": {
"_any": {
"x86_64": {
"file": "NewPackage_WINDOWS.zip"
}
}
},
"amazon": {
"_any": {
"x86_64": {
"file": "NewPackage_LINUX.zip"
}
}
},
"ubuntu": {
"_any": {
"x86_64": {
"file": "NewPackage_LINUX.zip"
}
}
}
},
"files": {
"NewPackage_WINDOWS.zip": {
"checksums": {
"sha256": "EXAMPLEc2c706013cf8c68163459678f7f6daa9489cd3f91d52799331EXAMPLE"
}
},
"NewPackage_LINUX.zip": {
"checksums": {
"sha256": "EXAMPLE2b8b9ed71e86f39f5946e837df0d38aacdd38955b4b18ffa6fEXAMPLE"
}
}
}
}
```
#### Beispiel für ein Paket
Ein Beispielpaket, [ExamplePackage.zip](https://docs.aws.amazon.com/systems-manager/latest/userguide/samples/ExamplePackage.zip), steht Ihnen auf unserer Website zum Herunterladen zur Verfügung. Das Beispielpaket enthält ein fertiges JSON-Manifest und drei ZIP-Dateien.
### Schritt 3: Hochladen von Paket und Manifest zu einem Amazon S3-Bucket
Bereiten Sie Ihr Paket vor, indem Sie alle ZIP-Dateien in einen Ordner oder ein Verzeichnis kopieren oder verschieben. Ein Paket ist nur gültig, wenn es das von Ihnen in [Schritt 2: Erstellen des JSON-Paketmanifests](#packages-manifest) erstellte Manifest und alle ZIP-Dateien enthält, die in der Dateiliste des Manifests angegeben sind.
**So laden Sie das Paket und das Manifest in Amazon S3 hoch**
1. Kopieren oder verschieben Sie alle von Ihnen im Manifest angegebenen ZIP-Archivdateien in einen Ordner oder ein Verzeichnis. Komprimieren Sie nicht den Ordner oder das Verzeichnis, in das/den Sie die ZIP-Archivdateien und die Manifestdatei verschieben.
1. Erstellen Sie einen Bucket, oder wählen Sie einen vorhandenen Bucket aus. Weitere Informationen finden Sie unter [Create a Bucket (Bucket erstellen)](https://docs.aws.amazon.com/AmazonS3/latest/userguide/CreatingABucket.html) im *Amazon Simple Storage Service Getting Started Guide (Amazon Simple Storage Service Erste-Schritte-Leitfaden)*. Weitere Informationen darüber, wie Sie einen AWS CLI Befehl ausführen, um einen Bucket zu erstellen, finden Sie [https://docs.aws.amazon.com/cli/latest/reference/s3/mb.html](https://docs.aws.amazon.com/cli/latest/reference/s3/mb.html)in der *AWS CLI Befehlsreferenz.*
1. Laden Sie den Ordner oder das Verzeichnis zum Bucket hoch. Anleitungen finden Sie unter [Hinzufügen eines Objekts zu einem Bucket](https://docs.aws.amazon.com/AmazonS3/latest/userguide/PuttingAnObjectInABucket.html) im *Erste Schritte-Handbuch zu Amazon Simple Storage Service*. Wenn Sie Ihr JSON-Manifest in die AWS Systems Manager Konsole einfügen möchten, laden Sie das Manifest nicht hoch. Weitere Informationen zum Ausführen eines AWS CLI Befehls zum Hochladen von Dateien in einen Bucket finden Sie [https://docs.aws.amazon.com/cli/latest/reference/s3/mv.html](https://docs.aws.amazon.com/cli/latest/reference/s3/mv.html)in der *AWS CLI Befehlsreferenz*.
1. Wählen Sie auf der Startseite des Buckets den von Ihnen hochgeladenen Ordner oder das Verzeichnis aus. Wenn Sie Ihre Dateien in einen Unterordner in einem Bucket hochgeladen haben, stellen Sie sicher, dass Sie sich den Namen des Unterordner notieren (wird auch als *Präfix* bezeichnet). Sie benötigen das Präfix, um Ihr Paket zu Distributor hinzuzufügen.
### Schritt 4: Hinzufügen eines Pakets zu Distributor
Sie können die AWS Systems Manager Konsole, die AWS Befehlszeilentools (AWS CLI und AWS -Tools für PowerShell) verwenden oder AWS SDKs ein neues Paket hinzufügenDistributor. Wenn Sie ein Paket hinzufügen, fügen Sie ein neues [SSM-Dokument](documents.md) hinzu. Mit dem Dokument können Sie das Paket an verwaltete Knoten bereitstellen.
**Topics**
+ [Fügen Sie ein Paket mit der Konsole hinzu](#create-pkg-console)
+ [Fügen Sie ein Paket hinzu, indem Sie AWS CLI](#create-pkg-cli)
#### Fügen Sie ein Paket mit der Konsole hinzu
Sie können die AWS Systems Manager Konsole verwenden, um ein Paket zu erstellen. Halten Sie den Namen des Buckets bereit, auf den Sie in Ihr Paket in [Schritt 3: Hochladen von Paket und Manifest zu einem Amazon S3-Bucket](#packages-upload-s3) hochgeladen haben.
**So fügen Sie Distributor ein Paket hinzu (Konsole)**
1. Öffnen Sie die AWS Systems Manager Konsole unter [https://console.aws.amazon.com/systems-manager/](https://console.aws.amazon.com/systems-manager/).
1. Wählen Sie im Navigationsbereich **Distributor** aus.
1. Wählenen Sie auf der Distributor-Startseite die Option **Create package** (Paket erstellen) und klicken Sie dann auf **Advanced** (Erweitert).
1. Geben Sie auf der Seite **Create package (Paket erstellen)** einen Namen für Ihr Paket ein. Paketnamen können Buchstaben, Zahlen, Punkte, Bindestriche und Unterstriche enthalten. Der Name sollte allgemein genug sein, um auf alle Versionen der Paketanhänge angewendet werden zu können, jedoch spezifisch genug, um den Zweck des Pakets zu identifizieren.
1. Geben Sie unter **Version name (Versionsname)** den exakten Wert des Eintrags `version` in Ihrer Manifestdatei ein.
1. Wählen Sie unter **S3 bucket name (S3-Bucketname)** den Namen des Buckets aus, in den Sie Ihre ZIP-Dateien und das Manifest in [Schritt 3: Hochladen von Paket und Manifest zu einem Amazon S3-Bucket](#packages-upload-s3) hochgeladen haben.
1. Geben Sie unter **S3 key prefix (S3-Schlüsselpräfix)** den Unterordner des Buckets ein, in dem Ihre ZIP-Dateien und das Manifest gespeichert sind.
1. Wählen Sie unter **Manifest** die Option **Extract from package (Aus Paket extrahieren)** aus, um ein Manifest zu verwenden, das Sie mit Ihren ZIP-Dateien in den Amazon S3-Bucket hochgeladen haben.
(Optional) Wenn Sie Ihr JSON-Manifest nicht in den S3-Bucket hochgeladen haben, in dem Ihre ZIP-Dateien gespeichert sind, wählen Sie **New Manifest (Neues Manifest)** aus. Sie können das gesamte Manifest in dem JSON-Editor erstellen oder in ihn hineinkopieren. Weitere Informationen zum Erstellen des JSON-Manifests finden Sie unter [Schritt 2: Erstellen des JSON-Paketmanifests](#packages-manifest).
1. Wenn das Manifest fertiggestellt ist, wählen Sie **Create package (Paket erstellen)**.
1. Warten Sie, bis Distributor die Erstellung des Pakets aus den ZIP-Dateien und dem Manifest abgeschlossen hat. Abhängig von der Anzahl und Größe der Pakete, die Sie hinzufügen, kann dies einige Minuten dauern. Distributor leitet Sie automatisch auf die Seite **Package details (Paketdetails)** für das neue Paket weiter, Sie können diese Seite aber jederzeit selbst öffnen, nachdem die Software hochgeladen ist. Auf der Seite **Package details (Paketdetails)** werden erst dann alle Informationen zu Ihrem Paket angezeigt, wenn Distributor den Paketerstellungsprozess abgeschlossen hat. Um den Upload- und Paketerstellungsprozess abzubrechen, wählen Sie **Cancel (Abbrechen)**.
#### Fügen Sie ein Paket hinzu, indem Sie AWS CLI
Sie können den verwenden AWS CLI , um ein Paket zu erstellen. Halten Sie die URL für den Bucket bereit, zu dem Sie Ihr Paket in [Schritt 3: Hochladen von Paket und Manifest zu einem Amazon S3-Bucket](#packages-upload-s3) hochgeladen haben.
**Um ein Paket zu Amazon S3 hinzuzufügen, verwenden Sie AWS CLI**
1. Um das zum Erstellen eines Pakets AWS CLI zu verwenden, führen Sie den folgenden Befehl aus und *package-name* ersetzen Sie ihn durch den Namen Ihres Pakets und *path-to-manifest-file* durch den Dateipfad für Ihre JSON-Manifestdatei. amzn-s3-demo-bucket ist die URL des Amazon S3-Buckets, in dem das gesamte Paket gespeichert ist. Wenn Sie den Befehl **create-document** in Distributor ausführen, geben Sie den `Package`-Wert für `--document-type` an.
Wenn Sie Ihre Manifestdatei nicht dem Amazon S3-Bucket hinzugefügt haben, ist der `--content`-Parameterwert der Dateipfad zur JSON-Manifestdatei.
```
aws ssm create-document \
--name "package-name" \
--content file://path-to-manifest-file \
--attachments Key="SourceUrl",Values="amzn-s3-demo-bucket" \
--version-name version-value-from-manifest \
--document-type Package
```
Im Folgenden wird ein -Beispiel gezeigt.
```
aws ssm create-document \
--name "ExamplePackage" \
--content file://path-to-manifest-file \
--attachments Key="SourceUrl",Values="https://s3.amazonaws.com/amzn-s3-demo-bucket/ExamplePackage" \
--version-name 1.0.1 \
--document-type Package
```
1. Vergewissern Sie sich, dass Ihr Paket hinzugefügt wurde, und zeigen Sie das Paketmanifest an, indem Sie den folgenden Befehl ausführen und ihn durch den Namen Ihres Pakets ersetzen*package-name*. Um eine spezifische Version des Dokuments (nicht identisch mit der Version eines Pakets) zu erhalten, können Sie den Parameter `--document-version` hinzufügen.
```
aws ssm get-document \
--name "package-name"
```
Informationen zu anderen Optionen, die Sie mit dem Befehl **create-document** verwenden können, finden Sie unter [https://docs.aws.amazon.com/cli/latest/reference/ssm/create-document.html](https://docs.aws.amazon.com/cli/latest/reference/ssm/create-document.html) im Abschnitt AWS Systems Manager der *AWS CLI -Command Reference*. Informationen zu anderen Optionen, die Sie mit dem Befehl **get-document** verwenden können, finden Sie unter [https://docs.aws.amazon.com/cli/latest/reference/ssm/get-document.html](https://docs.aws.amazon.com/cli/latest/reference/ssm/get-document.html).
# Bearbeiten von Distributor-Paketberechtigungen in der Konsole
Nachdem Sie ein Paket zu Distributor einem Tool hinzugefügt haben AWS Systems Manager, können Sie die Berechtigungen des Pakets in der Systems Manager Manager-Konsole bearbeiten. Sie können AWS-Konten den Berechtigungen eines Pakets weitere hinzufügen. Pakete können nur für andere Konten in derselben AWS-Region freigegeben werden. Die Freigabe über Regionsgrenzen hinweg wird nicht unterstützt. Standardmäßig sind Pakete auf **Privat** gesetzt, was bedeutet, dass nur diejenigen, die Zugriff auf die Daten des Paketerstellers haben, die Paketinformationen einsehen und das Paket aktualisieren oder löschen AWS-Konto können. Wenn **Private (Privat)**-Berechtigungen akzeptabel sind, können Sie dieses Verfahren überspringen.
**Anmerkung**
Sie können die Berechtigungen von Paketen aktualisieren, die mit 20 oder weniger Konten freigegeben werden.
**Bearbeiten von Paketberechtigungen in der Konsole**
1. Öffnen Sie die AWS Systems Manager Konsole unter [https://console.aws.amazon.com/systems-manager/](https://console.aws.amazon.com/systems-manager/).
1. Wählen Sie im Navigationsbereich **Distributor** aus.
1. Wählen Sie auf der Seite **Packages (Pakete)** das Paket aus, für das Sie Berechtigungen bearbeiten möchten.
1. Wählen Sie auf der Registerkarte **Package details (Paketdetails)** die Option **Edit permissions (Berechtigungen bearbeiten)** aus, um Berechtigungen zu ändern.
1. Wählen Sie unter **Edit permissions (Berechtigungen bearbeiten)** die Option **Shared with specific accounts (Für bestimmte Konten freigegeben)** aus.
1. Fügen Sie in **Shared with specific accounts (Für bestimmte Konten freigegeben)** nacheinander AWS-Konto hinzu. Wenn Sie fertig sind, wählen Sie **Speichern**.
# Bearbeiten von Distributor-Paket-Tags in der Konsole
Nachdem Sie ein Paket zu einem Tool hinzugefügt habenDistributor, können Sie die Tags des Pakets in der Systems Manager Manager-Konsole bearbeiten. AWS Systems Manager Diese Tags werden auf das Paket angewendet. Sie haben keine Verbindung zu Tags in dem verwalteten Knoten, auf dem Sie das Paket bereitstellen möchten. Tags unterscheiden nach Groß- und Kleinschreibung. Es handelt sich um Schlüssel-Wert-Paare, die Ihnen helfen können, Ihre Pakete nach für Ihre Organisation relevanten Kriterien zu gruppieren und zu filtern. Wenn Sie keine Tags hinzufügen möchten, können Sie Ihr Paket installieren oder eine neue Version hinzufügen.
**So bearbeiten Sie Paket-Tags in der Konsole**
1. Öffnen Sie die AWS Systems Manager Konsole unter [https://console.aws.amazon.com/systems-manager/](https://console.aws.amazon.com/systems-manager/).
1. Wählen Sie im Navigationsbereich **Distributor** aus.
1. Wählen Sie auf der Seite **Packages (Pakete)** das Paket aus, für das Sie Tags bearbeiten möchten.
1. Wählen Sie auf der Registerkarte **Package details (Paketdetails)** in **Tags (Tags)** die Option **Edit (Bearbeiten)** aus.
1. Geben Sie unter **Add tags (Tags hinzufügen)** einen Schlüssel oder ein Schlüssel-Wert-Paar für das Tag ein. Klicken Sie anschließend auf **Add (Hinzufügen)**. Wiederholen Sie dies, wenn Sie weitere Tags hinzufügen möchten. Um Tags zu löschen, wählen Sie unten im Fenster für das Tag **X** aus.
1. Wenn Sie Ihrem Paket keine weiteren Tags mehr hinzufügen möchten, wählen Sie **Save (Speichern)** aus.
# Hinzufügen einer Version zu einem Distributor-Paket
Um eine Paketversion hinzuzufügen, [erstellen Sie ein Paket](distributor-working-with-packages-create.md) und verwenden Sie es dann, Distributor um eine Paketversion hinzuzufügen, indem Sie dem AWS Systems Manager (SSM-) Dokument, das bereits für ältere Versionen vorhanden ist, einen Eintrag hinzufügen. Distributorist ein Tool in AWS Systems Manager. Um Zeit zu sparen, aktualisieren Sie das Manifest für eine ältere Version des Pakets, ändern den Wert des Eintrags `version` im Manifest (z. B. von `Test_1.0` in `Test_2.0`) und speichern das Manifest als Manifest für die neue Version. Bei dem einfachen **Add Version (Version hinzufügen)**-Workflow in der Distributor-Konsole wird das Manifest automatisch aktualisiert.
Eine neue Paketversion kann:
+ Mindestens eine der installierbaren Dateien ersetzen, die der aktuellen Version angefügt sind.
+ Neue installierbare Dateien hinzufügen, um zusätzliche Plattformen zu unterstützen
+ Dateien löschen, um die Unterstützung für bestimmte Plattformen zu beenden
Eine neuere Version kann denselben Amazon Simple Storage Service (Amazon S3)-Bucket verwenden, muss jedoch eine URL mit einem anderen Dateinamen am Ende besitzen. Sie können die Systems Manager-Konsole oder das AWS Command Line Interface (AWS CLI) verwenden, um die neue Version hinzuzufügen. Beim Hochladen einer installierbaren Datei mit demselben Namen wie eine vorhandene installierbare Datei in dem Amazon S3-Bucket wird die vorhandene Datei überschrieben. Es werden keine Dateien aus der älteren Version in die neue Version hineinkopiert. Sie müssen installierbare Dateien aus der älteren Version erneut hochladen, damit sie in die neue Version aufgenommen werden. Nachdem Distributor Ihre neue Paketversion erstellt hat, können Sie den Amazon S3-Bucket löschen oder wiederverwenden, da Distributor Ihre Software im Rahmen der Versioning in einen internen Systems Manager-Bucket kopiert.
**Anmerkung**
Jedes Paket ist auf maximal 25 Versionen beschränkt. Sie können Versionen löschen, die nicht mehr benötigt werden.
**Topics**
+ [Hinzufügen einer Paketversion mit der Konsole](#add-pkg-version)
+ [Hinzufügen einer Paketversion mit dem AWS CLI](#add-pkg-version-cli)
## Hinzufügen einer Paketversion mit der Konsole
Führen Sie vor der Ausführung der folgenden Schritte die Anweisungen unter [Erstellen eines Pakets in Distributor](distributor-working-with-packages-create.md) aus, um ein neues Paket für die Version zu erstellen. Verwenden Sie anschließend die Systems Manager-Konsole, um Distributor eine neue Paketversion hinzuzufügen.
### Hinzufügen einer Paketversion mithilfe des einfachen Workflows
Um eine Paketversion mithilfe des **einfachen** Workflows hinzuzufügen, bereiten Sie aktualisierte installierbare Dateien vor oder fügen Sie installierbare Dateien hinzu, um weitere Plattformen und Architekturen zu unterstützen. Verwenden Sie anschließend Distributor zum Hochladen neuer und aktualisierter installierbarer Dateien und fügen Sie eine Paketversion hinzu. Die vereinfachte **Add version (Version hinzufügen)**-Workflow in der Distributor Konsole aktualisiert die Manifestdatei und das zugehörige SSM-Dokument automatisch.
**Hinzufügen einer Paketversion mithilfe des einfachen Workflows**
1. Öffnen Sie die AWS Systems Manager Konsole unter [https://console.aws.amazon.com/systems-manager/](https://console.aws.amazon.com/systems-manager/).
1. Wählen Sie im Navigationsbereich **Distributor** aus.
1. Wählen Sie auf der Distributor-Startseite das Paket aus, dem Sie eine weitere Version hinzufügen möchten.
1. Wählen Sie auf der Seite **Add version (Version hinzufügen)** die Option **Simple (Einfach)**.
1. Geben Sie unter **Version name (Versionsname)** einen Versionsnamen ein. Der Versionsname für die neue Version muss sich von der älteren Version unterscheiden. Versionsnamen dürfen maximal 512 Zeichen lang sein und dürfen keine Sonderzeichen enthalten.
1. Wählen Sie für **S3 bucket name (S3-Bucketname)**, einen vorhandenen S3-Bucket aus der Liste aus. Dabei kann es sich um den Bucket handeln, den Sie zum Speichern installierbarer Dateien für ältere Versionen verwendet haben, aber die installierbaren Dateinamen müssen unterschiedlich sein, damit das Überschreiben vorhandener installierbaren Dateien in dem Bucket vermieden wird.
1. Geben Sie unter **S3 key prefix (S3-Schlüsselpräfix)** den Unterordner des Buckets ein, in dem Ihre installierbaren Komponenten gespeichert sind.
1. Navigieren Sie unter **Upload Software (Software hochladen)** zu den installierbaren Softwaredateien, die Sie für die neue Version anfügen möchten. Installierbare Versionen von vorhandenen Dateien werden nicht automatisch in eine neue Version herüberkopiert. Sie müssen alle installierbaren Dateien aus älteren Versionen des Pakets erneut hochladen, wenn Sie diese in die neue Version übernehmen möchten. Sie können mehrere Softwaredateien in einer einzigen Aktion hochladen.
1. Überprüfen Sie unter Für **Target platform (Ziel-Plattform** für jede Plattform, ob das Ziel-Betriebssystem für die installierbare Datei korrekt ist. Wenn das angezeigte Betriebssystem nicht korrekt ist, wählen Sie das richtige Betriebssystem aus der Dropdown-Liste aus.
Bei dem Workflow **Simple (Einfach)** zur Versioning sind zusätzliche Schritte erforderlich, wenn nur eine Datei für mehrere Betriebssysteme als Ziel verwendet werden soll, da installierbare Dateien nur einmal hochgeladen werden. Wenn Sie zum Beispiel eine installierbare Softwaredatei mit dem Namen `Logtool_v1.1.1.rpm` hochladen, müssen Sie einige Standardeinstellungen für den **Einfach**-Workflow ändern, um Distributor anzuweisen, für dieselbe Software sowohl das Amazon-Linux- als auch das Ubuntu Server-Betriebssystem als Ziel festzulegen. Um dieses Problem zu beheben, können Sie eine der folgenden Aktionen ausführen.
+ Verwenden Sie stattdessen den Workflow **Advanced (Erweitert)** zur Versioning, zippen Sie jede installierbare Datei, bevor Sie beginnen, und richten Sie das Manifest manuell so ein, dass eine installierbare Datei für mehrere Betriebssystemplattformen oder -versionen verwendet werden kann. Weitere Informationen finden Sie unter [Hinzufügen einer Paketversion mithilfe des erweiterten Workflows](#add-pkg-version-adv).
+ Bearbeiten Sie die Manifestdatei im Workflow **Simple (Einfach)** so, dass Ihre ZIP-Datei für mehrere Betriebssystemplattformen oder -versionen verwendet wird. Weitere Informationen zu diesem Verfahren finden Sie am Ende von Schritt 4 in [Schritt 2: Erstellen des JSON-Paketmanifests](distributor-working-with-packages-create.md#packages-manifest).
1. **Vergewissern Sie sich, dass es sich bei der angezeigten Plattformversion des Betriebssystems entweder **\$1any** um eine Hauptversion mit einem Platzhalter (8.\$1) oder um die genaue Betriebssystemversion handelt, für die Ihre Software gelten soll.** Weitere Informationen zum Festlegen einer Plattformversion finden Sie unter Schritt 4 in [Schritt 2: Erstellen des JSON-Paketmanifests](distributor-working-with-packages-create.md#packages-manifest).
1. Wählen Sie unter **Architecture (Architektur)** für jeden installierbare Datei die richtige Prozessorarchitektur aus der Dropdown-Liste aus. Weitere Informationen zu unterstützten Architekturen finden Sie unter [Unterstützte Paketplattformen und -architekturen](distributor.md#what-is-a-package-platforms).
1. (Optional) Erweitern Sie **Scripts (Skripts)** und überprüfen Sie die Installations- und Deinstallationsskripts, die Distributor für Ihre installierbare Software generiert hat.
1. Zum Hinzufügen weiterer installierbarer Softwaredateien zu der neuen Version wählen Sie **Add Software (Software hinzufügen)**. Andernfalls fahren Sie mit dem nächsten Schritt fort.
1. (Optional) Erweitern Sie **Manifest** und überprüfen Sie das JSON-Manifest des Pakets, das Distributor für Ihre installierbare Software generiert hat. Wenn Sie Informationen über Ihre installierbare Software geändert haben, nachdem Sie mit dieser Prozedur begonnen haben, beispielsweise die Plattformversion oder die Zielplattform, wählen Sie **Generate Manifest (Manifest erzeugen)**, um das Paketmanifest zu aktualisieren.
Sie können das Manifest manuell bearbeiten, wenn Sie möchten, dass für eine installierbare Software mehr als ein Betriebssystem als Ziel festgelegt wird, wie in Schritt 9 beschrieben. Weitere Informationen zum Bearbeiten des Manifests finden Sie unter [Schritt 2: Erstellen des JSON-Paketmanifests](distributor-working-with-packages-create.md#packages-manifest).
1. Wählen Sie nach dem Hinzufügen der Software und der Überprüfung der Daten zur Zielplattform, zur Version und zur Architektur Sie **Add version (Version hinzufügen)**.
1. Warten Sie, bis Distributor das Hochladen Ihrer Software und das Erstellen Ihres neuen Pakets abgeschlossen Hat. Distributor zeigt den Uploadstatus für jede installierbare Datei einzeln an. Abhängig von der Anzahl und Größe der Pakete, die Sie hinzufügen, kann dies einige Minuten dauern. Distributor leitet Sie automatisch auf die Seite **Package details (Paketdetails)** für das neue Paket weiter, Sie können diese Seite aber jederzeit selbst öffnen, nachdem die Software hochgeladen ist. Auf der Seite **Package details (Paketdetails)** werden erst dann alle Informationen zu Ihrem Paket angezeigt, wenn Distributor den Erstellungsprozess für die neue Paketversion abgeschlossen hat. Um den Uploadvorgang bzw. den prozess zur Erstellung der Paketversion anzuhalten, wählen Sie **Stop upload (Upload anhalten)**.
1. Wenn Distributor keine installierbaren Softwaredateien hochladen kann, wird eine Fehlermeldung **Upload failed (Upload fehlgeschlagen)** angezeigt. Um den Uploadversuch zu wiederholen, wählen Sie **Retry Upload (Uploadversuch wiederholen)**. Weitere Informationen zur Fehlerbehebung bei der Paketversionserstellung finden Sie unter [Problembehebung AWS Systems ManagerDistributor](distributor-troubleshooting.md).
1. Wenn Distributor die neue Paketversion erstellt hat. zeigen Sie auf der Seite **Details (Details)** auf der Registerkarte **Versions (Versionen)** die neue Version in der Liste der verfügbaren Paketversionen an. Legen Sie die Standardversion des Pakets fest, indem Sie eine Version auswählen. Wählen Sie anschließend **Set default version (Als Standardversion festlegen)** aus.
Wenn Sie keine Standardversion festlegen, ist die neueste Paketversion die Standardversion.
### Hinzufügen einer Paketversion mithilfe des erweiterten Workflows
Um eine Paketversion hinzuzufügen, [erstellen Sie ein Paket](distributor-working-with-packages-create.md) und verwenden Sie anschließend Distributor, um eine Paketversion hochzuladen, indem Sie dem für ältere Versionen vorhandenen SSM-Dokument einen Eintrag hinzufügen. Um Zeit zu sparen, aktualisieren Sie das Manifest für eine ältere Version des Pakets, ändern den Wert des Eintrags `version` im Manifest (z. B. von `Test_1.0` in `Test_2.0`) und speichern das Manifest als Manifest für die neue Version. Sie müssen das Manifest so ändern, dass eine neue Version des Pakets hinzugefügt wird. Dies führen Sie mit dem **Advanced**-Workflow durch.
**Hinzufügen einer Paketversion mithilfe des erweiterten Workflows**
1. Öffnen Sie die AWS Systems Manager Konsole unter. [https://console.aws.amazon.com/systems-manager/](https://console.aws.amazon.com/systems-manager/)
1. Wählen Sie im Navigationsbereich **Distributor** aus.
1. Wählen Sie auf der Distributor-Startseite das Paket aus, dem Sie eine weitere Version hinzufügen möchten, an wählen Sie dann **Add version (Version hinzufügen)**.
1. Geben Sie unter **Version name (Versionsname)** den exakten Wert des Eintrags `version` Ihrer Manifestdatei ein.
1. Wählen Sie für **S3 bucket name (S3-Bucketname)**, einen vorhandenen S3-Bucket aus der Liste aus. Dabei kann es sich um den Bucket handeln, den Sie zum Speichern installierbarer Dateien für ältere Versionen verwendet haben, aber die installierbaren Dateinamen müssen unterschiedlich sein, damit das Überschreiben vorhandener installierbaren Dateien in dem Bucket vermieden wird.
1. Geben Sie unter **S3 key prefix (S3-Schlüsselpräfix)** den Unterordner des Buckets ein, in dem Ihre installierbaren Komponenten gespeichert sind.
1. Wählen Sie unter **Manifest** die Option **Extract from package (Aus Paket extrahieren)** aus, um ein Manifest zu verwenden, das Sie mit Ihren ZIP-Dateien in den S3-Bucket hochgeladen haben.
(Optional) Wenn Sie kein aktualisiertes JSON-Manifest in den Amazon S3-Bucket mit Ihren ZIP-Dateien hochgeladen haben, wählen Sie **New manifest (Neues Manifest)** aus. Sie können das gesamte Manifest in dem JSON-Editor erstellen oder in ihn hineinkopieren. Weitere Informationen zum Erstellen des JSON-Manifests finden Sie unter [Schritt 2: Erstellen des JSON-Paketmanifests](distributor-working-with-packages-create.md#packages-manifest).
1. Wenn das Manifest fertiggestellt ist, wählen Sie **Add package version (Paketversion hinzufügen)**.
1. Zeigen Sie auf der Seite **Details (Details)** auf der Registerkarte **Versions (Versionen)** die neue Version in der Liste der verfügbaren Paketversionen an. Legen Sie die Standardversion des Pakets fest, indem Sie eine Version auswählen. Wählen Sie anschließend **Set default version (Als Standardversion festlegen)** aus.
Wenn Sie keine Standardversion festlegen, ist die neueste Paketversion die Standardversion.
## Hinzufügen einer Paketversion mit dem AWS CLI
Sie können den verwenden AWS CLI , um eine neue Paketversion hinzuzufügenDistributor. Vor der Ausführung der folgenden Befehle müssen Sie eine neue Paketversion erstellen und diese zu S3 hochladen wie am Anfang dieses Themas beschrieben.
**Um eine Paketversion hinzuzufügen, verwenden Sie AWS CLI**
1. Führen Sie den folgenden Befehl aus, um das AWS Systems Manager Dokument mit einem Eintrag für eine neue Paketversion zu bearbeiten. *document-name*Ersetzen Sie es durch den Namen Ihres Dokuments. *amzn-s3-demo-bucket*Ersetzen Sie es durch die URL des JSON-Manifests, das Sie kopiert haben[Schritt 3: Hochladen von Paket und Manifest zu einem Amazon S3-Bucket](distributor-working-with-packages-create.md#packages-upload-s3). *S3-bucket-URL-of-package*ist die URL des Amazon S3 S3-Buckets, in dem das gesamte Paket gespeichert ist. *version-name-from-updated-manifest*Ersetzen Sie es durch den Wert von `version` im Manifest. Legen Sie den Parameter `--document-version` auf `$LATEST` fest, um das Dokument für diese Paketversion als aktuelle Version des Dokuments festzulegen.
```
aws ssm update-document \
--name "document-name" \
--content "S3-bucket-URL-to-manifest-file" \
--attachments Key="SourceUrl",Values="amzn-s3-demo-bucket" \
--version-name version-name-from-updated-manifest \
--document-version $LATEST
```
Im Folgenden wird ein -Beispiel gezeigt.
```
aws ssm update-document \
--name ExamplePackage \
--content "https://s3.amazonaws.com/amzn-s3-demo-bucket/ExamplePackage/manifest.json" \
--attachments Key="SourceUrl",Values="https://s3.amazonaws.com/amzn-s3-demo-bucket/ExamplePackage" \
--version-name 1.1.1 \
--document-version $LATEST
```
1. Führen Sie den folgenden Befehl aus, um zu überprüfen, ob Ihr Paket aktualisiert wurde, und das Paketmanifest anzuzeigen. *package-name*Ersetzen Sie es durch den Namen Ihres Pakets und optional durch die Versionsnummer des Dokuments (nicht identisch *document-version* mit der Paketversion), das Sie aktualisiert haben. Wenn diese Paketversion der aktuellen Version des Dokuments zugeordnet ist, können Sie `$LATEST` als Wert des optionalen Parameters `--document-version` angeben.
```
aws ssm get-document \
--name "package-name" \
--document-version "document-version"
```
Informationen zu anderen Optionen, die Sie mit dem **update-document** Befehl verwenden können, finden Sie [https://docs.aws.amazon.com/cli/latest/reference/ssm/update-document.html](https://docs.aws.amazon.com/cli/latest/reference/ssm/update-document.html)im AWS Systems Manager Abschnitt der *AWS CLI Befehlsreferenz*.
# Installieren oder Aktualisieren von Distributor-Paketen
Sie können Pakete auf Ihren AWS Systems Manager verwalteten Knoten bereitstellenDistributor, indem Sie ein Tool in verwenden AWS Systems Manager. Um die Pakete bereitzustellen, verwenden Sie entweder AWS-Managementkonsole 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, zur Installation von Paketen ein Tool in 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.
**Wichtig**
Mit Distributor installierte Pakete sollten nur mithilfe von Distributor deinstalliert werden. Andernfalls kann Systems Manager die Anwendung weiterhin als `INSTALLED` erkennen und es können andere unbeabsichtigte Ergebnisse auftreten.
| Präferenz | AWS Systems Manager Aktion | Weitere Informationen |
| --- | --- | --- |
| Installieren oder aktualisieren Sie ein Paket sofort. | Run Command | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/de_de/systems-manager/latest/userguide/distributor-working-with-packages-deploy.html) |
| Installieren Sie ein Paket nach einem Zeitplan, sodass die Installation immer die Standardversion enthält. | State Manager | [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/de_de/systems-manager/latest/userguide/distributor-working-with-packages-deploy.html) |
| 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 [Verstehen von Zielen und Ratensteuerungen in State Manager Zuordnungen](systems-manager-state-manager-targets-and-rate-controls.md). |
**Topics**
+ [Einmaliges Installieren oder Aktualisieren eines Pakets mithilfe der Konsole](#distributor-deploy-pkg-console)
+ [Planen einer Paketinstallation oder -aktualisierung mithilfe der Konsole](#distributor-deploy-sm-pkg-console)
+ [Einmaliges Installieren eines Pakets mit dem AWS CLI](#distributor-deploy-pkg-cli)
+ [Einmaliges Aktualisieren eines Pakets mit dem AWS CLI](#distributor-update-pkg-cli)
+ [Planung einer Paketinstallation mit dem AWS CLI](#distributor-smdeploy-pkg-cli)
+ [Planung einer Paket-Aktualisierung mit dem AWS CLI](#distributor-smupdate-pkg-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[AWS Systems Manager Run Command](run-command.md), Distributor verwendet ein Tool in AWS Systems Manager, um die Installation durchzuführen.
**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/](https://console.aws.amazon.com/systems-manager/).
1. Wählen Sie im Navigationsbereich **Distributor** aus.
1. Wählen Sie auf der Distributor-Startseite das Paket aus, das Sie installieren möchten.
1. 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.
1. Wählen Sie unter **Document version (Dokumentversion)** die Version des `AWS-ConfigureAWSPackage`-Dokuments aus, das Sie ausführen möchten.
1. Wählen Sie für **Action (Aktion)** die Option **Install (Installieren)**.
1. 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.
1. Überprüfen Sie, ob unter **Name** der Name des ausgewählten Pakets angegeben ist.
1. (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.
1. 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](fleet-manager-troubleshooting-managed-nodes.md).
1. 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.
1. 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.
1. (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](setup-instance-permissions.md) oder [Eine IAM-Servicerolle für eine Hybrid-Umgebung erstellen](hybrid-multicloud-service-role.md). 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.
1. 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](monitoring-sns-notifications.md).
1. Wenn Sie bereit sind, das Paket zu installieren, klicken Sie auf **Run (Ausführen)**.
1. 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.
1. 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.
1. (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 Paketinstallation oder -aktualisierung planen, verwendet Distributor [AWS Systems Manager State Manager](systems-manager-state.md) zum Installieren oder Aktualisieren.
**So planen Sie eine Paketinstallation mithilfe der Konsole**
1. Öffnen Sie die AWS Systems Manager Konsole unter [https://console.aws.amazon.com/systems-manager/](https://console.aws.amazon.com/systems-manager/).
1. Wählen Sie im Navigationsbereich **Distributor** aus.
1. Wählen Sie auf der Distributor-Startseite das Paket aus, das Sie installieren oder aktualisieren möchten.
1. 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.
1. 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.
1. In der Liste **Document (Dokument)** ist der Dokumentname `AWS-ConfigureAWSPackage` bereits ausgewählt.
1. Überprüfen Sie unter **Action (Aktion)**, ob **Install (Installieren)** ausgewählt ist.
1. 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.
1. Überprüfen Sie unter **Name**, ob der Name Ihres Pakets angegeben ist.
1. Geben Sie unter **Version** die Versionskennung ein, wenn Sie eine andere Paketversion als die zuletzt veröffentlichte Version installieren möchten.
1. 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**.
1. 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](state-manager-associations.md). Verwenden Sie die Steuerelemente, um einen `cron`- oder Rate-Zeitplan für die Zuordnung zu erstellen.
1. Wählen Sie **Zuordnung erstellen**.
1. 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](state-manager-associations.md) 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](state-manager-associations.md).
## Einmaliges Installieren eines Pakets mit dem 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.
**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` 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 [https://docs.aws.amazon.com/cli/latest/reference/ssm/send-command.html](https://docs.aws.amazon.com/cli/latest/reference/ssm/send-command.html)im AWS Systems Manager Abschnitt der *AWS CLI Befehlsreferenz*.
## Einmaliges Aktualisieren eines Pakets mit dem 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.
**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 [https://docs.aws.amazon.com/cli/latest/reference/ssm/send-command.html](https://docs.aws.amazon.com/cli/latest/reference/ssm/send-command.html)im AWS Systems Manager Abschnitt der *AWS CLI Befehlsreferenz*.
## Planung einer Paketinstallation mit dem 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 [https://docs.aws.amazon.com/cli/latest/reference/ssm/create-association.html](https://docs.aws.amazon.com/cli/latest/reference/ssm/create-association.html)im AWS Systems Manager Abschnitt der *AWS CLI Befehlsreferenz*.
## Planung einer Paket-Aktualisierung mit dem 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 [https://docs.aws.amazon.com/cli/latest/reference/ssm/create-association.html](https://docs.aws.amazon.com/cli/latest/reference/ssm/create-association.html)im AWS Systems Manager Abschnitt der *AWS CLI Befehlsreferenz*.
# Deinstallieren eines Distributor-Pakets
Sie können das AWS-Managementkonsole oder das AWS Command Line Interface (AWS CLI) verwenden, um Distributor Pakete von Ihren AWS Systems Manager verwalteten Knoten zu deinstallieren, indem SieRun Command. Distributorund Run Command sind Tools in AWS Systems Manager. In dieser Version können Sie pro Befehl eine Version eines Pakets deinstallieren. Sie können eine bestimmte Version oder die Standardversion deinstallieren.
**Wichtig**
Mit Distributor installierte Pakete sollten nur mithilfe von Distributor deinstalliert werden. Andernfalls kann Systems Manager die Anwendung weiterhin als `INSTALLED` erkennen und es können andere unbeabsichtigte Ergebnisse auftreten.
**Topics**
+ [Deinstallation eines Pakets über die Konsole](#distributor-pkg-uninstall-console)
+ [Deinstallation eines Pakets mit dem AWS CLI](#distributor-pkg-uninstall-cli)
## Deinstallation eines Pakets über die Konsole
Sie können Run Command in der Systems Manager-Konsole verwenden, um ein Paket einmalig zu deinstallieren. Distributor verwendet [AWS Systems Manager Run Command](run-command.md) zur Deinstallation von Paketen.
**Um ein Paket mit der Konsole zu deinstallieren**
1. Öffnen Sie die AWS Systems Manager Konsole unter [https://console.aws.amazon.com/systems-manager/](https://console.aws.amazon.com/systems-manager/).
1. Wählen Sie im Navigationsbereich **Run Command** aus.
1. Wählen Sie auf der Run Command-Startseite **Run command (Befehl ausführen)** aus.
1. Wählen Sie das Befehlsdokument `AWS-ConfigureAWSPackage` aus.
1. Wählen Sie in **Action (Aktion)** die Option **Uninstall (Deinstallieren)** aus.
1. Geben Sie in **Name (Name)** den Namen des Pakets ein, das Sie deinstallieren möchten.
1. Für **Targets** (Ziele) wählen Sie aus, wie Sie Ihre verwaltete Knoten anvisieren möchten. Sie können einen Tag-Schlüssel und Werte angeben, die von den Zielen geteilt werden. Sie können Ziele auch angeben, indem Sie Attribute wie ID, Plattform und SSM Agent-Version auswählen.
1. Sie können in den erweiterten Optionen Kommentare zur Operation hinzufügen, die Werte für **Concurrency (Gleichzeitigkeit)** und **Error threshold (Fehlerschwellenwert)** in **Rate control (Ratenkontrolle)** ändern, Ausgabeoptionen angeben oder Amazon Simple Notification Service (Amazon SNS)-Benachrichtigungen konfigurieren. Weitere Informationen finden Sie unter [Ausführen von Befehlen über die Konsole](https://docs.aws.amazon.com/systems-manager/latest/userguide/rc-console.html) in diesem Handbuch.
1. Wenn Sie zur Deinstallation des Pakets bereit sind, wählen Sie **Run (Ausführen)** und dann **View results (Ergebnisse anzeigen)** aus.
1. Wählen Sie in der Befehlsliste den `AWS-ConfigureAWSPackage` aus, den Sie ausgeführt haben. Wenn der Befehl noch in Bearbeitung ist, wählen Sie das Aktualisierungssymbol oben rechts in der Konsole aus.
1. Wenn die Spalte **Status** **Success** (Erfolg) oder **Failed** (Fehlgeschlagen) anzeigt, wählen Sie die Registerkarte **Output** (Ausgabe).
1. Wählen Sie **View output (Ausgabe anzeigen)** aus. Der Befehlsausgabeseite zeigt die Ergebnisse der Befehlsausführung an.
## Deinstallation eines Pakets mit dem AWS CLI
Sie können das verwenden AWS CLI , um ein Distributor Paket von verwalteten Knoten zu deinstallieren, indem SieRun Command.
**Um ein Paket mit dem zu deinstallieren 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":["Uninstall"],"name":["package-name (in same account) or package-ARN (shared from different account)"]}'
```
Im Folgenden wird ein -Beispiel gezeigt.
```
aws ssm send-command \
--document-name "AWS-ConfigureAWSPackage" \
--instance-ids "i-02573cafcfEXAMPLE" \
--parameters '{"action":["Uninstall"],"name":["Test-ConfigureAWSPackage"]}'
```
Informationen zu anderen Optionen, die Sie mit dem **send-command** Befehl verwenden können, finden Sie [https://docs.aws.amazon.com/cli/latest/reference/ssm/send-command.html](https://docs.aws.amazon.com/cli/latest/reference/ssm/send-command.html)im AWS Systems Manager Abschnitt der *AWS CLI Befehlsreferenz*.
# Löschen eines Distributor-Pakets
In diesem Abschnitt wird beschrieben, wie Sie ein Paket löschen. Sie können eine Version eines Pakets nicht löschen, sondern nur das gesamte Paket.
## Löschen eines Pakets über die Konsole
Sie können die AWS Systems Manager Konsole verwenden, um ein Paket oder eine Paketversion aus Distributor einem Tool in zu löschen AWS Systems Manager. Durch das Löschen eines Pakets werden alle Versionen des Pakets aus Distributor gelöscht.
**So löschen Sie ein Paket mithilfe der Konsole**
1. Öffnen Sie die AWS Systems Manager Konsole unter [https://console.aws.amazon.com/systems-manager/](https://console.aws.amazon.com/systems-manager/).
1. Wählen Sie im Navigationsbereich **Distributor** aus.
1. Wählen Sie auf der **Distributor**-Startseite das Paket aus, das Sie löschen möchten.
1. Wählen Sie auf der Detailseite des Pakets **Delete package (Paket löschen)** aus.
1. Wenn Sie zum Bestätigen des Löschvorgangs aufgefordert werden, wählen Sie **Delete package (Paket löschen)** aus.
## Löschen einer Paketversion über die Konsole
Sie können die Systems Manager-Konsole verwenden, um eine Paketversion aus Distributor zu löschen.
**Löschen einer Paketversion über die Konsole**
1. Öffnen Sie die AWS Systems Manager Konsole unter [https://console.aws.amazon.com/systems-manager/](https://console.aws.amazon.com/systems-manager/).
1. Wählen Sie im Navigationsbereich **Distributor** aus.
1. Wählen Sie auf der **Distributor**-Startseite das Paket aus, von dem Sie eine Version löschen möchten.
1. Wählen Sie auf der Versionsseite für das Paket die zu löschende Version und anschließend die Option **Delete version (Version löschen)** aus.
1. Wenn Sie zum Bestätigen des Löschvorgangs aufgefordert werden, wählen Sie **Delete package version (Paketversion löschen)** aus.
## Ein Paket mithilfe einer Befehlszeile löschen
Sie können Ihr bevorzugtes Befehlszeilen-Tool verwenden, um ein Paket aus Distributor zu löschen.
------
#### [ Linux & macOS ]
**Um ein Paket mit dem zu löschen AWS CLI**
1. Führen Sie den folgenden Befehl aus, um Dokumente für spezifische Pakete aufzulisten. Suchen Sie in den Ergebnissen dieses Befehls das Paket, das Sie löschen möchten.
```
aws ssm list-documents \
--filters Key=Name,Values=package-name
```
1. Führen Sie den folgenden Befehl aus, um ein Paket zu löschen. *package-name*Ersetzen Sie es durch den Paketnamen.
```
aws ssm delete-document \
--name "package-name"
```
1. Führen Sie den Befehl **list-documents** erneut aus, um zu überprüfen, ob das Paket gelöscht wurde. Das Paket, das Sie gelöscht haben, sollte nicht in die Liste aufgenommen werden.
```
aws ssm list-documents \
--filters Key=Name,Values=package-name
```
------
#### [ Windows ]
**Um ein Paket mit dem zu löschen AWS CLI**
1. Führen Sie den folgenden Befehl aus, um Dokumente für spezifische Pakete aufzulisten. Suchen Sie in den Ergebnissen dieses Befehls das Paket, das Sie löschen möchten.
```
aws ssm list-documents ^
--filters Key=Name,Values=package-name
```
1. Führen Sie den folgenden Befehl aus, um ein Paket zu löschen. *package-name*Ersetzen Sie es durch den Paketnamen.
```
aws ssm delete-document ^
--name "package-name"
```
1. Führen Sie den Befehl **list-documents** erneut aus, um zu überprüfen, ob das Paket gelöscht wurde. Das Paket, das Sie gelöscht haben, sollte nicht in die Liste aufgenommen werden.
```
aws ssm list-documents ^
--filters Key=Name,Values=package-name
```
------
#### [ PowerShell ]
**Um ein Paket mit Tools für zu löschen PowerShell**
1. Führen Sie den folgenden Befehl aus, um Dokumente für spezifische Pakete aufzulisten. Suchen Sie in den Ergebnissen dieses Befehls das Paket, das Sie löschen möchten.
```
$filter = New-Object Amazon.SimpleSystemsManagement.Model.DocumentKeyValuesFilter
$filter.Key = "Name"
$filter.Values = "package-name"
Get-SSMDocumentList `
-Filters @($filter)
```
1. Führen Sie den folgenden Befehl aus, um ein Paket zu löschen. *package-name*Ersetzen Sie es durch den Paketnamen.
```
Remove-SSMDocument `
-Name "package-name"
```
1. Führen Sie den Befehl **Get-SSMDocumentList** erneut aus, um zu überprüfen, ob das Paket gelöscht wurde. Das Paket, das Sie gelöscht haben, sollte nicht in die Liste aufgenommen werden.
```
$filter = New-Object Amazon.SimpleSystemsManagement.Model.DocumentKeyValuesFilter
$filter.Key = "Name"
$filter.Values = "package-name"
Get-SSMDocumentList `
-Filters @($filter)
```
------
## Eine Paketversion mithilfe einer Befehlszeile löschen
Sie können Ihr bevorzugtes Befehlszeilen-Tool verwenden, um eine Paketversion aus Distributor zu löschen.
------
#### [ Linux & macOS ]
**Um eine Paketversion mit dem zu löschen AWS CLI**
1. Führen Sie den folgenden Befehl aus, um die Versionen Ihres Pakets aufzulisten. Suchen Sie in den Ergebnissen dieses Befehls die Paketversion, die Sie löschen möchten.
```
aws ssm list-document-versions \
--name "package-name"
```
1. Führen Sie den folgenden Befehl aus, um eine Paketversion zu löschen. *package-name*Ersetzen Sie durch den Paketnamen und *version* die Versionsnummer.
```
aws ssm delete-document \
--name "package-name" \
--document-version version
```
1. Führen Sie den Befehl **list-document-versions** aus, um zu überprüfen, ob die Version des Pakets gelöscht wurde. Die von Ihnen gelöschte Paketversion sollte nicht gefunden werden.
```
aws ssm list-document-versions \
--name "package-name"
```
------
#### [ Windows ]
**Um eine Paketversion mit dem zu löschen AWS CLI**
1. Führen Sie den folgenden Befehl aus, um die Versionen Ihres Pakets aufzulisten. Suchen Sie in den Ergebnissen dieses Befehls die Paketversion, die Sie löschen möchten.
```
aws ssm list-document-versions ^
--name "package-name"
```
1. Führen Sie den folgenden Befehl aus, um eine Paketversion zu löschen. *package-name*Ersetzen Sie durch den Paketnamen und *version* die Versionsnummer.
```
aws ssm delete-document ^
--name "package-name" ^
--document-version version
```
1. Führen Sie den Befehl **list-document-versions** aus, um zu überprüfen, ob die Version des Pakets gelöscht wurde. Die von Ihnen gelöschte Paketversion sollte nicht gefunden werden.
```
aws ssm list-document-versions ^
--name "package-name"
```
------
#### [ PowerShell ]
**Um eine Paketversion mit Tools für zu löschen PowerShell**
1. Führen Sie den folgenden Befehl aus, um die Versionen Ihres Pakets aufzulisten. Suchen Sie in den Ergebnissen dieses Befehls die Paketversion, die Sie löschen möchten.
```
Get-SSMDocumentVersionList `
-Name "package-name"
```
1. Führen Sie den folgenden Befehl aus, um eine Paketversion zu löschen. *package-name*Ersetzen Sie es durch den Paketnamen und *version* die Versionsnummer.
```
Remove-SSMDocument `
-Name "package-name" `
-DocumentVersion version
```
1. Führen Sie den Befehl **Get-SSMDocumentVersionList** aus, um zu überprüfen, ob die Version des Pakets gelöscht wurde. Die von Ihnen gelöschte Paketversion sollte nicht gefunden werden.
```
Get-SSMDocumentVersionList `
-Name "package-name"
```
------
Informationen zu anderen Optionen, die Sie mit dem **list-documents** Befehl verwenden können, finden Sie [https://docs.aws.amazon.com/cli/latest/reference/ssm/list-documents.html](https://docs.aws.amazon.com/cli/latest/reference/ssm/list-documents.html)im AWS Systems Manager Abschnitt der *AWS CLI Befehlsreferenz*. Informationen zu anderen Optionen, die Sie mit dem Befehl **delete-document** verwenden können, finden Sie unter [https://docs.aws.amazon.com/cli/latest/reference/ssm/delete-document.html](https://docs.aws.amazon.com/cli/latest/reference/ssm/delete-document.html).
# Prüfen und Protokollieren von Distributor-Aktivitäten
Sie können verwenden AWS CloudTrail , um Aktivitäten im Zusammenhang mitDistributor, einem Tool in zu überprüfen AWS Systems Manager. Weitere Informationen zu den Prüfungs- und Protokollierungsoptionen für Systems Manager finden Sie unter [Einloggen und Überwachen AWS Systems Manager](monitoring.md).
## Prüfen Sie Distributor die Aktivität mithilfe von CloudTrail
CloudTrail erfasst API-Aufrufe, die in der AWS Systems Manager Konsole, dem AWS Command Line Interface (AWS CLI) und dem Systems Manager SDK getätigt wurden. Die Informationen können in der CloudTrail Konsole angezeigt oder in einem Amazon Simple Storage Service (Amazon S3) -Bucket gespeichert werden. Ein Bucket wird für alle CloudTrail Protokolle Ihres Kontos verwendet.
Protokolle von Run Command- und State Manager-Aktionen zeigen Aktivitäten im Zusammenhang mit Dokumenterstellung, Paketinstallation und Paketdeinstallation an. Run Command und State Manager sind Tools in AWS Systems Manager. Weitere Informationen zum Anzeigen und Verwenden von CloudTrail Protokollen der Systems Manager Manager-Aktivitäten finden Sie unter[AWS Systems Manager API-Aufrufe protokollieren mit AWS CloudTrail](monitoring-cloudtrail-logs.md).
# Problembehebung AWS Systems ManagerDistributor
Die folgenden Informationen können Ihnen helfen, Fehler zu beheben, die bei der Verwendung von Distributor, einem Tool in AWS Systems Manager, möglicherweise auftreten.
**Topics**
+ [Falsches Paket mit identischem Namen installiert](#distributor-tshoot-1)
+ [Fehler: Abruf des Manifests fehlgeschlagen: Aktuelle Version des Pakets wurde nicht gefunden](#distributor-tshoot-2)
+ [Fehler: Fehler beim Abrufen des Manifests: Validierungsausnahme](#distributor-tshoot-3)
+ [Paket wird nicht unterstützt (dem Paket fehlt Installationsaktion)](#distributor-tshoot-4)
+ [Fehler: Manifest konnte nicht heruntergeladen werden: Dokument mit dem Namen ist nicht vorhanden](#distributor-tshoot-5)
+ [Hochladen fehlgeschlagen.](#distributor-tshoot-6)
+ [Fehler: Failed to find platform: no manifest found for platform: oracle, version 8.9, architecture x86\$164](#distributor-tshoot-7)
## Falsches Paket mit identischem Namen installiert
**Problem:** Sie haben ein Paket installiert, Distributor hat stattdessen ein anderes Paket installiert.
**Ursache:** Während der Installation findet Systems Manager von AWS veröffentlichte Pakete als Ergebnisse, bevor benutzerdefinierte externe Pakete gefunden werden. Wenn Ihr benutzerdefinierter Paketname mit dem Namen eines AWS veröffentlichten Pakets identisch ist, wird das AWS Paket anstelle Ihres Pakets installiert.
**Lösung:** Um dieses Problem zu vermeiden, geben Sie Ihrem Paket einen anderen Namen als den Namen eines AWS veröffentlichten Pakets.
## Fehler: Abruf des Manifests fehlgeschlagen: Aktuelle Version des Pakets wurde nicht gefunden
**Problem:** Sie haben eine Fehlermeldung wie die folgende erhalten.
```
Failed to retrieve manifest: ResourceNotFoundException: Could not find the latest version of package
arn:aws:ssm:::package/package-name status code: 400, request id: guid
```
**Ursache:** Sie verwenden eine SSM Agent-Version mit einer früheren Distributor-Version als Version 2.3.274.0.
**Lösung:** Aktualisieren Sie die SSM Agent-Version auf Version 2.3.274.0 oder höher. Für weitere Informationen siehe [Aktualisierung von SSM Agent mithilfe von Run Command](run-command-tutorial-update-software.md#rc-console-agentexample) oder [Exemplarische Vorgehensweise: Automatisches Update SSM Agent mit dem AWS CLI](state-manager-update-ssm-agent-cli.md).
## Fehler: Fehler beim Abrufen des Manifests: Validierungsausnahme
**Problem:** Sie haben eine Fehlermeldung wie die folgende erhalten.
```
Failed to retrieve manifest: ValidationException: 1 validation error detected: Value 'documentArn'
at 'packageName' failed to satisfy constraint: Member must satisfy regular expression pattern:
arn:aws:ssm:region-id:account-id:package/package-name
```
**Ursache:** Sie verwenden eine SSM Agent-Version mit einer früheren Distributor-Version als Version 2.3.274.0.
**Lösung:** Aktualisieren Sie die SSM Agent-Version auf Version 2.3.274.0 oder höher. Für weitere Informationen siehe [Aktualisierung von SSM Agent mithilfe von Run Command](run-command-tutorial-update-software.md#rc-console-agentexample) oder [Exemplarische Vorgehensweise: Automatisches Update SSM Agent mit dem AWS CLI](state-manager-update-ssm-agent-cli.md).
## Paket wird nicht unterstützt (dem Paket fehlt Installationsaktion)
**Problem:** Sie haben eine Fehlermeldung wie die folgende erhalten.
```
Package is not supported (package is missing install action)
```
**Ursache:** Die Paketverzeichnisstruktur ist falsch.
**Lösung:** Zipen Sie kein übergeordnetes Verzeichnis, das die Software und die erforderlichen Skripte enthält. Erstellen Sie stattdessen eine `.zip`-Datei aller erforderlichen Inhalte direkt im absoluten Pfad. Um zu überprüfen, ob die`.zip`-Datei korrekt erstellt wurde, entpacken Sie das Zielplattformverzeichnis und überprüfen Sie die Verzeichnisstruktur. Der absolute Pfad für das Installationsskript sollte beispielsweise `/ExamplePackage_targetPlatform/install.sh` sein.
## Fehler: Manifest konnte nicht heruntergeladen werden: Dokument mit dem Namen ist nicht vorhanden
**Problem:** Sie haben eine Fehlermeldung wie die folgende erhalten.
```
Failed to download manifest - failed to retrieve package document description: InvalidDocument: Document with name filename does not exist.
```
**Ursache 1:** Distributor kann das Paket nicht anhand des Paketnamens finden, wenn ein Distributor-Paket von einem anderen Konto geteilt wird.
**Lösung 1:** Wenn Sie ein Paket von einem anderen Konto freigeben, verwenden Sie den vollständigen Amazon-Ressourcennamen (ARN) für das Paket und nicht nur den Namen.
**Ursache 2:** Wenn Sie eine VPC verwenden, haben Sie Ihrem IAM-Instanzprofil keinen Zugriff auf den AWS verwalteten S3-Bucket gewährt, der das Dokument `AWS-ConfigureAWSPackage` für das enthält, auf das AWS-Region Sie abzielen.
**Lösung 2:** Stellen Sie sicher, dass Ihr IAM-Instanzprofil Zugriff auf den AWS verwalteten S3-Bucket bietetSSM Agent, der das Dokument `AWS-ConfigureAWSPackage` für das, auf das AWS-Region Sie abzielen, enthält, wie unter erklärt. [SSM AgentKommunikation mit AWS verwalteten S3-Buckets](ssm-agent-technical-details.md#ssm-agent-minimum-s3-permissions)
## Hochladen fehlgeschlagen.
**Problem:** Sie haben eine Fehlermeldung wie die folgende erhalten.
```
Upload failed. At least one of your files was not successfully uploaded to your S3 bucket.
```
**Ursache:** Der Name Ihres Softwarepakets enthält ein Leerzeichen. Zum Beispiel würde bei `Hello World.msi` der Upload fehlschlagen.
## Fehler: Failed to find platform: no manifest found for platform: oracle, version 8.9, architecture x86\$164
**Problem:** Sie haben eine Fehlermeldung wie die folgende erhalten.
```
Failed to find platform: no manifest found for platform: oracle, version 8.9, architecture x86_64
```
**Ursache:** Der Fehler bedeutet, dass das JSON-Paketmanifest keine Definition für diese Plattform hat, in diesem Fall Oracle Linux.
**Lösung:** Laden Sie das Paket, das Sie verteilen möchten, von der [Trend Micro Deep Security Software](https://help.deepsecurity.trendmicro.com/software.html)-Website herunter. Erstellen Sie ein `.rpm`-Softwarepaket mit dem [Erstellen Sie ein Paket mithilfe des einfachen Workflows](distributor-working-with-packages-create.md#distributor-working-with-packages-create-simple). Legen Sie die folgenden Werte für das Paket fest und schließen Sie das Upload-Softwarepaket mithilfe von Distributor ab:
```
Platform version: _any
Target platform: oracle
Architecture: x86_64
```