Configurar o Cloud Hub

Este documento descreve como configurar o Cloud Hub.

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

  1. Para gerenciar seus recursos de maneira centrada no aplicativo, incluindo a visualização de dados dos aplicativos no Cloud Hub, configure o gerenciamento de aplicativos.

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

  2. Ative as APIs necessárias.

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

  4. Configure o acesso para usuários do Cloud Hub.

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

Funções exigidas

Para receber as permissões necessárias para configurar o Cloud Hub, peça ao administrador para conceder a você os seguintes papéis do IAM:

  • Ative o gerenciamento de aplicativos para uma pasta e conceda acesso aos usuários:
  • Crie aplicativos no App Hub: Editor do App Hub (roles/apphub.editor) no projeto de gerenciamento da pasta habilitada para apps.
  • Crie modelos de aplicativos no App Design Center: Usuário do App Design Center (roles/designcenter.user) no projeto de gerenciamento na pasta ativada por apps.
  • Crie aplicativos com base em modelos na Central de design de aplicativos: Editor de aplicativos (roles/designcenter.applicationEditor) no projeto de gerenciamento da pasta ativada 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.

Configurar o gerenciamento de aplicativos

Muitos aplicativos na nuvem evoluem para incluir vários recursos de infraestrutura de um ou mais projetos do Google Cloud , o que pode dificultar o gerenciamento e a compreensão desses recursos para desenvolvedores e operadores. Ao organizar seus recursos como aplicativos do App Hub, você entende melhor as interações de recursos e pode analisar, monitorar, gerenciar e resolver problemas de maneira centrada no aplicativo.

Antes de criar os aplicativos, é preciso ativar uma pasta Google Cloud para gerenciamento de aplicativos que contenha os recursos que você quer gerenciar como aplicativos.

Configurar uma pasta habilitada para apps

Ao configurar o gerenciamento de aplicativos para uma pasta, o processo inclui as seguintes ações:

  • Criação de um novo projeto de gerenciamento na pasta. O projeto de gerenciamento é de propriedade do Google e não pode ser movido ou excluído.
  • Ativar APIs para serviços que oferecem suporte ao gerenciamento de aplicativos. Os serviços estão ativados no projeto de gerenciamento.

Para saber como ativar o gerenciamento de aplicativos em uma pasta, consulte Gerenciar aplicativos em uma pasta.

Criar aplicativos

Depois de configurar uma pasta habilitada para apps, você pode 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 a central de design de aplicativos para criar e implantar novos recursosGoogle 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 obrigatórias

Esta seção lista as APIs necessárias para mostrar dados em uma página específica do Cloud Hub.

  • Se você configurou o gerenciamento de aplicativos, algumas APIs já estão ativadas no projeto de gerenciamento.
  • As APIs Cloud Logging e Cloud Monitoring são ativadas por padrão quando você cria um projeto.

As APIs de outros serviços precisam ser ativadas separadamente:

  • Cotas do Cloud
  • Manutenção unificada
  • Personalized Service Health
  • App Optimize
Página Dados compatíveis APIs necessárias Onde ativar as APIs
Início Aplicativo ou projeto A página inicial mostra dados resumidos das outras páginas do Cloud Hub.
Deployments Aplicativo App Hub e App Design Center

As APIs são ativadas automaticamente no projeto de gerenciamento quando ele é criado.
Integridade e solução de problemas Aplicativo ou projeto

Suporte do App Hub para dados de aplicativos

Cloud Logging, Cloud Monitoring, Cloud Trace, Error Reporting, integridade personalizada de serviço e Inventário de recursos do Cloud para dados de integridade

Para dados no nível do aplicativo, as APIs são ativadas automaticamente no projeto de gerenciamento quando ele é criado.

Para conferir dados no nível do projeto, ative as APIs que fornecem dados de saúde para os projetos que você quer visualizar.
Otimização Aplicativo ou projeto

Suporte do App Hub para dados de aplicativos

Cloud Monitoring e App Optimize para dados de custo e uso

Para dados no nível do aplicativo, as APIs do App Hub e do Monitoring são ativadas automaticamente no projeto de gerenciamento quando ele é criado. É necessário ativar a App Optimize API separadamente.

Para ver dados no nível do projeto, ative as APIs Cloud Monitoring e App Optimize nos projetos que você quer visualizar.
Manutenção Somente projeto Manutenção unificada

Ative a API para os projetos que você quer acessar.
Cotas e reservas Somente projeto

Cotas do Cloud para dados de cota

Compute Engine e Planejador de capacidade para usuários na prévia particular do Planejador de capacidade

Ative as APIs dos projetos que você quer visualizar
Suporte Somente projeto Cloud Customer Care

Ative as APIs dos projetos que você quer visualizar

Para ativar uma API específica:

  1. No console Google Cloud , acesse a página Biblioteca de APIs.

    Acessar a biblioteca de APIs

  2. Selecione o projeto do Google Cloud em que você quer ativar a API.

  3. Procure a API que você quer ativar.

  4. Clique no nome da API nos resultados da pesquisa.

  5. Na página Detalhes do produto da API, clique em ATIVAR.

Configurar visualizações agregadas de dados de telemetria

Como os dados dos aplicativos do App Hub podem incluir vários projetos, é necessário agregar registros, métricas e rastreamentos para ver os dados por aplicativo no Cloud Hub.

Se você estiver apenas visualizando dados por projeto, não será necessário agregar seus dados, mas ainda é recomendável, já que há outros benefícios além do gerenciamento de aplicativos:

  • É possível ver e consultar registros, métricas e traces em vários projetos ao visualizar os dados no Cloud Logging, no Cloud Monitoring e no Cloud Trace.
  • Armazenar registros em um projeto central desvincula o ciclo de vida dos registros do ciclo de vida dos projetos. Essa separação é benéfica para requisitos de compliance, como retenção de dados.
  • Se você precisar obedecer aos requisitos de localidade de dados, gerencie um pequeno conjunto de buckets de registros regionais que centralizam os registros de cada Google Cloud região usada.

Normalmente, a configuração da agregação de registros, métricas e rastreamentos é feita por um principal com o papel de administrador da organização (roles/resourcemanager.organizationAdmin) do Identity and Access Management (IAM).

A seguir