Configurazione dei componenti tecnici

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

In caso di domande durante il processo di onboarding, contatta il tuo Partner Engineer di Cloud Marketplace. Se non sai a chi è assegnato il Partner Engineer, utilizza il Partner Support Desk per richiedere assistenza e includi la parola "Marketplace" nella descrizione. Per ulteriori informazioni su Partner Support Desk, visita la pagina Richiedere assistenza con Cloud Marketplace.

Configurazione di Container Registry e IAM

Prima di poter creare il prodotto in Producer Portal, devi creare un repository Container Registry gestione temporanea ed eseguire il push delle immagini che vuoi distribuire nel prodotto in quel repository. Nel progetto, devi concedere il ruolo Editor di progetto a [e-mail].

Introduzione a Container Registry

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

Per i partner VM esistenti: il repository di Container Registry di gestione temporanea può trovarsi all'interno del tuo progetto di sviluppo anziché del tuo progetto pubblico.

Dopo aver installato gcloud e Docker, devi abilitare le seguenti API dalla pagina della libreria API:

• API Container Registry
• API Artifact Analysis

L'API Container Registry consente il push a Container Registry, mentre l'API Artifact Analysis consente l'analisi della sicurezza.

Se non riesci ad accedere a una di queste API, contatta il tuo Partner Engineer.

Tagging e push delle immagini

1. Scegli il percorso del repository gestione temporanea di Container Registry. È consigliabile che il repository segua la struttura gcr.io/YOUR-PARTNER-ID/YOUR-SOLUTION-ID.

   • Il repository temporaneo deve essere all'interno di gcr.io (altre regioni, ad esempio eu.gcr.io, non sono ancora supportate).
   • Salva o copia il percorso del repository gestione temporanea per la creazione dei prodotti in Producer Portal.

2. Crea l'immagine di cui vuoi eseguire il push nel repository gestione temporanea di Container Registry.

3. Applica il tagging all'immagine tramite Docker con latest.

   docker tag image_name staging_repo_path:tag

   Ad esempio, docker tag test-image gcr.io/testpartner/testsolution:latest

   Tieni presente che l'immagine taggata 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 eventuali altri tag o immagini che vuoi aggiungere al repository di gestione temporanea. Una singola immagine può avere più tag.

   • Tieni presente che il push di un'immagine nel repository di gestione temporanea non rende automaticamente visibile agli utenti; questo accade solo per le immagini dei tag che selezioni, dopo la pubblicazione.
   • L'ambito di un repository è il livello singolo della cartella specificata dal relativo percorso. Le immagini che si trovano in un'altra cartella del repository non si trovano effettivamente nel repository stesso. In altre parole, se un'immagine si trova in gcr.io/testpartner/testsolution/1.0, NON si trova nel repository gcr.io/testpartner/testsolution. gcr.io/testpartner/testsolution/1.0 è un repository separato.

Creazione del prodotto nel Producer Portal in corso...

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

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

• Dettagli prodotto: aggiungi informazioni di marketing e della scheda del 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 di Cloud Marketplace per il 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 del progetto pubblico che hai creato per Cloud Marketplace, ad esempio my-organization-public.

   Nota: se non vedi il link o non riesci ad accedere all'URL, verifica di aver selezionato il progetto corretto e di disporre del ruolo Editor (roles/editor) per il 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 Richiedere assistenza con Cloud Marketplace.

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. L'ID prodotto viene utilizzato nell'URL della tua scheda di Cloud Marketplace.

   Attenzione: l'ID prodotto e il tipo di prodotto non possono essere modificati dopo la creazione del prodotto. Puoi modificare il nome del prodotto prima di inviarlo.

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

Aggiungere i dettagli del prodotto

I dettagli del prodotto includono la tua scheda di prodotto su Cloud Marketplace, le informazioni di marketing e i 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 prodotto, vai a Dettagli prodotto e fai clic su Modifica.

3. Compila la scheda INFORMAZIONI SUL PRODOTTO nella sezione Dettagli prodotto. Durante la compilazione di INFORMAZIONI SUL PRODOTTO, puoi aggiungere ID categoria. Gli ID categoria consentono ai clienti di trovare il tuo prodotto in determinate categorie o filtri durante le ricerche in Cloud Marketplace.

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

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

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

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

Aggiunta delle immagini container

Devi creare una versione corrispondente al tag di registro dei container 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 Panoramica del prodotto, vai a Immagini container e fai clic su Modifica.

3. Nella sezione Immagini container, inserisci l'URL del repository Container Registry gestione temporanea.

4. Fai clic su Specifica release. La lettura del repository e il caricamento dei tag potrebbero richiedere alcuni secondi.

5. Seleziona il tag visualizzato 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 release disponibili per il prodotto per comodità degli utenti.

6. Se vuoi, aggiungi un Titolo versione e una breve descrizione della release. che aiutano gli utenti a eseguire il deployment della 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 sottoporre a revisione le immagini container.

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 dei tag nel repository gestione temporanea da quando hai convalidato le immagini container in Producer Portal, le immagini a cui viene fatto riferimento nell'anteprima potrebbero non essere precise.

Pubblica il prodotto con immagine container

Per pubblicare il tuo prodotto su Cloud Marketplace, devi:

• Completa le revisioni Dettagli prodotto e Immagini container.

• Avere l'approvazione come partner Google Cloud Build.

Dopo che tutte le recensioni sono state approvate, 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.