Bereitstellungspaket erstellen

Mit Sammlungen den Überblick behalten Sie können Inhalte basierend auf Ihren Einstellungen speichern und kategorisieren.

Auf dieser Seite wird beschrieben, wie Sie ein Bereitstellungspaket für Ihr VM-Produkt erstellen. Sie müssen das Bereitstellungspaket erstellen und einreichen, um Ihr Produkt bei Google Cloud Marketplace zu veröffentlichen.

Eine Bereitstellung besteht aus einer Reihe von Ressourcen, die zusammen erstellt und verwaltet werden, z. B. die für Ihr Produkt erforderlichen Ressourcen. Ein Bereitstellungspaket ist eine Spezifikation für eine Reihe von Ressourcen, die normalerweise zusammen bereitgestellt werden, wodurch der Prozess der Bereitstellung dieses bestimmten Produkts optimiert wird.

In dieser Anleitung verwenden Sie Deployment Manager, um Ihr Bereitstellungspaket zu erstellen. Mit Deployment Manager können Sie Bereitstellungspakete für Ihre VM-Produkte mit einfachen YAML-, JSON- oder ProtoText-Konfigurationsdateien erstellen.

Festlegen, wie Ihr Bereitstellungspaket erstellt wird

Wir empfehlen, die Bereitstellungsoption für das Producer Portal zu verwenden, um Ihr Bereitstellungspaket direkt in der Google Cloud Console zu erstellen.

Die interaktive Konfiguration unterstützt einfache VM-Produkte, z. B. einzelne VM-Bereitstellungen mit grundlegenden Firewallregeln, aber unterstützt keine komplexen Funktionen wie Bereitstellungen mit mehreren VMs und benutzerdefinierten Konfigurationsfeldern. Wenn Sie Features benötigen, die von der geführten Konfiguration nicht unterstützt werden, können Sie das Open-Source-mpdev-Tool verwenden, um entweder Ihr Bereitstellungspaket zu erstellen oder ein vorhandenes Pakets anzupassen, indem Sie zusätzliche Funktionen hinzufügen.

Zwischen geführter und manueller Konfiguration wechseln

Wenn Sie die Option der geführten Konfiguration von Producer Portal verwenden und später zum manuellen Konfigurieren Ihres Bereitstellungspakets wechseln möchten, können Sie auf ZUR MANUELLEN KONFIGURATION klicken, um zur manuellen Konfiguration zu wechseln.

Wenn Sie wechseln, können Sie die Autogen-Spezifikation für das Bereitstellungspaket herunterladen, die Sie bei der geführten Konfiguration erstellt haben, um sie als Grundlage für Ihre manuelle Konfiguration zu verwenden.

Hinweis

  1. Achten Sie darauf, dass Ihre Bereitstellung nicht Terraform verwendet oder Abhängigkeiten von Terraform hat.

  2. Wenn Sie das mpdev-Tool zum Erstellen Ihres Bereitstellungspakets verwenden, führen Sie die folgenden Schritte aus:

    1. Installieren Sie das mpdev-Tool mithilfe der Anleitung im Repository marketplace-tools.
    2. Laden Sie das Google Cloud SDK herunter.

Bereitstellungspaket erstellen und einreichen

Im folgenden Abschnitt wird erläutert, wie Sie Ihr Bereitstellungspaket erstellen und das Paket zur Prüfung an Google senden.

Erstellen Sie das Bereitstellungspaket mit einer der folgenden Methoden:

Bereitstellungspaket mithilfe der Google Cloud Console erstellen

So erstellen und reichen Sie mit der Google Cloud Console ein einfaches Bereitstellungspaket ein:

  1. Wechseln Sie in Producer Portal zum Abschnitt Bereitstellungspaket.

  2. Wählen Sie die interaktive Konfiguration für einfache Lösungen aus und klicken Sie auf WEITER.

  3. Klicken Sie im Abschnitt Autogen-Spezifikation konfigurieren neben dem Eingabefeld mit der Bezeichnung Cloud Storage-Bucket auf SUCHEN.

    Wenn Sie bereits einen Cloud Storage-Bucket erstellt haben, wählen Sie ihn hier aus.

    Wenn Sie keinen Cloud Storage-Bucket haben, klicken Sie auf das Symbol Neuen Bucket erstellen. Wenn Sie einen neuen Bucket erstellen, geschieht Folgendes:

    • Sie wählen einen Namen für den Bucket aus.
    • Sie geben an, in welchen Regionen die Daten im Bucket gespeichert werden.
    • Sie geben die Speicherklasse für Ihre Daten an.
    • Legen Sie den Detaillierungsgrad fest, der auf die IAM-Berechtigungen (Identity and Access Management) für die Daten des Buckets angewendet werden soll.
    • Konfigurieren Sie optionale erweiterte Einstellungen wie Verschlüsselung oder Datenaufbewahrungsrichtlinien.
  4. Achten Sie darauf, dass die Objektversionsverwaltung für Ihren Cloud Storage-Bucket aktiviert ist.

  5. Klicken Sie auf KONFIGURIEREN, um die Bucket-Einstellungen zu speichern und mit der Konfiguration des Bereitstellungspakets zu beginnen.

  6. Wählen Sie unter Image des Produkts auswählen das VM-Image aus.

    Das ausgewählte VM-Image muss:

    • Mit Ihrem aktuellen Google Cloud-Projekt verknüpft sein.

    • An die richtige Lizenz für Ihr Produkt angehängt sein. Sie erstellen diese Lizenz und hängen sie an, wenn Sie Ihr VM-Image erstellen.

  7. Unter Maschinentyp auswählen müssen Sie für Ihr VM-Produkt eine Standardzone, einen Mindestmaschinentyp und einen Standardmaschinentyp sowie die Größe und den Typ des Bootlaufwerks angeben.

  8. Unter Betriebssystem angeben müssen Sie den Namen und die Version des Betriebssystems, das Ihr VM-Image verwendet, sowie die Versionsnummer des VM-Images angeben.

  9. Optional können Sie unter VM-Zugriff einrichten Website- und Administrator-URLs sowie einen Nutzernamen und ein Passwort angeben, mit denen Nutzer nach der Bereitstellung auf die VM zugreifen können.

  10. Optional können Sie unter Netzwerk konfigurieren Einstellungen für die IP-Weiterleitung angeben und Firewallregeln konfigurieren.

  11. Unter Nächste Schritte definieren können Sie optional eine Anleitung für die Nutzer Ihres Produkts bereitstellen, um ihnen die ersten Schritte mit Ihrem Produkt zu zeigen. Diese Anleitung ist für sie nach der Bereitstellung des Produkts sichtbar.

  12. Klicken Sie nach Abschluss der vorherigen Schritte auf GENERIEREN, um Ihr Bereitstellungspaket zu erstellen.

    Wenn Sie später weitere Änderungen an Ihrem Bereitstellungspaket vornehmen möchten, können Sie auf BEARBEITEN klicken, um Änderungen vorzunehmen, und dann auf GENERIEREN, um Ihr Bereitstellungspaket mit diesen Änderungen neu zu generieren.

    Wenn Sie zur manuellen Konfiguration wechseln möchten, können Sie auf HERUNTERLADEN klicken, um die Autogen-Spezifikation für das Bereitstellungspaket herunterzuladen, das Sie in der geführten Konfiguration erstellt haben. Es kann dann als Grundlage für Ihre manuelle Konfiguration verwendet werden.

  13. Reichen Sie das Bereitstellungspaket zur Überprüfung im Producer Portal ein. Nachdem Sie das Paket eingereicht haben, kann es bis zu zwei Wochen dauern, bis Google es überprüft und genehmigt hat.

Bereitstellungspaket mit mpdev erstellen

In diesem Abschnitt wird erläutert, wie Sie mit dem mpdev-Tool ein Bereitstellungspaket erstellen und das Paket zur Überprüfung einreichen.

Das mpdev-Tool verwendet Autogen von Deployment Manager, um die Deployment Manager-Vorlagen für Ihr Bereitstellungspaket zu generieren. Das Tool generiert das Bereitstellungspaket anhand einer Autogen-Spezifikation, die die Konfigurationseingaben für Ihr VM-Produkt enthält.

Auf übergeordneter Ebene müssen Sie Folgendes tun, um Ihr Bereitstellungspaket zu generieren und zu senden:

  1. Erstellen und konfigurieren Sie einen Cloud Storage-Bucket, um den Zugriff auf das Bereitstellungspaket zu speichern und zu verwalten.
  2. Erstellen Sie eine Autogen-Spezifikation, die die Image-Details und Bereitstellungsanforderungen für Ihr VM-Produkt enthält.
  3. Generieren Sie das Bereitstellungspaket anhand Ihrer Autogen-Spezifikation und laden Sie das Paket in den Cloud Storage-Bucket hoch.
  4. Reichen Sie das Bereitstellungspaket zur Überprüfung in Producer Portal ein. Nachdem Sie das Paket gesendet haben, kann es bis zu zwei Wochen dauern, bis Google das Paket überprüft und genehmigt hat.

In den folgenden Abschnitten wird erläutert, wie Sie die Schritte zum Generieren und Senden des Bereitstellungspakets ausführen.

Cloud Storage-Bucket erstellen

Sie müssen den Cloud Storage-Bucket im selben öffentlichen Google Cloud-Projekt erstellen, das Sie für Producer Portal verwenden, und den Bucket so konfigurieren:

  • Aktivieren Sie die Objektversionsverwaltung für den Bucket, um das Bereitstellungspaket vor dem Löschen oder Überschreiben zu schützen.
  • Weisen Sie cloud-commerce-marketplace-onboarding@twosync-src.google.com die Rolle Storage-Objekt-Betrachter (roles/storage.objectViewer) zu.

Führen Sie die folgenden gsutil-Befehle aus, um einen Cloud Storage-Bucket zu erstellen und zu konfigurieren:

  BUCKET_NAME=YOUR_BUCKET_NAME
  gsutil mb $BUCKET_NAME
  gsutil versioning set on gs://$BUCKET_NAME
  gsutil iam ch "group:cloud-commerce-marketplace-onboarding@twosync-src.google.com:objectViewer" $BUCKET_NAME
  

Dabei ist YOUR_BUCKET_NAME der Name, den Sie für den neuen Bucket angeben. Beachten Sie dabei die Benennungsanforderungen.

Autogen-Spezifikation erstellen

Zum Erstellen Ihrer Autogen-Spezifikation empfehlen wir die Verwendung von single VM example im Repository marketplace-tools als anfängliche Autogen-Spezifikation zu verwenden und die Spezifikation dann mit den Konfigurationsdetails Ihrer VM anzupassen.

Für komplexere Anwendungsfälle können Sie die automatische Vervollständigung in einigen integrierten Entwicklungsumgebungen (IDEs) einrichten, um configurations.yaml-Dateien zu bearbeiten und zu validieren.

So erstellen Sie Ihre Autogen-Spezifikation aus dem single VM example:

  1. Checken Sie die vorkonfigurierte Autogen-Spezifikation des Beispiels in ein lokales Verzeichnis aus:

    PACKAGE=YOUR_PACKAGE_NAME
    mpdev pkg get https://github.com/GoogleCloudPlatform/marketplace-tools.git/examples/deployment-manager/autogen/singlevm $PACKAGE
    

    Dabei ist YOUR_PACKAGE_NAME der Name, den Sie für das lokale Verzeichnis angeben. Beispiel: my-deployment-package.

  2. Aktualisieren Sie die Spezifikation mit den Konfigurationsdetails der VM. Ändern Sie dazu die Datei configurations.yaml mit den folgenden Informationen:

    • Name Ihres VM-Images.
    • ID für das öffentliche Google Cloud-Projekt, das Ihr VM-Image hostet. Dies ist dasselbe Projekt, das Sie für Producer Portal verwenden.

    Eine Anleitung zum Aktualisieren der VM-Images und Google Cloud-Projektfelder in der Datei configurations.yaml finden Sie in der Datei README.md des single VM example.

  3. Passen Sie gegebenenfalls weitere Felder für Ihr Produkt an, z. B. passwords, deployInput und postDeploy. Diese Felder befinden sich unter der DeploymentSpec in der Datei configurations.yaml. Weitere Informationen zu den verfügbaren Feldern finden Sie in der Autogen-Referenzdokumentation.

Bereitstellungspaket generieren

Nachdem Sie die Autogen-Spezifikation erstellt und angepasst haben, verwenden Sie die Spezifikation, um die Deployment Manager-Vorlagendateien für Ihr Bereitstellungspaket zu generieren. Zum Speichern des Pakets laden Sie es in den Cloud Storage-Bucket hoch.

So generieren Sie Ihr Bereitstellungspaket und laden es hoch:

  1. Legen Sie den Ausgabespeicherort für das Bereitstellungspaket in Ihrem Cloud Storage-Bucket fest:

    mpdev cfg set zipPath gs://BUCKET_NAME/OBJECT
    

    Wo BUCKET_NAME der Name des Buckets ist, den Sie für das Paket erstellt haben und OBJECT der Name, den Sie für das Cloud Storage-Objekt angegeben haben und der den Benennungsrichtlinien unterliegt.

  2. Generieren Sie das Bereitstellungspaket:

    mpdev apply -f $PACKAGE/configurations.yaml
    

Das generierte Bereitstellungspaket wird komprimiert und in Ihren Bucket hochgeladen.

Um zu überprüfen, ob die Vorlage ordnungsgemäß konfiguriert ist, können Sie mit dem folgenden Befehl eine Bereitstellung erstellen:

  TMPDIR=$(mktemp -d)
  unzip $PACKAGE/template.zip -d $TMPDIR
  gcloud deployment-manager deployments create $PACKAGE --config $TMPDIR/test_config.yaml
  

Bereitstellungspaket zur Überprüfung in Producer Portal einreichen

Wenn Sie das Producer Portal zum Erstellen Ihrer Cloud Marketplace-Produktliste verwenden, müssen Sie das Paket nach dem Erstellen des Bereitstellungspakets an das Producer Portal senden, damit das Cloud Marketplace-Team das Paket prüfen und genehmigen kann.

So senden Sie Ihr Bereitstellungspaket zur Überprüfung:

Geführter Konfiguration

  1. Wechseln Sie in Producer Portal zum Abschnitt Bereitstellungspaket.

  2. Klicken Sie auf SENDEN, um das Bereitstellungspaket zur Überprüfung in Producer Portal einzureichen. Nachdem Sie das Paket gesendet haben, kann es bis zu zwei Wochen dauern, bis Google das Paket überprüft und genehmigt hat.

Manuelle Konfiguration

  1. Öffnen Sie das Producer Portal in der Google Cloud Console:

    https://console.cloud.google.com/producer-portal?project=YOUR_PUBLIC_PROJECT_ID
    

    Ersetzen Sie YOUR_PUBLIC_PROJECT_ID durch die ID des öffentlichen Projekts, das Sie für Cloud Marketplace erstellt haben, z. B. my-organization-public.

  2. Klicken Sie in der Produktliste auf den Namen des Produkts.

  3. Gehen Sie auf der Seite Übersicht für Ihr Produkt zum Abschnitt Bereitstellungspaket und klicken Sie auf BEARBEITEN.

  4. Wählen Sie unter Speicherort für Cloud Storage-Objekt angeben das zuvor hochgeladene Objekt des Bereitstellungspakets aus.

  5. Klicken Sie auf VALIDIEREN. Die Validierung kann bis zu zwei Stunden dauern. Sie können den Bildschirm während der Verarbeitung verlassen.

  6. Nachdem Ihr Producer Portal Ihr Bereitstellungspaket erfolgreich gelesen hat, können Sie auf VORSCHAU BEREITSTELLEN klicken, um zu sehen, wie der Kunde Ihre VM-Konfiguration sieht.

  7. Klicken Sie nach Abschluss der Validierung auf SENDEN, um das Bereitstellungspaket zur Überprüfung einzureichen. Nachdem Sie das Paket gesendet haben, kann es bis zu zwei Wochen dauern, bis Google das Paket überprüft und genehmigt hat.

Bereitstellungspakete aus Kundensicht

In folgenden Abschnitten werden die Bildschirmlayouts angezeigt, die Ihre Kunden bei der Bereitstellung Ihres Produkts für Produkte sehen, die auf automatisch generierten Standardlösungspaketen basieren.

Kundenansicht der Bereitstellung eines Pakets

Die Standard-Kundeneingabeelemente werden auf der linken Seite des folgenden Screenshots angezeigt und beinhalten die Zone, den Maschinentyp, die Laufwerkoptionen und die Netzwerkoptionen.

Wenn für die Bereitstellung eines Kunden mehrere Netzwerkschnittstellenkarten erforderlich sind, können diese zusätzliche Netzwerkschnittstellen hinzufügen, indem sie auf Netzwerkschnittstelle hinzufügen klicken.

Zum Bereitstellen Ihres Produkts müssen Ihre Kunden die Eingabefelder ausfüllen und dann auf Bereitstellen klicken.

Kundenansicht eines bereitgestellten Pakets

Das folgende Bild zeigt, wie Ihr Produkt Ihren Kunden nach erfolgreicher Bereitstellung angezeigt wird.

Die Standard-Ausgabeelemente werden auf der rechten Seite des folgenden Screenshots angezeigt und enthalten die Website-Adresse, das temporäre Administratorpasswort und die Instanzinformationen.