Creare il pacchetto di deployment

Mantieni tutto organizzato con le raccolte Salva e classifica i contenuti in base alle tue preferenze.

Questa pagina descrive i passaggi per creare un pacchetto di deployment per un prodotto di macchine virtuali (VM). Per pubblicare il tuo prodotto in Google Cloud Marketplace, devi creare e inviare il pacchetto di deployment.

Un deployment è un insieme di risorse create e gestite insieme, ad esempio le risorse necessarie per il prodotto. Un pacchetto di deployment è una specifica per un insieme di risorse di cui viene solitamente eseguito il deployment insieme, in modo da semplificare il processo di deployment di quel particolare prodotto.

In questa guida, utilizzerai Deployment Manager per creare il tuo pacchetto di deployment. Deployment Manager consente di creare pacchetti di deployment per i prodotti VM utilizzando file di configurazione YAML, JSON o ProtoText semplici.

Determina come creare il pacchetto di deployment

Ti consigliamo di utilizzare l'opzione di configurazione guidata di Producer Portal per creare il tuo pacchetto di deployment direttamente in Google Cloud Console.

La configurazione guidata supporta prodotti semplici delle VM, come i deployment VM singola con regole firewall di base, ma non supporta alcune funzionalità complesse, come i deployment con più VM e campi di configurazione personalizzati. Se hai bisogno di funzionalità non supportate dalla configurazione guidata, puoi utilizzare lo strumento open source mpdev per creare il pacchetto di deployment o per personalizzare un pacchetto esistente aggiungendovi funzionalità aggiuntive.

Passare dalla configurazione guidata alla configurazione manuale

Se utilizzi l'opzione di configurazione guidata di Producer Portal e in seguito vuoi passare alla configurazione manuale del pacchetto di deployment, puoi fare clic su VAI ALLA CONFIGURAZIONE MANUALE per passare alla configurazione manuale.

Quando esegui il passaggio, puoi scaricare la specifica di generazione automatica per il pacchetto di deployment creato nella configurazione guidata, da utilizzare come base per la configurazione manuale.

Prima di iniziare

  1. Assicurati che il deployment non utilizzi Terraform o che non abbia dipendenze dipendenze.

  2. Se stai utilizzando lo strumento mpdev per creare il pacchetto di deployment, completa questi passaggi:

    1. Installa lo strumento mpdev seguendo le istruzioni nel repository marketplace-tools.
    2. Scarica Google Cloud SDK.

Crea e invia il tuo pacchetto di deployment

La sezione seguente spiega come creare il pacchetto di deployment e inviarlo a Google per la revisione.

Crea il pacchetto di deployment utilizzando uno dei seguenti metodi:

Creare un pacchetto di deployment utilizzando la console Google Cloud

Per creare e inviare un semplice pacchetto di deployment utilizzando la console Google Cloud:

  1. In Producer Portal, vai alla sezione Deployment package (Pacchetto di deployment).

  2. Seleziona la Configurazione guidata di soluzioni semplici e fai clic su CONTINUA.

  3. Nella sezione Configura specifica di generazione automatica, accanto al campo di immissione Bucket Cloud Storage, fai clic su SFOGLIA.

    Se hai già creato un bucket Cloud Storage, selezionalo qui.

    Se non hai un bucket Cloud Storage, fai clic sull'icona Crea nuovo bucket. Quando crei un nuovo bucket:

    • Seleziona un nome per il bucket.
    • Specifica la regione o le regioni in cui sono archiviati i dati.
    • Specifica la classe di archiviazione dei dati.
    • Determina il livello di granularità da applicare alle autorizzazioni IAM (Identity and Access Management) per i dati del bucket.
    • Configura le impostazioni avanzate facoltative, ad esempio i criteri di crittografia o conservazione dei dati.

  4. Assicurati che il controllo delle versioni degli oggetti sia abilitato per il bucket Cloud Storage.

  5. Per salvare le impostazioni del bucket e iniziare a configurare il pacchetto di deployment, fai clic su CONFIGURA.

  6. In Scegli l'immagine del tuo prodotto, seleziona la tua immagine VM.

    L'immagine VM selezionata deve essere:

    • Associato al tuo progetto Google Cloud attuale.

    • Allegato alla licenza corretta per il tuo prodotto. Tu crei e allega questa licenza quando crei l'immagine VM.

  7. In Scegli il tipo di macchina, devi specificare una Zona predefinita, un Tipo di macchina minimo e un Tipo di macchina predefinito per il tuo prodotto VM, oltre alle dimensioni e al tipo di disco di avvio.

  8. In Specifica il sistema operativo, devi specificare il nome e la versione del sistema operativo utilizzato dall'immagine VM, nonché il numero di versione dell'immagine VM.

  9. Facoltativamente, in Configura l'accesso alle VM, puoi specificare gli URL dei siti e degli amministratori, oltre a un nome utente e una password, che gli utenti possono utilizzare per accedere alla VM dopo il deployment.

  10. Facoltativamente, in Configura rete, puoi specificare le impostazioni per l'inoltro IP e configurare le regole Firewall.

  11. Facoltativamente, in Definisci i passaggi successivi, puoi fornire istruzioni agli utenti del tuo prodotto per aiutarli a iniziare a utilizzarlo. Queste istruzioni saranno visibili agli utenti dopo il deployment del tuo prodotto.

  12. Dopo aver completato i passaggi precedenti, fai clic su GENERA per creare il pacchetto di deployment.

    Se in seguito dovrai apportare ulteriori modifiche al pacchetto di deployment, puoi fare clic su MODIFICA per apportare le modifiche, quindi fai clic su GENERA per generare nuovamente il pacchetto di deployment applicando le modifiche.

    Se prevedi di passare alla configurazione manuale, puoi fare clic su SCARICA per scaricare la specifica di generazione automatica per il pacchetto di deployment creato nella configurazione guidata, da utilizzare come base per la configurazione manuale.

  13. Invia il pacchetto di deployment per la revisione in Producer Portal. Una volta inviato il pacco, potrebbero trascorrere fino a due settimane prima che Google lo esamini e lo approvi.

Crea un pacchetto di deployment utilizzando mpdev

Questa sezione spiega come utilizzare lo strumento mpdev per creare un pacchetto di deployment e inviarlo per la revisione.

Lo strumento mpdev utilizza Autogen Deployment Manager per generare i modelli di Deployment Manager per il tuo pacchetto di deployment. Lo strumento genera il pacchetto di deployment in base a una specifica di generazione automatica contenente gli input di configurazione per il prodotto VM.

A livello generale, per generare e inviare il pacchetto di deployment, devi:

  1. Creare e configurare un bucket Cloud Storage per archiviare e gestire l'accesso al pacchetto di deployment.
  2. Crea una specifica di generazione automatica che includa i dettagli delle immagini e i requisiti di deployment per il tuo prodotto VM.
  3. Genera il pacchetto di deployment in base alla specifica di generazione automatica e carica il pacchetto nel bucket Cloud Storage.
  4. Invia il pacchetto di deployment per la revisione in Producer Portal. Una volta inviato il pacco, potrebbero trascorrere fino a due settimane prima che Google lo esamini e lo approvi.

Le sezioni seguenti spiegano come completare i passaggi per generare e inviare il pacchetto di deployment.

Crea il tuo bucket Cloud Storage

Devi creare il bucket Cloud Storage nello stesso progetto Google Cloud pubblico che utilizzi per Producer Portal e configurare il bucket nei modi seguenti:

Per creare e configurare un bucket Cloud Storage, esegui questi comandi gsutil:

  BUCKET_NAME=YOUR_BUCKET_NAME
  gsutil mb $BUCKET_NAME
  gsutil versioning set on gs://$BUCKET_NAME
  gsutil iam ch "group:cloud-commerce-marketplace-onboarding@twosync-src.google.com:objectViewer" $BUCKET_NAME

Dove YOUR_BUCKET_NAME è il nome che fornisci per il nuovo bucket, soggetto ai requisiti di denominazione.

Crea la specifica di generazione automatica

Per creare la tua specifica di generazione automatica, ti consigliamo di utilizzare single VM example nel repository marketplace-tools come specifica iniziale di generazione automatica, quindi di personalizzare la specifica con i dettagli di configurazione della tua VM.

Per casi d'uso più complessi, puoi configurare il completamento automatico in alcuni ambienti di sviluppo integrati (IDE) per facilitare la modifica e la convalida dei file configurations.yaml.

Per creare la specifica di generazione automatica da single VM example:

  1. Consulta la specifica di generazione automatica preconfigurata dell'esempio in una directory locale:

    PACKAGE=YOUR_PACKAGE_NAME
mpdev pkg get https://github.com/GoogleCloudPlatform/marketplace-tools.git/examples/deployment-manager/autogen/singlevm $PACKAGE

    Dove YOUR_PACKAGE_NAME è il nome che fornisci per la directory locale. Ad esempio, my-deployment-package.

  2. Aggiorna la specifica con i dettagli di configurazione della VM modificando il file configurations.yaml con le seguenti informazioni:

    • Il nome dell'immagine VM.
    • ID per il progetto pubblico Google Cloud che ospita l'immagine VM, che è lo stesso che utilizzi per Producer Portal.

    Per i passaggi per aggiornare l'immagine VM e i campi del progetto Google Cloud nel file configurations.yaml, fai riferimento al file README.md di single VM example.

  3. Se richiesto per il tuo prodotto, personalizza campi aggiuntivi come passwords, deployInput e postDeploy. Questi campi si trovano sotto DeploymentSpec nel file configurations.yaml. Per ulteriori informazioni sui campi disponibili per la personalizzazione, consulta la documentazione di riferimento per la generazione automatica.

Genera il tuo pacchetto di deployment

Dopo aver creato e personalizzato la specifica di generazione automatica, utilizza la specifica per generare i file del modello di Deployment Manager per il pacchetto di deployment. Per archiviare il pacchetto, devi caricarlo nel bucket Cloud Storage.

Per generare e caricare il pacchetto di deployment:

  1. Imposta la località di output per il pacchetto di deployment sul bucket Cloud Storage:

    mpdev cfg set zipPath gs://BUCKET_NAME/OBJECT

    Dove BUCKET_NAME è il nome del bucket che hai creato per il pacchetto e OBJECT è il nome che fornisci per l'oggetto Cloud Storage, soggetto alle linee guida per la denominazione.

  2. Genera il pacchetto di deployment:

    mpdev apply -f $PACKAGE/configurations.yaml

Il pacchetto di deployment generato viene compresso e caricato nel bucket.

Per verificare che il modello sia configurato correttamente, puoi creare un deployment eseguendo questo comando:

  TMPDIR=$(mktemp -d)
  unzip $PACKAGE/template.zip -d $TMPDIR
  gcloud deployment-manager deployments create $PACKAGE --config $TMPDIR/test_config.yaml

Invia il pacchetto di deployment per la revisione in Producer Portal

Se utilizzi Producer Portal per creare la tua scheda di prodotto Cloud Marketplace, dopo averla creata devi inviare il pacchetto a Producer Portal in modo che il team di Cloud Marketplace possa esaminare e approvare il pacchetto.

Per inviare il pacchetto di deployment per la revisione:

Configurazione guidata

  1. In Producer Portal, vai alla sezione Deployment package (Pacchetto di deployment).

  2. Per inviare il pacchetto di deployment per la revisione in Producer Portal, fai clic su Submit (Invia). Una volta inviato il pacco, potrebbero trascorrere fino a due settimane prima che Google lo esamini e lo approvi.

Configurazione manuale

  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.

  2. Nell'elenco dei prodotti, fai clic sul nome del tuo prodotto.

  3. Nella pagina Panoramica del prodotto, vai alla sezione Pacchetti di deployment e fai clic su Modifica.

  4. In Specifica la località del tuo oggetto Cloud Storage, seleziona l'oggetto del pacchetto di deployment che hai caricato in precedenza.

  5. Fai clic su Convalida. Il completamento del processo di convalida può richiedere fino a due ore. Puoi uscire dalla schermata mentre è in corso.

  6. Dopo aver letto correttamente il pacchetto di deployment, Producer Portal puoi fare clic su Deployment Preview per visualizzare come il cliente vede la configurazione della tua VM.

  7. Al termine della convalida, per inviare il pacchetto di deployment per la revisione, fai clic su Invia. Una volta inviato il pacco, potrebbero trascorrere fino a due settimane prima che Google lo esamini e lo approvi.

Pacchetti di deployment dalla visualizzazione cliente

Le seguenti sezioni mostrano i layout delle schermate che i clienti vedono quando eseguono il deployment del tuo prodotto, per i prodotti basati su pacchetti di soluzioni standard generati automaticamente.

Vista di un cliente che ha eseguito il deployment di un pacchetto

Gli elementi di input standard dei clienti sono visualizzati sul lato sinistro del seguente screenshot e includono zona, tipo di macchina, opzioni del disco e opzioni di networking.

Se il deployment di un cliente richiede più schede di interfaccia di rete, può aggiungere interfacce di rete aggiuntive facendo clic su Aggiungi interfaccia di rete.

Per eseguire il deployment del prodotto, i clienti devono compilare i campi di immissione e fare clic su Esegui il deployment.

Visualizzazione cliente di un pacchetto di cui è stato eseguito il deployment

L'immagine seguente mostra come appare il prodotto ai clienti dopo che hanno eseguito correttamente il deployment.

Gli elementi di output standard vengono mostrati sul lato destro dello screenshot seguente e includono l'indirizzo del sito, la password amministratore temporanea e le informazioni sull'istanza.

Indietro
Creazione dell'immagine VM
Avanti
Test del prodotto VM