Erstellen eines Pakets in Distributor

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

Wählen Sie im Navigationsbereich Distributor aus.

Wählen Sie auf der Distributor-Startseite die Option Create package (Paket erstellen) aus und wählen Sie dann die Option Simple (Einfach).

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.

(Optional) Geben Sie unter Version name (Versionsname) einen Versionsnamen ein. Versionsnamen dürfen maximal 512 Zeichen lang sein und dürfen keine Sonderzeichen enthalten.

Wählen Sie unter Location (Speicherort) einen Bucket aus. Verwenden Sie dazu den Namen und das Präfix des Buckets oder die Bucket-URL.

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.

Ü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 im Simple-Workflow einige Standardeinstellungen ändern, um als Zielplattform für die Software Amazon Linux- und Ubuntu-Betriebssysteme anzugeben. Führen Sie bei Verwendung mehrerer Zielplattformen einen der folgenden Schritte aus.

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 zur Angabe der Betriebssystem-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 Prozessorarchitekturen finden Sie unter Unterstützte Paketplattformen und -architekturen.

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

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

Zum Hinzufügen weiterer installierbaren Softwaredateien 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-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.

Wählen Sie Create package (Paket erstellen) aus.

Fügen Sie Ihrem Manifest die Schemaversion hinzu. In dieser Version ist die Schemaversion stets 2.0.

{ "schemaVersion": "2.0",

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",

(Optional) Fügen Sie den Namen des Publishers hinzu. Im Folgenden wird ein Beispiel gezeigt.

"publisher": "MyOrganization",

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.

Beim Wert in Plattformversion kann es sich um den Platzhalterwert _any handeln. 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.*. Wenn Sie einen Wert für Plattformversion für eine bestimmte Betriebssystemversion angeben, stellen Sie sicher, dass er genau mit der Version des Betriebssystem-AMI übereinstimmt, auf das Sie abzielen. Im Folgenden werden Ressourcen empfohlen, mit denen Sie den richtigen Wert für das Betriebssystem ermitteln können.

"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 2016.09 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": {
        "2016.09": {
            "_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 Ihre ZIP-Datei beispielsweise sowohl Red Hat Enterprise Linux 7.x Versionen als auch Amazon Linux unterstützt, enthält sie wie im folgenden Beispiel gezeigt im Abschnitt "packages" zwei Einträge, die auf dieselbe ZIP-Datei verweisen.

{
    "amazon": {
        "2018.03": {
            "x86_64": {
                "file": "test.zip"
            }
        }
    },
    "redhat": {
        "7.*": {
            "x86_64": {
                "file": "test.zip"
            }
        }
    }
},

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. In Windows führen Sie das Cmdlet Get-FileHash -Path path-to-.zip-file in PowerShell aus.

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-rhel5-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-rhel5-x86.rpm.zip": {
            "checksums": {
                "sha256": "EXAMPLE13df60aa3219bf117638167e5bae0a55467e947a363fff0a51EXAMPLE"
            }
        },
        "test-agent-rhel5-x86_64.rpm.zip": {
            "checksums": {
                "sha256": "EXAMPLE7ce8a2c471a23b5c90761a180fd157ec0469e12ed38a7094d1EXAMPLE"
            }
        }
    }

Nachdem Sie die Paketinformationen hinzugefügt haben, speichern und schließen Sie die Manifestdatei.

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.

Erstellen Sie einen Bucket, oder wählen Sie einen vorhandenen Bucket aus. Weitere Informationen finden Sie unter Create a Bucket (Bucket erstellen) im Amazon Simple Storage Service Getting Started Guide (Amazon Simple Storage Service Erste-Schritte-Leitfaden). Weitere Informationen zum Ausführen eines AWS CLI-Befehls zum Erstellen eines Buckets finden Sie unter mb in der AWS CLI-Befehlsreferenz.

Laden Sie den Ordner oder das Verzeichnis zum Bucket hoch. Anleitungen finden Sie unter Hinzufügen eines Objekts zu einem Bucket im Erste Schritte-Handbuch zu Amazon Simple Storage Service. Wenn Sie das JSON-Manifest in die AWS Systems Manager-Konsole einfügen werden, dürfen Sie das Manifest nicht hochladen. Weitere Informationen zum Ausführen eines AWS CLI-Befehls zum Hochladen von Dateien zu einem Bucket finden Sie unter mv in der AWS CLI-Befehlsreferenz.

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.

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

Wählen Sie im Navigationsbereich Distributor aus.

Wählenen Sie auf der Distributor-Startseite die Option Create package (Paket erstellen) und klicken Sie dann auf Advanced (Erweitert).

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.

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

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 hochgeladen haben.

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.

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.

Wenn das Manifest fertiggestellt ist, wählen Sie Create package (Paket erstellen).

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

Um mit AWS CLI ein Paket zu erstellen, führen Sie den folgenden Befehl aus und ersetzen Sie dabei package-name 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

Überprüfen Sie, ob Ihr Paket hinzugefügt wurde. Zeigen Sie hierzu das Paketmanifest an, indem Sie den folgenden Befehl ausführen, wobei Sie package-name durch den Namen Ihres Pakets ersetzen. 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"