Implantar produtos de máquina virtual (VM) usando a interface de linha de comando (CLI)

Os produtos de máquina virtual (VM) oferecidos pelo Google Cloud Marketplace são instâncias de VM personalizadas que podem ser executadas no Compute Engine. Para uma visão geral dos conceitos do Compute Engine, consulte a documentação do Compute Engine.

Alguns produtos de VM no Google Cloud Marketplace oferecem suporte à implantação pela interface de linha de comando (CLI) usando Terraform, uma ferramenta de código aberto para provisionamento e gerenciamento de infraestrutura. Para mais informações sobre o Terraform, acesse Primeiros passos com o Terraform.

Visão geral

Esta página descreve as etapas para implantar produtos de VM pela CLI usando o Terraform. Em detalhes, você vai:

  1. Acessar a seção relevante da página de produtos do Google Cloud Marketplace

  2. Opcionalmente, selecionar ou criar a conta de serviço que você quer usar para a implantação de linha de comando.

  3. Opcionalmente, configurar a identidade temporária de conta de serviço.

  4. Configurar o ambiente gcloud para o Terraform.

  5. Fazer o download do módulo do Terraform ou do snippet de código que você usa para implantar o produto de VM pela CLI.

  6. Usar o módulo ou snippet de código para implantar o produto de VM.

Acessar a guia "Implantação de linha de comando"

Para começar a implantar um produto de VM pela CLI:

  1. No Cloud Marketplace, acesse a página de informações do produto para o produto de VM que você quer implantar pela CLI.

    Acessar o Marketplace

  2. Clique no botão Iniciar ou em Implantar com a CLI para acessar a guia Implantação de linha de comando.

(Opcional) Selecionar ou criar sua conta de serviço

Na guia Implantação de linha de comando, você pode selecionar ou criar a conta de serviço que quer usar para a implantação de linha de comando. Se você não tiver selecionado ou criado uma conta de serviço na guia Implantação de linha de comando ao gerar o snippet de código, edite manualmente o snippet do Terraform gerado para adicionar uma conta de serviço antes de usá-la. Para mais informações sobre contas de serviço, acesse Como criar e gerenciar contas de serviço.

Se você quiser implantar um produto de VM do Cloud Marketplace pela CLI, a conta de serviço usada precisa ter o papel de administrador do Compute (roles/compute.admin) do Identity and Access Management (IAM). Se você criar uma conta de serviço na guia Implantação de linha de comando , o Google Cloud Marketplace vai conceder esse papel automaticamente à nova conta de serviço. Se você selecionar uma conta de serviço na guia Implantação de linha de comando , verifique se ela tem esse papel.

Para selecionar ou criar sua conta de serviço:

  1. Na guia Implantação de linha de comando da página de produtos do Google Cloud Marketplace, em Configurar uma conta de serviço (opcional), clique no botão Configurar.

  2. Em Conta de serviço que solicita permissões, clique em Selecionar uma conta de serviço ou Criar uma conta de serviço.

Selecionar uma conta de serviço

Para selecionar uma conta de serviço:

  1. Em Selecionar uma conta de serviço, selecione a conta de serviço que você quer usar. A lista contém todas as contas de serviço que têm o papel de administrador do Compute (roles/compute.admin).

    Se nenhuma das suas contas de serviço tiver o papel de administrador do Compute (roles/compute.admin), a lista estará vazia. Se a lista estiver vazia, você pode conceder esse papel a uma das suas contas de serviço existentes e retornar a essa guia ou criar uma nova conta de serviço .

  2. Clique no botão Enviar.

Criar uma conta de serviço

Para criar uma conta de serviço:

  1. Escolha um nome para a conta de serviço e adicione-o no campo Nome da conta de serviço.

  2. Escolha um ID para a conta de serviço e adicione-o no campo ID da conta de serviço.

  3. Adicione uma descrição para a conta de serviço no campo Descrição da conta de serviço.

  4. Clique no botão Criar conta de serviço.

Depois de criar a conta de serviço, você pode continuar gerenciando o controle de acesso dela usando o IAM.

(Opcional) Configurar a identidade temporária de conta de serviço

Recomendamos que você use a identidade temporária de conta de serviço para gerenciar o acesso à implantação de linha de comando. Se você usar a representação, em vez de criar chaves de conta de serviço que qualquer pessoa possa usar para acessar a implantação, gerencie o acesso concedendo ou revogando o papel de criador de token da conta de serviço (roles/iam.serviceAccountTokenCreator) do IAM para principais específicos.

Para saber como conceder e revogar papéis em contas de serviço, consulte Gerenciar o acesso a contas de serviço. Para saber mais sobre a identidade temporária de conta de serviço, consulte Identidade temporária de conta de serviço.

Configurar o ambiente da gcloud para o Terraform

Na guia Implantação de linha de comando, em Configurar a gcloud, você verá uma série de comandos. Para configurar o ambiente gcloud para o Terraform, copie e execute os comandos fornecidos.

Fazer o download do módulo do Terraform

Você usa um módulo do Terraform incluído ou um snippet de código gerado para implantar um produto de VM pela CLI, dependendo de como o produto de VM está configurado. Para verificar se você usa um módulo incluído ou um snippet de código gerado para implantar um produto de VM, acesse a guia Implantação de linha de comando da página de informações do produto do Cloud Marketplace. Se você usar um módulo incluído para implantar o produto, um botão Download será exibido. Se você usar um snippet de código gerado para implantar o produto, um botão Gerar código será exibido.

Para fazer o download do módulo incluído ou do snippet de código gerado, siga estas etapas:

Módulo do Terraform incluído

  1. Na guia Implantação de linha de comando da página de produtos do Cloud Marketplace da VM, clique no botão Download. Isso faz o download de um arquivo ZIP que contém o módulo do Terraform usado.

  2. Extraia o módulo do Terraform do arquivo ZIP que você fez o download.

Snippet de código gerado

  1. Na guia Implantação de linha de comando da página de informações do produto da VM no Cloud Marketplace, clique no botão Gerar código. Isso gera um snippet de código que você pode copiar e usar com o Terraform para implantar uma VM com o Terraform.

  2. Para copiar o snippet de código gerado, clique em Copiar para a área de transferência.

Usar o módulo incluído ou o snippet de código gerado para implantar o produto de VM

Para usar o módulo incluído ou o snippet de código gerado para implantar o produto de VM pela CLI, siga estas etapas:

Módulo do Terraform incluído

  1. No módulo do Terraform que você fez o download, localize o README.md arquivo .

  2. Siga as instruções específicas do produto no arquivo README.md.

    Ao seguir as instruções específicas do produto, se você tiver problemas, tente implantar o módulo executando os seguintes comandos:

    • terraform init

    • terraform apply

Snippet de código gerado

  1. Verifique se o snippet de código gerado inclui a conta de serviço que você quer usar. Se você configurou uma conta de serviço para a implantação de linha de comando, as informações dessa conta de serviço serão incluídas no snippet de código gerado. Se você não configurou uma conta de serviço, edite o snippet de código gerado para especificar a conta de serviço que quer usar.

  2. Crie um novo arquivo chamado main.tf na máquina em que você instalou o Terraform.

  3. Cole o snippet de código gerado, com as edições feitas, no arquivo main.tf criado.

  4. Execute os comandos a seguir:

    • terraform init

    • terraform apply

Próximas etapas

Para informações sobre como gerenciar as implantações de CLI de produtos de VM, acesse Gerenciar implantações de CLI de produtos de VM.