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

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

Festlegen, wie Ihr Bereitstellungspaket erstellt wird

Wir empfehlen Ihnen die geführte Konfiguration im Producer Portal, um Erstellen Sie Ihr Bereitstellungspaket direkt in der Google Cloud Console.

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 den Open-Source-Tool mpdev um entweder Ihr Bereitstellungspaket zu erstellen oder ein vorhandenes Paket anzupassen indem Sie weitere Funktionen hinzufügen.

Wir raten davon ab, benutzerdefinierte Bereitstellungsvorlagen zu verwenden, mit der Google Cloud Console oder Deployment Manager Autogen im Cloud Marketplace. Wir empfehlen Ihnen, Ihre Bereitstellung zu erstellen, direkt in der Google Cloud Console.

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

Um die Konfiguration und das Senden eines einfachen Bereitstellungspakets mit der Führen Sie in der Google Cloud Console die folgenden Schritte aus:

  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 mit der Beschriftung 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 fest, welcher Detaillierungsgrad auf die IAM-Berechtigungen (Identity and Access Management) für die Daten des Buckets.
    • 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 Anweisungen für um sie bei den ersten Schritten mit dem Produkt zu unterstützen. Diese Anleitung ist für sie sichtbar, nachdem sie Ihr Produkt.

  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 vorhaben, zur manuellen Konfiguration zu wechseln, können Sie auf Herunterladen klicken, um die Autogen-Spezifikation für die Bereitstellungspaket, das Sie in der geführten Konfiguration erstellt haben, um es als für Ihre manuelle Konfiguration.

  11. Reichen Sie das Bereitstellungspaket zur Überprüfung in Producer Portal ein. Nachdem du das Paket abgeschickt hast, kann es bis zu zwei Wochen, damit Google das Paket prüfen und genehmigen kann.

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.

Hinweis

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 Ihr Bereitstellungspaket gelöscht wird, oder überschrieben.
  • 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) , 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 einer lokalen Verzeichnis:

    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. 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 im Rahmen 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. Um das Paket zu speichern, laden Sie es in den Cloud Storage-Bucket.

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 richtig konfiguriert wurde, erstellen Sie eine Bereitstellung, indem Sie und führen Sie den folgenden Befehl aus:

  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 den an das Producer Portal zu senden, damit das Cloud Marketplace-Team und genehmigen Sie das Paket.

  1. Gehen Sie im Producer Portal zum Abschnitt Bereitstellungspaket.

  2. Wählen Sie unter Geben Sie den Speicherort des Cloud Storage-Objekts an die Bereitstellung aus. Paketobjekt, das Sie zuvor hochgeladen haben.

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

  4. Nachdem Producer Portal das Bereitstellungspaket erfolgreich gelesen hat, können Sie auf Bereitstellungsvorschau klicken, Sehen Sie sich an, wie der Kunde Ihre VM-Konfiguration sieht.

  5. Nach erfolgreicher Validierung senden Sie die Bereitstellung, zur Überprüfung einreichen möchten, klicken Sie auf Senden. Nachdem du das Paket abgeschickt hast, Es kann bis zu zwei Wochen dauern, bis Google das Paket überprüft und genehmigt hat.