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

I prodotti per 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 ulteriori informazioni su Terraform, consulta Introduzione a 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, dovrai:

  1. Visita la sezione pertinente della scheda del prodotto su Google Cloud Marketplace.

  2. Se vuoi, seleziona o crea l'account di servizio che vuoi utilizzare per il deployment da riga di comando.

  3. Se vuoi, configura la simulazione dell'identità dell'account di servizio.

  4. Configura l'ambiente gcloud per Terraform.

  5. Scarica il modulo o lo snippet di codice Terraform che utilizzi per eseguire il deployment del prodotto VM tramite l'interfaccia a riga di comando.

  6. Utilizza il modulo o lo snippet di codice per eseguire il deployment del prodotto VM.

Vai alla scheda Deployment della riga di comando

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

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

    Vai a Marketplace

  2. Fai clic sul pulsante Avvia o su Esegui il deployment con l'interfaccia a riga di comando per aprire la scheda Deployment dell'interfaccia a riga di comando.

(Facoltativo) Seleziona o crea il tuo account di servizio

Nella scheda Deployment a riga di comando, puoi scegliere di selezionare o creare l'account di servizio da utilizzare per il deployment a riga di comando. Se non hai selezionato o creato un account di servizio nella scheda Deployment a 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 maggiori informazioni sugli account di servizio, consulta Creare e gestire gli account di servizio.

Se vuoi eseguire il deployment di un prodotto VM di Cloud Marketplace tramite la CLI, l'account di servizio che utilizzi deve disporre del ruolo Amministratore di Compute (roles/compute.admin) di Identity and Access Management (IAM). 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 dalla riga di comando, devi verificare che l'account di servizio abbia questo ruolo.

Per selezionare o creare il tuo account di servizio:

  1. Nella scheda Deployment da riga di comando della scheda del prodotto VM nel Google Cloud Marketplace, fai clic sul pulsante Configura in Configura un service account (facoltativo).

  2. In Account di servizio che richiede autorizzazioni, puoi fare clic su Seleziona un account di servizio esistente o Crea un nuovo account di servizio.

Seleziona un service account esistente

Per selezionare un service account esistente:

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

    Se nessuno dei tuoi 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 dei tuoi account di servizio esistenti e poi tornare a questa scheda oppure puoi scegliere di creare un nuovo account di servizio.

  2. Fai clic sul pulsante Invia.

Crea un nuovo service account

Per creare un nuovo account di servizio:

  1. Scegli un nome per l'account di servizio e aggiungilo nel campo Nome account di servizio.

  2. Scegli un ID per il tuo account di servizio e aggiungilo nel campo ID account di servizio.

  3. Aggiungi una descrizione per l'account di servizio nel campo Descrizione account di servizio.

  4. 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 la simulazione dell'identità dell'account di servizio

Ti consigliamo di utilizzare la rappresentazione dell'account di servizio per gestire l'accesso al tuo deployment a riga di comando. Se utilizzi l'usurpazione di identità, anziché creare chiavi dell'account di servizio che chiunque può utilizzare per accedere al tuo deployment, gestisci 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 in un account di servizio, consulta Gestire l'accesso agli account di servizio. Per scoprire di più sull'impersonificazione degli account di servizio, consulta Impersonificazione dell'account di servizio.

Configura l'ambiente gcloud per Terraform

Nella scheda Deployment a riga di comando, in Configura gcloud, viene visualizzata 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, vai alla scheda Deployment a riga di comando della scheda del prodotto in Cloud Marketplace. Se utilizzi un modulo incluso per eseguire il deployment del prodotto, viene visualizzato un pulsante Scarica. Se utilizzi uno snippet di codice generato per il deployment del prodotto, viene visualizzato un pulsante Genera codice.

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

Modulo Terraform incluso

  1. Nella scheda Deployment da riga di comando della scheda del prodotto VM nel Cloud Marketplace, fai clic sul pulsante Scarica. Verrà scaricato un file ZIP contenente il modulo Terraform che utilizzi.

  2. Estrai il modulo Terraform dal file ZIP scaricato.

Snippet di codice generato

  1. Nella scheda Deployment da riga di comando della scheda del prodotto VM nel Cloud Marketplace, fai clic sul pulsante Genera codice. Verrà generato uno snippet di codice che puoi copiare e utilizzare con Terraform per eseguire il deployment di una VM con Terraform.

  2. 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

  1. Nel modulo Terraform che hai scaricato, individua il file README.md .

  2. Segui le istruzioni specifiche del prodotto riportate nel file README.md.

    Mentre segui le istruzioni specifiche del prodotto, se riscontri problemi, puoi provare a eseguire il deployment del modulo eseguendo i seguenti comandi:

    • terraform init

    • terraform apply

Snippet di codice generato

  1. Verifica che lo snippet di codice generato includa l'account di servizio che vuoi utilizzare. Se hai configurato un account di servizio per il tuo deployment a riga di comando, le informazioni dell'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.

  2. Crea un nuovo file denominato main.tf sulla macchina in cui hai installato Terraform.

  3. Incolla lo snippet di codice generato, con eventuali modifiche apportate, nel file main.tf che hai creato.

  4. 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.