Configurazione dei componenti tecnici

Questa pagina illustra come creare i componenti tecnici chiave necessari per: di distribuzione del prodotto con immagini container con Google Cloud Marketplace.

Se hai domande durante il processo di onboarding, rivolgiti al tuo Partner Engineer di Cloud Marketplace. Se non sai a chi è stato assegnato Il Partner Engineer prevede di utilizzare Partner Support Desk per richiedere assistenza. e includi la parola "Marketplace" nella descrizione. Per ulteriori informazioni informazioni su Partner Support Desk, visita Richiedi assistenza per Cloud Marketplace.

Artifact Registry e configurazione IAM

Prima di poter creare il tuo prodotto in Producer Portal, devi creare un repository Artifact Registry gestione temporanea ed eseguire il push le immagini che vuoi distribuire nel tuo prodotto in quel repository. Nel devi concedere il ruolo Editor di progetto cloud-commerce-marketplace-onboarding@twosync-src.google.com.

Introduzione a Container Registry

Per eseguire il push di immagini container con tag in Container Registry, segui le passaggi in Prima di iniziare nella Documentazione di Artifact Registry. Quindi, segui i passaggi riportati di seguito per abilitare l'API Artifact Analysis.

Dopo aver installato gcloud e Docker, devi abilitare le API seguenti dal Pagina della libreria API:

  • API Artifact Registry
  • API Artifact Analysis

L'API Artifact Registry ti consente di eseguire il push Artifact Registry e l'API Artifact Analysis consentono analisi della sicurezza.

Se hai problemi ad accedere a una di queste API, contatta il tuo partner Ingegnere.

Tagging e trasferimento delle immagini

  1. Scegli il percorso del repository di gestione temporanea di Artifact Registry. È ha consigliato che il repository segua la struttura us-docker.pkg.dev/YOUR-PARTNER-ID/YOUR-SOLUTION-ID.

    • Il repository temporaneo deve trovarsi all'interno di us-docker.pkg.dev o gcr.io (altre regioni, ad esempio europe-docker.pkg.dev o eu.gcr.io, non sono ancora supportati).
    • Salva o copia il percorso del repository di gestione temporanea per la creazione dei prodotti in Producer Portal.
  2. Crea l'immagine di cui vuoi eseguire il push alla gestione temporanea di Artifact Registry repository Git.

  3. Tagga l'immagine tramite Docker con latest.

    docker tag image_name staging_repo_path:tag

    Ad esempio: docker tag test-image us-docker.pkg.dev/testpartner/testsolution:latest

    Tieni presente che l'immagine taggata latest viene estratta se un utente non specifica un del tag.

  4. Esegui il push dell'immagine utilizzando gcloud:

    gcloud docker push staging_repo_path:tag

  5. Ripeti la procedura per tutti i tag o le immagini che vuoi aggiungere alla gestione temporanea. repository Git. Una singola immagine può avere più tag.

    • Ricorda che il push di un'immagine al repository gestione temporanea li rendono automaticamente visibili agli utenti; Questo accade solo alle immagini dei tag selezionati dopo la loro pubblicazione.
    • L'ambito di un repository è il singolo livello del percorso della cartella specifica. Qualsiasi immagine che si trova all'interno di un'altra cartella nel repository non si trovano effettivamente nel repository stesso. In altre parole, se un'immagine è in us-docker.pkg.dev/testpartner/testsolution/1.0, è NON in us-docker.pkg.dev/testpartner/testsolution repository Git. us-docker.pkg.dev/testpartner/testsolution/1.0 è un repository separato.

Creare il tuo prodotto in Producer Portal

Questa sezione descrive come creare e pubblicare il prodotto immagine container in Producer Portal.

Per pubblicare il tuo prodotto in Producer Portal, devi creare una voce per il tuo prodotto, quindi invii le seguenti informazioni per la revisione:

  • Dettagli del prodotto: aggiungi le schede e le informazioni di marketing relative al prodotto.
  • Immagini container: fornisci il repository di Google Container Registry che include le immagini container.

Puoi inviare queste recensioni in qualsiasi momento e in qualsiasi ordine.

Per creare la voce Cloud Marketplace del tuo prodotto:

  1. Apri Producer Portal nella console Google Cloud:

    https://console.cloud.google.com/producer-portal?project=YOUR_PUBLIC_PROJECT_ID
    

    Sostituisci YOUR_PUBLIC_PROJECT_ID con l'ID per il pubblico creato per Cloud Marketplace, ad esempio my-organization-public.

  2. Nella parte superiore della pagina, fai clic su Aggiungi prodotto.

  3. Seleziona Immagine container.

  4. In Nome prodotto, assegna un nome al prodotto e controlla l'ID prodotto. La L'ID prodotto viene utilizzato nell'URL della scheda di Cloud Marketplace.

  5. Fai clic su Crea. La creazione del prodotto potrebbe richiedere alcuni secondi.

Aggiunta dei dettagli del prodotto

I dettagli del prodotto includono la tua scheda di prodotto su Cloud Marketplace, informazioni di marketing e link alla documentazione.

Per aggiungere i dettagli dei tuoi prodotti:

  1. Nell'elenco dei prodotti, fai clic sull'ID prodotto.

  2. Nella pagina Panoramica del tuo prodotto, vai a Dettagli prodotto. e fai clic su Modifica.

  3. Compila la scheda INFORMAZIONI SUL PRODOTTO della sezione Dettagli prodotto. Mentre Se completi INFORMAZIONI SUL PRODOTTO, puoi aggiungere gli ID categoria. Gli ID categoria consentono ai clienti di trovare il tuo prodotto in determinate categorie o filtri mentre eseguire una ricerca in Cloud Marketplace.

  4. Per aggiungere tutorial, documentazione e, facoltativamente, anche contratti di licenza, compila la scheda DOCUMENTAZIONE del Prodotto Dettagli. La documentazione deve soddisfare i requisiti per le guide dell'utente.

  5. Per aggiungere metadati o parole chiave per la ricerca o personalizzare l'URL dei dettagli per il tuo prodotto, compila la scheda METADATI DEI PRODOTTI del Sezione Dettagli prodotto.

  6. Quando sei pronto per inviare i dettagli dei tuoi prodotti per l'elaborazione, fai clic su Invia.

Il team Partner Engineering impiega circa 2-5 giorni per rivedere e approvare i dettagli del prodotto. Puoi iniziare a modificare i dettagli ora e inviare la revisione in un secondo momento.

Aggiunta delle immagini container

Devi creare una versione corrispondente al container Tag del registro latest (sensibile alle maiuscole). Questa è la versione predefinita in pagina del prodotto.

Per aggiungere le immagini container:

  1. Nell'elenco dei prodotti, fai clic sull'ID prodotto.

  2. Nella pagina Panoramica del prodotto, vai a Immagini container, e fai clic su Modifica.

  3. Nella sezione Immagini container, inserisci l'URL della gestione temporanea repository Artifact Registry.

  4. Fai clic su Specifica l'uscita. Potrebbero essere necessari alcuni secondi per leggere repository e caricare i tag.

  5. Seleziona il tag display per la release che vuoi includere nella prodotto. Devi includere la release latest nel prodotto, ma puoi aggiungerne altre. Consigliamo di limitare il numero di le release disponibili per il tuo prodotto per i la praticità.

  6. Se vuoi, puoi aggiungere un titolo della versione e una breve descrizione della release. Aiutano gli utenti a eseguire il deployment della versione che cercano.

  7. Inserisci il sistema operativo supportato da questa release. Puoi specificare del sistema operativo, se necessario.

  8. Dopo aver aggiunto tutte le informazioni relative alla release, fai clic su Fine.

  9. Per aggiungere un'altra versione, fai clic su Aggiungi release e inserisci le informazioni per quella release.

  10. Quando hai finito di aggiungere le release supportate al tuo prodotto, fai clic su Salva e convalida. Le immagini vengono copiate in un repository pubblico dopodiché eseguiamo una serie di test sulle immagini.

  11. Fai clic su Invia per inviare le immagini del contenitore per la revisione.

Visualizza l'anteprima del prodotto con immagine container

Per visualizzare l'anteprima della scheda di Cloud Marketplace prima che sia visibile agli utenti:

  1. Nell'elenco dei prodotti, fai clic sull'ID prodotto.

  2. Nella pagina Panoramica del prodotto, fai clic su Anteprima completa.

Se hai modificato i tag nel repository di gestione temporanea dopo aver convalidato immagini container in Producer Portal, le immagini a cui viene fatto riferimento nell'anteprima non essere precisi.

Pubblica il prodotto con immagine container

Per pubblicare il tuo prodotto su Cloud Marketplace, devi:

Dopo che tutte le recensioni sono state approvate, puoi pubblicare e lanciare il prodotto entro pochi minuti. Per pubblicare il tuo prodotto:

  1. Nell'elenco dei prodotti, fai clic sull'ID prodotto.

  2. Nella pagina Panoramica del prodotto, fai clic su Pubblica.