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 an uns wenden. Geben Sie in Ihrer Beschreibung das Wort „Marktplatz“ an. Weitere Informationen zum Partner Support Desk finden Sie Unterstützung für 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 [e-mail] die Rolle „Projektbearbeiter“ zuweisen.

Erste Schritte mit Container Registry

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

Für bestehende VM-Partner: Sie können Ihr Staging-Repository für Artifact Registry in Ihrem Entwicklungsprojekt statt in Ihrem öffentlichen Projekt erstellen.

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

• 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 gekennzeichnete Image abgerufen wird, wenn ein Nutzer keinen Tag.

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 ein Bild befindet sich in us-docker.pkg.dev/testpartner/testsolution/1.0, es ist NICHT im us-docker.pkg.dev/testpartner/testsolution zu erstellen. 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 Repository für Google Container Registry an. die 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. Ö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 der öffentlichen ID. 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, verwenden Sie das Partner Support Desk Hilfe und fügen Sie das Wort „Marktplatz“ in der Beschreibung. Weitere Informationen zum Partner-Supportdesk finden Sie unter Hilfe zum 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 Die Produkt-ID wird in der URL Ihres Cloud Marketplace-Eintrags 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

Zu den Produktdetails gehören Ihr Produkteintrag im Cloud Marketplace, Marketinginformationen und Links zur Dokumentation.

So fügen Sie Ihre 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. Kategorie-IDs ermöglichen können Kunden Ihr Produkt unter ausgewählten Kategorien oder Filtern finden, Cloud Marketplace suchen können.

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 das Staging ein. Artifact Registry-Repository.

4. Klicken Sie auf Release angeben. Es kann einige Sekunden dauern, bis Sie Repository und laden Sie Ihre Tags.

5. Wähle das Display-Tag für den Release aus, den du in deinem Produkt verwenden möchtest. Du musst den Release latest in dein Produkt aufnehmen, aber können Sie weitere Versionen hinzufügen. Wir empfehlen, die Anzahl der Veröffentlichungen, die für Ihr Produkt für die Komfort zu bieten.

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. 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 ein. für diese Version.

10. Wenn Sie Ihrem Produkt alle unterstützten Releases hinzugefügt haben, klicken Sie auf Speichern und validieren Sie Ihre Eingaben. 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 Liste der Produkte auf die Produkt-ID.

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

Wenn Sie seit der Validierung des Staging-Repositorys Tags in Ihrem Staging-Repository geändert haben, Container-Images im Producer Portal können die Images, auf die in der Vorschau verwiesen wird, ungenau sein.

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 muss genehmigt sein als Google Cloud Build-Partner.

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.