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, können Sie sich über den Partner-Supportdesk Hilfe holen. Geben Sie in Ihrer Beschreibung das Wort „Marktplatz“ an. Weitere Informationen zum Partner Support Desk finden Sie unter Hilfe mit dem Cloud Marketplace anfordern.

Artifact Registry und IAM-Einrichtung

Bevor du dein Produkt im Producer Portal erstellen kannst, musst du ein Staging-Repository für Artifact Registry erstellen und die Images, die du in deinem Produkt verteilen möchtest, dorthin per Push-Funktion übertragen. In Ihrem Projekt müssen Sie cloud-commerce-marketplace-onboarding@twosync-src.google.com die Rolle „Projektbearbeiter“ zuweisen.

Erste Schritte mit Container Registry

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

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

• Artifact Registry API
• Artifact Analysis API

Mit der Artifact Registry API können Sie per Push-Funktion in die Artifact Registry übertragen und die Artifact Analysis API ermöglicht Sicherheitsscans.

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 Artifact Registry aus. Es wird empfohlen, dass Ihr Repository der Struktur us-docker.pkg.dev/YOUR-PARTNER-ID/YOUR-SOLUTION-ID folgt.

   • Das Staging-Repository muss sich innerhalb von us-docker.pkg.dev oder gcr.io befinden. Andere Regionen, z. B. europe-docker.pkg.dev oder eu.gcr.io, werden noch nicht unterstützt.
   • Speichern Sie den Staging-Repository-Pfad oder kopieren Sie ihn, um im Producer Portal Produkte zu erstellen.

2. Erstellen Sie das Image, das Sie per Push-Funktion in Ihr Staging-Repository für Artifact 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 us-docker.pkg.dev/testpartner/testsolution:latest.

   Beachten Sie, dass das mit latest getaggte Bild abgerufen wird, wenn ein Nutzer kein Tag angibt.

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

   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: Ein Image, das sich in us-docker.pkg.dev/testpartner/testsolution/1.0 befindet, befindet sich NICHT im Repository us-docker.pkg.dev/testpartner/testsolution. us-docker.pkg.dev/testpartner/testsolution/1.0 ist ein separates Repository.

Produkt im Producer Portal erstellen

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

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

• Produktdetails: Fügen Sie Informationen zu Ihrem Unternehmen und Werbeinformationen zu Ihrem Produkt hinzu.
• Container-Images: Geben Sie das Google Container Registry-Repository an, das Ihre Container-Images enthält.

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

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

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

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.

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

Produktdetails hinzufügen

Produktdetails umfassen Produkteinträge im Cloud Marketplace, Marketinginformationen und Links zu Dokumentationen.

So fügen Sie Produktdetails hinzu:

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

2. Klicken Sie auf der Seite Übersicht Ihres 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. Anhand von Kategorie-IDs finden Kunden Ihr Produkt unter Einsatz ausgewählter Kategorien oder Filter bei der Suche im Cloud Marketplace.

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 an 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 mit dem Container Registry-Tag latest (Groß-/Kleinschreibung beachten) erstellen. Das ist die Standardversion auf der Produktseite.

So fügen Sie Ihre Container-Images hinzu:

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

2. Klicken Sie auf der Seite Übersicht Ihres Produkts auf Container-Images und dann auf Bearbeiten.

3. Geben Sie im Bereich Container-Images die URL für Ihr Staging-Artifact Registry-Repository ein.

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

5. Wähle das Display-Tag für den Release aus, den du in deinem Produkt verwenden möchtest. Sie müssen die latest-Version in Ihrem Produkt verwenden, können aber auch zusätzliche Versionen hinzufügen. Wir empfehlen, die Anzahl der für Ihr Produkt verfügbaren Releases einzuschränken, um die Nutzerfreundlichkeit zu erhöhen.

6. Optional können Sie einen Versionstitel und eine kurze Beschreibung der Version hinzufügen. So können Ihre Nutzer die gewünschte Version bereitstellen.

7. Geben Sie das Betriebssystem ein, das von dieser Version unterstützt wird. Sie können bei Bedarf die Betriebssystemversion angeben.

8. Nachdem Sie alle Informationen für die Version hinzugefügt haben, klicken Sie auf Fertig.

9. Wenn Sie eine weitere Version hinzufügen möchten, klicken Sie auf Release hinzufügen und geben Sie die Informationen für diesen Release ein.

10. Wenn Sie Ihrem Produkt alle unterstützten Releases hinzugefügt haben, klicken Sie auf Speichern und validieren. Die Bilder werden in ein öffentliches Repository kopiert und wir führen dann eine Reihe von Tests an den Bildern durch.

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

Vorschau Ihres Container-Image-Produkts

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 Ihres 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 nicht korrekt.

Container-Image-Produkt veröffentlichen

Wenn Sie Ihr Produkt im Cloud Marketplace veröffentlichen möchten, müssen Sie Folgendes tun:

• Füllen Sie die Überprüfungen für Produktdetails und Container-Images aus.

• Sie müssen als Google Cloud Build-Partner zugelassen 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 Ihres Produkts auf Veröffentlichen.