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

Os produtos de máquina virtual (VM) oferecidos no 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 são compatíveis com a implantação por meio da 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.

Informações gerais

Nesta página, descrevemos as etapas para implantar produtos de VM com a CLI usando o Terraform. De modo geral, você:

  1. Visite a seção relevante da listagem do produto no Google Cloud Marketplace.

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

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

  4. Configure o ambiente do gcloud para o Terraform.

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

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

Acesse a guia de implantação de linha de comando

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

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

    Acessar o Marketplace

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

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

Na guia Command-line deployment, 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 gerado do Terraform para adicionar uma conta de serviço antes de usá-lo. 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 usando a CLI, a conta de serviço usada precisará ter o papel Identity and Access Management (IAM) de administrador do Compute (roles/compute.admin). Se você criar uma nova conta de serviço na guia Implantação de linha de comando, o Google Cloud Marketplace concederá automaticamente esse papel a ela. Se você selecionar uma conta de serviço atual na guia Implantação de linha de comando, precisará verificar se a conta de serviço tem esse papel.

Para selecionar ou criar sua conta de serviço:

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

  2. Em Solicitação de permissões da conta de serviço, clique em Selecionar uma conta de serviço atual ou em Criar uma nova conta de serviço.

Selecione uma conta de serviço

Para selecionar uma conta de serviço existente:

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

    Se nenhuma das contas de serviço atuais tiver o papel Administrador do Compute (roles/compute.admin), a lista estará vazia. Se a lista estiver vazia, conceda esse papel a uma das suas contas de serviço atuais e volte a esta guia ou crie 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 a conta de serviço e adicione-a 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 sua conta de serviço, é possível continuar gerenciando o controle de acesso da conta de serviço usando o IAM.

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

Recomendamos que você use a representação da conta de serviço para gerenciar o acesso à implantação de linha de comando. Se usar a representação, em vez de criar chaves de conta de serviço que qualquer pessoa possa usar para acessar sua implantação, gerencie o acesso concedendo ou revogando o papel do IAM de 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 personificação de conta de serviço, consulte Representação de conta de serviço.

Configurar o ambiente da gcloud para o Terraform

Na guia Implantação da 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

Use um módulo do Terraform incluído ou um snippet de código gerado para implantar um produto de VM usando a 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 na listagem do produto no 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, o 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 listagem do produto de VM no Cloud Marketplace, clique no botão Fazer o download. Isso faz o download de um arquivo ZIP que contém o módulo do Terraform que você está usando.

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

Snippet de código gerado

  1. Na guia Implantação de linha de comando da listagem do produto de VM no Cloud Marketplace, clique no botão Gerar código. 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 de VM

Para usar o módulo incluído ou o snippet de código gerado para implantar o produto de VM usando a CLI, conclua as seguintes 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 você segue as instruções específicas do produto, se 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 da linha de comando, as informações dessa conta 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 a ser usada.

  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 que você criou.

  4. Execute os comandos a seguir:

    • terraform init

    • terraform apply

Próximas etapas

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