Hinzufügen einer Paketversion zu Distributor - AWS Systems Manager
Hinzufügen einer Paketversion (Konsole)Hinzufügen einer Paketversion (AWS CLI)

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.

Hinzufügen einer Paketversion zu Distributor

Um eine Paketversion hinzuzufügen, erstellen Sie ein Paket und verwenden Sie dann, Distributor um eine Paketversion hinzuzufügen, indem Sie dem Dokument AWS Systems Manager (SSM) einen Eintrag hinzufügen, der bereits für ältere Versionen vorhanden ist. Distributorist eine Fähigkeit von 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 aber am Ende einen Bucket URL mit einem anderen Dateinamen haben. 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.

Hinzufügen einer Paketversion (Konsole)

Führen Sie vor der Ausführung der folgenden Schritte die Anweisungen unter Erstellen eines Pakets 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 (einfach)

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. Der vereinfachte Workflow „Version hinzufügen“ in der Distributor Konsole aktualisiert die Manifestdatei und SSM das zugehörige Dokument für Sie.

So fügen Sie eine Paketversion hinzu (einfacher Workflow)

  1. Öffnen Sie die AWS Systems Manager Konsole unter https://console.aws.amazon.com/systems-manager/.

  2. Wählen Sie im Navigationsbereich Distributor aus.

  3. Wählen Sie auf der Distributor-Startseite das Paket aus, dem Sie eine weitere Version hinzufügen möchten.

  4. Wählen Sie auf der Seite Add version (Version hinzufügen) die Option Simple (Einfach).

  5. 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.

  6. 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.

  7. Geben Sie unter S3 key prefix (S3-Schlüsselpräfix) den Unterordner des Buckets ein, in dem Ihre installierbaren Komponenten gespeichert sind.

  8. 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.

  9. Ü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 Simple-Workflow ändern, um Distributor anzuweisen, für dieselbe Software sowohl das Amazon Linux- als auch das Ubuntu-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 (erweitert).

    • 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 Sie das Paketmanifest JSON.

  10. Stellen Sie unter Platform version (Plattformversion)sicher, dass als Betriebssystem-Plattformversion _any, eine Hauptversionsnummer, gefolgt von einem Platzhalter (7.*), angezeigt wird, oder genau die spezifische Betriebssystemversion, die Sie als Plattformversion für Ihre Softwareinstallation verwenden möchten. Weitere Informationen zum Festlegen einer Plattformversion finden Sie unter Schritt 4 in Schritt 2: Erstellen Sie das Paketmanifest JSON.

  11. 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.

  12. (Optional) Erweitern Sie Scripts (Skripts) und überprüfen Sie die Installations- und Deinstallationsskripts, die Distributor für Ihre installierbare Software generiert hat.

  13. 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.

  14. (Optional) Erweitern Sie Manifest und überprüfen Sie das JSON Paketmanifest, das für Ihre installierbare Software Distributor generiert wird. 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 Sie das Paketmanifest JSON.

  15. 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).

  16. 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).

  17. 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 Fehlerbehebung für AWS Systems ManagerDistributor.

  18. 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 (erweitert)

Um eine Paketversion hinzuzufügen, erstellen Sie ein Paket und verwenden Sie dann, Distributor um eine Paketversion hinzuzufügen, indem Sie dem SSM Dokument einen Eintrag hinzufügen, der für ältere Versionen vorhanden ist. 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.

So fügen Sie eine Paketversion hinzu (erweitert)

  1. Öffnen Sie die AWS Systems Manager Konsole unter https://console.aws.amazon.com/systems-manager/.

  2. Wählen Sie im Navigationsbereich Distributor aus.

  3. Wählen Sie auf der Distributor-Startseite das Paket aus, dem Sie eine weitere Version hinzufügen möchten, an wählen Sie dann Add version (Version hinzufügen).

  4. Geben Sie unter Version name (Versionsname) den exakten Wert des Eintrags version Ihrer Manifestdatei ein.

  5. 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.

  6. Geben Sie unter S3 key prefix (S3-Schlüsselpräfix) den Unterordner des Buckets ein, in dem Ihre installierbaren Komponenten gespeichert sind.

  7. 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 Ihr überarbeitetes JSON Manifest nicht in den Amazon S3 S3-Bucket hochgeladen haben, in dem Sie Ihre ZIP-Dateien gespeichert haben, wählen Sie Neues Manifest. Sie können das gesamte Manifest verfassen oder in das JSON Editorfeld einfügen. Weitere Informationen zum Erstellen des JSON Manifests finden Sie unterSchritt 2: Erstellen Sie das Paketmanifest JSON.

  8. Wenn das Manifest fertiggestellt ist, wählen Sie Add package version (Paketversion hinzufügen).

  9. 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 (AWS CLI)

Sie können das 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.

So fügen Sie eine Paketversion hinzu (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. Ersetzen document-name mit dem Namen Ihres Dokuments. Ersetzen amzn-s3-demo-bucket mit dem URL des JSON Manifests, das Sie kopiert habenSchritt 3: Hochladen von Paket und Manifest zu einem Amazon S3-Bucket. S3-bucket-URL-of-package ist der URL des Amazon S3 S3-Buckets, in dem das gesamte Paket gespeichert ist. Ersetzen version-name-from-updated-manifest mit dem 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

  2. Führen Sie den folgenden Befehl aus, um zu überprüfen, ob Ihr Paket aktualisiert wurde, und das Paketmanifest anzuzeigen. Ersetzen package-name mit dem Namen Ihres Pakets und optional document-version mit der Versionsnummer des Dokuments (nicht identisch 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 update-documentim AWS Systems Manager Abschnitt der AWS CLI Befehlsreferenz.