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:

• Ative o gerenciamento de aplicativos: Administrador de pastas (roles/resourcemanager.folderAdmin) no recurso pai da pasta
• Ative as APIs: Administrador do Service Usage (roles/serviceusage.serviceUsageAdmin) na pasta de destino (para ativar as APIs necessárias e recomendadas)
• Vincule uma conta de faturamento ao projeto de gerenciamento:
  • Gerente de faturamento do projeto (roles/billing.projectManager) no projeto de gerenciamento
  • Usuário da conta de faturamento (roles/billing.user) na conta de faturamento de destino
• Conceda papéis focados em aplicativos aos usuários: Administrador do IAM do projeto (roles/resourcemanager.projectIamAdmin) no projeto de gerenciamento
• Configure o escopo de observabilidade:
  • Editor de observabilidade (roles/observability.editor) no projeto de gerenciamento
  • Gravador de configuração de registros (roles/logging.configWriter) no projeto de gerenciamento
  • Administrador do Monitoring (roles/monitoring.admin) no projeto de gerenciamento e em cada projeto que você quer adicionar ao escopo de métricas
  • Usuário do Cloud Trace (roles/cloudtrace.user) no projeto de gerenciamento
  • Leitor do App Hub (roles/apphub.viewer) no projeto de gerenciamento
• Acessar dados no nível do aplicativo e para envolvidos no projeto no Cloud Hub: Operador do Cloud Hub (roles/cloudhub.operator) na pasta habilitada para apps

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:

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]
}

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:

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

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.

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.