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ê:
Acesse a seção relevante da página do produto no Google Cloud Marketplace.
Se preferir, selecione ou crie a conta de serviço que você quer usar para a implantação de linha de comando.
Como alternativa, configure a representação de uma conta de serviço.
Configure seu ambiente
gcloud
para o Terraform.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.
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:
No Cloud Marketplace, acesse a página de informações do produto de VM que você quer implantar pela CLI.
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:
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.
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:
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.Clique no botão Enviar.
Criar uma nova conta de serviço
Para criar uma nova conta de serviço:
Escolha um nome para sua conta de serviço e adicione-o no campo Nome da conta de serviço.
Escolha um ID para sua conta de serviço e adicione-o no campo ID da conta de serviço.
Adicione uma descrição à sua conta de serviço no campo Descrição da conta de serviço.
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
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.
Extraia o módulo do Terraform do arquivo ZIP que você fez o download.
Snippet de código gerado
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.
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
No módulo do Terraform que você fez o download, localize o arquivo
README.md
.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
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.
Crie um novo arquivo com o nome
main.tf
na máquina em que você instalou o Terraform.Cole o snippet de código gerado, com as edições feitas, no arquivo
main.tf
que você criou.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.