Configure o Cloud Hub

Este documento descreve como configurar o Cloud Hub.

Existem vários passos principais no processo de configuração:

  1. Para criar aplicações do App Hub e ver dados sobre as mesmas no Cloud Hub, configure a gestão de aplicações.

    Se não configurar a gestão de aplicações, pode continuar a ver alguns dados por Google Cloud projeto em vez de por aplicação no Cloud Hub.

  2. Ative as APIs para os dados do projeto. Algumas páginas no Cloud Hub não suportam dados de aplicações. Tem de ativar as APIs para estas páginas separadamente.

  3. Configure vistas agregadas de registos, métricas e rastreios.

  4. Conceda acesso aos utilizadores do Cloud Hub.

Pessoas ou equipas diferentes podem ser responsáveis por diferentes passos no processo de configuração do Cloud Hub.

Configure a gestão de aplicações

Esta secção descreve os passos necessários para ativar a gestão de aplicações e criar as suas aplicações.

Funções necessárias

Para receber as autorizações de que precisa para configurar uma pasta com apps, peça ao seu administrador para lhe conceder as seguintes funções do IAM:

Para mais informações sobre a atribuição de funções, consulte o artigo Faça a gestão do acesso a projetos, pastas e organizações.

Também pode conseguir as autorizações necessárias através de funções personalizadas ou outras funções predefinidas.

Ative a gestão de aplicações

A gestão de aplicações permite-lhe mudar o foco dos componentes de infraestrutura individuais para a sua aplicação como um todo.

Quando ativa a gestão de aplicações numa pasta, esta é denominada pasta com apps ativadas e ocorre o seguinte:

  • Um projeto é definido como o projeto de gestão na pasta.
  • O sistema ativa as APIs necessárias no projeto de gestão.
  • O projeto de gestão armazena dados da aplicação, incluindo APIs ativadas, faturação, quotas e controlos de acesso.

Para ativar a gestão de aplicações numa pasta, faça o seguinte:

Consola

  1. Selecione ou crie a Google Cloud pasta que quer configurar como uma pasta com apps. Para criar uma nova pasta, consulte o artigo Criar pastas.

  2. Na Google Cloud consola, abra a página Gerir recursos.

    Aceda a Gerir recursos

  3. Na lista de projetos e pastas, localize a pasta que quer configurar.

    Se uma pasta tiver o ícone de pasta com a app ativada, a gestão de aplicações já está ativada.

  4. Na linha da pasta, abra o menu Ações e clique em Definições.

    Se a gestão de aplicações não tiver sido ativada na pasta, a definição Gestão de aplicações apresenta Não ativada.

  5. Na área Ativar gestão de aplicações, clique em Criar projeto.

    É aberto o painel Crie um projeto de gestão e ative as APIs necessárias.

  6. Reveja a lista de APIs necessárias. Estas APIs gerem o ciclo de vida da sua aplicação. Para APIs que tenham custos associados, clique no nome da API para saber mais sobre os preços.

  7. Para ativar a gestão de aplicações, clique em Criar projeto e ativar APIs.

    O sistema cria o projeto de gestão na pasta.

  8. Tome nota do nome e do ID do projeto de gestão. Vai usar estes valores para conceder acesso.

    Em alternativa, para obter o ID do projeto de gestão, pode usar o seguinte comando da CLI gcloud:

    gcloud resource-manager folders describe FOLDER_ID
    --format="value(managementProject.split('/').slice(-1))"

    Substitua FOLDER_ID pelo ID da pasta com a app ativada.

    Para mais informações, consulte o artigo Encontre o nome, o número e o ID do projeto.

gcloud

  1. In the Google Cloud console, activate Cloud Shell.

    Activate Cloud Shell

    At the bottom of the Google Cloud console, a Cloud Shell session starts and displays a command-line prompt. Cloud Shell is a shell environment with the Google Cloud CLI already installed and with values already set for your current project. It can take a few seconds for the session to initialize.

  2. Certifique-se de que tem instalada a versão mais recente da Google Cloud CLI:

    gcloud components update

  3. Para ativar a gestão de aplicações numa pasta específica, use o comando gcloud resource-manager capabilities update com a flag --enable.

    gcloud resource-manager capabilities update folders/FOLDER_ID/capabilities/app-management \
   --enable

    Substitua FOLDER_ID pelo ID da pasta.

    Este comando ativa a capacidade de gestão de aplicações na pasta especificada e aprovisiona automaticamente um novo projeto do Google Cloud Platform nessa pasta para servir como projeto de gestão. Google Cloud

  4. Opcionalmente, para ativar as APIs recomendadas no projeto de gestão, siga as instruções para ativar Google Cloud serviços num projeto.

    5. Terraform

    Para ativar a gestão de aplicações numa pasta através do Terraform, use o recurso google_resource_manager_capability, por exemplo:

    resource "google_folder" "folder" {
  display_name     = "my-folder"
  parent           = "organizations/123456789"
  deletion_protection = false
}
resource "time_sleep" "wait_60s" {
  depends_on = [google_folder.folder]
  create_duration = "60s"
}
resource "google_resource_manager_capability" "capability" {
  value            = true
  parent           = "${google_folder.folder.name}"
  capability_name  = "app-management"
  depends_on = [time_sleep.wait_60s]
}

    Este comando ativa a capacidade de gestão de aplicações na pasta especificada e aprovisiona automaticamente um novo projeto do Google Cloud nessa pasta para servir como projeto de gestão. Para ativar a lista de APIs recomendadas no projeto de gestão, siga as instruções para ativar um serviço de API num Google Cloud projeto.

Associe uma conta de faturação ao projeto de gestão

Para usar funcionalidades avançadas do Google Cloud centradas na aplicação, tem de associar uma conta de faturação ativa ao projeto de gestão. Por exemplo, uma conta de faturação associada ajuda a fazer o seguinte:

  • Faça a gestão de cargas de trabalho que excedem as quotas de recursos do App Hub.
  • Use o Application Design Center para criar modelos e implementar aplicações.

Para uma vista geral dos potenciais custos associados à gestão de aplicações e às APIs ativadas, consulte o artigo Compreender os custos.

Siga estes passos para associar uma conta de faturação ativa ao seu projeto de gestão:

Consola

  1. Verifique se existe a conta de faturação que quer usar para a gestão de aplicações. Para criar uma conta de faturação, consulte o artigo Crie uma nova conta do Cloud Billing self-service.

  2. Na Google Cloud consola, abra a página Faturação.

    Aceder a Faturação

  3. No separador Os meus projetos, localize o projeto de gestão.

  4. Na linha do projeto, abra o menu Ações, selecione Alterar faturação e, de seguida, escolha a conta do Cloud Billing.

Para mais informações sobre como ativar a faturação de um projeto, consulte o artigo Ativar a faturação de um projeto.

gcloud 

gcloud billing projects link PROJECT_ID \
    --billing-account ACCOUNT_ID

Substitua o seguinte:

  • PROJECT_ID: o ID do projeto de gestão.
  • ACCOUNT_ID: o ID da conta de faturação. Os IDs das contas de faturação estão no formato 0X0X0X-0X0X0X-0X0X0X.

Configure âmbitos de observabilidade

O âmbito de observabilidade determina onde a Google Cloud consola procura dados de telemetria para apresentar. Cada Google Cloud projeto tem um âmbito de observabilidade único, que identifica os âmbitos de registo e rastreio predefinidos. Para dados de métricas, o âmbito das métricas do projeto determina onde a Google Cloud consola procura dados.

Para ver ou analisar todos os dados de telemetria da sua aplicação, configure o âmbito de observabilidade e o âmbito de métricas para o projeto de gestão. Ao configurar estes âmbitos, o Cloud Hub e outros serviços podem encontrar e apresentar os dados de registo, métricas e rastreio da sua aplicação, mesmo quando esses dados estão armazenados em vários projetos.

Esta secção resume a configuração necessária. Para instruções detalhadas, consulte o artigo Configure a monitorização de aplicações. A tabela seguinte mostra os âmbitos de configuração necessários.

Componente de âmbito Cenário de configuração Principais ações e considerações
Âmbito do registo Usa um destino agregado para encaminhar todos os registos na organização para um contentor de registos central.
  1. Crie uma vista de registo que inclua apenas registos de aplicações armazenados no contentor.
  2. Configure o âmbito do registo predefinido no projeto de gestão para incluir a visualização de registos.
Não tem um sink agregado ao nível da organização e a pasta ativada para apps não tem pastas aninhadas.
  1. Configure um sink agregado para encaminhar os registos de aplicações para o contentor de registos _Default do projeto de gestão.
  2. Certifique-se de que o âmbito do registo denominado _Default é o âmbito do registo predefinido.
Não quer usar um destino agregado. Configure o âmbito do registo predefinido no projeto de gestão para listar as localizações de armazenamento dos dados de registo da sua aplicação.
Âmbito das métricas Configurou uma pasta com apps ativadas que contém todos os projetos que armazenam os dados de métricas que quer ver. O Google Cloud Observability tenta sincronizar a lista de projetos na sua pasta com apps ativadas com a lista de projetos no âmbito das métricas.

Desde que o número de projetos na pasta com apps ativadas não exceda a sua quota do âmbito das métricas, o Google Cloud Observability pode manter a lista de projetos no âmbito das métricas atualizada quando adiciona ou remove projetos na pasta com apps ativadas.
Âmbito do rastreio Quiser monitorizar dados de rastreio de aplicações em vários projetos.
  1. Crie um âmbito de rastreio personalizado no projeto de gestão que liste os projetos que armazenam os dados de rastreio da sua aplicação.
  2. Defina o âmbito do rastreio personalizado como o âmbito do rastreio predefinido.

Crie aplicações

Depois de ativar a gestão de aplicações, pode criar as suas aplicações. Tem as seguintes opções para criar as suas aplicações:

  • Use o App Hub para criar aplicações a partir deGoogle Cloud recursos existentes. Consulte o artigo Crie uma aplicação.
  • Use o Application Design Center para conceber e implementar novos Google Cloud recursos, que aprovisionam automaticamente aplicações do App Hub. Usa modelos de aplicações para definir o design e, em seguida, implementa instâncias de aplicações com base nos modelos.

Ative as APIs para dados do projeto

A maioria das páginas no Cloud Hub apresenta dados da aplicação e dados do projeto. No entanto, algumas páginas só suportam vistas de projeto dos dados.

Quando configurou a gestão de aplicações, as APIs para ver dados de aplicações no Cloud Hub foram ativadas no projeto de gestão.

Para ver dados de recursos em projetos individuais, tem de ativar as APIs necessárias nesses projetos. Algumas APIs necessárias, como o Cloud Logging e o Cloud Monitoring, estão ativadas por predefinição quando cria um projeto.

Funções necessárias

Para receber as autorizações de que precisa para ativar as APIs, peça ao seu administrador que lhe conceda a função de IAM de administrador de utilização de serviços (roles/serviceusage.serviceUsageAdmin) no projeto. Para mais informações sobre a atribuição de funções, consulte o artigo Faça a gestão do acesso a projetos, pastas e organizações.

Também pode conseguir as autorizações necessárias através de funções personalizadas ou outras funções predefinidas.

Para usar o Gemini Cloud Assist para receber ajuda com tarefas como a resolução de problemas ou a otimização de custos, configure o Gemini Cloud Assist para ativar as APIs necessárias. Esta configuração é independente da ativação da API no Cloud Hub.

A tabela seguinte resume as APIs necessárias para cada página do Cloud Hub.

Ativar APIs

Para ativar APIs para projetos, siga estes passos:

Página Dados suportados APIs necessárias Funcionalidades opcionais
Início Aplicação ou projeto A página inicial apresenta dados de resumo das outras páginas do Cloud Hub.
Implementações Aplicação Hub de apps e Centro de design de aplicações
Estado e resolução de problemas Aplicação ou projeto

App Hub para apoio técnico de dados de aplicações

Cloud Logging, Cloud Monitoring, Error Reporting, Personalized Service Health e Cloud Asset Inventory para dados de saúde

Configure o Gemini Cloud Assist para criar e ver investigações.
Otimização Aplicação ou projeto

App Hub para apoio técnico de dados de aplicações

Cloud Monitoring e App Optimize para dados de custos e utilização

Configure o Gemini Cloud Assist para receber assistência com a otimização de custos.
Manutenção Apenas projeto Unified Maintenance
Quotas e reservas Apenas projeto

Cloud Quotas para dados de quotas

Compute Engine e Capacity Planner para utilizadores na pré-visualização privada do Capacity Planner
Apoio técnico Apenas projeto Cloud Customer Care

Consola

Na página inicial do Cloud Hub, pode ver uma lista de APIs que não estão ativadas para o Cloud Hub e ativar essas APIs.

  1. Na Google Cloud consola, aceda à página Início.

    Aceder ao ecrã principal

  2. No seletor de projetos, selecione o projeto que quer ver.

  3. Junto a Ativar APIs recomendadas, clique em Ver APIs. É apresentada uma caixa de diálogo com as APIs a ativar.

  4. Para ativar as APIs, clique em Ativar.

gcloud

Pode usar a CLI do Google Cloud para ativar uma ou mais APIs específicas.

  1. Defina o projeto predefinido para o projeto no qual quer ativar a API.

    gcloud config set project PROJECT_ID

    Substitua PROJECT_ID pelo ID do seu projeto.

  2. Obtenha uma lista de serviços que pode ativar no seu projeto:

    gcloud services list --available

    Se não vir a API listada, significa que não lhe foi concedido acesso para ativar a API.

  3. Ative os serviços que quer usar no projeto. Pode ativar mais do que uma API fornecendo uma lista de nomes de serviços.

    gcloud services enable SERVICE_NAME1 SERVICE_NAME2

Conceda acesso aos utilizadores do Cloud Hub

A função de operador do Cloud Hub inclui autorizações para ver a maioria dos dados no Cloud Hub. Tem de conceder acesso para ver os custos dos recursos na página de otimização e nas investigações do Gemini Cloud Assist em separado.

Consoante as responsabilidades específicas dos seus utilizadores, pode ter de conceder outras funções para que possam tomar medidas relativamente aos dados que veem no Cloud Hub.

Funções necessárias

Para receber as autorizações de que precisa para gerir o acesso a um projeto ou uma pasta, peça ao seu administrador que lhe conceda as seguintes funções de IAM no recurso para o qual quer gerir o acesso (projeto ou pasta):

Para mais informações sobre a atribuição de funções, consulte o artigo Faça a gestão do acesso a projetos, pastas e organizações.

Também pode conseguir as autorizações necessárias através de funções personalizadas ou outras funções predefinidas.

Conceda acesso aos dados da aplicação

Consola

  1. Na Google Cloud consola, aceda à página IAM.

    Aceda ao IAM

  2. No seletor de projetos, escolha a pasta com apps.

  3. Na página IAM, clique em Conceder acesso. O painel Conceder acesso é aberto.

  4. No campo Novos membros, introduza o endereço de email de um utilizador do Cloud Hub.

  5. Clique em Selecionar uma função e, no campo Filtro, introduza Cloud Hub.

  6. Selecione a função Operador do Cloud Hub e clique em Guardar. A função é concedida ao indivíduo em todos os projetos e subpastas da pasta ativada para apps.

  7. No seletor de projetos, escolha o projeto de gestão.

  8. Para conceder funções para custos de recursos e investigações, conceda as funções necessárias no projeto de gestão.

    1. Na página IAM, clique em Conceder acesso. O painel Conceder acesso é aberto.
    2. Conceda as seguintes funções aos indivíduos adequados:
      • Para ver dados de custos na página Otimização, tem de ter a função Leitor (roles/reader), Visitante (roles/viewer) ou uma função personalizada que contenha a autorização billing.resourceCosts.get.
      • Para ver investigações do Gemini Cloud Assist: Visualizador de investigações (roles/geminicloudassist.investigationViewer)

gcloud

  1. In the Google Cloud console, activate Cloud Shell.

    Activate Cloud Shell

    At the bottom of the Google Cloud console, a Cloud Shell session starts and displays a command-line prompt. Cloud Shell is a shell environment with the Google Cloud CLI already installed and with values already set for your current project. It can take a few seconds for the session to initialize.

  2. Certifique-se de que tem instalada a versão mais recente da Google Cloud CLI. Execute o seguinte comando a partir do Cloud Shell:

    gcloud components update

  3. Conceda a função de operador do Cloud Hub na pasta com apps ativadas aos indivíduos. Esta função é concedida a um indivíduo em todos os projetos e subpastas da pasta ativada para apps.

    gcloud resource-manager folders add-iam-policy-binding FOLDER_ID \
    --member='user:PRINCIPAL' \
    --role='roles/cloudhub.operator'

    Substitua FOLDER_ID pelo ID da pasta. Pode encontrar o ID da pasta com apps ativadas na página IAM e administração Definições da consola Google Cloud . Para garantir que a pasta tem a app ativada, a página Definições deve apresentar o ID do projeto de gestão. Se não conseguir encontrar o ID do projeto de gestão, pode não estar numa pasta com apps ativadas. No seletor de projetos, selecione a pasta com apps.

  4. Conceder acesso para ver os custos dos recursos no projeto de gestão. O comando de exemplo concede a função de leitor (roles/reader). Para conceder uma função com um conjunto de autorizações mais restrito, crie uma função personalizada que contenha a autorização billing.resourceCosts.get.

    gcloud projects add-iam-policy-binding PROJECT-ID \
    --member='user:PRINCIPAL' \
    --role='roles/reader'

    Substitua PROJECT-ID pelo ID do projeto de gestão. O ID do projeto de gestão de uma pasta tem o formato FOLDER-NAME-mp.

  5. Conceda acesso para ver investigações no projeto de gestão.

    gcloud projects add-iam-policy-binding PROJECT-ID \
    --member='user:PRINCIPAL' \
    --role='roles/geminicloudassist.investigationViewer'

Conceda acesso aos dados do projeto

Consola

  1. Na Google Cloud consola, aceda à página inicial do Cloud Hub .

    Aceder ao ecrã principal

  2. No seletor de projetos, escolha o seu projeto.

  3. Clique em Gerir acesso. O painel Conceder acesso é aberto.

  4. No campo Novos membros, introduza o endereço de email de um utilizador do Cloud Hub.

  5. Clique em Selecionar uma função e, no campo Filtro, introduza Cloud Hub.

  6. Selecione a função Operador do Cloud Hub e clique em Guardar.

  7. Use os mesmos passos para conceder funções para ver os custos dos recursos e as investigações.

    • Para ver dados de custos na página Otimização: leitor (roles/reader), visitante (roles/viewer) ou uma função personalizada que contenha a autorização billing.resourceCosts.get.
    • Para ver investigações do Gemini Cloud Assist: Visualizador de investigações (roles/geminicloudassist.investigationViewer)

gcloud

  1. In the Google Cloud console, activate Cloud Shell.

    Activate Cloud Shell

    At the bottom of the Google Cloud console, a Cloud Shell session starts and displays a command-line prompt. Cloud Shell is a shell environment with the Google Cloud CLI already installed and with values already set for your current project. It can take a few seconds for the session to initialize.

  2. Certifique-se de que tem instalada a versão mais recente da Google Cloud CLI. Execute o seguinte comando a partir do Cloud Shell:

    gcloud components update

  3. Conceda a função de operador do Cloud Hub no projeto.

    gcloud projects add-iam-policy-binding PROJECT_ID \
    --member='user:PRINCIPAL' \
    --role='roles/cloudhub.operator'

    Substitua PROJECT_ID pelo ID do projeto.

  4. Conceder acesso para ver os custos dos recursos no projeto. O comando de exemplo concede a função de leitor (roles/reader). Para conceder uma função com um conjunto de autorizações mais restrito, crie uma função personalizada que contenha a autorização billing.resourceCosts.get.

    gcloud projects add-iam-policy-binding PROJECT_ID \
    --member='user:PRINCIPAL' \
    --role='roles/reader'

  5. Conceder acesso para ver investigações no projeto.

    gcloud projects add-iam-policy-binding PROJECT_ID \
    --member='user:PRINCIPAL' \
    --role='roles/geminicloudassist.investigationViewer'

O que se segue?