Configurar o Cloud Hub

Este documento descreve como configurar o Cloud Hub.

Há várias etapas principais no processo de configuração:

  1. Para criar aplicativos do App Hub e ver dados sobre eles no Cloud Hub, configure o gerenciamento de aplicativos.

    Se você não configurar o gerenciamento de aplicativos, ainda poderá ver alguns dados por Google Cloud projeto em vez de por aplicativo no Cloud Hub.

  2. Ative as APIs para dados do projeto. Algumas páginas no Cloud Hub não são compatíveis com dados de aplicativos. É preciso ativar as APIs dessas páginas separadamente.

  3. Configure visualizações agregadas de registros, métricas e traces.

  4. Conceda acesso aos usuários do Cloud Hub.

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

Configurar o gerenciamento de aplicativos

Nesta seção, descrevemos as etapas necessárias para ativar o gerenciamento de aplicativos e criar seus aplicativos.

Funções exigidas

Para receber as permissões necessárias para configurar uma pasta ativada para apps, peça ao administrador que conceda a você os seguintes papéis do IAM:

Para mais informações sobre a concessão de papéis, consulte Gerenciar o acesso a projetos, pastas e organizações.

Também é possível conseguir as permissões necessárias usando papéis personalizados ou outros papéis predefinidos.

Ativar o gerenciamento de aplicativos

Com o gerenciamento de aplicativos, você muda o foco de componentes individuais da infraestrutura para o aplicativo como um todo.

Quando você ativa o gerenciamento de aplicativos em uma pasta, ela é chamada de pasta habilitada para apps e acontece o seguinte:

  • Um projeto é definido como o projeto de gerenciamento na pasta.
  • O sistema ativa as APIs necessárias no projeto de gerenciamento.
  • O projeto de gerenciamento armazena dados de aplicativos, incluindo APIs ativadas, faturamento, cotas e controles de acesso.

Para ativar o gerenciamento de aplicativos em uma pasta, faça o seguinte:

Console

  1. Selecione ou crie a pasta Google Cloud que você quer configurar como uma pasta habilitada para apps. Para criar uma pasta, consulte Como criar pastas.

  2. No console Google Cloud , abra a página Gerenciar recursos.

    Acessar "Gerenciar recursos"

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

    Se uma pasta tiver o ícone de pasta habilitada para apps, o gerenciamento de aplicativos já estará ativado.

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

    Se o gerenciamento de aplicativos não estiver ativado na pasta, a configuração Gerenciamento de aplicativos vai mostrar Não ativado.

  5. Na área Ativar gerenciamento de aplicativos, clique em Criar projeto.

    O painel Criar projeto de gerenciamento e ativar APIs necessárias é aberto.

  6. Confira a lista de APIs necessárias. Essas APIs gerenciam o ciclo de vida do seu aplicativo. Para APIs que têm custos associados, clique no nome da API para saber mais sobre os preços.

  7. Para ativar o gerenciamento de aplicativos, clique em Criar projeto e ativar APIs.

    O sistema cria o projeto de gerenciamento na pasta.

  8. Anote o nome e o ID do projeto de gerenciamento. Você usará esses valores para conceder acesso.

    Como alternativa, para receber o ID do projeto de gerenciamento, use o seguinte comando da Google Cloud CLI:

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

    Substitua FOLDER_ID pelo ID da pasta habilitada para apps.

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

gcloud

  1. No console do Google Cloud , ative o Cloud Shell.

    Ativar o Cloud Shell

    Na parte de baixo do console Google Cloud , uma sessão do Cloud Shell é iniciada e exibe um prompt de linha de comando. O Cloud Shell é um ambiente shell com a CLI do Google Cloud já instalada e com valores já definidos para o projeto atual. A inicialização da sessão pode levar alguns segundos.

  2. Verifique se a versão mais recente da Google Cloud CLI está instalada:

    gcloud components update

  3. Para ativar o gerenciamento de aplicativos em uma 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.

    Esse comando ativa o gerenciamento de aplicativos na pasta especificada e provisiona automaticamente um novo projeto Google Cloud dentro dessa pasta para servir como projeto de gerenciamento.

  4. Se quiser ativar as APIs recomendadas no projeto de gerenciamento, siga as instruções para ativar serviços do Google Cloud em um projeto.

Terraform

Para ativar o gerenciamento de aplicativos em uma pasta usando o 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]
}

Esse comando ativa o gerenciamento de aplicativos na pasta especificada e provisiona automaticamente um novo projeto Google Cloud dentro dessa pasta para servir como projeto de gerenciamento. Para ativar a lista de APIs recomendadas no projeto de gerenciamento, siga as instruções para ativar um serviço de API em um projeto do Google Cloud .

Vincular uma conta de faturamento ao projeto de gerenciamento

Para usar os recursos avançados do Google Cloud centrados em aplicativos, vincule uma conta de faturamento ativa ao projeto de gerenciamento. Por exemplo, uma conta de faturamento vinculada ajuda você a fazer o seguinte:

  • Gerenciar cargas de trabalho que excedem as cotas de recursos do App Hub.
  • Use o App Design Center para criar modelos e implantar aplicativos.

Para uma visão geral dos possíveis custos associados ao gerenciamento de aplicativos e às APIs ativadas, consulte Entender os custos.

Siga estas etapas para vincular uma conta de faturamento ativa ao seu projeto de gerenciamento:

Console

  1. Verifique se a conta de faturamento que você quer usar para o gerenciamento de aplicativos existe. Para criar uma conta do Cloud Billing, consulte Criar uma nova conta de autoatendimento do Cloud Billing.

  2. No console do Google Cloud , abra a página Faturamento.

    Acessar "Faturamento"

  3. Na guia Meus projetos, localize o projeto de gerenciamento.

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

Para mais informações sobre como ativar o faturamento de um projeto, consulte Ativar o faturamento de um projeto.

gcloud 

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

Substitua:

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

Configurar escopos de observabilidade

O escopo de observabilidade determina onde o console Google Cloud pesquisa dados de telemetria para mostrar. Cada projeto Google Cloud tem um único escopo de observabilidade, que identifica os escopos de registros e rastreamentos padrão. Para dados de métricas, o escopo de métricas do projeto determina onde o consoleGoogle Cloud pesquisa dados.

Para ver ou analisar todos os dados de telemetria do aplicativo, configure o escopo de observabilidade e as métricas de escopo do projeto de gerenciamento. Ao configurar esses escopos, o Cloud Hub e outros serviços podem encontrar e mostrar os dados de registro, métricas e rastreamento do seu aplicativo, mesmo quando esses dados são armazenados em vários projetos.

Esta seção resume a configuração necessária. Para instruções detalhadas, consulte Configurar o monitoramento de aplicativos. A tabela a seguir mostra os escopos de configuração obrigatórios.

Componente de escopo Cenário de configuração Principais ações e considerações
Escopo do registro Você usa um coletor agregado para encaminhar todos os registros da organização para um bucket de registros central.
  1. Crie uma visualização de registros que inclua apenas os registros de aplicativos armazenados no bucket.
  2. Configure o escopo do registro padrão no projeto de gerenciamento para incluir a visualização de registros.
Você não tem um coletor agregado no nível da organização, e a pasta habilitada para apps não tem pastas aninhadas.
  1. Configure um coletor agregado para rotear registros de aplicativos para o bucket de registros _Default do projeto de gerenciamento.
  2. Verifique se o escopo do registro chamado _Default é o padrão.
Você não quer usar um coletor agregado. Configure o escopo de registro padrão no projeto de gerenciamento para listar os locais de armazenamento dos dados de registro do seu aplicativo.
Escopo de métricas Você configurou uma pasta habilitada para gerenciar apps que contém todos os projetos que armazenam os dados de métricas que você quer ver. O Google Cloud Observability tenta sincronizar a lista de projetos na sua pasta habilitada para apps com a lista de projetos no escopo das métricas.

Desde que o número de projetos na pasta habilitada para apps não exceda a cota do escopo de métricas, o Google Cloud Observability pode manter a lista de projetos no escopo das métricas atualizada quando você adiciona ou remove projetos na pasta habilitada para apps.
Escopo do trace Você quer monitorar dados de rastreamento de aplicativos em vários projetos.
  1. Crie um escopo de rastreamento personalizado no projeto de gerenciamento que liste os projetos que armazenam os dados de rastreamento do seu aplicativo.
  2. Defina seu escopo de rastreamento personalizado como o padrão.

Criar aplicativos

Depois de ativar o gerenciamento de aplicativos, você poderá criar seus aplicativos. Você tem as seguintes opções para criar seus aplicativos:

  • Use o App Hub para criar aplicativos com base em recursos Google Cloud existentes. Consulte Criar um aplicativo.
  • Use o App Design Center para criar e implantar novos recursos doGoogle Cloud , que provisionam automaticamente aplicativos do App Hub. Você usa modelos de aplicativos para definir o design e implantar instâncias de aplicativos com base nos modelos.

Ativar APIs para o Cloud Hub

O Cloud Hub não tem uma API própria. Em vez disso, ele chama outras APIs que fornecem dados ao Cloud Hub.

A tabela a seguir lista as APIs usadas pelo Cloud Hub. Algumas dessas APIs têm custos associados ou dependências com custos. Consulte os links de preços para mais informações.

API Uso no Cloud Hub Preços

API App Hub
(apphub.googleapis.com)

Armazena metadados para todos os aplicativos registrados. Permite organizar recursos em aplicativos.

Necessário para mostrar dados de aplicativos no Cloud Hub. Saiba mais sobre o App Hub.

Preços do App Hub

API App Topology
(apptopology.googleapis.com)

Ver visualizações das relações entre recursos de aplicativos.

Necessário para ver as visualizações da App Topology.

API App Design Center
(designcenter.googleapis.com)

Projetar, implantar e atualizar aplicativos

Necessário para ver implantações de aplicativos no Cloud Hub.

 Preços

App Optimize API
(appoptimize.googleapis.com)

Receba dados de custo e utilização para ajudar a otimizar os custos.

Necessário para visualizar dados na página "Otimização" no Cloud Hub.

Não há cobranças adicionais para essa API. A API recupera dados do Cloud Billing e do Cloud Monitoring

API Capacity Planner
(planner.googleapis.com)

Confira os dados de custo e utilização para otimizar os custos.

Necessário para acessar dados de uso e previsão no Cloud Hub.

 Preços do Planejador de capacidade

API Compute Engine
(compute.googleapis.com)

Provisione instâncias de máquina virtual (VM) autogerenciadas e instâncias bare metal.

Necessário para acessar dados de reserva no Cloud Hub.

 Informações de faturamento para reservas futuras
API Cloud Logging
(logging.googleapis.com)

Gerenciamento de registros em tempo real.

Fornece geração de registros para serviços Google Cloud . Obrigatório para a página de integridade e solução de problemas no Cloud Hub.

Preços da observabilidade
API Cloud Monitoring API
(monitoring.googleapis.com)

Fornece métricas e alertas para serviços do Google Cloud . Necessário para dados de alerta e telemetria na página de integridade e solução de problemas no Cloud Hub.

Preços da observabilidade
API Service Health
(servicehealth.googleapis.com)

Identifique Google Cloud interrupções de serviço relevantes para seus aplicativos

Necessário para ver incidentes Google Cloud nas páginas Integridade e solução de problemas e Suporte no Cloud Hub.

Preços do Personalized Service Health
API Recommender
(recommender.googleapis.com)

Gerar recomendações e insights do Active Assist para ajudar você a otimizar seus recursos do Google Cloud

Necessário para ver as recomendações de otimização de custos no Cloud Hub.

Preços do Recomendador
API Gemini Cloud Assist
(geminicloudassist.googleapis.com)

Um produto do portfólio Gemini para Google Cloud que oferece assistência com tecnologia de IA para simplificar o ciclo de vida do aplicativo em Google Cloud.

É necessário usar o Gemini Cloud Assist para receber ajuda com tarefas como otimização de custos e solução de problemas.

Preços do Gemini Cloud Assist
API Cloud Quotas
(cloudquotas.googleapis.com)

Visualizar e gerenciar cotas.

Necessário para ver cotas e limites do sistema no Cloud Hub.

 Preços das cotas do Cloud
API Unified Maintenance
(maintenance.googleapis.com)

Gerencie a manutenção planejada em todos os serviços do Google Cloud .

Necessário para ver atividades de manutenção no Cloud Hub.

 Preços do Unified Maintenance
API Service Usage
(serviceusage.googleapis.com)

Liste e gerencie APIs e serviços nos seus projetos do Google Cloud .

Necessário para ver cotas e limites do sistema no Cloud Hub.

 Preços do Service Usage

Depois de configurar o gerenciamento de aplicativos, muitas das APIs que fornecem dados ao Cloud Hub são ativadas no projeto de gerenciamento como APIs obrigatórias.

No entanto, algumas APIs usadas pelo Cloud Hub só fornecem dados para projetos ou não são ativadas automaticamente como APIs necessárias em um projeto de gerenciamento.

Use as instruções nesta seção para ativar as APIs ausentes do Cloud Hub.

  • Se você configurar uma pasta habilitada para apps, ative as APIs no projeto de gerenciamento da pasta.
  • Para ver dados de um único projeto, ative as APIs nele.

  • Na página "Manutenção": se os projetos não estiverem em uma pasta habilitada para apps, configure um projeto para agregar registros dos outros projetos e ative a API Unified Maintenance nesse projeto.

Funções exigidas

Para receber as permissões necessárias para ativar APIs, peça ao administrador para conceder a você o papel do IAM de administrador de uso do serviço (roles/serviceusage.serviceUsageAdmin) no projeto em que você quer ativar as APIs. Para mais informações sobre a concessão de papéis, consulte Gerenciar o acesso a projetos, pastas e organizações.

Também é possível conseguir as permissões necessárias usando papéis personalizados ou outros papéis predefinidos.

Ativar APIs

Para informações sobre as APIs usadas pelo Cloud Hub, consulte Ativar APIs para o Cloud Hub.

Console

Na página inicial do Cloud Hub, é possível conferir uma lista de APIs que não estão ativadas para o Cloud Hub e ativar essas APIs.

  1. No console do Google Cloud , acesse a página Início.

    Ir para a página inicial

  2. No seletor de projetos, selecione o projeto que você quer acessar.

  3. Ao lado de "Ativar APIs recomendadas", clique em Ativar APIs. Um painel é aberto e mostra as APIs que ainda não foram ativadas.

  4. Selecione as APIs que você quer ativar e clique em Ativar.

gcloud

  1. Defina o projeto padrão como aquele em que você quer ativar a API.

    gcloud config set project PROJECT_ID

    Substitua PROJECT_ID pela ID do seu projeto.

  2. Receba uma lista de serviços que podem ser ativados no projeto:

    gcloud services list --available

    Se a API não estiver listada, o acesso para a ativação dela não foi concedido a você

  3. Ative os serviços que você quer usar no projeto. É possível ativar mais de uma API fornecendo uma lista de nomes de serviços.

    gcloud services enable SERVICE_NAME1 SERVICE_NAME2

Conceder acesso aos usuários do Cloud Hub

O papel de operador do Cloud Hub inclui permissões para visualizar a maioria dos dados no Cloud Hub.

Dependendo das responsabilidades específicas dos usuários, talvez seja necessário conceder outras funções para que eles possam usar os recursos do Gemini Cloud Assist ou realizar ações com base nos dados que visualizam no Cloud Hub. Para mais informações, consulte Controle de acesso com o IAM.

Funções exigidas

Para receber as permissões necessárias para gerenciar o acesso a um projeto ou uma pasta, peça ao administrador para conceder a você os seguintes papéis do IAM no recurso em que você quer gerenciar o acesso (projeto ou pasta):

Para mais informações sobre a concessão de papéis, consulte Gerenciar o acesso a projetos, pastas e organizações.

Também é possível conseguir as permissões necessárias usando papéis personalizados ou outros papéis predefinidos.

conceder acesso a usuários

Console

  1. Acesse a página inicial no Cloud Hub.

    Ir para a página inicial

  2. No seletor de projetos, escolha a pasta ou o projeto habilitado para apps em que você quer conceder acesso.

  3. Clique em Conceder acesso. O painel Conceder acesso ao Cloud Hub é aberto.

  4. No campo Novos principais, insira um principal que precisa de acesso ao Cloud Hub.

  5. Clique em Conceder funções.

gcloud

  1. No console do Google Cloud , ative o Cloud Shell.

    Ativar o Cloud Shell

    Na parte de baixo do console Google Cloud , uma sessão do Cloud Shell é iniciada e exibe um prompt de linha de comando. O Cloud Shell é um ambiente shell com a CLI do Google Cloud já instalada e com valores já definidos para o projeto atual. A inicialização da sessão pode levar alguns segundos.

  2. Verifique se a versão mais recente da Google Cloud CLI está instalada. Execute o comando a seguir no Cloud Shell:

    gcloud components update

  3. Para conceder o papel de operador do Cloud Hub, execute o comando adequado:

    Para uma pasta habilitada para apps:

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

    Para um único projeto:

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

    Substitua as seguintes variáveis:

    • FOLDER_ID: o ID da pasta habilitada para apps. No console Google Cloud , é possível encontrar o ID da pasta na página Início do Cloud Hub. O campo Tipo de pasta tem o valor App-enabled folder se a pasta estiver configurada para gerenciamento de aplicativos.
    • PROJECT_ID: o ID do projeto. No console Google Cloud , você encontra o ID do projeto na página Início do Cloud Hub.
    • PRINCIPAL: a identidade que você está concedendo.

A seguir