Lebenszyklus einer Marketplace-Bereitstellung

In diesem Dokument wird erläutert, wie Sie Softwarepakete aus dem Google Distributed Cloud (GDC) Marketplace mit Air Gap über die GDC Console installieren, aktualisieren und deinstallieren. Sie können Softwarepakete auch mit der gdcloud marketplace CLI oder der Marketplace API installieren.

Dieses Dokument richtet sich an Zielgruppen in der Gruppe der Anwendungsoperatoren, die den Lebenszyklus von Marketplace-Bereitstellungen in GDC-Projekten verwalten. Weitere Informationen finden Sie unter Dokumentation zu Zielgruppen für GDC mit Air Gap.

Hinweis

Bevor Sie Softwarepakete aus dem Marketplace installieren, aktualisieren oder deinstallieren können, benötigen Sie die erforderlichen Berechtigungen und müssen Ihre Umgebung vorbereiten.

IAM-Rollen anfordern

Wenden Sie sich an Ihren IAM-Administrator der Organisation oder IAM-Administrator des Projekts, um die folgenden Rollen anzufordern, je nachdem, welche Aufgaben Sie in Ihrem Projekt ausführen müssen:

• Marketplace-Bearbeiter (marketplace-editor): Softwarepakete aus dem Marketplace installieren, aktualisieren und deinstallieren.
• Projektbetrachter (project-viewer): Ein vorhandenes Projekt und seine Ressourcen ansehen.

Der IAM-Administrator der Organisation kann diese Rollen für jedes Projekt in der Organisation zuweisen. Der IAM-Administrator des Projekts kann diese Rollen im Rahmen seines spezifischen Projekts zuweisen.

Umgebung vorbereiten

Für die Aufgaben auf dieser Seite wird hauptsächlich die GDC Console verwendet. Wenn Sie die Befehlszeilenalternativen verwenden möchten, führen Sie die folgenden Schritte aus:

• Laden Sie die gdcloud CLI herunter und installieren Sie sie, falls noch nicht geschehen.
• Wenn Sie die API mit kubectl verwenden möchten, ist eine zusätzliche Einrichtung erforderlich:
  • Installieren Sie die kubectl CLI.
  • Generieren Sie eine kubeconfig-Datei.

Softwarepaket aus dem Distributed Cloud Marketplace installieren

Führen Sie die folgenden Schritte aus, um ein Softwarepaket aus dem Distributed Cloud Marketplace zu installieren:

Console

1. Wählen Sie in der Projektauswahl der GDC Console das Projekt aus, in dem Sie das Softwarepaket installieren möchten.
2. Rufen Sie im Distributed Cloud Marketplace die Angebotsseite für das Produkt auf, das Sie installieren möchten. Auf dieser Seite finden Sie Details zum Produkt und Links zur Dokumentation, zu den Preisen und zu den Nutzungsbedingungen.
3. Wenn Sie dieses Produkt zum ersten Mal installieren, klicken Sie auf Installieren. Andernfalls rufen Sie den Tab „Verwaltung“ auf und klicken Sie auf Neue Instanz.
4. Wählen Sie im Dialogfeld den Nutzercluster aus, in dem Sie das Softwarepaket installieren möchten. Wenn Sie die Konfiguration anpassen möchten, klicken Sie auf Weiter. Wenn Sie die Standardkonfiguration verwenden möchten, klicken Sie auf Installieren.
5. Wenn Sie auf Weiter geklickt haben, können Sie jetzt die Standardkonfiguration prüfen. Klicken Sie auf Benutzerdefinierte Konfiguration, um eigene Parameter einzugeben. Folgen Sie dabei der Dokumentation des Anbieters. Klicken Sie anschließend auf Installieren, um mit der Installation fortzufahren. Bei Kubernetes-Softwarepaketen überschreiben die hier konfigurierten Parameter die Standardwerte, die der Anbieter in seiner Helm-Werte-Datei bereitstellt.

6. Warten Sie einige Minuten, bis Ihre neue Instanz auf dem Tab Verwaltung der Seite als Bereit gekennzeichnet ist.

   

7. In der Dokumentation des jeweiligen Softwareanbieters erfahren Sie, wie Sie die Lösung nach der Installation verwenden.

gdcloud

1. Wählen Sie das Projekt aus, in dem Sie das Softwarepaket installieren möchten:

   gdcloud config set project PROJECT_NAME
   

   Ersetzen Sie PROJECT_NAME durch den Namen des Projekts, in dem Sie das Softwarepaket installieren möchten.

2. Listen Sie die verfügbaren Marketplace-Anwendungen auf:

   gdcloud marketplace services list
   

3. Installieren Sie die ausgewählte Anwendung aus der Liste und geben Sie den Zielcluster an:

   gdcloud marketplace services install SERVICE_NAME \
     --cluster=CLUSTER_NAME
   

   Verwenden Sie das Flag --parameters-file, um während der Installation benutzerdefinierte Konfigurationsüberschreibungen anzugeben:

   gdcloud marketplace services install SERVICE_NAME \
     --cluster=CLUSTER_NAME \
     --parameters-file=PATH_TO_PARAMETERS_FILE
   

   Ersetzen Sie Folgendes:

   • SERVICE_NAME: der Name des zu installierenden Marketplace-Dienstes (z. B. dataproc)
   • CLUSTER_NAME: der Name des Zielnutzerclusters, in dem Sie die Anwendung installieren möchten
   • PATH_TO_PARAMETERS_FILE: der Pfad zu einer YAML-Datei mit Konfigurationsüberschreibungsparametern für die Dienstinstanz

4. Installation prüfen:

   gdcloud marketplace services list
   

   Prüfen Sie, ob die neu installierte Anwendung mit dem Status READY oder INSTALLED in der Liste angezeigt wird.

API

1. Listen Sie die verfügbaren ServiceVersion-Ressourcen auf, um den gewünschten Dienst und die gewünschte Version zu finden:

   kubectl get serviceversions -n mkt-system
   

2. Erstellen Sie ein YAML-Manifest für eine ServiceInstance-Ressource (z. B. service-instance.yaml):

   apiVersion: marketplace.gdc.goog/v1
   kind: ServiceInstance
   metadata:
     name: INSTANCE_NAME
   spec:
     clusterRef:
       name: CLUSTER_NAME
       namespace: CLUSTER_NAMESPACE
     serviceVersionRef:
       name: SERVICE_VERSION_NAME
       namespace: mkt-system
     parameters:
       KEY: VALUE
   

   Ersetzen Sie Folgendes:

   • INSTANCE_NAME: ein Name für Ihre neue Anwendungsinstanz
   • CLUSTER_NAME: der Name des Zielnutzerclusters, in dem Sie die Anwendung installieren möchten
   • CLUSTER_NAMESPACE: der Namespace des Clusters (z. B. production-cluster)
   • SERVICE_VERSION_NAME: der Name der zu installierenden ServiceVersion (z. B. dataproc-1.0.0)
   • KEY: der Name des Konfigurationsüberschreibungsparameters gemäß dem Helm-Werteschema des Anbieters
   • VALUE: der Wert für den Konfigurationsüberschreibungsparameter

   Weitere Informationen und ein Beispielmanifest finden Sie unter Marketplace API overview.

3. Wenden Sie das Manifest auf das Projekt an:

   kubectl apply -f service-instance.yaml -n PROJECT_NAME
   

   Ersetzen Sie PROJECT_NAME durch den Namen des Projekts, in dem Sie das Softwarepaket installieren möchten.

4. Prüfen Sie die Installation, indem Sie den Status des ServiceInstance-Objekts untersuchen:

   kubectl get serviceinstance INSTANCE_NAME -n PROJECT_NAME -o yaml
   

   Prüfen Sie, ob status.conditions eine Bedingung vom Typ Ready mit dem Status "True" enthält und ob unter status.installedVersion die installierte Version angezeigt wird.

Hinweis: Wenn Sie wissen möchten, welches Container-Image in GDC verfügbar ist, sehen Sie sich die Liste der Marketplace-Images an, die in Ihrer Version von GDC enthalten sind. Images, die in früheren Versionen von GDC enthalten waren, können auch nach einem Upgrade von GDC weiterhin verwendet werden.

Instanz eines Softwarepakets aus dem Distributed Cloud Marketplace neu konfigurieren

Warnung: Sie können zwar eine laufende Instanz eines Softwarepakets aus dem Distributed Cloud Marketplace neu konfigurieren, der Prozess wird jedoch vom Anbieter implementiert, der das Produkt veröffentlicht hat. Daher variiert der Prozess von Softwarepaket zu Softwarepaket. Wir empfehlen Ihnen, die Dokumentation des jeweiligen Anbieters sorgfältig zu lesen, bevor Sie mit der Neukonfiguration fortfahren. Je nachdem, wie der Anbieter den Neukonfigurationsprozess implementiert hat, kann es zu Ausfallzeiten des bereitgestellten Dienstes kommen.

Einige Softwarepakete aus dem Distributed Cloud Marketplace können neu konfiguriert werden, während sie bereits ausgeführt werden. Bei Kubernetes-basierten Diensten entspricht dies dem Anwenden neuer Werte auf das Helm-Chart des Anbieters.

So konfigurieren Sie eine laufende Instanz eines Softwarepakets aus dem Distributed Cloud Marketplace neu:

1. Wählen Sie in der Projektauswahl der GDC Console das Projekt aus, in dem Sie das Softwarepaket aktualisieren möchten.
2. Rufen Sie auf der Seite des Distributed Cloud Marketplace die Angebotsseite für das Produkt auf, das Sie aktualisieren möchten.
3. Klicken Sie auf den Tab Verwaltung.
4. Klicken Sie für die Instanz, die Sie neu konfigurieren möchten, auf Konfigurationsdatei.
5. Geben Sie im angezeigten Bereich Ihre benutzerdefinierten Parameter ein. Folgen Sie dabei der Dokumentation des Anbieters.
6. Klicken Sie auf Speichern , um die neuen Parameter anzuwenden. Die Neukonfiguration ist in wenigen Minuten abgeschlossen.

Softwarepaket aus dem Distributed Cloud Marketplace aktualisieren

Warnung: Sie können zwar das Upgrade eines Softwarepakets über den Distributed Cloud Marketplace auslösen, der Prozess wird jedoch vom Anbieter implementiert, der das Produkt veröffentlicht hat. Daher variiert der Prozess von Softwarepaket zu Softwarepaket. Wir empfehlen Ihnen, die Versionshinweise und die Upgrade-Dokumentation des jeweiligen Anbieters sorgfältig zu lesen, bevor Sie mit einem Upgrade fortfahren. Je nachdem, wie der Anbieter den Upgrade-Prozess implementiert hat, kann es zu Ausfallzeiten des bereitgestellten Dienstes oder zu Kompatibilitätsproblemen zwischen älteren und neueren Versionen kommen.

Einige Softwarepakete aus dem Google Distributed Cloud Marketplace können auf eine neue Version aktualisiert werden, nachdem Ihr Infrastrukturadministrator diese neuen Versionen für Sie verfügbar gemacht hat.

So aktualisieren Sie ein Softwarepaket aus dem Distributed Cloud Marketplace:

1. Wählen Sie in der Projektauswahl der GDC Console das Projekt aus, in dem Sie das Softwarepaket aktualisieren möchten.
2. Rufen Sie auf der Seite des Distributed Cloud Marketplace die Angebotsseite für das Produkt auf, das Sie aktualisieren möchten.
3. Klicken Sie auf den Tab „Verwaltung“.
4. Klicken Sie für die Instanz, die Sie aktualisieren möchten, auf Aktualisieren. Das Upgrade ist in wenigen Minuten abgeschlossen.

Hinweis: Wenn Sie ein Softwarepaket über die Distributed Cloud Console aktualisieren, wird die nächste verfügbare Version der Software installiert. Wenn mehrere neue Versionen der Software verfügbar sind, müssen Sie den Vorgang für jede Version wiederholen. Verwenden Sie bei Bedarf die Marketplace API, um ein Upgrade auf eine bestimmte Version durchzuführen.

Softwarepaket aus dem Distributed Cloud Marketplace deinstallieren

Warnung: Das Deinstallieren eines Softwarepakets aus dem Distributed Cloud Marketplace ist eine destruktive Aktion, die zu Datenverlust oder Ausfallzeiten von Systemen führen kann, die von dieser Software abhängig sind. Sichern Sie alle wichtigen Daten und prüfen Sie, ob kein wichtiges System von der Software abhängig ist, die Sie deinstallieren möchten, bevor Sie fortfahren. In der Dokumentation des jeweiligen Anbieters erfahren Sie, wie Sie von der Software verwaltete Daten sichern.

So deinstallieren Sie ein Softwarepaket aus dem Distributed Cloud Marketplace:

1. Wählen Sie in der Projektauswahl der GDC Console das Projekt aus, aus dem Sie das Softwarepaket deinstallieren möchten.
2. Rufen Sie auf der Seite des Distributed Cloud Marketplace die Angebotsseite für das Produkt auf, das Sie deinstallieren möchten.
3. Klicken Sie auf den Tab Verwaltung.
4. Klicken Sie für die Instanz, die Sie deinstallieren möchten, auf Deinstallieren. Das Softwarepaket wird in wenigen Minuten deinstalliert.