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 Onboardingprozesses Fragen haben, wenden Sie sich an Ihren Cloud Marketplace-Partnerentwickler. Wenn Sie nicht wissen, wer Ihr Partnerentwickler ist, fordern Sie über den Partner Support Desk Unterstützung an und fügen Sie in Ihrer Beschreibung das Wort „Marketplace“ hinzu. Weitere Informationen zum Partner Support Desk finden Sie unter Unterstützung für Cloud Marketplace anfordern.

Artifact Registry und IAM einrichten

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

Erste Schritte mit Container Registry

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

Für bestehende VM-Partner: Ihr Artifact Registry-Staging-Repository kann sich in Ihrem Entwicklungsprojekt statt in Ihrem öffentlichen Projekt befinden.

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 Daten per Push an Artifact Registry übertragen. Die Artifact Registry 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 Artifact Registry-Staging-Repositorys 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 wie europe-docker.pkg.dev oder 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 in Ihr Artifact Registry-Staging-Repository ü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.

   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 us-docker.pkg.dev/testpartner/testsolution/1.0 befindet, befindet es 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.

Zum Veröffentlichen Ihres Produkts im Producer Portal erstellen Sie einen Eintrag für das Produkt und reichen dann die folgenden Informationen zur Überprüfung ein:

• Produktdetails: Fügen Sie Informationen zu Einträgen und Marketinginformationen 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 Ihres Produkts:

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 über den Partner Support Desk Unterstützung an und fügen Sie in Ihrer Beschreibung das Wort „Marketplace“ hinzu. 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 Ihre Produktdetails hinzu:

1. Klicken Sie in der Liste der Produkte auf die Produkt-ID.

2. Rufen Sie auf der Seite Übersicht des Produkts Produktdetails auf und klicken Sie auf Bearbeiten.

3. Vervollständigen Sie den Tab PRODUKTINFO im Abschnitt Produktdetails. Beim Vervollständigen der PRODUKTINFO können Sie Kategorie-IDs hinzufügen. Mithilfe von 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 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 erstellen, die dem Container Registry-Tag latest entspricht (Groß-/Kleinschreibung beachten). Dies ist die Standardversion auf der Produktseite.

So fügen Sie Ihre Container-Images hinzu:

1. Klicken Sie in der Liste der Produkte auf die Produkt-ID.

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

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

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

5. Wählen Sie das Anzeige-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. Wir empfehlen, die Anzahl der für Ihr Produkt verfügbaren Releases zu begrenzen.

6. Fügen Sie optional einen Versionstitel und eine kurze Beschreibung des Release hinzu. Damit können Ihre Nutzer die gewünschte Version bereitstellen.

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

8. Nachdem Sie alle Informationen für die Veröffentlichung 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 Images werden in ein öffentliches Repository kopiert. Dann führen wir eine Reihe von Tests mit den Images aus.

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

Vorschau des Container-Image-Produkts ansehen

So sehen Sie sich eine Vorschau Ihres Cloud Marketplace-Eintrags an, bevor er für Nutzer sichtbar ist:

1. Klicken Sie in der Liste der Produkte auf die Produkt-ID.

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

Wenn Sie nach der Validierung der 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 im Cloud Marketplace veröffentlichen können, müssen folgende Voraussetzungen erfüllt sein:

• Schließen Sie die Prüfungen 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 Liste der Produkte auf die Produkt-ID.

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