VM-Image für die Bereitstellung mit Deployment Manager konfigurieren

Wenn Sie die Bereitstellung mit Deployment Manager für Ihr VM-Produkt unterstützen, müssen Sie die folgenden Schritte ausführen.

Festlegen, wie Ihr Bereitstellungspaket erstellt wird

Wir empfehlen, die Option „Gediente Konfiguration“ von 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 Funktionen 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.

Wir empfehlen nicht, benutzerdefinierte Bereitstellungsvorlagen zu verwenden, die Sie ohne die Google Cloud Console oder das Deployment Manager Autogen-Tool mit Cloud Marketplace erstellt haben. Wir empfehlen, das Bereitstellungspaket direkt in der Google Cloud Console zu erstellen.

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, klicken Sie auf Zur manuellen Konfiguration.

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.

Geführte Konfiguration abschließen

So konfigurieren Sie ein einfaches Bereitstellungspaket mit der Google Cloud Console fertig und reichen es ein:

  1. Rufe im Producer Portal den Bereich Bereitstellungspaket auf.

  2. Klicken Sie unter Deployment Manager-Konfiguration neben dem Eingabefeld Cloud Storage-Bucket auf Durchsuchen.

    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.
  3. Achten Sie darauf, dass die Objektversionsverwaltung für Ihren Cloud Storage-Bucket aktiviert ist.

  4. Klicken Sie auf Konfigurieren, um Ihre Bucket-Einstellungen zu speichern und mit der Konfiguration Ihres Bereitstellungspakets fortzufahren.

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

  6. Geben Sie unter Betriebssystem angeben den Namen und die Version des Betriebssystems an, das Ihr VM-Image verwendet, sowie die Versionsnummer des VM-Images.

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

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

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

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

    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.

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

Manuelle Konfiguration abschließen

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.

Hinweise

Wenn Sie mpdev 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.

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 gcloud storage-Befehle aus, um einen Cloud Storage-Bucket zu erstellen und zu konfigurieren:

  BUCKET_NAME=YOUR_BUCKET_NAME
  gcloud storage buckets create gs://$BUCKET_NAME
  gcloud storage buckets update gs://$BUCKET_NAME --versioning
  gcloud storage buckets add-iam-policy-binding gs://$BUCKET_NAME --member=group:cloud-commerce-marketplace-onboarding@twosync-src.google.com --role=roles/storage.objectViewer
  

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 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 prüfen, ob Sie die Vorlage richtig konfiguriert haben, erstellen Sie eine Bereitstellung mit dem folgenden Befehl:

  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

Nachdem Sie Ihr Bereitstellungspaket erstellt und konfiguriert haben, müssen Sie es im Producer Portal einreichen, damit das Cloud Marketplace-Team es prüfen und genehmigen kann.

  1. Rufe im Producer Portal den Bereich Bereitstellungspaket auf.

  2. Wählen Sie unter Speicherort des Cloud Storage-Objekts angeben das zuvor hochgeladene Bereitstellungspaketobjekt aus.

  3. Klicke auf Validieren. Die Validierung kann bis zu zwei Stunden dauern. Sie können den Bildschirm während der Verarbeitung verlassen.

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

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