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 passaggi seguenti.

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

Stabilisci come creare il tuo pacchetto di deployment

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

La configurazione guidata supporta prodotti VM semplici, ad esempio deployment su 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.

Non è consigliabile 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 alla configurazione manuale e viceversa

Se utilizzi l'opzione di configurazione guidata di Producer Portal e in seguito 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 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.

Completa 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, accanto al campo di immissione denominato 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 il bucket archivia i dati.
   • Specifica la classe di archiviazione per i dati.
   • Determina il livello di granularità da applicare alle autorizzazioni IAM (Identity and Access Management) per i dati del bucket.
   • Configura impostazioni avanzate facoltative, ad esempio criteri di crittografia o conservazione dei dati.

3. Assicurati di aver abilitato il controllo delle versioni degli oggetti per il 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 tuo prodotto VM, insieme alle dimensioni e al 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 VM, nonché il numero di versione dell'immagine VM.

7. Facoltativamente, in Configura l'accesso alle 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. Facoltativamente, in Configura rete, puoi specificare le impostazioni per l'inoltro IP e configurare le regole Firewall.

9. Facoltativamente, in Definisci i passaggi successivi puoi fornire istruzioni agli utenti del tuo prodotto per guidarli nella loro fase iniziale. Queste istruzioni saranno visibili dopo che avranno eseguito 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 devi apportare ulteriori modifiche al pacchetto di deployment, puoi fare clic su Modifica, quindi 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 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 aver inviato il pacco, Google potrebbe impiegare fino a due settimane per esaminare e approvare il pacco.

Completare 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 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:

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 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. Dopo aver inviato il pacco, Google potrebbe impiegare fino a due settimane per esaminare e approvare il pacco.

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 Google Cloud SDK.

Crea il 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:

• Abilita il controllo delle versioni degli oggetti per il bucket per proteggere il tuo 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 questi comandi gsutil:

  BUCKET_NAME=YOUR_BUCKET_NAME
  gsutil mb $BUCKET_NAME
  gsutil versioning set on gs://$BUCKET_NAME
  gsutil iam ch "group:[e-mail]: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 specifica di generazione automatica, ti consigliamo di utilizzare single VM example nel repository marketplace-tools come specifica iniziale di generazione automatica, 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 modificare e convalidare i file configurations.yaml.

Nota: se il deployment contiene più VM, puoi creare e personalizzare la specifica di generazione automatica in base alla specifica 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 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.
   • Il valore ID per il progetto Google Cloud pubblico che ospita l'immagine VM, ovvero lo stesso progetto che utilizzi per Producer Portal.

   Per i passaggi per aggiornare i 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 prodotto, personalizza altri campi, come 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 sulla generazione automatica.

Genera il pacchetto di deployment

Dopo aver creato e personalizzato la specifica di generazione automatica, utilizzala per generare i file del 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 località di output del pacchetto di deployment nel bucket Cloud Storage:

   Nota: puoi utilizzare il seguente comando se hai utilizzato una delle proprietà 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 località di output.

   mpdev cfg set zipPath gs://BUCKET_NAME/OBJECT
   

   Dove BUCKET_NAME è il nome del bucket creato per il pacchetto e OBJECT è il nome che fornisci per l'oggetto Cloud Storage, in conformità alle linee guida per l'assegnazione dei nomi.

2. Genera il pacchetto di deployment:

   mpdev apply -f $PACKAGE/configurations.yaml
   

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

Per verificare di aver configurato correttamente il modello, crea 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

Dopo aver creato e configurato il pacchetto di deployment, devi inviarlo a Producer Portal in modo che 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 Convalida. Il completamento della procedura di convalida può richiedere fino a due ore, mentre puoi uscire dalla schermata.

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

5. Una volta completata la convalida, fai clic su Invia per inviare il pacchetto di deployment per la revisione. Dopo aver inviato il pacco, Google potrebbe impiegare fino a due settimane per esaminare e approvare il pacco.