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.

Vorbereitung der Verwendung des Softwarepaket-Katalogs

Der folgende Abschnitt bietet einen Überblick über den Lebenszyklus der Paketversionen und Informationen zur Verwendung des AWS IoT Device Management Softwarepaketkatalogs.

Lebenszyklus der Paketversion

Eine Paketversion kann sich in den folgenden Lebenszyklusstatus weiterentwickeln: draft, published, und deprecated. Sie kann auch deleted sein.

Namenskonventionen für Paketversionen

Wenn Sie Paketversionen benennen, ist es wichtig, eine logische Benennungsstrategie zu planen und anzuwenden, damit Sie und andere leicht die neueste Paketversion und den Versionsverlauf erkennen können. Sie müssen bei der Erstellung der Paketversion einen Versionsnamen angeben, aber die Strategie und das Format hängen weitgehend von Ihrem Geschäftsszenario ab.

Als bewährte Methode empfehlen wir die Verwendung des Semantic SemVerVersioning-Formats. Zum Beispiel, 1.2.3 wo 1 die Hauptversion für funktionell inkompatible Änderungen ist, 2 die Hauptversion für funktionell kompatible Änderungen und 3 die Patch-Version (für Fehlerbehebungen) ist. Weitere Informationen finden Sie unter Semantic Versioning 2.0.0. Weitere Informationen zu den Anforderungen an die Paketversionsnamen finden Sie versionNameim AWS IoT API Referenzhandbuch.

Standardversion

Das Festlegen einer Version als Standard ist optional. Sie können Standard-Paketversionen hinzufügen oder entfernen. Sie können auch eine Paketversion bereitstellen, die nicht als Standardversion benannt ist.

Wenn Sie eine Paketversion erstellen, wird sie in einen draft Status versetzt und kann erst dann als Standardversion bezeichnet werden, wenn Sie die Paketversion auf veröffentlicht umstellen. Der Softwarepaket-Katalog wählt nicht automatisch eine Version als Standard aus oder aktualisiert eine neuere Paketversion als Standard. Sie müssen die gewählte Paketversion bewusst über die Konsole oder durch die Ausführung des UpdatePackageVersionAPIVorgangs benennen.

Versionsattribute

Versionsattribute und ihre Werte enthalten wichtige Informationen über Ihre Paketversionen. Wir empfehlen Ihnen, allgemeine Attribute für ein Paket oder eine Paketversion zu definieren. Sie können beispielsweise ein Name-Wert-Paar für Plattform, Architektur, Betriebssystem, Veröffentlichungsdatum, Autor oder Amazon S3 erstellen. URL

Wenn Sie einen AWS IoT Job mit einem Jobdokument erstellen, können Sie auch eine Substitutionsvariable ($parameter) verwenden, die auf den Wert eines Attributs verweist. Weitere Informationen finden Sie unter AWS IoT Jobs vorbereiten.

Versionsattribute, die in Paketversionen verwendet werden, werden nicht automatisch zum reservierten benannten Schatten hinzugefügt und können nicht direkt über Fleet Indexing indexiert oder abgefragt werden. Um Paketversionsattribute über Fleet Indexing zu indizieren oder abzufragen, können Sie das Versionsattribut im reservierten benannten Schatten auffüllen.

Wir empfehlen, dass der Versionsattributparameter im reservierten Schatten die vom Gerät gemeldeten Eigenschaften erfasst, z. B. das Betriebssystem und die Installationszeit. Sie können auch über Fleet Indexing indexiert und abgefragt werden.

Für Versionsattribute ist es nicht erforderlich, dass sie einer bestimmten Benennungskonvention entsprechen. Sie können Name-Wert-Paare erstellen, um Ihren Geschäftsanforderungen gerecht zu werden. Die Gesamtgröße aller Attribute in einer Paketversion ist auf 3 KB begrenzt. Weitere Informationen finden Sie unter Beschränkungen für Softwarepakete und Paketversionen im Softwarepaket-Katalog.

Alle Attribute in einem Jobdokument verwenden

Sie können festlegen, dass alle Attribute der Paketversion automatisch zu Ihrer Auftragsbereitstellung für ausgewählte Geräte hinzugefügt werden. Informationen zur automatischen programmgesteuerten Verwendung aller Paketversionsattribute in einem API CLI OR-Befehl finden Sie im folgenden Beispiel für ein Jobdokument:

"TestPackage": "${aws:iot:package:TestPackage:version:PackageVersion:attributes}"

Stückliste der Software

Die Softwareliste (SBOM) bietet eine zentrale Ablage für alle Aspekte Ihres Softwarepakets. Zusätzlich zum Speichern von Softwarepaketen und Paketversionen können Sie die Softwareliste (SBOM), die jeder Paketversion zugeordnet ist, im AWS IoT Device Management Softwarepaketkatalog speichern. Ein Softwarepaket enthält eine oder mehrere Paketversionen, und jede Paketversion besteht aus einer oder mehreren Komponenten. Jede dieser Komponenten, die die Zusammenstellung einer bestimmten Paketversion unterstützen, kann anhand einer Softwareliste beschrieben und katalogisiert werden. Die unterstützten Industriestandards für Softwarelisten sind SPDX CyclonedX. Wenn eine zum ersten Mal erstellt SBOM wird, wird sie anhand des Industriestandardformats SPDX und des CyclonedX-Industriestandards validiert. Weitere Informationen finden Sie SPDX unter System Package Data Exchange. Weitere Informationen zu CyclonedX finden Sie unter CyclonedX.

Die Softwareliste beschreibt alle Aspekte der Komponenten einer bestimmten Paketversion wie Paketinformationen, Dateiinformationen und andere relevante Metadaten. Das folgende Beispiel zeigt die Dokumentstruktur einer Software-Stückliste im folgenden SPDX Format:

Vorteile der Softwareliste

Einer der wichtigsten Vorteile beim Hinzufügen Ihrer Softwareliste für eine Paketversion zum Softwarepaketkatalog ist das Schwachstellenmanagement.

Verwaltung von Sicherheitslücken

Die Bewertung und Minderung Ihrer Anfälligkeit gegenüber offensichtlichen Sicherheitsrisiken in Softwarekomponenten ist nach wie vor von entscheidender Bedeutung für den Schutz der Integrität Ihrer Geräteflotte. Mit der zusätzlichen Softwareliste, die im Softwarepaketkatalog für jede Paketversion gespeichert ist, können Sie proaktiv Sicherheitslücken aufdecken, indem Sie anhand der Paketversion wissen, welche Geräte gefährdet sind, und Ihre eigene interne Schwachstellen-Management-Lösung SBOM verwenden. Sie können Fixes auf den betroffenen Geräten installieren und Ihre Geräteflotte schützen.

Aufbewahrung von Softwarelisten

Die Softwareliste (SBOM) für jede Softwarepaketversion wird mithilfe der Amazon S3 S3-Versionierungsfunktion in einem Amazon S3 S3-Bucket gespeichert. Der Amazon S3 S3-Bucket, in dem das gespeichert ist, SBOM muss sich in derselben Region befinden, in der die Paketversion erstellt wurde. Ein Amazon S3 S3-Bucket, der die Versionierungsfunktion verwendet, verwaltet mehrere Varianten eines Objekts in demselben Bucket. Weitere Informationen zur Verwendung der Versionierung in einem Amazon S3 S3-Bucket finden Sie unter Verwenden der Versionierung in Amazon S3 S3-Buckets.

Der spezifische Amazon S3 S3-Schlüssel und die Versions-ID für Ihren Bucket werden verwendet, um jede Version einer Softwareliste für eine Paketversion eindeutig zu identifizieren.

Richtlinie für Berechtigungen

Um als der angegebene Principal auf die im Amazon S3 S3-Bucket gespeicherten SBOM ZIP-Archivdateien zugreifen zu können, benötigen Sie eine ressourcenbasierte Berechtigungsrichtlinie. AWS IoT Im folgenden Beispiel finden Sie die richtige ressourcenbasierte Berechtigungsrichtlinie:

{
    "Version": "2012-10-17",
    "Statement": [
        {
            "Effect": "Allow",
            "Principal": {
                "Service": [
                    "iot.amazonaws.com"
                ]
            },
            "Action": "s3:*",
            "Resource": "arn:aws:s3:::bucketName/*"
        }
    ]
}

Weitere Informationen zu ressourcenbasierten Berechtigungsrichtlinien finden Sie unter Ressourcenbasierte AWS IoT -Richtlinien

Aktualisierung der SBOM

Sie können die Softwareliste so oft wie nötig aktualisieren, um Ihre Geräteflotte zu schützen und zu erweitern. Jedes Mal, wenn die Softwareliste in Ihrem Amazon S3 S3-Bucket aktualisiert wird, ändert sich die Versions-ID, der Softwarepaketkatalog wird über das Update informiert und Sie müssen den neuen Amazon S3 S3-Bucket URL der entsprechenden Paketversion zuordnen. Sie sehen die neue Versions-ID in der Spalte Amazon S3 S3-Objekt-Versions-ID auf der Paketversionsseite im AWS Management Console. Darüber hinaus können Sie den API Vorgang GetPackageVersion oder den CLI Befehl verwendenget-package-version, um die neue Versions-ID anzuzeigen.

Weitere Informationen zu Amazon S3 S3-Objektschlüsseln finden Sie unter Objektschlüsselnamen erstellen.

Aktivierung der AWS IoT Flottenindizierung

Um die AWS IoT Flottenindizierung mit dem Softwarepaketkatalog zu nutzen, legen Sie den reservierten benannten Schatten ($package) als Datenquelle für jedes Gerät fest, auf dem Sie indizieren und Metriken sammeln möchten. Weitere Informationen zu reservierten benannten Schatten finden Sie unterReservierter benannter Schatten.

Die Flottenindizierung bietet Unterstützung, sodass AWS IoT Dinge anhand dynamischer Dinggruppen gruppiert werden können, die nach der Version des Softwarepakets gefiltert werden. Mit der Flottenindizierung können beispielsweise Objekte identifiziert werden, für die eine bestimmte Paketversion installiert ist oder für die keine Paketversionen installiert sind oder die bestimmten Name-Wert-Paaren entsprechen. Schließlich bietet die Flottenindizierung standardmäßige und benutzerdefinierte Messwerte, anhand derer Sie sich einen Überblick über den Status Ihrer Geräteflotte verschaffen können. Weitere Informationen finden Sie unter Vorbereitung der Flottenindizierung.

Reservierter benannter Schatten

Der reservierte, benannte Schatten, $package, gibt den Status der auf dem Gerät installierten Softwarepakete und Paketversionen wieder. Die Flottenindizierung verwendet den reservierten benannten Schatten als Datenquelle, um Standard- und benutzerdefinierte Messwerte zu erstellen, mit denen Sie den Status Ihrer Flotte abfragen können. Weitere Informationen finden Sie unter Vorbereitung der Flottenindizierung

Ein reservierter benannter Schatten ähnelt einem benannten Schatten mit der Ausnahme, dass sein Name vordefiniert ist und Sie ihn nicht ändern können. Darüber hinaus aktualisiert sich der reservierte benannte Schatten nicht mit Metadaten und verwendet nur die Schlüsselwörter version und attributes.

Bei Aktualisierungsanfragen, die andere Stichwörter enthalten, wie z. B. description, wird unter dem rejected Thema eine Fehlermeldung angezeigt. Weitere Informationen finden Sie unter Geräteschatten-Fehlermeldungen.

Es kann erstellt werden, wenn Sie AWS IoT etwas über die Konsole erstellen, wenn ein AWS IoT Job erfolgreich abgeschlossen und der Shadow aktualisiert wurde und wenn Sie den UpdateThingShadowAPIVorgang ausführen. Weitere Informationen finden Sie UpdateThingShadowim AWS IoT Core Entwicklerhandbuch.

Struktur des $package Schattens

Der reservierte benannte Schatten enthält Folgendes:

{
    "state": {
        "reported": {
            "<packageName>": {
                "version": "",
                "attributes": {
                }
            }
        }
    },
    "version" : 1
    "timestamp" : 1672531201
}

Die Schatteneigenschaften werden mit den folgenden Informationen aktualisiert:

Weitere Informationen zum Format und Verhalten eines benannten Schattens finden Sie unter AWS-IoT-Device-Shadow-Service Reihenfolge der Nachrichten.

Löschen eines Softwarepakets und seiner Paketversionen

Führen Sie vor dem Löschen eines Softwarepakets die folgenen Schritte aus:

Solange es keine benannte Standardpaketversion gibt, können Sie die Konsole verwenden, um ein Softwarepaket zu löschen. Alle zugehörigen Paketversionen werden ebenfalls gelöscht. Wenn Sie einen API Aufruf zum Löschen von Softwarepaketen verwenden, müssen Sie zuerst die Paketversionen und dann das Softwarepaket löschen.