Eine Version zu einer hinzufügen Distributor package

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

Wählen Sie im Navigationsbereich Distributor.

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

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

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.

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.

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

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.

Ü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 beispielsweise eine installierbare Softwaredatei mit dem Namen hochladenLogtool_v1.1.1.rpm, müssen Sie einige Standardeinstellungen im Simple Workflow ändern, um Anweisungen zu geben Distributor um dieselbe Software sowohl für Amazon Linux- als auch für Ubuntu-Betriebssysteme ins Visier zu nehmen. Um dieses Problem zu beheben, können Sie eine der folgenden Aktionen ausführen.

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 des JSON-Paketmanifests.

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.

(Optional) Erweitern Sie den Bereich Skripte und überprüfen Sie die Installations- und Deinstallationsskripts Distributor generiert für Ihre installierbare Software.

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.

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

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

Warte auf Distributor um den Upload Ihrer Software und die Erstellung der neuen Paketversion abzuschließen. Distributor zeigt den Upload-Status für jede installierbare Datei an. Je nach Anzahl und Größe der Pakete, die Sie hinzufügen, kann dies einige Minuten dauern. Distributor leitet Sie automatisch zur Seite mit den Paketdetails für das Package weiter. Sie können diese Seite jedoch auch selbst öffnen, nachdem die Software hochgeladen wurde. Auf der Seite mit den Paketdetails werden erst alle Informationen zu Ihrem Package angezeigt Distributor beendet die Erstellung der neuen Paketversion. Um den Uploadvorgang bzw. den prozess zur Erstellung der Paketversion anzuhalten, wählen Sie Stop upload (Upload anhalten).

Wenn Distributor kann keine der installierbaren Softwaredateien hochladen, es wird die Meldung Upload failed 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 Manager Distributor.

Wann Distributor ist mit der Erstellung der neuen Paketversion fertig. Sehen Sie sich auf der Detailseite des Pakets auf der Registerkarte 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.

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

Wählen Sie im Navigationsbereich Distributor.

Auf dem Distributor Wählen Sie auf der Startseite das Paket aus, zu dem Sie eine weitere Version hinzufügen möchten, und wählen Sie dann Version hinzufügen aus.

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

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.

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

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.

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

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.

Führen Sie den folgenden Befehl aus, um das AWS Systems Manager Dokument mit einem Eintrag für eine neue Paketversion zu bearbeiten. document-nameErsetzen Sie es durch den Namen Ihres Dokuments. amzn-s3-demo-bucketErsetzen Sie es durch die URL des JSON-Manifests, das Sie kopiert habenSchritt 3: Hochladen von Paket und Manifest zu einem Amazon S3-Bucket. S3-bucket-URL-of-packageist die URL des Amazon S3 S3-Buckets, in dem das gesamte Paket gespeichert ist. version-name-from-updated-manifestErsetzen 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

Führen Sie den folgenden Befehl aus, um zu überprüfen, ob Ihr Paket aktualisiert wurde, und das Paketmanifest anzuzeigen. package-nameErsetzen 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"