Technische Komponenten einrichten

Auf dieser Seite wird beschrieben, wie Sie die wichtigsten technischen Komponenten erstellen, die für den Vertrieb Ihres Container-Image-Produkts mit Google Cloud Marketplace erforderlich sind.

Wenn Sie während des Onboarding-Prozesses Fragen haben, wenden Sie sich an Ihren Cloud Marketplace-Partnerentwickler. Wenn Sie nicht wissen, wer Ihr Partnerentwickler ist, wenden Sie sich an den Partner Support Desk, um Unterstützung anzufordern. Nehmen Sie dabei das Wort „Marketplace“ in die Beschreibung auf. Weitere Informationen zum Partner Support Desk finden Sie unter Unterstützung für Cloud Marketplace anfordern.

Container Registry und IAM-Einrichtung

Bevor Sie Ihr Produkt im Producer Portal erstellen können, müssen Sie ein Container Registry-Staging-Repository erstellen und die Images, die Sie in Ihrem Produkt verteilen möchten, in dieses Repository übertragen. In Ihrem Projekt müssen Sie [e-mail] die Rolle „Projektbearbeiter“ zuweisen.

Erste Schritte mit Container Registry

Um getaggte Container-Images in Container Registry zu übertragen, führen Sie die Schritte unter Vorbereitung in der Dokumentation zu Container Registry aus. Führen Sie dann die folgenden Schritte aus, um die Artifact Analysis API zu aktivieren.

Für bestehende VM-Partner: Ihr Staging-Repository für Container Registry kann sich in Ihrem Entwicklungsprojekt befinden, nicht in Ihrem öffentlichen Projekt.

Nachdem Sie gcloud und Docker installiert haben, müssen Sie die folgenden APIs über die Seite API-Bibliothek aktivieren:

• Container Registry API
• Artifact Analysis API

Mit der Container Registry API können Sie Daten in Container Registry übertragen und mit der Artifact Analysis API Sicherheitsscans durchführen.

Wenn Sie Probleme beim Zugriff auf eine dieser APIs haben, wenden Sie sich an Ihren Partnerentwickler.

Images taggen und per Push übertragen

1. Wählen Sie den Pfad des Staging-Repositorys für Container Registry aus. Es wird empfohlen, dass Ihr Repository der Struktur gcr.io/YOUR-PARTNER-ID/YOUR-SOLUTION-ID folgt.

   • Das Staging-Repository muss sich innerhalb von gcr.io befinden. Andere Regionen, z. B. eu.gcr.io, werden noch nicht unterstützt.
   • Speichern oder kopieren Sie den Staging-Repository-Pfad für die Produkterstellung im Producer Portal.

2. Erstellen Sie das Image, das Sie per Push-Funktion in Ihr Staging-Repository für Container Registry übertragen möchten.

3. Taggen Sie das Image über Docker mit latest.

   docker tag image_name staging_repo_path:tag

   Beispiel: docker tag test-image gcr.io/testpartner/testsolution:latest.

   Das mit latest gekennzeichnete Image wird abgerufen, wenn ein Nutzer kein Tag angibt.

4. Übertragen Sie das Image mit gcloud per Push:

   gcloud docker push staging_repo_path:tag

5. Wiederholen Sie diese Schritte für alle zusätzlichen Tags oder Images, die Sie Ihrem Staging-Repository hinzufügen möchten. Ein einzelnes Image kann mehrere Tags enthalten.

   • Denken Sie daran, dass ein Image nicht automatisch für Nutzer sichtbar wird, wenn es per Push-Funktion in Ihr Staging-Repository übertragen wird. Dies geschieht nur für die Images mit den Tags, die Sie auswählen, und erst nach ihrer Veröffentlichung.
   • Der Bereich eines Repositorys ist genau der Ordner, der durch den Pfad angegeben wird. Alle Images, die in einem anderen Ordner liegen, befinden sich nicht in diesem Repository. Mit anderen Worten: Wenn sich ein Image in gcr.io/testpartner/testsolution/1.0 befindet, befindet es sich NICHT im Repository gcr.io/testpartner/testsolution. gcr.io/testpartner/testsolution/1.0 ist ein separates Repository.

Ihr Produkt im Producer Portal erstellen

In diesem Abschnitt wird beschrieben, wie Sie Ihr Container-Image-Produkt im Producer Portal erstellen und veröffentlichen.

Um Ihr Produkt im Producer Portal zu veröffentlichen, erstellen Sie einen Eintrag für Ihr Produkt und reichen dann die folgenden Informationen zur Überprüfung ein:

• Produktdetails: Fügen Sie Informationen zum Produkteintrag und Marketing hinzu.
• Container-Images: Stellen Sie das Google Container Registry-Repository bereit, das Ihre Container-Images enthält.

Sie können diese Bewertungen jederzeit und in beliebiger Reihenfolge einreichen.

So erstellen Sie einen Cloud Marketplace-Eintrag für Ihr Produkt:

1. Ö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.

   Hinweis: Wenn der Link nicht angezeigt wird oder wenn Sie nicht auf die URL zugreifen können, prüfen Sie, ob Sie das richtige Projekt ausgewählt haben und die Rolle "Bearbeiter" (roles/editor) für das Projekt haben. Wenn Sie immer noch nicht auf die URL zugreifen können, fordern Sie beim Partner Support Desk Unterstützung an. Nehmen Sie dabei das Wort „Marketplace“ in die Beschreibung auf. Weitere Informationen zum Partner Support Desk finden Sie unter Unterstützung für Cloud Marketplace anfordern.

2. Klicken Sie oben auf der Seite auf Produkt hinzufügen.

3. Wählen Sie Container-Image aus.

4. 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 für Ihren Cloud Marketplace-Eintrag verwendet.

   Achtung: Die Produkt-ID und der Produkttyp können nach dem Erstellen des Produkts nicht mehr geändert werden. Sie können den Produktnamen vor dem Einreichen ändern.

5. Klicken Sie auf Erstellen. Es kann einige Sekunden dauern, bis Ihr Produkt erstellt wurde.

Produktdetails hinzufügen

Die Produktdetails umfassen Ihren Produkteintrag im Cloud Marketplace, Marketinginformationen und Links zur Dokumentation.

So fügen Sie Produktdetails hinzu:

1. Klicken Sie in der Produktliste auf die Produkt-ID.

2. Klicken Sie auf der Seite Übersicht des Produkts auf Produktdetails und dann auf Bearbeiten.

3. Vervollständigen Sie den Tab PRODUKTINFO im Abschnitt Produktdetails. Beim Vervollständigen der PRODUKTINFO können Sie Kategorie-IDs hinzufügen. Mit Kategorie-IDs können Kunden Ihr Produkt bei der Suche in Cloud Marketplace unter ausgewählten Kategorien oder Filtern finden.

4. Um Anleitungen und Dokumentation hinzuzufügen und optional weitere Lizenzvereinbarungen hinzuzufügen, füllen Sie den Tab DOKUMENTATION auf der Seite Produktdetails aus. Die Dokumentation muss die Anforderungen für Nutzerhandbücher erfüllen.

5. Um Suchmetadaten oder Suchbegriffe hinzuzufügen oder die URL der Detailseite für Ihr Produkt anzupassen, vervollständigen Sie im Abschnitt Produktdetails den Tab PRODUKTMETADATEN.

6. Wenn Sie bereit sind, Ihre Produktdetails zur Verarbeitung einzureichen, klicken Sie auf Senden.

Es dauert etwa 2–5 Tage, bis das Partner Engineering-Team Ihre Produktdetails überprüft und genehmigt hat. Sie können jetzt mit der Bearbeitung der Details beginnen und sie später zur Prüfung einreichen.

Container-Images hinzufügen

Sie müssen eine Version erstellen, die dem Container Registry-Tag latest entspricht (Groß-/Kleinschreibung beachten). Dies ist die Standardversion auf der Produktseite.

So fügen Sie Container-Images hinzu:

1. Klicken Sie in der Produktliste auf die Produkt-ID.

2. Rufen Sie auf der Seite Übersicht des Produkts Container-Images auf und klicken Sie auf Bearbeiten.

3. Geben Sie im Abschnitt Container-Images die URL für das Staging-Repository für die Container Registry ein.

4. Klicken Sie auf Release angeben. Es kann einige Sekunden dauern, bis das Repository gelesen und Ihre Tags geladen wurden.

5. Wählen Sie das Display-Tag für den Release aus, den Sie in Ihr Produkt aufnehmen möchten. Sie müssen den Release latest in Ihr Produkt aufnehmen, können aber weitere Versionen hinzufügen. Aus Gründen der Nutzerfreundlichkeit sollten Sie die Anzahl der für Ihr Produkt verfügbaren Releases beschränken.

6. Fügen Sie optional einen Versionstitel und eine kurze Beschreibung des Release hinzu. Sie helfen Ihren Nutzern dabei, die gewünschte Version bereitzustellen.

7. Geben Sie das von diesem Release unterstützte Betriebssystem an. Bei Bedarf können Sie die Betriebssystemversion angeben.

8. Wenn Sie alle Informationen für den Release hinzugefügt haben, klicken Sie auf Fertig.

9. Klicken Sie zum Hinzufügen einer weiteren Version auf Release hinzufügen und geben Sie die Informationen für diesen Release ein.

10. Wenn Sie dem Produkt keine unterstützten Releases hinzugefügt haben, klicken Sie auf Speichern und validieren. Die Images werden in ein öffentliches Repository kopiert. Anschließend führen wir eine Reihe von Tests für die Images aus.

11. Klicken Sie auf Senden, um die Container-Images zur Überprüfung einzureichen.

Vorschau des Container-Image-Produkts ansehen

So rufen Sie eine Vorschau Ihres Cloud Marketplace-Eintrags auf, bevor er für Nutzer sichtbar ist:

1. Klicken Sie in der Produktliste auf die Produkt-ID.

2. Klicken Sie auf der Seite Übersicht des Produkts auf Vollständige Vorschau.

Wenn Sie seit der Validierung Ihrer Container-Images im Producer Portal Tags in Ihrem Staging-Repository geändert haben, sind die in der Vorschau referenzierten Images möglicherweise ungenau.

Container-Image-Produkt veröffentlichen

Damit Sie Ihr Produkt in Cloud Marketplace veröffentlichen können, müssen Sie:

• Schließen Sie die Rezensionen für Produktdetails und Container-Images ab.

• Sie müssen als Google Cloud Build-Partner genehmigt sein.

Nachdem alle Überprüfungen genehmigt wurden, können Sie das Produkt innerhalb weniger Minuten veröffentlichen und starten. So veröffentlichen Sie Ihr Produkt:

1. Klicken Sie in der Produktliste auf die Produkt-ID.

2. Klicken Sie auf der Seite Übersicht des Produkts auf Veröffentlichen.