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.
# Erste Schritte mit dem Softwarepaket-Katalog
Sie können den AWS IoT Device Management Softwarepaketkatalog mithilfe der AWS-Managementkonsole AWS IoT Core API-Operationen und AWS Command Line Interface (AWS CLI) erstellen und verwalten.
**Anmerkung**
Die Aktivierung der AWS IoT Flottenindizierung ist eine Voraussetzung für die Verwendung des Softwarepaketkatalogs. Grundlegende Operationen wie das Erstellen einer Softwarepaketversion im AWS-Managementkonsole und das Verwenden des `CreatePackage` API-Befehls schlagen fehl, wenn die AWS IoT Flottenindizierung nicht aktiviert ist.
Weitere Informationen zur Verwendung der AWS IoT Flottenindizierung mit dem Softwarepaketkatalog finden Sie unter[Vorbereitung der Flottenindizierung](preparing-fleet-indexing.md).
**Verwenden der Konsole**
Um den zu verwenden AWS-Managementkonsole, melden Sie sich in Ihrem AWS Konto an und navigieren Sie zu [AWS IoT Core](https://console.aws.amazon.com/iot/home). Wählen Sie im Navigationsbereich **Softwarepakete** aus. In diesem Abschnitt können Sie dann Pakete und deren Versionen erstellen und verwalten.
**Verwenden von API- oder CLI-Operationen**
Sie können die AWS IoT Core API-Operationen verwenden, um Funktionen des Softwarepaketkatalogs zu erstellen und zu verwalten. Weitere Informationen finden Sie unter [AWS IoT API-Referenz AWS](https://docs.aws.amazon.com/iot/latest/apireference/) [SDKs und Toolkits](https://aws.amazon.com/developer/tools/). Die AWS CLI Befehle verwalten auch Ihren Katalog. Weitere Informationen finden Sie in der [AWS IoT CLI Befehlsreferenz](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/iot/index.html).
**Topics**
+ [Ein Softwarepaket und eine Paketversion erstellen](creating-package-and-version.md)
+ [Bereitstellen einer Paketversion über Jobs AWS IoT](deploying-package-version.md)
+ [Einer Sache eine Paketversion zuordnen AWS IoT](associating-package-version.md)
# Ein Softwarepaket und eine Paketversion erstellen
Sie können die folgenden Schritte verwenden, um ein Paket und eine erste Version über die AWS-Managementkonsole zu erstellen.
**So erstellen Sie ein Softwarepaket**
1. Loggen Sie sich in Ihr AWS Konto ein und navigieren Sie zur [AWS IoT Konsole](https://console.aws.amazon.com/iot/home).
1. Wählen Sie im Navigationsbereich **Softwarepakete** aus.
1. Wählen Sie auf der Seite **AWS IoT Softwarepaket** die Option **Paket erstellen** aus. Das Dialogfeld **Abhängigkeiten für die Paketverwaltung aktivieren** wird angezeigt.
1. Wählen Sie unter **Flottenindizierung** die Option **Gerätesoftwarepakete und Version hinzufügen** aus. Dies ist für den Softwarepaket-Katalog erforderlich und bietet Flottenindizierung und Kennzahlen zu Ihrer Flotte.
1. [Optional] Wenn Sie möchten, dass AWS IoT Jobs den reservierten benannten Shadow aktualisieren, wenn Jobs erfolgreich abgeschlossen wurden, wählen Sie **Shadows automatisch aus Jobs aktualisieren**. Wenn Sie nicht möchten, dass AWS IoT Jobs diese Aktualisierung vornehmen, lassen Sie dieses Kontrollkästchen deaktiviert.
1. [Optional] Um AWS IoT Jobs die Rechte zur Aktualisierung des reservierten benannten Shadows zu gewähren, **wählen Sie unter Rolle auswählen die Option Rolle** **erstellen** aus. Wenn Sie nicht möchten, dass AWS IoT Jobs diese Aktualisierung vornehmen, ist diese Rolle nicht erforderlich.
1. Erstellen oder wählen Sie eine Rolle aus.
1. Wenn Sie **keine Rolle für diesen Zweck haben**: Wenn das Dialogfeld **Rolle erstellen** angezeigt wird, geben Sie einen **Rollennamen** ein, und wählen Sie dann **Erstellen** aus.
1. Falls **Sie über eine Rolle für diesen Zweck verfügen**: Wählen Sie unter **Rolle auswählen** Ihre Rolle aus und stellen Sie dann sicher, dass das Kontrollkästchen **Richtlinie an IAM-Rolle anhängen** aktiviert ist.
1. Wählen Sie **Bestätigen** aus. Die Seite **Neues Paket erstellen** wird angezeigt.
1. Geben Sie unter **Paketdetails** einen **Paketnamen** ein.
1. Geben Sie unter **Paketbeschreibung** Informationen ein, die Ihnen helfen, dieses Paket zu identifizieren und zu verwalten.
1. [Optional] Mit Tags können Sie dieses Paket besser kategorisieren und verwalten. Um Tags hinzuzufügen, erweitern Sie **Tags**, wählen Sie Tag **hinzufügen** und geben Sie ein Schlüssel-Wert-Paar ein. Sie können bis zu 50 Tags eingeben. Weitere Informationen finden Sie unter [AWS IoT Ressourcen taggen](https://docs.aws.amazon.com/iot/latest/developerguide/tagging-iot.html).
**Um beim Erstellen eines neuen Pakets eine Paketversion hinzuzufügen**
1. Geben Sie unter **Erste Version** einen **Versionsnamen** ein.
Wir empfehlen, das [SemVer Format](https://semver.org/) (z. B.`1.0.0.0`) zu verwenden, um Ihre Paketversion eindeutig zu identifizieren. Sie können auch eine andere Formatierungsstrategie verwenden, die besser zu Ihrem Anwendungsfall passt. Weitere Informationen finden Sie unter [Lebenszyklus der Paketversion](preparing-to-use-software-package-catalog.md#package-version-lifecycle).
1. Geben Sie unter **Versionsbeschreibung** Informationen ein, anhand derer Sie diese Paketversion identifizieren und verwalten können.
**Anmerkung**
Das Kontrollkästchen **Standardversion** ist deaktiviert, da Paketversionen in einem bestimmten `draft` Status erstellt werden. Sie können der Standardversion einen Namen geben, nachdem Sie die Paketversion erstellt haben und wenn Sie den Status in ändern`published`. Weitere Informationen finden Sie unter [Lebenszyklus der Paketversion](preparing-to-use-software-package-catalog.md#package-version-lifecycle).
1. [Optional] Um Ihnen bei der Verwaltung dieser Version zu helfen oder Informationen an Ihre Geräte zu übermitteln, geben Sie ein oder mehrere Name-Wert-Paare für **Versionsattribute** ein. Wählen Sie für jedes Name-Wert-Paar, das Sie eingeben, die Option **Attribut hinzufügen** aus. Weitere Informationen finden Sie unter [Versionsattribute](preparing-to-use-software-package-catalog.md#version-attributes).
1. [Optional] Mit Tags können Sie dieses Paket besser kategorisieren und verwalten. Um Tags hinzuzufügen, erweitern Sie **Tags**, wählen Sie Tag **hinzufügen** und geben Sie ein Schlüssel-Wert-Paar ein. Sie können bis zu 50 Tags eingeben. Weitere Informationen finden Sie unter [AWS IoT Ressourcen taggen](https://docs.aws.amazon.com/iot/latest/developerguide/tagging-iot.html).
1. Wählen Sie **Weiter** aus.
**Ordnen Sie die Softwareliste einer Paketversion zu (optional)**
1. Wählen Sie unter **Schritt 3: Version SBOMs (optional)** im Fenster **SBOM-Konfigurationen** das Standard-SBOM-Dateiformat und den Validierungsmodus aus, mit denen Ihre Softwareliste validiert wird, bevor sie Ihrer Paketversion zugeordnet wird.
1. Geben **Sie im Fenster SBOM-Datei hinzufügen** den Amazon-Ressourcennamen (ARN) für Ihren versionierten Amazon S3-Bucket und das bevorzugte SBOM-Dateiformat ein, falls der Standardtyp nicht funktioniert.
**Anmerkung**
Sie können entweder eine einzelne SBOM-Datei oder eine einzelne ZIP-Datei mit mehreren Dateien hinzufügen, SBOMs wenn Sie mehr als eine Softwareliste für Ihre Paketversion haben.
1. Im Fenster **Hinzugefügte SBOM-Datei** können Sie die SBOM-Datei anzeigen, die Sie für Ihre Paketversion hinzugefügt haben.
1. Wählen Sie Paket und Version **erstellen** aus. Die Seite mit der Paketversion wird angezeigt, und Sie können den Validierungsstatus Ihrer SBOM-Datei im Fenster „SBOM-Datei **hinzugefügt**“ sehen. Der Anfangsstatus lautet, dass die `In progress` SBOM-Datei validiert wird.
**Anmerkung**
Der Validierungsstatus der SBOM-Datei ist`Invalid file`,,,,, `Not started``In progress`, und die Gründe für die `Validated (SPDX)` fehlgeschlagene `Validated (CycloneDX)` Überprüfung.
# Bereitstellen einer Paketversion über Jobs AWS IoT
Sie können die folgenden Schritte ausführen, um eine Paketversion über den AWS-Managementkonsole bereitzustellen.
**Voraussetzungen:**
Bevor Sie beginnen, führen Sie die folgenden Schritte aus:
+ AWS IoT Dinge registrieren bei AWS IoT Core. Anweisungen zum Hinzufügen Ihrer Geräte finden Sie AWS IoT Core unter [Ein Ding-Objekt erstellen](https://docs.aws.amazon.com/iot/latest/developerguide/create-iot-resources.html#create-aws-thing).
+ [Optional] Erstellen Sie eine AWS IoT Dinggruppe oder dynamische Dinggruppe für die Geräte, für die Sie die Paketversion bereitstellen werden. Anweisungen zum Erstellen einer Objektgruppe finden Sie unter [Erstellen einer statischen Objektgruppe](https://docs.aws.amazon.com/iot/latest/developerguide/thing-groups.html#create-thing-group). Anweisungen zum Erstellen einer dynamischen Objektgruppe finden Sie unter [Erstellen einer dynamischen Objektgruppe](https://docs.aws.amazon.com/iot/latest/developerguide/dynamic-thing-groups.html#create-dynamic-thing-group).
+ Erstellen Sie ein Softwarepaket und eine Paketversion. Weitere Informationen finden Sie unter [Ein Softwarepaket und eine Paketversion erstellen](creating-package-and-version.md).
+ Erstellen eines Auftragsdokuments. Weitere Informationen finden Sie unter [Vorbereiten des Auftragsdokuments und der Paketversion für die Bereitstellung](https://docs.aws.amazon.com/iot/latest/developerguide/preparing-jobs-for-service-package-catalog.html#preparing-to-deploy).
**Um einen AWS IoT Job bereitzustellen**
1. Wählen Sie auf der [AWS IoT Konsole](https://console.aws.amazon.com/iot/home) **Softwarepakete** aus.
1. Wählen Sie das Softwarepaket aus, das Sie bereitstellen möchten. Die Seite mit den **Details zum Softwarepaket** wird angezeigt.
1. Wählen Sie unter **Versionen** die Paketversion aus, die Sie bereitstellen möchten, und wählen Sie dann **Auftragsversion bereitstellen** aus.
1. Wenn Sie zum ersten Mal einen Auftrag über dieses Portal bereitstellen, wird ein Dialogfeld mit einer Beschreibung der Anforderungen angezeigt. Prüfen Sie die Informationen und wählen Sie **Bestätigen** aus.
1. Geben Sie einen Namen für die Bereitstellung ein, oder lassen Sie den automatisch generierten Namen im Feld **Name** stehen.
1. [Optional] Geben Sie im Feld **Beschreibung** eine Beschreibung ein, die den Zweck oder den Inhalt der Bereitstellung identifiziert, oder lassen Sie die automatisch generierten Informationen übrig.
**Hinweis:** Wir empfehlen, dass Sie in den Feldern Auftragsname und Beschreibung keine personenbezogenen Daten verwenden.
1. [Optional] Fügen Sie alle Tags hinzu, die mit diesem Auftrag verknüpft werden sollen.
1. Wählen Sie **Weiter** aus.
1. Wählen Sie unter **Auftragsziele** die Objekte oder Objektgruppen aus, die den Auftrag erhalten sollen.
1. Geben Sie im Feld **Auftragsdatei** die JSON-Datei des Auftragsdokuments an.
1. Öffnen Sie **Auftragsintegration mit dem Paketkatalogdienst**.
1. Wählen Sie die Pakete und Versionen aus, die in Ihrem Auftragsdokument angegeben sind.
**Anmerkung**
Sie müssen dieselben Pakete und Paketversionen auswählen, die im Auftragsdokument angegeben sind. Sie können mehr hinzufügen, aber der Auftrag gibt Anweisungen nur für die Pakete und Versionen aus, die im Auftragsdokument enthalten sind. Weitere Informationen finden Sie unter [Benennen der Pakete und Versionen bei der Bereitstellung](https://docs.aws.amazon.com/iot/latest/developerguide/preparing-jobs-for-service-package-catalog.html#naming-package-versions).
1. Wählen Sie **Weiter** aus.
1. Wählen Sie auf der Seite Auftragskonfiguration im Dialogfeld Auftragskonfiguration einen der folgenden Auftragstypen aus:
+ **Snapshot-Auftrag:** Ein Snapshot-Auftrag ist abgeschlossen, wenn er abgeschlossen ist. Er wird auf den Zielgeräten und -gruppen ausgeführt.
+ **Kontinuierlicher Auftrag:** Ein kontinuierlicher Auftrag gilt für Objektgruppen und wird auf jedem Gerät ausgeführt, das Sie später zu einer bestimmten Zielgruppe hinzufügen.
1. Überprüfen Sie im Dialogfeld **Zusätzliche Konfigurationen — optional** die folgenden optionalen Auftragskonfigurationen und treffen Sie Ihre Auswahl entsprechend. Weitere Informationen finden Sie unter Konfigurationen für [Auftrags-Rollout, Planung und Abbruch sowie Konfigurationen](https://docs.aws.amazon.com/iot/latest/developerguide/jobs-configurations-details.html#job-rollout-abort-scheduling) für [Timeout und Wiederholungsversuche bei der Auftragsausführung](https://docs.aws.amazon.com/iot/latest/developerguide/jobs-configurations-details.html#job-timeout-retry).
+ Konfiguration des Rollouts
+ Konfiguration des Zeitplans
+ Konfiguration des Timeouts für Auftragsausführungen
+ Auftragsausführungen: Konfiguration wiederholen
+ Abbruch der Konfiguration
1. Überprüfen Sie die Auftragsauswahl und klicken Sie dann auf **Absenden.**
Nachdem Sie den Auftrag erstellt haben, generiert die Konsole eine JSON-Signatur und setzt sie in Ihr Auftragsdokument. Sie können die AWS IoT Konsole verwenden, um den Status eines Jobs anzuzeigen oder einen Job abzubrechen oder zu löschen. Gehen Sie zum [Auftrags-Hub der Konsole](https://console.aws.amazon.com/iot/home#/jobhub), um Aufträge zu verwalten.
# Einer Sache eine Paketversion zuordnen AWS IoT
Nachdem Sie Software auf Ihrem Gerät installiert haben, können Sie dem reservierten Shadow einer AWS IoT Sache eine Paketversion zuordnen. Wenn AWS IoT Jobs so konfiguriert wurden, dass der reservierte Named Shadow des Dings aktualisiert wird, nachdem der Job bereitgestellt und erfolgreich abgeschlossen wurde, müssen Sie dieses Verfahren nicht abschließen. Weitere Informationen finden Sie unter [Reservierter benannter Schatten](preparing-to-use-software-package-catalog.md#reserved-named-shadow).
**Voraussetzungen:**
Bevor Sie beginnen, führen Sie die folgenden Schritte aus:
+ Erstellen Sie ein oder AWS IoT mehrere Dinge und richten Sie die Telemetrie mithilfe von ein. AWS IoT Core Weitere Informationen finden Sie unter [Erste Schritte mit AWS IoT Core](https://docs.aws.amazon.com/iot/latest/developerguide/iot-gs.html).
+ Erstellen Sie ein Softwarepaket und eine Paketversion. Weitere Informationen finden Sie unter [Ein Softwarepaket und eine Paketversion erstellen](creating-package-and-version.md).
+ Installieren Sie die Software der Paketversion auf dem Gerät.
**Anmerkung**
Durch das Zuordnen einer Paketversion zu AWS IoT einem Objekt wird keine Software auf dem physischen Gerät aktualisiert oder installiert. Die Paketversion muss auf dem Gerät bereitgestellt werden.
**Um einer Sache eine Paketversion zuzuordnen AWS IoT**
1. Erweitern Sie im Navigationsbereich der [AWS IoT -Konsole](https://console.aws.amazon.com/iot/home) das Menü **Alle Geräte** und wählen Sie **Objekte** aus.
1. Identifizieren Sie das AWS IoT Ding, das Sie aktualisieren möchten, aus der Liste und wählen Sie den Namen des Dings aus, um die zugehörige Detailseite anzuzeigen.
1. Wählen Sie im Abschnitt **Details** die Option **Pakete und Versionen** aus.
1. Wählen Sie **Zu Paket und Version hinzufügen**.
1. Wählen Sie unter **Gerätepaket auswählen** das gewünschte Softwarepaket aus.
1. Wählen Sie unter **Version auswählen** die gewünschte Softwareversion aus.
1. Wählen Sie **Gerätepaket hinzufügen**.
Das Paket und die Version werden in der Liste **Ausgewählte Pakete und Versionen** angezeigt.
1. Wiederholen Sie diese Schritte für jedes Paket und jede Version, die Sie diesem Objekt zuordnen möchten.
1. Wenn Sie fertig sind, wählen Sie **Paket- und Versionsdetails hinzufügen**. Die Seite mit den **Objektdetails** wird geöffnet, und Sie können das neue Paket und die neue Version in der Liste sehen.