Configura l'immagine VM per il deployment di Deployment Manager

Se scegli di supportare il deployment con Deployment Manager per il tuo prodotto VM, devi completare i seguenti passaggi.

Attenzione: la funzionalità Azioni di Deployment Manager non è più supportata. Se il tuo prodotto si basa su questa funzionalità, 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.

Determina come creare il pacchetto di deployment

Ti consigliamo di utilizzare l'opzione di configurazione guidata del Producer Portal per creare il pacchetto di deployment direttamente nella console Google Cloud.

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

Sconsigliamo di utilizzare modelli di deployment personalizzati creati senza utilizzare la console Google Cloud o lo strumento di generazione automatica di Deployment Manager con Cloud Marketplace. Ti consigliamo di creare il pacchetto di deployment direttamente nella console Google Cloud.

Passare dalla configurazione guidata a quella manuale e viceversa

Se utilizzi l'opzione di configurazione guidata di Producer Portal e in un secondo momento vuoi passare alla configurazione manuale del pacchetto di deployment, fai clic su Vai alla configurazione manuale.

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

Nota: quando passi dalla configurazione guidata alla configurazione manuale del pacchetto di deployment, annulli tutte le convalide in esecuzione per il metodo di configurazione precedente.

Completare la configurazione guidata

Per completare la configurazione e inviare un semplice pacchetto di deployment utilizzando la console Google Cloud, completa i seguenti passaggi:

1. In Producer Portal, vai alla sezione Pacchetto di deployment.

2. In Configurazione di Deployment Manager, fai clic su Sfoglia accanto al campo di immissione Bucket Cloud Storage.

   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 il bucket archivia i dati.
   • Specifica la classe di archiviazione per i tuoi 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 la crittografia o i criteri di conservazione dei dati.

3. Assicurati di abilitare il controllo delle versioni degli oggetti per il tuo bucket Cloud Storage.

4. Per salvare le impostazioni del bucket e continuare a configurare il pacchetto di deployment, fai clic su Configura.

5. In Scegli il tipo di macchina, devi specificare una Zona predefinita, un Tipo di macchina minimo e un Tipo di macchina predefinito per il prodotto VM, nonché le dimensioni e il tipo del relativo disco di avvio.

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

7. Facoltativamente, in Configura l'accesso alla VM, puoi specificare gli URL del sito e dell'amministratore, insieme a un nome utente e una password, che gli utenti possono utilizzare per accedere alla VM dopo il deployment.

8. Se vuoi, in Configura la rete puoi specificare le impostazioni per il forwarding IP e configurare le regole del firewall.

9. Se vuoi, in Definire i passaggi successivi puoi fornire istruzioni per aiutare gli utenti del tuo prodotto a iniziare a utilizzarlo. Queste istruzioni saranno visibili dopo il deployment del prodotto.

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

    Se in un secondo momento dovrai apportare ulteriori modifiche al pacchetto di deployment, puoi fare clic su Modifica per apportare le modifiche e poi su Genera per rigenerare il pacchetto di deployment con le modifiche applicate.

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

11. Invia il pacchetto di deployment per la revisione in Producer Portal. Dopo l'invio del pacchetto, potrebbero essere necessarie fino a due settimane prima che Google lo esamini e approvi.

Completa la configurazione manuale

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

Lo strumento mpdev utilizza la funzionalità Generazione automatica di Deployment Manager per generare i modelli di Deployment Manager per il pacchetto di deployment. Lo strumento genera il pacchetto di deployment in base a una specifica di generazione automatica che contiene gli input di configurazione per il prodotto VM.

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

1. Crea e configura 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 dell'immagine e i requisiti di deployment per il prodotto VM.
3. Genera il pacchetto di deployment in base alla specifica di generazione automatica e caricalo nel bucket Cloud Storage.
4. Invia il pacchetto di deployment per la revisione nel Producer Portal. Dopo che hai inviato il pacchetto, potrebbero essere necessarie fino a due settimane perché Google lo esamini e approvi.

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

Prima di iniziare

Se utilizzi mpdev per creare il pacchetto di deployment, completa i seguenti passaggi:

1. Installa lo strumento mpdev seguendo le istruzioni nel repository marketplace-tools.

2. Scarica l'SDK Google Cloud.

Crea il bucket Cloud Storage

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

• Abilita il controllo delle versioni degli oggetti per il bucket per proteggere il pacchetto di deployment dall'eliminazione o dalla sovrascrittura.
• Concedi il ruolo Visualizzatore oggetti Storage (roles/storage.objectViewer) a [e-mail].

Per creare e configurare un bucket Cloud Storage, esegui i seguenti comandigcloud storage:

  BUCKET_NAME=YOUR_BUCKET_NAME
  gcloud storage buckets create gs://$BUCKET_NAME
  gcloud storage buckets update gs://$BUCKET_NAME --versioning
  gcloud storage buckets add-iam-policy-binding gs://$BUCKET_NAME --member=group:[e-mail] --role=roles/storage.objectViewer
  

dove YOUR_BUCKET_NAME è il nome fornito per il nuovo bucket, soggetto ai requisiti di denominazione.

Crea la tua specifica di generazione automatica

Per creare la specifica di generazione automatica, ti consigliamo di utilizzare single VM example nel repository marketplace-tools come specifica di generazione automatica iniziale, quindi di personalizzarla con i dettagli di configurazione della 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.

Nota: se il tuo deployment contiene più VM, puoi creare e personalizzare la specifica della generazione automatica in base a multi VM example del repository.

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

1. Controlla 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 fornito 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.
   • Il ID per il progetto Google Cloud pubblico che ospita l'immagine VM, che è lo stesso progetto che utilizzi per il Producer Portal.

   Per la procedura di aggiornamento dei campi dell'immagine VM e del progetto Google Cloud nel file configurations.yaml, consulta il file README.md di single VM example.

3. Se necessario per il tuo prodotto, personalizza campi aggiuntivi, ad esempio passwords, deployInput e postDeploy. Questi campi si trovano sotto DeploymentSpec nel file configurations.yaml. Per scoprire di più sui campi disponibili per la personalizzazione, consulta la documentazione di riferimento di Autogen.

Genera il pacchetto di deployment

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

Per generare e caricare il pacchetto di deployment:

1. Imposta la posizione di output del pacchetto di deployment nel tuo bucket Cloud Storage:

   Nota: puoi utilizzare il seguente comando se hai utilizzato uno dei Autogen specification examples nel repository marketplace-tools. Se hai creato la specifica di generazione automatica manualmente, devi modificare direttamente il file della specifica per aggiornare la posizione di output.

   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 fornito per l'oggetto Cloud Storage, in base 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 di aver configurato correttamente il modello, crea un deployment eseguendo il seguente comando:

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

Inviare il pacchetto di deployment per la revisione in Producer Portal

Dopo aver creato e configurato il pacchetto di deployment, devi inviarlo a Producer Portal affinché il team di Cloud Marketplace possa esaminarlo e approvarlo.

1. In Producer Portal, vai alla sezione Pacchetto di deployment.

2. In Specifica la posizione dell'oggetto Cloud Storage, seleziona l'oggetto del pacchetto di deployment che hai caricato in precedenza.

3. Fai clic su Validate (Convalida). Il completamento della procedura di convalida può richiedere fino a due ore e puoi uscire dallo schermo durante il completamento.

4. Dopo che Producer Portal ha letto correttamente il pacchetto di deployment, puoi fare clic su Anteprima di deployment per visualizzare la configurazione della VM vista dal cliente.

5. Una volta completata la convalida, fai clic su Invia per inviare il pacchetto di deployment per la revisione. Dopo che avrai inviato il pacchetto, potrebbero essere necessarie fino a due settimane prima che Google lo esamini e approvi.