Como visualizar e lançar soluções

Neste artigo, você aprenderá como visualizar e iniciar soluções a partir do Catálogo Particular.

Antes de começar

  • Para iniciar uma solução usando o Catálogo Privado, você precisa ter os seguintes papéis do Gerenciamento de identidade e acesso (IAM):

    • Consumidor do catálogo (roles/cloudprivatecatalog.consumer) OU Visualizador do IAM (roles/viewer) para o projeto do Google Cloud em que a solução foi compartilhada com você.

      Se você não tiver nenhum dos papéis para o projeto do Cloud, entre em contato com o administrador da organização para solicitar acesso.

    • Se você estiver implantando uma configuração do Terraform, precisará dos seguintes papéis no projeto em que quer implantar a configuração:

      Se você não tiver esses papéis, entre em contato com o proprietário do projeto OU alguém que tenha a permissão setIAMpolicy para o projeto solicitar acesso.

    • Se você estiver implantando uma solução usando o Cloud Deployment Manager, o papel do Editor do Deployment Manager (roles/deploymentmanager.editor) para o projeto em que a solução está sendo implantada.

      Se você não tiver esse papel, entre em contato com o proprietário do projeto OU alguém que tenha a permissão setIAMpolicy para o projeto solicitar acesso.

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

    1. Ative a API Cloud Build.

      Ative a API

    2. Crie uma conta de serviço para o Cloud Build.
    3. Conceda à conta de serviço o papel de editor do projeto (roles/editor) do projeto em que você está implantando a configuração do Terraform.
    4. Para gerenciar todos os arquivos de estado do Terraform no Catálogo Privado, conceda o papel de Administrador do Storage (roles/storage.admin) à conta de serviço do Cloud Build do projeto em que a configuração é compartilhada, bem como o projeto. onde você está implantando a configuração.

      Veja as etapas para conceder acesso em Como configurar o acesso para a conta de serviço do Cloud Build.

Veja as soluções do Catálogo Particular

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

Para visualizar as soluções disponíveis, acesse a página Catálogo Particular do Console do Cloud. 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 Catálogo Particular do Console do Cloud.

    Acesse a página "Catálogo Particular"

  2. Em TYPE, 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 Particular do Console do Cloud.

    Acesse a página "Catálogo Particular"

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

  3. Clique em Iniciar no Compute Engine.

  4. Se solicitado, ative a API Deployment Manager e a API Private 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.

  6. Clique em Implantar.

A solução está implantada.

Inicie uma configuração do Terraform

Para iniciar uma configuração do Terraform:

  1. Acesse a página Catálogo Particular do Console do Cloud.

    Acesse a página "Catálogo Particular"

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

  3. Clique em Implantar.

  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. Preencha os parâmetros.

  8. Clique em Visualizar e implantar.

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

A solução está implantada.

Atualizar uma implantação do Terraform

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

Para atualizar uma implantação atual:

  1. Acesse a página Implantações no Catálogo Privado.

    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. Atualizar os detalhes da implantação.

  5. Clique em Visualizar e implantar.

  6. 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, veja se a solução associada lançou uma versão mais recente da configuração do Terraform e atualize 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 Privado.

    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. Se solicitado, insira os valores para os parâmetros adicionais.

  6. Clique em Visualizar e implantar.

  7. 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 dela.

Para desprovisionar uma implantação:

  1. Acesse a página Catálogo Particular do Console do Cloud.

    Acesse a página "Catálogo Particular"

  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) e clique em Desprovisionar.

A implantação é desprovisionado.