Como visualizar e lançar soluções

Neste documento, você vai aprender a visualizar e iniciar soluções a partir do catálogo de serviços.

Antes de começar

  • Para lançar uma solução usando o catálogo de serviços, é necessário ter o papel de gerenciamento de identidade e acesso (IAM) de consumidor do catálogo OU leitor do IAM para o Google Cloud projeto em que a solução foi compartilhada com você. Se você não tiver nenhum dos papéis no Google Cloud projeto, entre em contato com o administrador da organização para solicitar acesso.

  • Para implantar uma configuração do Terraform, são necessários os seguintes papéis para o Google Cloud projeto em que você quer implantar a configuração do Terraform. Se você não tiver esses papéis, entre em contato com o proprietário do projeto ou com alguém que tenha a permissão setIAMpolicy para o projeto que você precisa de acesso.

    Se você planeja usar sua própria conta de serviço, também é necessário ter o papel de usuário da conta de serviço para o Google Cloud projeto que contém a conta de serviço que você planeja usar.

  • Se você estiver implantando uma configuração do Terraform e escolher usar sua própria conta de serviço, ela precisará ter os seguintes papéis do IAM para o projeto em que você quer criar a solução:

  • Se você estiver implantando uma solução usando o Cloud Deployment Manager, o papel de editor do Deployment Manager para o projeto em que a solução será implantada. Se você não tiver esse papel, entre em contato com o proprietário do projeto OU com alguém que tenha a setIAMpolicy permissão para o projeto que você precisa de acesso.

  • Se você estiver iniciando uma configuração do Terraform, configure o Cloud Build:

    1. Ative a API Cloud Build.

      Funções necessárias para ativar APIs

      Para ativar as APIs, é necessário ter o papel do IAM de administrador de uso do serviço (roles/serviceusage.serviceUsageAdmin), que contém a permissão serviceusage.services.enable. Saiba como conceder papéis.

      Ativar a API

    2. No Google Cloud console, acesse a página do Cloud Build.
    3. Selecione a guia Configurações.
    4. Use a conta de serviço listada em E-mail da conta de serviço :.

    5. Se você não estiver usando sua própria conta de serviço, conceda os seguintes papéis do Identity and Access Management (IAM) à conta de serviço do Cloud Build. Por exemplo, no arquivo de configuração de amostra do Terraform fornecido em Criar uma configuração do Terraform, Compute Engine é um dos recursos, e o papel Administrador da instância do Compute (v1) (roles/compute.instanceAdmin.v1) foi ativado para a conta de serviço.

    6. Conceda o papel de editor do projeto à conta de serviço do projeto em que você está implantando a configuração do Terraform.

    7. Para gerenciar todos os arquivos de estado do Terraform no catálogo de serviços, conceda o papel de administrador do Storage à conta de serviço do Cloud Build no projeto em que a configuração é compartilhada e no projeto em que você está implantando. Para ver as etapas de concessão de acesso, consulte Como configurar o acesso à conta de serviço do Cloud Build.

Veja as soluções do catálogo de serviços

No catálogo de serviços, existe um conjunto de soluções de todos os catálogos a que você tem acesso de acordo com sua Google Cloud hierarquia.

Para visualizar as soluções disponíveis, acesse a página Google Cloud Catálogo de serviços do console. As soluções compartilhadas com você são exibidas no painel principal.

Para iniciar uma solução com base em links de referência:

  1. Acesse a página Google Cloud Catálogo de serviços do console.

    Acesse a página Catálogo de serviços

  2. Em TIPO, filtre por Link e clique em uma solução.

  3. Clique em Ir para o link.

    Isso leva para um link fora do domínio do Google, onde é possível fazer o download de uma solução.

Iniciar uma solução baseada no Deployment Manager (DM)

Para iniciar uma solução baseada no Deployment Manager (DM, na sigla em inglês):

  1. Acesse a página Google Cloud Catálogo de serviços do console.

    Acesse a página Catálogo de serviços

  2. Em TIPO, filtre por Modelo de DM e clique em uma solução.

  3. Clique em Iniciar no Compute Engine.

  4. Se solicitado, ative a API Deployment Manager e a API Catálogo de Serviços.

    A ativação das APIs leva vários minutos para ser concluída, mas você só precisa fazer isso uma vez por Google Cloud projeto (não por solução).

  5. Preencha o formulário de implantação.

    Insira o parâmetro zona manualmente. Para isso, especifique a região e a zona do Compute Engine de sua preferência. Insira a região seguida de um traço e, em seguida, a zona (sem espaços): region-zone. Por exemplo, us-central1-a, em que us-central1 é a região e a é a zona.

  6. Clique em Implantar.

A solução está implantada.

Iniciar uma configuração do Terraform

Para iniciar uma configuração do Terraform:

  1. Acesse a página Google Cloud Catálogo de serviços do console.

    Acesse a página Catálogo de serviços

  2. Em TIPO, filtre por Terraform e clique em uma solução.

  3. Clique em Deploy.

  4. Se solicitado, clique em Iniciar uma nova implantação na janela exibida.

  5. Se solicitado, ative a API Cloud Build.

    A ativação das APIs leva vários minutos para ser concluída, mas você só precisa fazer isso uma vez por Google Cloud projeto (não por solução).

  6. Crie um nome para a implantação.

  7. Opcionalmente, você pode fornecer sua própria conta de serviço clicando na caixa de seleção ao lado de Selecionar ou inserir sua própria conta de serviço. Se a conta de serviço estiver localizada no mesmo Google Cloud projeto em que você está criando a solução, selecione Selecionar uma conta de serviço do projeto atual e selecione a conta de serviço no menu suspenso. Se a conta de serviço estiver localizada em um projeto diferente Google Cloud da solução, selecione Digitar um e-mail de conta de serviço de qualquer projetoe insira o e-mail da conta de serviço.

  8. Preencha os parâmetros.

  9. Clique em Visualizar e implantar.

  10. Revise a implantação e clique em Implantar.

A solução está implantada.

Atualizar uma implantação do Terraform

Para uma implantação existente de uma solução do Terraform, é possível atualizar os detalhes da implantação, incluindo parâmetros. Se houver uma nova versão da configuração do Terraform disponível para a solução, será possível atualizar a implantação para a versão mais recente da configuração.

Para atualizar uma implantação existente:

  1. Acesse a página Implantações no catálogo de serviços.

    Acessar a página "Implantações"

  2. Na tabela de implantações, clique no nome da implantação que você quer atualizar.

  3. Na página Detalhes da implantação, clique em Atualizar implantação.

  4. Atualize os detalhes da implantação.

  5. Opcionalmente, você pode fornecer sua própria conta de serviço clicando na caixa de seleção ao lado de Selecionar ou inserir sua própria conta de serviço. Se a conta de serviço estiver localizada no mesmo Google Cloud projeto em que você está criando a solução, selecione Selecionar uma conta de serviço do projeto atual e selecione a conta de serviço no menu suspenso. Se a conta de serviço estiver localizada em um projeto diferente Google Cloud da solução, selecione Digitar um e-mail de conta de serviço de qualquer projetoe insira o e-mail da conta de serviço.

  6. Clique em Visualizar e implantar.

  7. Revise a implantação e clique em Implantar.

Ver e aplicar a versão mais recente de uma configuração

Ao gerenciar as implantações do Terraform, é possível ver se a solução associada lançou uma versão mais recente da configuração do Terraform e atualizar a implantação para a configuração mais recente.

Para ver se uma implantação tem atualizações disponíveis e aplicar a versão mais recente da configuração:

  1. Acesse a página Implantações no catálogo de serviços.

    Acessar a página "Implantações"

  2. Clique em Ver implantações com atualizações para filtrar a tabela de implantações. Na tabela, encontre a implantação que você quer atualizar e clique em Nova versão disponível.

  3. Na página Detalhes da implantação, clique em Atualizar implantação.

  4. Em Selecionar versão, selecione Atualizar para a versão mais recente.

  5. Opcionalmente, você pode fornecer sua própria conta de serviço clicando na caixa de seleção ao lado de Selecionar ou inserir sua própria conta de serviço. Se a conta de serviço estiver localizada no mesmo Google Cloud projeto em que você está criando a solução, selecione Selecionar uma conta de serviço do projeto atual e selecione a conta de serviço no menu suspenso. Se a conta de serviço estiver localizada em um projeto diferente Google Cloud da solução, selecione Digitar um e-mail de conta de serviço de qualquer projetoe insira o e-mail da conta de serviço.

  6. Se solicitado, insira valores de todos os parâmetros adicionais.

  7. Clique em Visualizar e implantar.

  8. Revise a implantação e clique em Implantar.

Desprovisionar uma implantação do Terraform

Você desprovisiona uma implantação do Terraform para excluir permanentemente todos os recursos.

Para desprovisionar uma implantação:

  1. Acesse a página Google Cloud Catálogo de serviços do console.

    Acesse a página Catálogo de serviços

  2. Clique em Implantações do Terraform.

  3. Na tabela, encontre a implantação que você quer desprovisionar.

  4. Clique no menu Mais ações (exibido como três pontos dispostos verticalmente) .

  5. Opcionalmente, você pode fornecer sua própria conta de serviço clicando na caixa de seleção ao lado de Selecionar ou inserir sua própria conta de serviço. Se a conta de serviço estiver localizada no mesmo Google Cloud projeto em que você está criando a solução, selecione Selecionar uma conta de serviço do projeto atual e selecione a conta de serviço no menu suspenso. Se a conta de serviço estiver localizada em um projeto diferente Google Cloud da solução, selecione Digitar um e-mail de conta de serviço de qualquer projetoe insira o e-mail da conta de serviço.

  6. Clique em Desprovisionar.