Gerenciar aplicativos do App Hub

Ao escolher o modelo de configuração do aplicativo, você define um limite de gerenciamento 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 conferir 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 atuais em um aplicativo.

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

  • Para aplicativos implantados de um modelo do App Design Center: use o App 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 App Design Center

  • Para aplicativos criados registrando recursos atuais no App Hub: Gerencie aplicativos, serviços e cargas de trabalho diretamente no App Hub.

    Acessar o App Hub

Esta página descreve como gerenciar aplicativos registrados diretamente no App Hub. É possível realizar essas ações usando o Google Cloud console ou a Google Cloud CLI. Para aplicativos implantados de um modelo, consulte a documentação do App Design Center.

Antes de começar

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

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 personalizados papéis ou outros predefinidos papéis.

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 dentro do limite de gerenciamento de aplicativos:

Console

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

  2. Navegue até 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 Criticidade ou Ambiente.

gcloud

  1. Encontre o ID do projeto de gerenciamento.

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

    • Listar todos os aplicativos:

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

      Substitua:

      • PROJECT_ID: o ID do projeto de gerenciamento.
      • LOCATION: o local dos aplicativos. Use global para aplicativos globais ou uma região específica, como us-east1, para aplicativos regionais.

    • Filtre a lista de aplicativos com base em atributos usando a --filter flag:

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

      Substitua:

      • PROJECT_ID: o ID do projeto de gerenciamento.
      • LOCATION: o local dos aplicativos. Use global para aplicativos globais 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.

Conferir detalhes do aplicativo

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

Console

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

  2. Navegue até 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 conferir.

    A guia Detalhes do aplicativo é mostrada.

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. Você especifica esse valor ao criar um aplicativo.
    • PROJECT_ID: o ID do projeto de gerenciamento.
    • LOCATION: o local do aplicativo. Use global para aplicativos globais 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 do aplicativo durante o registro.

Console

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

  2. Navegue até 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 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. Atualize os 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. Você especifica esse valor ao criar um aplicativo.
    • Obrigatório: PROJECT_ID: o ID do projeto de gerenciamento.
    • Obrigatório: LOCATION: o local do aplicativo. Use global para aplicativos globais ou uma região específica, como us-east1, para aplicativos regionais.
    • Opcional: DISPLAY_NAME: o nome de exibição do 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 proprietário do desenvolvedor, 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 no arquivo de configuração.google_apphub_application Quando você aplica as mudanças, o Terraform atualiza o aplicativo para corresponder à nova configuração.

O exemplo a seguir atualiza os atributos de criticidade 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, é necessário primeiro 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 Google Cloud console, use o seletor de projetos para selecionar o seu projeto de gerenciamento.

  2. Navegue até 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 aos 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 componentes registrados, exclua-o:

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

    Substitua:

    • APPLICATION_NAME: o nome do aplicativo. Você especifica esse valor ao criar um aplicativo.
    • PROJECT_ID: o ID do projeto de gerenciamento.
    • LOCATION: o local do aplicativo. Use global para aplicativos globais 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:

  • Remover o recurso da configuração: exclua o recurso block do arquivo do Terraform e execute terraform apply.google_apphub_application 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