Gerenciar aplicativos do App Hub

Ao escolher seu modelo de configuração de aplicativo, você define um limite de gerenciamento de aplicativos para seus aplicativos do App Hub em um projeto de gerenciamento. Em seguida, você pode 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 do ciclo de vida de aplicativos.

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 foram definidos originalmente:

  • Para aplicativos implantados usando um modelo do App Design Center: use o App Design Center para gerenciar e atualizar o aplicativo. Você pode 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 ao registrar recursos no App Hub: gerencie aplicativos, serviços e cargas de trabalho diretamente no App Hub.

    Acessar o App Hub

Nesta página, descrevemos como gerenciar aplicativos registrados diretamente 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 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 papéis personalizados ou outros papéis predefinidos.

Para mais informações sobre os papéis da Central de apps, consulte Papéis e permissões do IAM da Central de apps.

Listar aplicativos

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

Console

  1. No console Google Cloud , use o seletor de projetos para escolher seu 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 do seu 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 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 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 conferir as informações detalhadas de um aplicativo específico, incluindo atributos e metadados:

Console

  1. No console Google Cloud , use o seletor de projetos para escolher seu 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 ver.

    A guia Detalhes do aplicativo é exibida.

gcloud

  1. Encontre o ID do projeto do seu projeto de gerenciamento.

  2. Descrever um aplicativo:

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

    Substitua:

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

Console

  1. No console Google Cloud , use o seletor de projetos para escolher seu 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 do seu 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 seu aplicativo. Você especifica esse valor ao criar um aplicativo.
    • Obrigatório: PROJECT_ID: o ID do seu projeto de gerenciamento.
    • Obrigatório: LOCATION: o local do seu 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 do recurso 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 gravidade 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 Google Cloud , use o seletor de projetos para escolher seu 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 aos detalhes do aplicativo e clique em Excluir.

gcloud

  1. Encontre o ID do projeto do seu projeto de gerenciamento.

  2. Confira 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 seu aplicativo. Você especifica esse valor ao criar um aplicativo.
    • PROJECT_ID: o ID do seu projeto de gerenciamento.
    • LOCATION: o local do seu 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:

  • Remova o recurso da configuração: exclua o bloco do recurso 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.
  • Encerre todos os recursos: execute o comando terraform destroy para encerrar todos os recursos gerenciados pela configuração do Terraform, incluindo o aplicativo.

A seguir