Bereitstellungspaket erstellen

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 erstellen Sie mit Deployment Manager Ihr Bereitstellungspaket. Mit Deployment Manager können Sie Bereitstellungspakete für Ihre VM-Produkte mithilfe einfacher YAML-, JSON- oder ProtoText-Konfigurationsdateien erstellen.

Festlegen, wie Ihr Bereitstellungspaket erstellt wird

Producer Portal

Wir empfehlen die Verwendung der geführten Konfigurationsoption im Producer Portal, 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.

Partner-Portal

Wenn Ihr Produkt eine einfache Bereitstellung einer einzelnen VM-Instanz mit grundlegenden Firewallregeln ist, können Sie direkt in der Google Cloud Console ein einfaches Bereitstellungspaket erstellen.

Wenn Ihr Produkt eine komplexe Bereitstellung ist, verwenden Sie das Open-Source-mpdev-Tool, um Ihr Bereitstellungspaket mit zusätzlichen Funktionen zu erstellen und anzupassen.

In der folgenden Tabelle werden die Unterschiede zwischen einfachen und komplexen Bereitstellungen erläutert:

Deployment Beschreibung Das Paket erstellen
Praktisch Einzelne VM-Instanz mit grundlegenden Firewallregeln Google Cloud Console
Komplex Komplexe Bereitstellung, entweder mit einer oder mehreren VMs Für die Bereitstellung sind möglicherweise folgende Funktionen erforderlich:
  • Kontingentprüfungen für CPUs und GPUs, sodass Nutzer Ihres Produkts nicht bereitstellen können, wenn sie die Kontingentanforderungen überschreiten.
  • Dynamische Preisaktualisierungen auf der Seite Deployment Manager.
  • Unterstützung für gemeinsam genutzte Virtual Private Clouds (VPCs).
  • Unterstützung für VMs mit mehreren Netzwerkkarten.
  • Die Möglichkeit, Nutzer daran zu hindern, Maschinentypen, GPUs oder Subnetzwerke auszuwählen, die in der von ihnen ausgewählten Zone nicht verfügbar sind.
mpdev tool

Wenn Sie sich nicht sicher sind, welche Bereitstellungsoption für Ihr Produkt besser geeignet ist, wenden Sie sich an Ihren Google-Partnerentwickler.

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 mit der Google Cloud Console erstellen

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

Producer Portal

  1. Wechseln Sie in Producer Portal zum Abschnitt Bereitstellungspaket.

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

  3. Klicken Sie im Abschnitt Autogen-Spezifikation konfigurieren neben dem Eingabefeld 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.
    • Sie legen fest, welcher Detaillierungsgrad auf die IAM-Berechtigungen (Identity and Access Management) für die Daten des Buckets angewendet wird.
    • Sie konfigurieren optionale erweiterte Einstellungen wie Verschlüsselungs- oder Datenaufbewahrungsrichtlinien.
  4. Achten Sie darauf, dass die Objektversionsverwaltung für Ihren Cloud Storage-Bucket aktiviert ist.

  5. Klicken Sie auf KONFIGURIEREN, um Ihre Bucket-Einstellungen zu speichern und mit der Konfiguration Ihres 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 Folgendes angeben: Standardzone, Mindestmaschinentyp und Standardmaschinentyp für Ihr VM-Produkt zusammen mit der Größe und dem Typ des Bootlaufwerks.

  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. Optional können Sie unter Nächste Schritte definieren eine Anleitung für die Nutzer Ihres Produkts angeben, um sie durch den Einstieg in Ihr Produkt zu führen. Diese Anleitung ist für sie sichtbar, nachdem sie Ihr Produkt bereitgestellt haben.

  12. Nachdem Sie die vorherigen Schritte ausgeführt haben, klicken Sie auf ERSTELLEN, um Ihr Bereitstellungspaket zu erstellen.

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

    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 Anleitung erstellt haben, um es als Grundlage für Ihre manuelle Konfiguration zu verwenden.

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

Partner-Portal

  1. Gehen Sie zum Partner-Portal und wählen Sie Ihr Produkt aus der Liste der Produkte aus.
  2. Klicken Sie neben Bereitstellungspaket auf Bearbeiten.
  3. Wählen Sie Ein Paket generieren und klicken Sie dann auf Weiter.
  4. Wählen Sie Ihr VM-Image mithilfe der Dropdown-Listen Projekt und Image aus und klicken Sie dann auf Weiter.
  5. Wählen Sie Ihre Mindesteinstellungen für Maschinentyp und Standardmaschinentyp aus und klicken Sie dann auf Weiter.
  6. Fügen Sie alle nächsten Schritte nach der Bereitstellung hinzu, die Ihre Kunden ausführen sollten, und klicken Sie dann auf Weiter.
  7. Richten Sie Ihre Firewall-Regeln und ggf. andere Netzwerkoptionen ein und klicken Sie dann auf Weiter.
  8. Sie können eine Site oder eine Administrator-URL deklarieren. Wenn Ihr Produkt eine Anmeldung erfordert, können Sie Anmeldedaten festlegen, wenn Sie Ihre Lösung einreichen. Klicken Sie auf Weiter.
  9. Wählen Sie unter Paketinhalt auflisten den Betriebssystemnamen und die Betriebssystemversion des Betriebssystems Ihres VM-Images aus. Sie können dann für jede zusätzliche Software, die als Teil Ihres Produkts enthalten ist, einen Namen und eine Version hinzufügen. Wenn Sie den gesamten Inhalt Ihres Pakets aufgelistet haben, klicken Sie auf Weiter.
  10. Nach Abschluss der vorherigen Schritte wird Ihr Lösungspaket unter Überprüfen angezeigt. Sie können das Lösungspaket herunterladen oder auf JSON bearbeiten klicken, um es manuell zu ändern. Klicken Sie auf Speichern, um das Paket zu speichern und zu Ihrer Lösung zurückzukehren.

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.

Gehen Sie zum Erstellen Ihres Bereitstellungspakets mit mpdev folgendermaßen vor, je nachdem, ob Sie Ihr Produkt mit Producer Portal oder dem Partner-Portal in Google Cloud Marketplace einbinden:

Producer Portal

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 zu verhindern, dass das Bereitstellungspaket gelöscht oder überschrieben wird.
  • 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

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

  2. 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 zum Generieren der Deployment Manager-Vorlagendateien für Ihr Bereitstellungspaket. 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

Partner-Portal

Autogen-Spezifikation erstellen

Es empfiehlt sich, die anfängliche Autogen-Spezifikation zu erstellen. Dazu verwenden Sie single VM example im Repository marketplace-tools. Führen Sie den folgenden Befehl aus, um Ihre Spezifikation über single VM example zu erstellen:

mpdev pkg get https://github.com/GoogleCloudPlatform/marketplace-tools.git/examples/deployment-manager/autogen/singlevm MY_PACKAGE

Führen Sie die nächsten Schritte aus, die in der Datei README.md des heruntergeladenen Beispiels beschrieben sind. Diese Schritte umfassen das Bearbeiten von Feldern in der Datei configurations.yaml, die für Ihr Produkt spezifisch sind. Führen Sie mpdev apply für die von Ihnen bearbeitete mpdev-Konfiguration aus, um Ihr Deployment Manager-Paket zu generieren.

Eine ausführliche Dokumentation der Felder unter DeploymentSpec in configurations.yaml finden Sie in der Dokumentation zur Autogen-Referenz.

Weitere Beispielkonfigurationen finden Sie auch im Ordner examples.

Anmeldedaten für die Autorisierung erstellen

Sie können mehrere passwords in DeploymentSpec in configurations.yaml angeben. Sie können Passwörter vom Instanzmetadatenserver abrufen und in der Schnittstelle nach der Bereitstellung anzeigen.

Bereitstellungspaket generieren

Mit dem folgenden Beispielbefehl wird die Spezifikation in MY_PACKAGE/configurations.yaml gelesen und eine ZIP-Datei an den in MY_PACKAGE/configurations.yaml angegebenen Speicherort ausgegeben:

mpdev apply -f MY_PACKAGE/configurations.yaml

Folgen Sie dieser Anleitung, nachdem Sie das Bereitstellungspaket erstellt haben, um das Bereitstellungspaket in das Partner-Portal hochzuladen.

Bereitstellungspaket zur Überprüfung in Producer Portal einreichen

Wenn Sie Producer Portal zum Erstellen Ihres Google Cloud Marketplace-Produkteintrags verwenden, müssen Sie nach dem Erstellen Ihres Bereitstellungspakets das Paket an Producer Portal senden, damit das Google 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 Google 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 des GCS-Objekts angeben das zuvor hochgeladene Bereitstellungspaketobjekt 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.