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, acesse 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 o 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 um nível alto, você:

  1. Acesse a seção relevante da página do produto no Google Cloud Marketplace.

  2. Se preferir, selecione ou crie a conta de serviço que você quer usar para a implantação de linha de comando.

  3. Como alternativa, configure a representação de uma conta de serviço.

  4. Configure seu ambiente gcloud para o Terraform.

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

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

Acessar a guia de 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 de VM que você quer implantar pela CLI.

    Acessar o Marketplace

  2. Clique no botão Launch ou em Deploy with CLI para acessar a guia Command-line deployment.

(Opcional) Selecione ou crie sua conta de serviço

Na guia Deployment de linha de comando, é possível selecionar ou criar a conta de serviço que você 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 Deployment de linha de comando ao gerar o snippet de código, será necessário editar 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 gerenciamento de identidade e acesso (IAM) do administrador do Compute (roles/compute.admin). Se você criar uma nova conta de serviço na guia Deployment de linha de comando, o Google Cloud Marketplace concederá automaticamente essa função à nova conta de serviço. Se você selecionar uma conta de serviço na guia Deployment de linha de comando, verifique se ela tem esse papel.

Para selecionar ou criar sua conta de serviço:

  1. Na aba Deployment de linha de comando da página do produto da VM no Google Cloud Marketplace, em Configure a service account (optional), clique no botão Configure.

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

Selecionar uma conta de serviço

Para selecionar uma conta de serviço atual:

  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, conceda essa função a uma das suas contas de serviço e volte a esta guia. Você também pode criar uma nova conta de serviço.

  2. Clique no botão Enviar.

Criar uma nova conta de serviço

Para criar uma nova conta de serviço:

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

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

  3. Adicione uma descrição à sua 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 a gerenciar o controle de acesso dela usando o IAM.

(Opcional) Configurar a representação de conta de serviço

Recomendamos o uso da impersonação 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 sua implantação, você vai gerenciar o acesso concedendo ou revogado o papel do IAM Criador de token da conta de serviço (roles/iam.serviceAccountTokenCreator) para principais específicos.

Para saber como conceder e revogar papéis em uma conta de serviço, consulte Gerenciar o acesso a contas de serviço. Para saber mais sobre a representação de uma conta de serviço, consulte Representação da conta de serviço.

Configurar o ambiente da gcloud para o Terraform

Na guia Deployment de linha de comando, em Configurar gcloud, você encontra 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

Use 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 do produto no Google Cloud Marketplace. Se você usar um módulo incluído para implantar o produto, um botão Download vai aparecer. Se você usar um snippet de código gerado para implantar o produto, vai aparecer um botão Generate code.

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 Deployment de linha de comando da página do produto da VM no Cloud Marketplace, clique no botão Download. Isso faz o download de um arquivo ZIP que contém o módulo do Terraform que você usa.

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

Snippet de código gerado

  1. Na guia Deployment de linha de comando da página de detalhes do produto da VM no Cloud Marketplace, clique no botão Generate code. Isso gera um snippet de código que pode ser copiado e usado 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.

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

Para usar o módulo incluído ou o snippet de código gerado para implantar o produto 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 arquivo README.md .

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

    Enquanto segue 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ê tiver configurado 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 fragmento de código gerado. Se você não tiver configurado uma conta de serviço, edite o snippet de código gerado para especificar a conta de serviço que você quer usar.

  2. Crie um novo arquivo com o nome 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 que você criou.

  4. Execute os comandos a seguir:

    • terraform init

    • terraform apply

Próximas etapas

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