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.
Para aplicativos criados pelo registro de recursos no App Hub: gerencie aplicativos, serviços e cargas de trabalho diretamente no 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 :
-
Atualizar e excluir aplicativos:
Editor do App Hub (
roles/apphub.editor) -
Ver aplicativos:
Leitor do App Hub (
roles/apphub.viewer)
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
No console do Google Cloud , use o seletor de projetos para selecionar o projeto de gerenciamento.
Acesse a página Aplicativos no App Hub:
A página mostra uma lista dos seus aplicativos.
Para filtrar a lista, use o campo Filtro. É possível filtrar por atributos como Gravidade ou Ambiente.
gcloud
Encontre o ID do projeto de gerenciamento.
Mostre uma lista dos seus aplicativos usando uma das seguintes opções:
Liste todos os aplicativos:
gcloud apphub applications list \ --project=PROJECT_ID \ --location=LOCATIONSubstitua:
PROJECT_ID: o ID do seu projeto de gerenciamento.LOCATION: o local dos seus aplicativos. Useglobalpara aplicativos globais, uma multirregião (usoueu) para aplicativos multirregionais ou uma região específica, comous-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. Useglobalpara aplicativos globais, uma multirregião (usoueu) para aplicativos multirregionais ou uma região específica, comous-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 ambientePRODUCTION, useattributes.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
No console do Google Cloud , use o seletor de projetos para selecionar o projeto de gerenciamento.
Acesse a página Aplicativos no App Hub:
A página mostra uma lista dos seus aplicativos.
Clique no nome do aplicativo que você quer visualizar.
A guia Detalhes do aplicativo é exibida.
gcloud
Encontre o ID do projeto de gerenciamento.
Descreva um aplicativo:
gcloud apphub applications describe APPLICATION_NAME \ --project=PROJECT_ID \ --location=LOCATIONSubstitua:
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. Useglobalpara aplicativos globais, uma multirregião (usoueu) para aplicativos multirregionais ou uma região específica, comous-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
No console do Google Cloud , use o seletor de projetos para selecionar o projeto de gerenciamento.
Acesse a página Aplicativos no App Hub:
A página mostra uma lista dos seus aplicativos.
No aplicativo que você quer atualizar, clique em Editar.
No painel Editar aplicativo, modifique os campos conforme necessário.
Clique em Salvar.
gcloud
Encontre o ID do projeto de gerenciamento.
Atualizar atributos do aplicativo. É possível atualizar qualquer um dos atributos mutáveis, como
display-name,criticality-type,environment-typee 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_EMAILSubstitua:
- 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. Useglobalpara aplicativos globais, uma multirregião (usoueu) para aplicativos multirregionais ou uma região específica, comous-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_CRITICALHIGHMEDIUMLOW
Opcional:
ENVIRONMENT: o estágio do ciclo de vida do software. Use um dos seguintes valores:PRODUCTIONSTAGINGDEVELOPMENTTEST
Opcional:
DEV_NAMEeDEV_EMAIL: o nome de exibição e o endereço de e-mail do desenvolvedor proprietário, respectivamente.Opcional:
OPERATOR_NAMEeOPERATOR_EMAIL: o nome de exibição e o endereço de e-mail do proprietário do operador, respectivamente.Opcional:
BUSINESS_NAMEeBUSINESS_EMAIL: o nome de exibição e o endereço de e-mail do proprietário da empresa, respectivamente.
- Obrigatório:
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
No console do Google Cloud , use o seletor de projetos para selecionar o projeto de gerenciamento.
Acesse a página Aplicativos no App Hub:
A página mostra uma lista dos seus aplicativos.
Clique no nome do aplicativo que você quer excluir.
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.
Depois que todos os serviços e cargas de trabalho forem cancelados, volte para os detalhes do aplicativo e clique em Excluir.
gcloud
Encontre o ID do projeto de gerenciamento.
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.
Depois que o aplicativo não tiver mais componentes registrados, exclua-o:
gcloud apphub applications delete APPLICATION_NAME \ --project=PROJECT_ID \ --location=LOCATIONSubstitua:
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. Useglobalpara aplicativos globais, uma multirregião (usoueu) para aplicativos multirregionais ou uma região específica, comous-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_applicationdo arquivo do Terraform e executeterraform 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 destroypara encerrar todos os recursos gerenciados pela configuração do Terraform, incluindo o aplicativo.
A seguir
- Gerenciar serviços e cargas de trabalho
- Otimizar um aplicativo com recomendações de design
- Monitorar seus aplicativos