Como visualizar e lançar soluções

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

Antes de começar

Observação: a partir de 29 de abril de 2024, o Cloud Build vai usar contas de serviço do Compute Engine por padrão, em vez das contas de serviço do Cloud Build. Isso não vai afetar os projetos Google Cloud em que o Cloud Build já está ativado. Se você ativar o Cloud Build para um projeto a partir de 29 de abril de 2024, você ou o administrador da organização precisarão atualizar as políticas da organização ou as contas de serviço do Compute Engine para evitar problemas. Para mais detalhes, consulte Mudança na conta de serviço do Cloud Build.

• 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 no projeto Google Cloud em que a solução foi compartilhada com você. Se você não tiver nenhum desses papéis no projeto do Google Cloud, 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 no projeto Google Cloud 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 para solicitar acesso.

  • Editor do Cloud Build
  • Administrador do Storage
  • Leitor

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

• Se você estiver implantando uma configuração do Terraform e optar por 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:

  • Administrador de armazenamento. Se a configuração do Terraform estiver em um projeto diferente, a conta de serviço também precisará ter o papel de Visualizador de objetos do Storage para o projeto que contém a configuração do Terraform.
  • Gravador de registros.
  • Quaisquer outros papéis do IAM necessários para executar a configuração do Terraform.

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

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

  1. Enable the Cloud Build API.

     Enable the API

  2. No console do Google Cloud, acesse a página 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 de gerenciamento de identidade e acesso (IAM) à conta de serviço do Cloud Build. Por exemplo, no arquivo de configuração 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.

     Observação: se você não fornecer sua própria conta de serviço, o Service Catalog vai usar as configurações padrão da conta de serviço do Cloud Build. Para mais informações, consulte Mudança na conta de serviço do Cloud Build.

  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 ela está sendo implantada. Para conferir 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 hierarquia Google Cloud .

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

Iniciar uma solução baseada em link

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

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

   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 Catálogo de serviços do console do Google Cloud.

   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 Service Catalog.

   A ativação das APIs leva vários minutos para ser concluída, mas você só precisa fazer isso uma vez em cada projeto do Google Cloud (não a cada 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.

   Observação: se você usar o parâmetro rede no modelo e especificar default, a sub-rede também precisa ser definida como default.

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 Catálogo de serviços do console do Google Cloud.

   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 em cada projeto do Google Cloud (não a cada 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 projeto Google Cloud em que você está criando a solução, selecione Selecionar uma conta de serviço do projeto atual e selecione sua conta de serviço no menu suspenso. Se a conta de serviço estiver em um projeto Google Cloud diferente da solução, selecione Digitar um e-mail de conta de serviço de qualquer projeto e insira o e-mail da sua conta de serviço.

   Observação: se você não fornecer sua própria conta de serviço, o Service Catalog usará as configurações padrão da conta de serviço do Cloud Build. Para mais informações, consulte Mudança na conta de serviço do Cloud Build.

8. Preencha os parâmetros.

   Observação: em alguns campos, é preciso usar a sintaxe da Linguagem de configuração HashCorp (HCL, na sigla em inglês).

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 projeto Google Cloud em que você está criando a solução, selecione Selecionar uma conta de serviço do projeto atual e selecione sua conta de serviço no menu suspenso. Se a conta de serviço estiver em um projeto Google Cloud diferente da solução, selecione Digitar um e-mail de conta de serviço de qualquer projeto e insira o e-mail da sua conta de serviço.

   Observação: se você não fornecer sua própria conta de serviço, o Service Catalog usará as configurações padrão da conta de serviço do Cloud Build. Para mais informações, consulte Mudança na conta de serviço do Cloud Build.

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 projeto Google Cloud em que você está criando a solução, selecione Selecionar uma conta de serviço do projeto atual e selecione sua conta de serviço no menu suspenso. Se a conta de serviço estiver em um projeto Google Cloud diferente da solução, selecione Digitar um e-mail de conta de serviço de qualquer projeto e insira o e-mail da sua conta de serviço.

   Observação: se você não fornecer sua própria conta de serviço, o Service Catalog usará as configurações padrão da conta de serviço do Cloud Build. Para mais informações, consulte Mudança na conta de serviço do Cloud Build.

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 Catálogo de serviços do console do Google Cloud.

   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 organizados 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 projeto Google Cloud em que você está criando a solução, selecione Selecionar uma conta de serviço do projeto atual e selecione sua conta de serviço no menu suspenso. Se a conta de serviço estiver em um projeto Google Cloud diferente da solução, selecione Digitar um e-mail de conta de serviço de qualquer projeto e insira o e-mail da sua conta de serviço.

   Observação: se você não fornecer sua própria conta de serviço, o Service Catalog usará as configurações padrão da conta de serviço do Cloud Build. Para mais informações, consulte Mudança na conta de serviço do Cloud Build.

6. Clique em Desprovisionar.