Gerenciar aplicativos do App Hub

O App Hub permite visualizar os aplicativos registrados, atualizar os atributos deles e excluir aplicativos para manter o inventário de aplicativos preciso. Para evitar desvios de configuração, use o App Hub apenas para atualizar ou excluir aplicativos que você registrou diretamente e gerencie aplicativos com base em modelos no Application Design Center.

Visão geral

Ao escolher o modelo de configuração do aplicativo, você define um limite de gerenciamento de aplicativos para os aplicativos do App Hub em um projeto de gerenciamento. Em seguida, é possível registrar serviços e cargas de trabalho em aplicativos dentro desse limite.

Para ver casos de uso recomendados para introduzir práticas de gerenciamento de aplicativos, consulte Preparar para o gerenciamento de aplicativos. Para criar um aplicativo e registrar recursos, consulte Registrar recursos em um aplicativo.

Para evitar desvios de configuração e manter uma fonte de verdade clara, recomendamos que você gerencie os componentes de aplicativo no ambiente em que eles foram definidos originalmente:

  • Para aplicativos implantados de um modelo do Application Design Center: use o Application Design Center para gerenciar e atualizar o aplicativo. É possível revisar o modelo para mudanças no design do aplicativo ou criar uma revisão do aplicativo para atualizar configurações, como detalhes do aplicativo e do componente.

    Acessar o Application Design Center

  • Para aplicativos criados pelo registro de recursos no App Hub: gerencie aplicativos, serviços e cargas de trabalho diretamente no App Hub.

    Acessar o App Hub

No App Hub, é possível realizar essas ações usando o console doGoogle Cloud ou a Google Cloud CLI. Para aplicativos implantados de um modelo, consulte a documentação do Application Design Center.

Antes de começar

Este documento pressupõe que você tem um aplicativo com recursos compatíveis registrados.

Funções exigidas

Para receber as permissões necessárias para gerenciar aplicativos no App Hub, peça ao administrador para conceder a você os seguintes papéis do IAM no projeto de gerenciamento que define o limite de gerenciamento de aplicativos :

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.

Para mais informações sobre os papéis do App Hub, consulte Papéis e permissões do IAM do App Hub.

Listar aplicativos

Siga estas etapas para listar e filtrar todos os aplicativos no seu limite de gerenciamento de aplicativos:

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

    A página mostra uma lista dos seus aplicativos.

  3. Para filtrar a lista, use o campo Filtro. É possível filtrar por atributos como Gravidade ou Ambiente.

gcloud

  1. Encontre o ID do projeto de gerenciamento.

  2. Mostre uma lista dos seus aplicativos usando uma das seguintes opções:

    • Liste todos os aplicativos:

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

      Substitua:

      • PROJECT_ID: o ID do seu projeto de gerenciamento.
      • LOCATION: o local dos seus aplicativos. Use global para aplicativos globais, uma multirregião (us ou eu) para aplicativos multirregionais ou uma região específica, como us-east1, para aplicativos regionais.
    • Filtre a lista de aplicativos com base em atributos usando a flag --filter:

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

      Substitua:

      • PROJECT_ID: o ID do seu projeto de gerenciamento.
      • LOCATION: o local dos seus aplicativos. Use global para aplicativos globais, uma multirregião (us ou eu) para aplicativos multirregionais ou uma região específica, como us-east1, para aplicativos regionais.
      • FILTER_EXPRESSION: a expressão de filtro para especificar atributos. Por exemplo, para listar todos os aplicativos com um tipo de ambiente PRODUCTION, use attributes.environment.type=PRODUCTION.

Ver detalhes do aplicativo

Siga estas etapas para ver as informações detalhadas de um aplicativo específico, incluindo os atributos e metadados dele:

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

    A página mostra uma lista dos seus aplicativos.

  3. Clique no nome do aplicativo que você quer visualizar.

    A guia Detalhes do aplicativo é exibida.

gcloud

  1. Encontre o ID do projeto de gerenciamento.

  2. Descreva um aplicativo:

    gcloud apphub applications describe APPLICATION_NAME \
        --project=PROJECT_ID \
        --location=LOCATION
    

    Substitua:

    • APPLICATION_NAME: o nome do aplicativo. Especifique esse valor ao criar um aplicativo.
    • PROJECT_ID: o ID do seu projeto de gerenciamento.
    • LOCATION: o local do aplicativo. Use global para aplicativos globais, uma multirregião (us ou eu) para aplicativos multirregionais ou uma região específica, como us-east1, para aplicativos regionais.

Atualizar atributos do aplicativo

Para modificar os atributos de um aplicativo depois que ele for criado, siga estas etapas. Os serviços e as cargas de trabalho também podem usar os mesmos atributos de aplicativo durante o registro.

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

    A página mostra uma lista dos seus aplicativos.

  3. No aplicativo que você quer atualizar, clique em Editar.

  4. No painel Editar aplicativo, modifique os campos conforme necessário.

  5. Clique em Salvar.

gcloud

  1. Encontre o ID do projeto de gerenciamento.

  2. Atualizar atributos do aplicativo. É possível atualizar qualquer um dos atributos mutáveis, como display-name, criticality-type, environment-type e proprietários:

    gcloud apphub applications update APPLICATION_NAME \
        --project=PROJECT_ID \
        --location=LOCATION \
        --display-name=DISPLAY_NAME \
        --criticality-type=CRITICALITY_LEVEL \
        --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:

    • Obrigatório: APPLICATION_NAME: o nome do aplicativo. Especifique esse valor ao criar um aplicativo.
    • Obrigatório: PROJECT_ID: o ID do seu projeto de gerenciamento.
    • Obrigatório: LOCATION: o local do aplicativo. Use global para aplicativos globais, uma multirregião (us ou eu) para aplicativos multirregionais ou uma região específica, como us-east1, para aplicativos regionais.
    • Opcional: DISPLAY_NAME: o nome de exibição do seu aplicativo.
    • Opcional: CRITICALITY_LEVEL: o nível de importância do aplicativo. 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.

Terraform

Para atualizar os atributos do aplicativo com o Terraform, modifique os argumentos no bloco de recursos google_apphub_application no arquivo de configuração. Quando você aplica as mudanças, o Terraform atualiza o aplicativo para corresponder à nova configuração.

O exemplo a seguir atualiza os atributos de importância e ambiente de um aplicativo regional em us-central1:

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."
    attributes {
        criticality {
            type = "HIGH" # Updated criticality
        }
        environment {
            type = "PRODUCTION"
        }
        # ... other attributes
    }
}

Excluir um aplicativo

Antes de excluir um aplicativo, é preciso cancelar o registro de todos os serviços e cargas de trabalho dele. Em seguida, siga estas etapas para excluir o aplicativo:

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

    A página mostra uma lista dos seus aplicativos.

  3. Clique no nome do aplicativo que você quer excluir.

  4. Acesse a guia Serviços e cargas de trabalho e verifique se você cancelou o registro de todos os componentes do aplicativo. Para mais informações, consulte Cancelar o registro de serviços e cargas de trabalho.

  5. Depois que todos os serviços e cargas de trabalho forem cancelados, volte para os detalhes do aplicativo e clique em Excluir.

gcloud

  1. Encontre o ID do projeto de gerenciamento.

  2. Verifique se você cancelou o registro de todos os componentes do aplicativo. Para mais informações, consulte Cancelar o registro de serviços e cargas de trabalho.

  3. Depois que o aplicativo não tiver mais componentes registrados, exclua-o:

    gcloud apphub applications delete APPLICATION_NAME \
        --project=PROJECT_ID \
        --location=LOCATION
    

    Substitua:

    • APPLICATION_NAME: o nome do aplicativo. Especifique esse valor ao criar um aplicativo.
    • PROJECT_ID: o ID do seu projeto de gerenciamento.
    • LOCATION: o local do aplicativo. Use global para aplicativos globais, uma multirregião (us ou eu) para aplicativos multirregionais ou uma região específica, como us-east1, para aplicativos regionais.

Terraform

Para excluir um aplicativo gerenciado pelo Terraform, você tem as seguintes opções:

  • Remova o recurso da configuração: exclua o bloco de recursos google_apphub_application do arquivo do Terraform e execute terraform apply. O Terraform reconhece que o recurso não está mais na configuração e o exclui do projeto.
  • Encerrar todos os recursos: execute o comando terraform destroy para encerrar todos os recursos gerenciados pela configuração do Terraform, incluindo o aplicativo.

A seguir