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, wem Sie Partnerentwickler ist: Partner Support Desk, wenn Sie Unterstützung benötigen. und das Wort „Marktplatz“ in der Beschreibung. Weitere Informationen zum Partner Support Desk finden Sie 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 Sie in Ihrem Produkt an dieses Repository verteilen möchten. In müssen Sie Ihrem Projekt die Rolle "Projektbearbeiter" cloud-commerce-marketplace-onboarding@twosync-src.google.com

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.

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 Push-Vorgänge Artifact Registry und die Artifact Analysis API ermöglichen Sicherheitsscans an.

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.

    • Staging-Repository muss sich innerhalb von us-docker.pkg.dev befinden oder gcr.io (andere Regionen, z. B. europe-docker.pkg.dev oder eu.gcr.io sind nicht noch unterstützt).
    • Speichern oder kopieren Sie den Staging-Repository-Pfad für die Produkterstellung in Producer Portal.
  2. Image erstellen, das per Push in das Artifact Registry-Staging übertragen werden soll zu erstellen.

  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 in Producer Portal.

Um Ihr Produkt im Producer Portal zu veröffentlichen, erstellen Sie einen Eintrag für Ihre und reichen Sie 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 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 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 der öffentlichen ID. 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 Die Produkt-ID wird in der URL Ihres Cloud Marketplace-Eintrags verwendet.

  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 Liste der Produkte auf die Produkt-ID.

  2. Gehen Sie auf der Seite Übersicht des Produkts zu Produktdetails. 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. Kategorie-IDs ermöglichen 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. Ihre Dokumente müssen den Anforderungen an Nutzerhandbücher.

  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 entspricht Registry-Tag latest (Groß-/Kleinschreibung beachten). Dies ist die Standardversion in 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 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ählen Sie das Anzeige-Tag für den Release aus, den Sie in Ihrem Produkt. 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 die Betriebssystemversion.

  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 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 Images werden in ein öffentliches Repository kopiert. und führen dann eine Reihe von Tests mit den Bildern durch.

  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 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

Damit Sie Ihr Produkt im Cloud Marketplace veröffentlichen können, müssen folgende Voraussetzungen erfüllt 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.