VM-Image für Deployment Manager konfigurieren

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

Festlegen, wie Ihr Bereitstellungspaket erstellt wird

Wir empfehlen, das Bereitstellungspaket direkt in der Google Cloud Console mit der geführten Konfigurationsoption des Producer Portal 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.

Wir raten davon ab, 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 geführte Konfigurationsoption des Producer Portal verwenden und später zur manuellen Konfiguration 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

Führen Sie die folgenden Schritte aus, um die Konfiguration abzuschließen und ein einfaches Bereitstellungspaket über die Google Cloud Console zu senden:

  1. Gehen Sie im Producer Portal zum Abschnitt Bereitstellungspaket.

  2. Klicken Sie unter Deployment Manager-Konfiguration neben dem Eingabefeld mit der Bezeichnung 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 mit der Bezeichnung 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.
  3. Achten Sie darauf, dass Sie für Ihren Cloud Storage-Bucket die Objektversionsverwaltung aktivieren.

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

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

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

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

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

  9. Optional können Sie unter Nächste Schritte definieren Anweisungen für die Nutzer Ihres Produkts angeben, die sie bei den ersten Schritten mit Ihrem Produkt unterstützen. Diese Anleitung ist für den Nutzer sichtbar, nachdem er Ihr Produkt bereitgestellt hat.

  10. Nachdem Sie die vorherigen Schritte abgeschlossen haben, klicken Sie auf Generieren, um das Bereitstellungspaket zu erstellen.

    Wenn Sie später weitere Änderungen an Ihrem Bereitstellungspaket vornehmen müssen, klicken Sie auf Bearbeiten, um Änderungen vorzunehmen, und dann auf Generieren, um das Bereitstellungspaket mit diesen angewendeten Änderungen neu zu generieren.

    Wenn Sie vorhaben, zur manuellen Konfiguration zu wechseln, können Sie auf Herunterladen klicken, um die Autogen-Spezifikation für das Bereitstellungspaket herunterzuladen, das Sie in der geführten Konfiguration erstellt haben, und als Grundlage für Ihre manuelle Konfiguration zu verwenden.

  11. Reichen Sie das Bereitstellungspaket zur Überprüfung im Producer Portal ein. Nachdem Sie das Paket gesendet haben, kann es bis zu zwei Wochen dauern, bis es von Google geprüft und genehmigt wird.

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 das 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 es von Google geprüft und genehmigt wird.

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

Hinweise

Wenn Sie das Bereitstellungspaket mit mpdev erstellen, 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 Ihr 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. Sehen Sie sich die vorkonfigurierte Autogen-Spezifikation des Beispiels in einem lokalen Verzeichnis an:

    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 sie, um die Deployment Manager-Vorlagendateien für Ihr Bereitstellungspaket zu generieren. Laden Sie das Paket in den Cloud Storage-Bucket hoch, um das Paket zu speichern.

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 die Vorlage ordnungsgemäß konfiguriert wurde, erstellen Sie mit dem folgenden Befehl eine Bereitstellung:

  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 das Paket an das Producer Portal senden, damit das Cloud Marketplace-Team es prüfen und genehmigen kann.

  1. Gehen Sie im Producer Portal zum Abschnitt Bereitstellungspaket.

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

  3. Klicke auf Validieren. Die Überprüfung kann bis zu zwei Stunden dauern. Sie können den Bildschirm währenddessen verlassen.

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

  5. Wenn die Validierung erfolgreich abgeschlossen ist, klicken Sie auf Senden, um das Bereitstellungspaket zur Überprüfung einzureichen. Nachdem Sie das Paket gesendet haben, kann es bis zu zwei Wochen dauern, bis es von Google geprüft und genehmigt wird.