Configurazione dei componenti tecnici

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

Se hai domande durante la procedura di onboarding, rivolgiti al tuo Ingegnere partner di Cloud Marketplace. Se non sai chi è il tuo Partner Engineer, utilizza il Partner Support Desk per richiedere assistenza e includi la parola "Marketplace" nella descrizione. Per ulteriori informazioni sul Partner Support Desk, consulta Richiedi assistenza per Cloud Marketplace.

Configurazione di Artifact Registry e IAM

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

Inizia a utilizzare Container Registry

Per eseguire il push delle immagini container taggate in Container Registry, segui la procedura descritta in Prima di iniziare nella documentazione di Artifact Registry. A questo punto, segui i passaggi riportati di seguito per attivare l'API Artifact Analysis.

Dopo aver installato gcloud e Docker, devi attivare le seguenti API dalla pagina Libreria API:

• API Artifact Registry
• API Artifact Analysis

L'API Artifact Registry ti consente di eseguire il push in Artifact Registry, mentre l'API Artifact Analysis consente di eseguire la scansione di sicurezza.

Se hai difficoltà ad accedere a una di queste API, contatta il tuo Partner Engineer.

Tagging e push delle immagini

1. Scegli il percorso del repository di staging di Artifact Registry. È consigliabile che il repository segua la strutturaus-docker.pkg.dev/YOUR-PARTNER-ID/YOUR-SOLUTION-ID.

   • Il repository di staging deve trovarsi in us-docker.pkg.dev o gcr.io (altre regioni, come europe-docker.pkg.dev o eu.gcr.io, non sono ancora supportate).
   • Salva o copia il percorso del repository di staging per la creazione del prodotto in Producer Portal.

2. Crea l'immagine che vuoi eseguire il push nel repository di staging di Artifact Registry.

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 con il tag latest viene estratta se un utente non specifica un tag.

4. Esegui il push dell'immagine utilizzando gcloud:

   gcloud docker push staging_repo_path:tag

5. Ripeti l'operazione per eventuali altri tag o immagini da aggiungere al repository di staging. Una singola immagine può avere più tag.

   • Ricorda che l'invio di un'immagine al repository di staging non la rende automaticamente visibile agli utenti. Questo accade solo per le immagini dei tag selezionati dopo la pubblicazione.
   • L'ambito di un repository è il singolo livello della cartella specificato dal percorso. Eventuali immagini all'interno di un'altra cartella nel repository non sono effettivamente nel repository stesso. In altre parole, se un'immagine è in us-docker.pkg.dev/testpartner/testsolution/1.0, non è nel repository us-docker.pkg.dev/testpartner/testsolution. us-docker.pkg.dev/testpartner/testsolution/1.0 è un repository separato.

Creazione del prodotto in Producer Portal

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

Per pubblicare il tuo prodotto in Producer Portal, crea una voce per il prodotto e poi invia le seguenti informazioni per la revisione:

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

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

Per creare la voce di Cloud Marketplace del tuo prodotto:

1. Apri il 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 del progetto pubblico che hai 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 del prodotto, assegna un nome al prodotto e controlla l'ID prodotto. L'ID prodotto viene utilizzato nell'URL della tua 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 scheda del prodotto su Cloud Marketplace, informazioni di marketing e link alla documentazione.

Per aggiungere i dettagli del prodotto:

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

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

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

4. Per aggiungere tutorial, documentazione e, facoltativamente, contratti di licenza aggiuntivi, compila la scheda DOCUMENTAZIONE della sezione Dettagli prodotto. La documentazione deve soddisfare i requisiti previsti per le guide utente.

5. Per aggiungere metadati o parole chiave per la rete di ricerca o per personalizzare l'URL della pagina dei dettagli del prodotto, compila la scheda METADATI DEL PRODOTTO della sezione Dettagli prodotto.

6. Quando è il momento di inviare i dettagli del prodotto per l'elaborazione, fai clic su Invia.

Il team di ingegneria dei partner impiega circa 2-5 giorni per esaminare e approvare i dettagli del prodotto. Puoi iniziare a modificare i dettagli ora e inviare la recensione in un secondo momento.

Aggiunta delle immagini container

Devi creare una versione corrispondente al tag Container Registry latest (sensibile alle maiuscole). Questa è la versione predefinita nella pagina del prodotto.

Per aggiungere le immagini container:

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

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

3. Nella sezione Immagini container, inserisci l'URL del repository Artifact Registry di staging.

4. Fai clic su Specifica release. Potrebbero essere necessari alcuni secondi per leggere il repository e caricare i tag.

5. Seleziona il tag display per la release che vuoi includere nel prodotto. Devi includere la release latest nel tuo prodotto, ma puoi aggiungere altre versioni. Per comodità degli utenti, ti consigliamo di limitare il numero di release disponibili per il tuo prodotto.

6. Se vuoi, aggiungi un Titolo versione e una breve descrizione della release. Aiutano gli utenti a implementare la versione che preferiscono.

7. Inserisci il sistema operativo supportato da questa release. Se necessario, puoi specificare la versione del sistema operativo.

8. Dopo aver aggiunto tutte le informazioni per la release, fai clic su Fine.

9. Per aggiungere un'altra versione, fai clic su Aggiungi release e inserisci le informazioni relative alla 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, quindi 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 tua 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 staging da quando hai convalidato le immagini container in Producer Portal, le immagini a cui si fa riferimento nell'anteprima potrebbero essere imprecise.

Pubblicare il prodotto immagine container

Per pubblicare il tuo prodotto su Cloud Marketplace, devi:

• Completa le recensioni dei dettagli del prodotto e delle immagini del contenitore.

• Essere approvato come partner di Google Cloud Build.

Una volta approvate tutte le revisioni, puoi pubblicare e lanciare il prodotto in 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.