Esegui il deployment di prodotti di macchine virtuali (VM) utilizzando l'interfaccia a riga di comando (CLI)

I prodotti di macchine virtuali (VM) offerti tramite Google Cloud Marketplace sono istanze VM personalizzate che puoi eseguire su Compute Engine. Per una panoramica dei concetti di Compute Engine, consulta la documentazione di Compute Engine.

Alcuni prodotti VM su Google Cloud Marketplace supportano il deployment tramite l'interfaccia a riga di comando (CLI) utilizzando Terraform, uno strumento open source per il provisioning e la gestione dell'infrastruttura. Per saperne di più su Terraform, consulta la Guida introduttiva all'utilizzo di Terraform.

Panoramica

Questa pagina descrive i passaggi per eseguire il deployment dei prodotti VM tramite l'interfaccia a riga di comando utilizzando Terraform. In linea generale, devi:

Visita la sezione pertinente della scheda di Google Cloud Marketplace del prodotto.
Facoltativamente, seleziona o crea l'account di servizio da utilizzare per il deployment della riga di comando.
Facoltativamente, configura l'impersonificazione degli account di servizio.
Configura il tuo ambiente gcloud per Terraform.
Scarica il modulo Terraform o lo snippet di codice che utilizzi per eseguire il deployment del prodotto VM tramite l'interfaccia a riga di comando.
Utilizza il modulo o lo snippet di codice per eseguire il deployment del prodotto VM.

Visita la scheda di deployment della riga di comando

Per avviare il deployment di un prodotto VM tramite l'interfaccia a riga di comando:

In Cloud Marketplace, visita la pagina della scheda del prodotto VM di cui vuoi eseguire il deployment tramite l'interfaccia a riga di comando.

Vai a Marketplace
Fai clic sul pulsante Avvia o fai clic su Esegui il deployment con l'interfaccia a riga di comando per visitare la scheda Deployment della riga di comando.

(Facoltativo) Seleziona o crea il tuo account di servizio

Nella scheda Deployment dalla riga di comando, puoi scegliere di selezionare o creare l'account di servizio che vuoi utilizzare per il deployment dalla riga di comando. Se non hai selezionato o creato un account di servizio nella scheda Deployment della riga di comando quando generi lo snippet di codice, devi modificare manualmente lo snippet Terraform generato per aggiungere un account di servizio prima di utilizzarlo. Per ulteriori informazioni sugli account di servizio, consulta Creazione e gestione degli account di servizio.

Se vuoi eseguire il deployment di un prodotto VM Cloud Marketplace tramite l'interfaccia a riga di comando, l'account di servizio che utilizzi deve disporre del ruolo IAM (Identity and Access Management (roles/compute.admin)). Se crei un nuovo account di servizio dalla scheda Deployment da riga di comando, Google Cloud Marketplace concede automaticamente questo ruolo al nuovo account di servizio. Se selezioni un account di servizio esistente dalla scheda Deployment da riga di comando, devi verificare che l'account di servizio disponga di questo ruolo.

Per selezionare o creare il tuo account di servizio:

Nella scheda Deployment da riga di comando dell'elenco di Google Cloud Marketplace del prodotto VM, in Configura un account di servizio (facoltativo), fai clic sul pulsante Configura.
In Account di servizio che richiede le autorizzazioni, puoi fare clic su Seleziona un account di servizio esistente o Crea un nuovo account di servizio.

Seleziona un account di servizio esistente

Per selezionare un account di servizio esistente:

In Seleziona un account di servizio, scegli l'account di servizio che vuoi utilizzare. L'elenco contiene tutti gli account di servizio esistenti con il ruolo Amministratore Compute (roles/compute.admin).

Se nessuno degli account di servizio esistenti ha il ruolo Amministratore Compute (roles/compute.admin), l'elenco è vuoto. Se l'elenco è vuoto, puoi concedere questo ruolo a uno degli account di servizio esistenti e poi tornare a questa scheda. In alternativa, puoi scegliere di creare un nuovo account di servizio.
Fai clic sul pulsante Invia.

Crea un nuovo account di servizio

Per creare un nuovo account di servizio:

Scegli un nome per l'account di servizio e aggiungilo nel campo Nome account di servizio.
Scegli un ID per il tuo account di servizio e aggiungilo nel campo ID account di servizio.
Aggiungi una descrizione per l'account di servizio nel campo Descrizione account di servizio.
Fai clic sul pulsante Crea account di servizio.

Dopo aver creato l'account di servizio, puoi continuare a gestire il controllo dell'accesso dell'account di servizio utilizzando IAM.

(Facoltativo) Configura l'impersonificazione degli account di servizio

Ti consigliamo di utilizzare l'impersonificazione degli account di servizio per gestire l'accesso al deployment della riga di comando. Se utilizzi la rappresentazione, anziché creare chiavi dell'account di servizio utilizzabili da chiunque per accedere al deployment, puoi gestire l'accesso concedendo o revocando il ruolo IAM Creatore token account di servizio (roles/iam.serviceAccountTokenCreator) a entità specifiche.

Per scoprire come concedere e revocare i ruoli su un account di servizio, vedi Gestire l'accesso agli account di servizio. Per scoprire di più sull'impersonificazione degli account di servizio, consulta Furto d'identità degli account di servizio.

Configura il tuo ambiente gcloud per Terraform

Nella scheda Deployment dalla riga di comando, in Configura gcloud, vedrai una serie di comandi. Per configurare l'ambiente gcloud per Terraform, puoi copiare ed eseguire i comandi forniti.

Scarica il modulo Terraform

Puoi utilizzare un modulo Terraform incluso o uno snippet di codice generato per eseguire il deployment di un prodotto VM tramite l'interfaccia a riga di comando, a seconda di come è configurato il prodotto VM. Per verificare se utilizzi un modulo incluso o uno snippet di codice generato per eseguire il deployment di un prodotto VM, visita la scheda Deployment della riga di comando nella scheda di Cloud Marketplace del prodotto. Se utilizzi un modulo incluso per eseguire il deployment del prodotto, viene visualizzato un pulsante Scarica. Se utilizzi uno snippet di codice generato per eseguire il deployment del prodotto, vedrai un pulsante Genera codice.

Per scaricare il modulo incluso o lo snippet di codice generato, completa i seguenti passaggi:

Modulo Terraform incluso

Nella scheda Deployment tramite riga di comando dell'elenco Cloud Marketplace del prodotto VM, fai clic sul pulsante Scarica. Verrà scaricato un file ZIP contenente il modulo Terraform che utilizzi.
Estrai il modulo Terraform dal file ZIP che hai scaricato.

Snippet di codice generato

Nella scheda Deployment tramite riga di comando dell'elenco Cloud Marketplace del prodotto VM, fai clic sul pulsante Genera codice. Viene generato uno snippet di codice che puoi copiare e utilizzare con Terraform per eseguire il deployment di una VM con Terraform.
Per copiare lo snippet di codice generato, fai clic su Copia negli appunti.

Utilizza il modulo incluso o lo snippet di codice generato per eseguire il deployment del prodotto VM

Per utilizzare il modulo incluso o lo snippet di codice generato per eseguire il deployment del prodotto VM tramite l'interfaccia a riga di comando, completa i seguenti passaggi:

Modulo Terraform incluso

Nel modulo Terraform che hai scaricato, individua il file README.md .
Segui le istruzioni specifiche del prodotto contenute nel file README.md.

Mentre segui le istruzioni specifiche del prodotto, in caso di problemi, puoi facoltativamente provare a eseguire il deployment del modulo eseguendo i comandi seguenti:
- terraform init
- terraform apply

Snippet di codice generato

Verifica che lo snippet di codice generato includa l'account di servizio che vuoi utilizzare. Se hai configurato un account di servizio per il deployment della riga di comando, le informazioni di quell'account di servizio sono incluse nello snippet di codice generato. Se non hai configurato un account di servizio, devi modificare lo snippet di codice generato per specificare l'account di servizio che vuoi utilizzare.
Crea un nuovo file denominato main.tf sulla macchina in cui hai installato Terraform.
Incolla lo snippet di codice generato, con le modifiche apportate, nel file main.tf che hai creato.
Esegui questi comandi:
- terraform init
- terraform apply

Passaggi successivi

Per informazioni sulla gestione dei deployment dell'interfaccia a riga di comando dei prodotti VM, consulta Gestire i deployment dell'interfaccia a riga di comando dei prodotti VM.