Lebenszyklus einer Marketplace-Bereitstellung

In diesem Dokument wird beschrieben, wie Sie Softwarepakete aus dem GDC-Marktplatz (Google Distributed Cloud) mit Air Gap über die GDC-Konsole installieren, aktualisieren und deinstallieren. Sie können Softwarepakete auch über die gdcloud marketplace-CLI oder die 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 Marketplace-Softwarepakete installieren, aktualisieren oder deinstallieren können, müssen Sie die erforderlichen Berechtigungen haben und Ihre Umgebung vorbereiten.

IAM-Rollen anfordern

Wenden Sie sich an Ihren IAM-Admin der Organisation oder IAM-Projektadministrator, um die folgenden Rollen basierend auf den Aufgaben anzufordern, die Sie in Ihrem Projekt ausführen müssen:

• Marketplace-Bearbeiter (marketplace-editor): Installieren, aktualisieren und deinstallieren Sie Marketplace-Softwarepakete.
• Projektbetrachter (project-viewer): Vorhandenes Projekt und die zugehörigen Ressourcen ansehen.

Der IAM-Organisationsadministrator kann diese Rollen für jedes Projekt innerhalb der Organisation zuweisen. Der IAM-Projektadministrator kann diese Rollen im Rahmen seines spezifischen Projekts zuweisen.

Umgebung vorbereiten

Für die Aufgaben auf dieser Seite wird hauptsächlich die GDC-Konsole 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-Befehlszeile.
  • kubeconfig-Datei generieren

Softwarepaket aus dem Distributed Cloud Marketplace installieren

So installieren Sie ein Softwarepaket aus dem Distributed Cloud Marketplace:

Console

1. Wählen Sie in der Projektauswahl der GDC-Konsole das Projekt aus, in dem Sie das Softwarepaket installieren möchten.
2. Rufen Sie im Distributed Cloud Marketplace die Seite mit dem Eintrag für das Produkt auf, das Sie installieren möchten. Auf dieser Seite können Sie sich Details zum Produkt ansehen und Links zur Dokumentation, zu den Preisen und zu den Nutzungsbedingungen aufrufen.
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 sich jetzt die Standardkonfiguration ansehen. Klicken Sie auf Benutzerdefinierte Konfiguration, um eigene Parameter gemäß der Dokumentation des Anbieters einzugeben. 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-Wertedatei bereitgestellt hat.

6. Warten Sie einige Minuten, bis die neue Instanz auf dem Tab Verwaltung der Seite als Bereit markiert 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 in der Liste mit dem Status READY oder INSTALLED 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 die 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 des zu installierenden ServiceVersion (z. B. dataproc-1.0.0)
   • KEY: der Name des Parameters für die Konfigurationsüberschreibung, der dem Helm-Wertschema des Anbieters entspricht
   • VALUE: der Wert für den Parameter zum Überschreiben der Konfiguration

   Weitere Informationen und ein Beispielmanifest finden Sie in der Übersicht zur Marketplace API.

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 prüfen:

   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 status.installedVersion die installierte Version anzeigt.

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 GDC-Version enthalten sind. Images, die in früheren Versionen von GDC enthalten waren, bleiben auch nach einem Upgrade von GDC verfügbar.

Instanz eines Distributed Cloud Marketplace-Softwarepakets neu konfigurieren

Warnung: Sie können eine laufende Instanz eines Distributed Cloud Marketplace-Softwarepakets zwar neu konfigurieren, der Neukonfigurationsprozess wird jedoch vom Anbieter implementiert, der das Produkt veröffentlicht hat. Der Rekonfigurationsprozess variiert daher 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 Rekonfigurationsprozess implementiert hat, kann es zu Ausfallzeiten beim bereitgestellten Dienst kommen.

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

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

1. Wählen Sie in der Projektauswahl der GDC-Konsole das Projekt aus, in dem Sie das Softwarepaket aktualisieren möchten.
2. Rufen Sie auf der Distributed Cloud Marketplace-Seite die Eintragsseite 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 die benutzerdefinierten Parameter gemäß der Dokumentation des Anbieters ein.
6. Klicken Sie auf Speichern, um die neuen Parameter anzuwenden. Die Neukonfiguration ist in wenigen Minuten abgeschlossen.

Distributed Cloud Marketplace-Softwarepaket aktualisieren

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

Einige Softwarepakete im Distributed Cloud Marketplace können über den Google Distributed Cloud Marketplace auf eine neue Version aktualisiert werden, nachdem Ihr Infrastruktur-Operator diese neuen Versionen für Sie verfügbar gemacht hat.

So aktualisieren Sie ein Distributed Cloud Marketplace-Softwarepaket:

1. Wählen Sie in der Projektauswahl der GDC-Konsole das Projekt aus, in dem Sie das Softwarepaket aktualisieren möchten.
2. Rufen Sie auf der Distributed Cloud Marketplace-Seite die Eintragsseite für das Produkt auf, das Sie aktualisieren möchten.
3. Klicken Sie auf den Tab „Verwaltung“.
4. Klicken Sie bei der Instanz, die Sie aktualisieren möchten, auf Upgrade. 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 einzelne wiederholen. Verwenden Sie bei Bedarf die Marketplace API, um ein Upgrade auf eine bestimmte Version durchzuführen.

Distributed Cloud Marketplace-Softwarepaket deinstallieren

Warnung: Die Deinstallation eines Distributed Cloud Marketplace-Softwarepakets ist ein destruktiver Vorgang und kann zu Datenverlust oder Ausfallzeiten von Systemen führen, die von dieser Software abhängig sind. Sichern Sie alle wichtigen Daten und stellen Sie sicher, dass kein wichtiges System von der Software abhängt, die Sie deinstallieren möchten, bevor Sie fortfahren. In der Dokumentation des jeweiligen Anbieters finden Sie Informationen dazu, wie Sie Daten sichern, die von seiner Software verwaltet werden.

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

1. Wählen Sie in der Projektauswahl der GDC-Konsole das Projekt aus, aus dem Sie das Softwarepaket deinstallieren möchten.
2. Rufen Sie auf der Distributed Cloud Marketplace-Seite die Eintragsseite 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 innerhalb weniger Minuten deinstalliert.