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 consiste nell'utilizzare 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 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. Nella devi concedere il ruolo Editor di progetto [e-mail].

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. A questo punto, segui i passaggi riportati di seguito per attivare l'API Artifact Analysis.

Per i partner VM esistenti: il repository Artifact Registry di staging può trovarsi nel progetto di sviluppo anziché nel progetto pubblico.

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 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 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 la procedura per tutti gli altri tag o le altre immagini che vuoi aggiungere al repository di staging. 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 è 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, devi creare una voce per il prodotto e inviare 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.

   Nota: se non vedi il link o non puoi accedere all'URL, verifica di avere selezionato il progetto corretto e disporre del ruolo Editor (roles/editor) per del progetto. Se non riesci ancora ad accedere all'URL, utilizza il Partner Support Desk per richiedere assistenza e includi la parola "Marketplace" nella descrizione. Per ulteriori informazioni sul Partner Support Desk, visita la pagina Richiedi assistenza per Cloud Marketplace.

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.

   Attenzione: non è possibile modificare l'ID prodotto e il tipo di prodotto dopo il quando viene creato un prodotto. Puoi modificare il nome del prodotto prima di inviarlo.

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 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 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, contratti di licenza aggiuntivi, compila la scheda DOCUMENTAZIONE della sezione Dettagli prodotto. La documentazione deve soddisfare i requisiti per le guide dell'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 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 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 prodotto, ma puoi aggiungerne altre. Consigliamo di limitare il numero di disponibili per il tuo prodotto per i clienti la praticità.

6. Se vuoi, puoi aggiungere un titolo della 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 relative alla 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 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 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 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.