Auf dieser Seite werden die Schritte zum Einrichten Ihrer Google Cloud-Umgebung für das Verteilen Ihrer Kubernetes-Anwendungen beschrieben.
Arbeitsbereich erstellen
Wir empfehlen, dass Sie ein neues Projekt in der Google Cloud Console hauptsächlich für Ihre Cloud Marketplace-Produkte erstellen.
Zum Verwalten von Produkten, die Sie an Cloud Marketplace senden, empfehlen wir, ein neues Projekt mit einer Projekt-ID zu erstellen, die auf -public
endet. Informationen zum Erstellen eines Projekts für Ihre Produkte finden Sie unter Projekte erstellen und verwalten.
Wenn Sie bereits ein Projekt zum Verkaufen auf Cloud Marketplace eingerichtet haben, das Sie verwenden möchten, prüfen Sie, ob die Rollen für Kubernetes korrekt zugewiesen wurden. Fahren Sie dann mit dem Einrichten einer Container Registry fort.
Nachdem Sie Ihr Projekt erstellt haben, erteilen Sie die folgenden Rollen:
- Die Rollen „Projektbearbeiter“ und „Dienstverwaltungsadministrator“ für
cloud-commerce-marketplace-onboarding@twosync-src.google.com
- Die Rolle „Service Consumer“ und „Service Controller“ für
cloud-commerce-procurement@system.gserviceaccount.com
auf Dienstebene - Rolle „Service Management-Administrator“ für
managed-services@cloud-marketplace.iam.gserviceaccount.com
- Die Rolle des Konfigurationsbearbeiters (
roles/servicemanagement.configEditor
) fürcloud-commerce-producer@system.gserviceaccount.com
Wenn Sie Hilfe bei der Fehlerbehebung in Ihrem Projekt benötigen, z. B. bei der Fehlerbehebung für das Container Registry-Repository, erteilen Sie cloud-commerce-marketplace-onboarding@twosync-src.google.com
die Rolle „Projektbearbeiter“.
Die Schritte zum Gewähren des Zugriffs auf Ihr Projekt finden Sie unter Zugriff für Projektmitglieder gewähren, ändern und widerrufen.
Schritte zum Gewähren des Zugriffs auf Dienstebene finden Sie unter Zugriff auf die API gewähren und widerrufen.
Nachdem Sie das Projekt erstellt haben, füllen Sie das Projektinformationsformular aus, das Sie vom Cloud Marketplace-Team erhalten.
Container Registry einrichten
Sie benötigen ein Container Registry-Repository zum Hosten der Container-Images für Ihre Anwendung. Container Analysis scannt die Anwendungs-Images kontinuierlich auf Sicherheitslücken, damit Sie Probleme prüfen und beheben können, bevor Sie Ihr Produkt an Cloud Marketplace senden.
Befolgen Sie zum Einrichten der Container Registry, des Dockers und des Google Cloud SDK die Schnellanleitung zur Containerregistrierung.
Nachdem Sie Container Registry eingerichtet haben, gewähren Sie cloud-commerce-marketplace-onboarding@twosync-src.google.com
in dem Projekt, das Ihre Registry enthält, die Rolle „Projektbetrachter“.
Container Analysis API aktivieren
Sie müssen die Container Analysis API aktivieren, die Ihre Container-Images in der Container Registry auf Schwachstellen überprüft. Eine Übersicht über das Scannen von Sicherheitslücken in der Containeranalyse finden Sie in der Container Registry-Dokumentation.
Produkt dem Cloud Marketplace hinzufügen
Mit dem Producer Portal können Sie Ihr Produkt im Cloud Marketplace erstellen und veröffentlichen. Ihr Partnerentwickler aktiviert dies, nachdem Sie das Informationsformular für Cloud Marketplace-Projekte ausgefüllt haben.
Erstellen Sie zum Veröffentlichen Ihres Produkts im Producer Portal einen Eintrag für Ihr Produkt und reichen Sie dann die folgenden Informationen zur Überprüfung ein:
- Produktdetails: Fügen Sie Produkt- und Marketinginformationen zu Ihrem Produkt hinzu.
- Preise: Wählen Sie Ihr Preismodell aus und legen Sie es fest, um festzulegen, wie Kunden Sie für Ihr Produkt bezahlen.
- Container-Images: Geben Sie das Google Container Registry-Repository an, das Ihre Container-Images enthält.
- Open-Source-Compliance: Ihr Produkt muss den Google-Richtlinien für Open-Source-Software entsprechen.
Sie können diese Bewertungen jederzeit und in beliebiger Reihenfolge einreichen. Die Überprüfung kann bis zu zwei Wochen dauern. Wir empfehlen Ihnen, die Anforderungen zu überprüfen und so früh wie möglich zu beginnen.
So erstellen Sie den Cloud Marketplace-Eintrag Ihres Produkts:
Öffnen Sie das Producer Portal in der Google Cloud Console:
https://console.cloud.google.com/producer-portal?project=YOUR_PUBLIC_PROJECT_ID
Ersetzen Sie YOUR_PUBLIC_PROJECT_ID durch die ID des öffentlichen Projekts, das Sie für Cloud Marketplace erstellt haben, z. B.
my-organization-public
.Klicken Sie oben auf der Seite auf Produkt hinzufügen.
Wählen Sie Kubernetes aus.
Geben Sie unter Produktname einen Namen für Ihr Produkt ein und prüfen Sie die Produkt-ID. Die Produkt-ID wird in der URL Ihres Cloud Marketplace-Eintrags verwendet.
Klicken Sie auf Erstellen. Es kann einige Sekunden dauern, bis Ihr Produkt erstellt wurde.
Das Preismodell und die Marketinginformationen für Ihre Lösung fügen Sie später hinzu.
Entwicklungscluster in Kubernetes Engine erstellen
Mit Google Kubernetes Engine können Sie Kubernetes-Cluster verwalten und skalieren. Befolgen Sie die Schnellanleitung zu Google Kubernetes Engine, um einen Testcluster zu erstellen und eine Basisanwendung darauf bereitzustellen.
Entwicklungstool mpdev
installieren
Das mpdev
-Tool ist ein Container, in dem Dienstprogramme zum Testen und Veröffentlichen Ihrer Anwendungs-Images zusammengefasst sind. Während die Installation von mpdev
für das Einreichen einer Anwendung zur Veröffentlichung nicht erforderlich ist, können Sie zur Aktivierung der Option mpdev
ausführen, um Ihre Entwicklungsumgebung zu prüfen und zu testen, ob Ihre Anwendung in Ihrem Entwicklungscluster richtig installiert wird.
Installieren Sie mpdev
aus dem GitHub-Repository der Cloud Marketplace-Tools.
Informationen zur Verwendung von mpdev
zum Prüfen Ihrer Umgebung und zum Testen Ihrer Anwendung finden Sie in der mpdev-Referenz auf GitHub.
Releases verwalten
Im Allgemeinen muss jede Version Ihrer Anwendung die semantische Versionsverwaltung 2.0 einhalten, die der Namenskonvention MAJOR.MINOR.PATCH
entspricht. Jede Version muss eine eindeutige Versionsnummer wie 1.0.1
, 1.0.2
, 1.3.1
usw. haben.
Fügen Sie optional einen Bindestrich nach der Versionsnummer ein, um einen Vorrelease-Modifikator hinzuzufügen, z. B. 1.3.1-alpha201910
. Sie können mit Modifikatoren vor der Veröffentlichung zusätzliche Informationen speichern und hervorheben, die für Sie nützlich sind, z. B. Build-Daten, die angeben, wann Versionen erstellt wurden.
Wir empfehlen, dass Sie Ihre Software in Tracks veröffentlichen. Jeder Track ist eine Reihe von Versionen mit abwärtskompatiblen Updates. Die Release-Tracks sollten auf einer Nebenversion, beispielsweise 4.1.x
, basieren. Als Best Practice sollten Sie keine allgemeinen Versionsnamen wie beispielsweise latest
verwenden.
Wenn Sie beispielsweise Version 2.0
Ihrer Software im Cloud Marketplace veröffentlichen und erwarten, dass die Versionen 2.0.1
, 2.0.5
usw. mit 2.0
abwärtskompatibel sind, organisieren Sie diese Releases im Release-Track 2.0
.
Wenn Sie eine abwärtskompatible Version Ihrer Anwendung veröffentlichen oder eine Version, bei der Nutzer manuelle Migrationsschritte ausführen müssen, geben Sie sie auf einer neuen Spur frei, damit Nutzer ihre Updates planen können.
Produktkennzeichnungen auswählen
Sie müssen die folgenden Kennzeichnungen für Ihr Unternehmen, Ihr Produkt und Ihre Container-Images auswählen. Damit können Sie Ihre Cloud Marketplace-URLs und die URIs für Ihre Container-Images erstellen:
Name Ihres Unternehmens: Wenn der Name Ihres Unternehmens beispielsweise Examplesoft Inc. lautet, können Sie die Kennzeichnung
examplesoft
verwenden.Name Ihres Produkts. Wenn der Produktname beispielsweise Example Pro lautet, verwenden Sie die Kennzeichnung
example-pro
.Release-Track Ihres Produkts, z. B.
4.0
.Ihre Container-Images. Wählen Sie für jedes Container-Image in Ihrer Anwendung eine eindeutige Kennzeichnung aus. Die folgenden Kennzeichnungen sind für alle Anwendungen erforderlich:
- Das primäre Image: Dieses Container-Image ist das Haupt-Image für Ihr Produkt und verwendet dieselbe Kennzeichnung wie das Produkt. Wenn Ihre Produktkennzeichnung beispielsweise
example-pro
ist, verwendet das Primär-Image dieselbe Kennzeichnung. deployer
: Das Deployment-Container-Image für den Track. Der Bereitstellungscontainer wird ausgeführt, wenn Nutzer Ihre Anwendung über die Google Cloud Console bereitstellen. Das Deployment-Image erstellen Sie zusammen mit Ihrem Anwendungspaket.
- Das primäre Image: Dieses Container-Image ist das Haupt-Image für Ihr Produkt und verwendet dieselbe Kennzeichnung wie das Produkt. Wenn Ihre Produktkennzeichnung beispielsweise
Das Unternehmen "Examplesoft Inc." wählt beispielsweise die folgenden Kennzeichnungen für sein Produkt "Example Pro":
Name | Kennzeichnung | |
---|---|---|
Unternehmen | Examplesoft Inc | examplesoft |
Produkt | Example Pro | example-pro |
Image [1] (Hauptimage) | Example Pro server | – |
Image [2] | Example Queue | example-queue |
Image [Bereitstellungsimage] | – | deployer |
Release-Track [1] | Version 4.x.x | 4.0 |
Release-Track [2] | Version 5.x.x | 5.0 |
Für diese Kennzeichnungen werden automatisch folgende Informationen generiert:
Die Produkt-URL in Cloud Marketplace:
https://console.cloud.google.com/marketplace/details/examplesoft/example-pro
Die Container-Image-URIs:
marketplace.gcr.io/examplesoft/example-pro:4.0
marketplace.gcr.io/examplesoft/example-pro/example-queue:4.0
marketplace.gcr.io/examplesoft/example-pro/deployer:4.0
marketplace.gcr.io/examplesoft/example-pro:5.0
marketplace.gcr.io/examplesoft/example-pro/example-queue:5.0
marketplace.gcr.io/examplesoft/example-pro/deployer:5.0