Registrar recursos atuais em um aplicativo

Registrar os recursos do Google Cloud como serviços e cargas de trabalho em um aplicativo do App Hub simplifica o gerenciamento, organizando os recursos com base na finalidade comercial. Essa abordagem oferece visibilidade, monitoramento, governança e controle operacional unificados.

Neste guia, mostramos como agrupar recursos do Google Cloud que ainda não estão formalmente definidos como um aplicativo.

Antes de começar

Conclua a configuração inicial do gerenciamento de aplicativos antes de organizar os recursos em aplicativos. Esse processo geralmente envolve as seguintes funções e etapas:

Criar um aplicativo

Crie um aplicativo no App Hub para atuar como um contêiner lógico para seus recursos do Google Cloud :

Console

  1. No console do Google Cloud , use o seletor de projetos para selecionar o projeto de gerenciamento.

  2. Acesse a página Aplicativos no App Hub:

    Acesse Aplicativos

  3. Clique em Criar aplicativo.

  4. Na guia Detalhes do aplicativo, selecione o melhor local para seu aplicativo com base nos requisitos de distribuição geográfica:

    • Selecione Global para criar um aplicativo global.
    • Selecione Multirregional para criar um aplicativo multirregional. Em seguida, selecione uma multirregião compatível (us ou eu) para o aplicativo.
    • Selecione Regional para criar um aplicativo regional. Em seguida, selecione a região específica para seu aplicativo com base nas regiões com disponibilidade compatíveis com o App Hub.

    Para mais informações sobre o melhor local para seu aplicativo, consulte Aplicativos globais, multirregionais e regionais.

  5. Insira um nome para o aplicativo.

    Esse nome é um identificador exclusivo que só pode conter letras minúsculas, números ou hifens. Não é possível mudar esse nome depois de criar o aplicativo.

  6. Se quiser, adicione um nome de exibição e uma descrição para o aplicativo.

    Eles não são identificadores exclusivos e podem ser alterados depois que você criar o aplicativo.

  7. Clique em Continuar.

  8. Na guia Recursos do aplicativo, navegue pelos recursos de infraestrutura e marque as caixas de seleção dos recursos que você quer registrar como serviços e cargas de trabalho do aplicativo.

    É possível selecionar até 10 recursos por vez.

  9. Clique em Continuar.

  10. Na guia Atributos e proprietários, é possível adicionar atributos ao aplicativo, como criticidade, ambiente e proprietários do aplicativo.

    É possível usar os mesmos atributos e proprietários para os recursos que você está registrando no aplicativo ou defini-los mais tarde.

  11. Clique em Criar.

Quando o aplicativo é criado, a página Aplicativos exibe os detalhes dele, incluindo os recursos que você registrou como serviços e cargas de trabalho. Depois de criar o aplicativo, é possível registrar mais serviços e cargas de trabalho nele.

gcloud

  1. Use a CLI do Google Cloud para criar um aplicativo no terminal ou no Cloud Shell:

    gcloud apphub applications create APPLICATION_NAME \
      --project=PROJECT_ID \
      --scope-type=SCOPE_TYPE \
      --location=LOCATION \
      --display-name=DISPLAY_NAME \
      --criticality-type=CRITICALITY \
      --environment-type=ENVIRONMENT \
      --developer-owners=display-name=DEV_NAME,email=DEV_EMAIL \
      --operator-owners=display-name=OPERATOR_NAME,email=OPERATOR_EMAIL \
      --business-owners=display-name=BUSINESS_NAME,email=BUSINESS_EMAIL
    

    Substitua APPLICATION_NAME pelo nome do aplicativo. Esse nome é um identificador exclusivo que pode conter apenas letras minúsculas, números ou hifens.

    Use flags opcionais, como --criticality-type, para definir os atributos de nível superior do aplicativo e oferecer suporte à facilidade de descoberta e à governança.

    Para flags obrigatórias e opcionais, substitua o seguinte:

    • Obrigatório: PROJECT_ID: o ID do projeto de gerenciamento.
    • Obrigatório: SCOPE_TYPE: o local do aplicativo com base nos requisitos de distribuição geográfica. Use um dos seguintes valores:

      • REGIONAL para aplicativos regionais.
      • MULTI_REGIONAL para aplicativos multirregionais.
      • GLOBAL para aplicativos globais.

      Para mais informações sobre o melhor local para seu aplicativo, consulte Aplicativos globais, multirregionais e regionais.

    • Obrigatório: LOCATION: o local específico do aplicativo. Use um dos seguintes valores:

      • Se o --scope-type local para seu aplicativo estiver definido como REGIONAL, especifique um nome de região com disponibilidade compatível com o App Hub.
      • Se o local --scope-type do aplicativo estiver definido como MULTI_REGIONAL, especifique us ou eu.
      • Se o local --scope-type do aplicativo estiver definido como GLOBAL, use global.
    • Opcional: DISPLAY_NAME: o nome de exibição do seu aplicativo. O nome de exibição não é um identificador exclusivo e pode ser alterado depois que você criar o aplicativo.

    • Opcional: CRITICALITY: o nível de importância do aplicativo para suas operações. Use um dos seguintes valores:

      • MISSION_CRITICAL
      • HIGH
      • MEDIUM
      • LOW
    • Opcional: ENVIRONMENT: o estágio do ciclo de vida do software. Use um dos seguintes valores:

      • PRODUCTION
      • STAGING
      • DEVELOPMENT
      • TEST
    • Opcional: DEV_NAME e DEV_EMAIL: o nome de exibição e o endereço de e-mail do desenvolvedor proprietário, respectivamente.

    • Opcional: OPERATOR_NAME e OPERATOR_EMAIL: o nome de exibição e o endereço de e-mail do proprietário do operador, respectivamente.

    • Opcional: BUSINESS_NAME e BUSINESS_EMAIL: o nome de exibição e o endereço de e-mail do proprietário da empresa, respectivamente.

  2. Liste os aplicativos no seu projeto:

    gcloud apphub applications list \
      --project=PROJECT_ID \
      --location=LOCATION
    

    Você vai receber uma saída semelhante a esta:

    ID                 DISPLAY_NAME   CREATE_TIME
    APPLICATION_NAME   DISPLAY_NAME   2023-10-31T18:33:48
    

Terraform

Para criar um aplicativo com o Terraform, use o recurso google_apphub_application. Esse recurso permite definir as propriedades do aplicativo, incluindo nome, local e atributos.

O exemplo a seguir cria um aplicativo regional em us-central1 com atributos de criticidade, ambiente e proprietário definidos:

resource "google_apphub_application" "example" {
    project        = "my-project-id"
    location       = "us-central1"
    application_id = "my-application"
    display_name   = "My Application"
    description    = "This application represents our platform."
    scope {
        type = "REGIONAL"
    }
    attributes {
        criticality {
            type = "MISSION_CRITICAL"
        }
        environment {
            type = "PRODUCTION"
        }
        business_owners {
            display_name = "Alice"
            email        = "alice@example.com"
        }
        developer_owners {
            display_name = "Bob"
            email        = "bob@example.com"
        }
        operator_owners {
            display_name = "Charlie"
            email        = "charlie@example.com"
        }
    }
}

Registrar serviços e cargas de trabalho

O App Hub permite selecionar recursos compatíveis localizados no limite de gerenciamento de aplicativos para registrá-los como serviços e cargas de trabalho. Depois de criar um aplicativo, é possível registrar recursos do Google Cloud como serviços e cargas de trabalho nele.

Só é possível registrar serviços exclusivos em um aplicativo. No entanto, os serviços compartilhados podem ser registrados em mais de um aplicativo. O App Hub vai descobrir serviços compartilhados quando você os registrar em um aplicativo, mesmo que eles já estejam registrados em outro aplicativo, mas talvez não seja possível modificar os atributos deles.

Console

Depois de criar um aplicativo, é possível registrar vários recursos nele:

  1. No console do Google Cloud , use o seletor de projetos para selecionar o projeto de gerenciamento.

  2. Acesse a página Aplicativos no App Hub:

    Acesse Aplicativos

  3. Clique no nome do aplicativo em que você quer registrar os recursos do Google Cloud .

  4. Na página do aplicativo, selecione a guia Serviços e cargas de trabalho.

  5. Clique em Registrar serviços ou cargas de trabalho.

  6. Na guia Serviços e cargas de trabalho, navegue pelos recursos de infraestrutura e marque as caixas de seleção dos recursos que você quer registrar como serviços ou cargas de trabalho do aplicativo.

    É possível selecionar até 10 recursos por vez.

  7. Clique em Continuar.

  8. Na guia Atributos e proprietários, é possível adicionar atributos para esses recursos, como importância, ambiente e proprietários de recursos.

    Você pode usar os mesmos atributos e proprietários do aplicativo ou definir atributos diferentes mais tarde.

  9. Clique em Registrar.

A guia Serviços e cargas de trabalho mostra todos os serviços e cargas de trabalho registrados do aplicativo.

gcloud

O App Hub permite selecionar recursos compatíveis localizados no limite de gerenciamento de aplicativos como serviços ou cargas de trabalho. Use a CLI do Google Cloud para listar serviços ou cargas de trabalho que podem ser registrados no aplicativo pelo terminal ou pelo Cloud Shell. Os comandos são um pouco diferentes para serviços e cargas de trabalho:

Registrar serviços

  1. Liste os serviços disponíveis que podem ser registrados em um aplicativo:

    gcloud apphub discovered-services list \
      --project=PROJECT_ID \
      --location=REGION \
      --filter=FILTER_EXPRESSION
    

    Para flags obrigatórias e opcionais, substitua o seguinte:

    • Obrigatório: PROJECT_ID: o ID do projeto de gerenciamento.
    • Obrigatório: REGION: o local específico do serviço com base na sua distribuição geográfica. Use um dos seguintes valores:

    • Opcional: FILTER_EXPRESSION: a expressão de filtro para a flag --filter para exibir apenas serviços de um projeto especificado dentro do limite de gerenciamento de aplicativos ou com uma propriedade específica, por exemplo:

      • service_properties.gcp_project=projects/PROJECT_ID
      • service_properties.gcp_project=projects/PROJECT_ID AND service_reference.uri~"forwardingRules"

    A resposta será semelhante a:

    ID            SERVICE_REFERENCE                                                                                             SERVICE_PROPERTIES
    SERVICE_ID    {'uri': '//compute.googleapis.com/projects/PROJECT_NUMBER/regions/REGION/forwardingRules/forwarding-rule'}    {'gcpProject': 'projects/PROJECT_ID', 'location': 'REGION'}
    
  2. Copie o ID do serviço, SERVICE_ID, da saída.

  3. Registre o serviço no aplicativo:

    gcloud apphub applications services create SERVICE_NAME \
      --project=PROJECT_ID \
      --location=APPLICATION_LOCATION \
      --application=APPLICATION_NAME \
      --discovered-service=projects/PROJECT_ID/locations/REGION/discoveredServices/SERVICE_ID \
      --display-name=SERVICE_DISPLAY_NAME \
      --criticality-type=CRITICALITY \
      --environment-type=ENVIRONMENT \
      --developer-owners=display-name=DEV_NAME,email=DEV_EMAIL \
      --operator-owners=display-name=OPERATOR_NAME,email=OPERATOR_EMAIL \
      --business-owners=display-name=BUSINESS_NAME,email=BUSINESS_EMAIL
    

    Substitua SERVICE_NAME pelo nome que você quer usar para registrar o serviço no aplicativo.

    Use flags opcionais, como --criticality-type, para definir os atributos de nível superior do serviço e oferecer suporte à facilidade de descoberta e à governança.

    Para flags obrigatórias e opcionais, substitua o seguinte:

    • Obrigatório: PROJECT_ID: o ID do projeto de gerenciamento.
    • Obrigatório: APPLICATION_LOCATION: o local do aplicativo. Use um dos seguintes valores:

    • Obrigatório: APPLICATION_NAME: o nome do aplicativo em que você quer registrar o serviço.

    • Obrigatório: REGION: o local do serviço descoberto na saída anterior.

    • Obrigatório: SERVICE_ID: o ID do serviço que você copiou da saída anterior.

    • Opcional: SERVICE_DISPLAY_NAME: o nome de exibição do serviço.

    • Opcional: CRITICALITY: o nível de importância do serviço para suas operações. Use um dos seguintes valores:

      • MISSION_CRITICAL
      • HIGH
      • MEDIUM
      • LOW
    • Opcional: ENVIRONMENT: o estágio do ciclo de vida do software. Use um dos seguintes valores:

      • PRODUCTION
      • STAGING
      • DEVELOPMENT
      • TEST
    • Opcional: DEV_NAME e DEV_EMAIL: o nome de exibição e o endereço de e-mail do desenvolvedor proprietário, respectivamente.

    • Opcional: OPERATOR_NAME e OPERATOR_EMAIL: o nome de exibição e o endereço de e-mail do proprietário do operador, respectivamente.

    • Opcional: BUSINESS_NAME e BUSINESS_EMAIL: o nome de exibição e o endereço de e-mail do proprietário da empresa, respectivamente.

  4. Liste os serviços registrados no aplicativo:

    gcloud apphub applications services list \
      --application=APPLICATION_NAME \
      --project=PROJECT_ID \
      --location=APPLICATION_LOCATION
    

    Você precisa receber uma saída semelhante à seguinte para cada serviço registrado:

    ID              DISPLAY_NAME            SERVICE_REFERENCE                                                                                             CREATE_TIME
    SERVICE_NAME    SERVICE_DISPLAY_NAME    {'uri': '//compute.googleapis.com/projects/PROJECT_NUMBER/regions/REGION/forwardingRules/forwarding-rule'}    2023-11-01T21:38:08
    

Registrar cargas de trabalho

  1. Liste as cargas de trabalho disponíveis que podem ser registradas em um aplicativo:

    gcloud apphub discovered-workloads list \
      --project=PROJECT_ID \
      --location=REGION \
      --filter=FILTER_EXPRESSION
    

    Para flags obrigatórias e opcionais, substitua o seguinte:

    • Obrigatório: PROJECT_ID: o ID do projeto de gerenciamento.
    • Obrigatório: REGION: o local específico da carga de trabalho com base na distribuição geográfica. Use um dos valores a seguir:

    • Opcional: FILTER_EXPRESSION: a expressão de filtro para a flag --filter para exibir apenas cargas de trabalho de um projeto especificado no limite de gerenciamento de aplicativos ou com uma propriedade específica, por exemplo, workload_properties.gcp_project=projects/PROJECT_ID.

    A resposta será semelhante a:

    ID             WORKLOAD_REFERENCE                                                                                    WORKLOAD_PROPERTIES
    WORKLOAD_ID    {'uri': '//compute.googleapis.com/projects/PROJECT_NUMBER/regions/REGION/instanceGroups/mig-name'}    {'gcpProject': 'projects/PROJECT_ID', 'location': 'REGION'}
    
  2. Copie o ID da carga de trabalho, WORKLOAD_ID, da saída.

  3. Registre a carga de trabalho no aplicativo:

    gcloud apphub applications workloads create WORKLOAD_NAME \
      --project=PROJECT_ID \
      --location=APPLICATION_LOCATION \
      --application=APPLICATION_NAME \
      --discovered-workload=projects/PROJECT_ID/locations/REGION/discoveredWorkloads/WORKLOAD_ID \
      --display-name=WORKLOAD_DISPLAY_NAME \
      --criticality-type=CRITICALITY \
      --environment-type=ENVIRONMENT \
      --developer-owners=display-name=DEV_NAME,email=DEV_EMAIL \
      --operator-owners=display-name=OPERATOR_NAME,email=OPERATOR_EMAIL \
      --business-owners=display-name=BUSINESS_NAME,email=BUSINESS_EMAIL
    

    Substitua WORKLOAD_NAME pelo nome que você quer usar para registrar a carga de trabalho no aplicativo.

    Use flags opcionais, como --criticality-type, para definir os atributos de nível superior da carga de trabalho e oferecer suporte à facilidade de descoberta e à governança.

    Para flags obrigatórias e opcionais, substitua o seguinte:

    • Obrigatório: PROJECT_ID: o ID do projeto de gerenciamento.
    • Obrigatório: APPLICATION_LOCATION: o local do aplicativo. Use um dos seguintes valores:

    • Obrigatório: APPLICATION_NAME: o nome do aplicativo em que você quer registrar a carga de trabalho.

    • Obrigatório: REGION: o local da carga de trabalho descoberta da saída anterior.

    • Obrigatório: WORKLOAD_ID: o ID da carga de trabalho que você copiou da saída anterior.

    • Opcional: WORKLOAD_DISPLAY_NAME: o nome de exibição da carga de trabalho.

    • Opcional: CRITICALITY: o nível de importância da carga de trabalho para suas operações. Use um dos seguintes valores:

      • MISSION_CRITICAL
      • HIGH
      • MEDIUM
      • LOW
    • Opcional: ENVIRONMENT: o estágio do ciclo de vida do software. Use um dos seguintes valores:

      • PRODUCTION
      • STAGING
      • DEVELOPMENT
      • TEST
    • Opcional: DEV_NAME e DEV_EMAIL: o nome de exibição e o endereço de e-mail do desenvolvedor proprietário, respectivamente.

    • Opcional: OPERATOR_NAME e OPERATOR_EMAIL: o nome de exibição e o endereço de e-mail do proprietário do operador, respectivamente.

    • Opcional: BUSINESS_NAME e BUSINESS_EMAIL: o nome de exibição e o endereço de e-mail do proprietário da empresa, respectivamente.

  4. Liste as cargas de trabalho registradas no aplicativo:

    gcloud apphub applications workloads list \
      --application=APPLICATION_NAME \
      --project=PROJECT_ID \
      --location=APPLICATION_LOCATION
    

    Você precisa receber uma saída semelhante à seguinte para cada carga de trabalho registrada:

    ID               DISPLAY_NAME             WORKLOAD_REFERENCE                                                                                    CREATE_TIME
    WORKLOAD_NAME    WORKLOAD_DISPLAY_NAME    {'uri': '//compute.googleapis.com/projects/PROJECT_NUMBER/regions/REGION/instanceGroups/mig-name'}    2023-11-01T21:38:08
    

Terraform

Para usar o Terraform para registrar recursos do Google Cloud no limite de gerenciamento de aplicativos como serviços ou cargas de trabalho em um aplicativo, use as fontes de dados google_apphub_discovered_service e google_apphub_discovered_workload para recuperar dinamicamente informações sobre os recursos que você quer registrar.

Em seguida, use os recursos google_apphub_service ou google_apphub_workload para registrar serviços ou cargas de trabalho, respectivamente.

Registrar serviços

  1. Receba informações sobre um serviço usando o URI dele:

    data "google_apphub_discovered_service" "my-service" {
        location = "LOCATION"
        service_uri = "SERVICE_URI"
    }
    
  2. Registre o serviço descoberto no aplicativo, por exemplo:

    resource "google_apphub_service" "example" {
        project            = "my-project-id"
        location           = "us-central1"
        application_id     = google_apphub_application.example.application_id
        service_id         = "frontend-load-balancer"
        discovered_service = data.google_apphub_discovered_service.my-forwarding-rule.name
        display_name       = "Frontend Load Balancer"
        description        = "The primary load balancer for the frontend."
    }
    

Registrar cargas de trabalho

  1. Receba informações sobre uma carga de trabalho usando o URI dela:

    data "google_apphub_discovered_workload" "my-workload" {
        location = "LOCATION"
        workload_uri = "WORKLOAD_URI"
    }
    
  2. Registre a carga de trabalho descoberta no aplicativo, por exemplo:

    resource "google_apphub_workload" "example" {
        project             = "my-project-id"
        location            = "us-central1"
        application_id      = google_apphub_application.example.application_id
        workload_id         = "frontend-instance-group"
        discovered_workload = data.google_apphub_discovered_workload.my-mig.name
        display_name        = "Frontend Instance Group"
        description         = "The managed instance group for the frontend."
    }
    

O status de registro de serviços e cargas de trabalho registrados em um aplicativo pode mudar para desvinculado se você mover um projeto ou uma pasta para fora do limite de gerenciamento de aplicativos ou excluir o recurso subjacente. Os serviços e as cargas de trabalho desvinculados permanecem no aplicativo até que você cancele o registro deles, mas o App Hub não pode mais gerenciá-los ou monitorá-los. Para mais informações, consulte Status de registro de serviços e cargas de trabalho.

Para reanexar serviços ou cargas de trabalho a um aplicativo, é necessário registrá-los novamente.

Conceder permissões e iniciar operações

Depois de criar um aplicativo e registrar serviços e cargas de trabalho no App Hub, é necessário conceder acesso ao usuário com base nas responsabilidades do ciclo de vida para gerenciar esse grupo lógico como uma única unidade:

  1. Dependendo das suas necessidades de acesso, é possível conceder permissões a aplicativos individuais ou a todos os aplicativos. Para ver uma lista de papéis recomendados, consulte Conceder papéis centrados em aplicativos aos usuários.
  2. Se quiser, acesse o Cloud Hub para ver um painel operacional unificado do aplicativo definido, incluindo dados de integridade, desempenho e dados de custo.