Gerenciar aplicativos do App Hub

Ao configurar o App Hub, você cria um limite administrativo para seus aplicativos. Esse limite é o projeto de gerenciamento ou o conjunto de projetos host e de serviço que você configurou para o gerenciamento de aplicativos, dependendo do modelo de configuração. Os serviços e as cargas de trabalho são registrados como aplicativos dentro desse limite administrativo.

Para evitar a deriva de configuração e manter uma fonte de verdade clara, recomendamos que você gerencie os recursos 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 registrando recursos no App Hub: gerencie o aplicativo, os serviços e as 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 Google Cloud ou a Google Cloud CLI. Para aplicativos implantados de um modelo, consulte a documentação do App Design Center.

Antes de começar

Antes de listar, visualizar, atualizar e excluir aplicativos no App Hub, siga estas etapas:

1. Configure o App Hub usando um dos modelos de configuração compatíveis.
2. Crie um aplicativo e registre os recursos compatíveis com o aplicativo que você quer gerenciar.

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 limite administrativo do aplicativo no modelo de configuração (o projeto de gerenciamento ou os projetos de host e serviço) :

• 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 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 limite administrativo do App Hub:

Console

1. Na página Bem-vindo do console do Google Cloud , use o seletor de projetos para escolher seu projeto de gerenciamento ou host:

   Acessar "Conheça"

2. Acesse a página Aplicativos do 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 Criticality ou Environment.

gcloud

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

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 projeto host ou 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 projeto host ou 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. Na página Bem-vindo do console do Google Cloud , use o seletor de projetos para escolher seu projeto de gerenciamento ou host:

   Acessar "Conheça"

2. Acesse a página Aplicativos do 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 ou host.

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 projeto host ou 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

Siga estas etapas para modificar os atributos definidos pelo usuário de um aplicativo depois que ele for criado:

Console

1. Na página Bem-vindo do console do Google Cloud , use o seletor de projetos para escolher seu projeto de gerenciamento ou host:

   Acessar "Conheça"

2. Acesse a página Aplicativos do 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 ou host.

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 host ou 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.

   Observação: os endereços de e-mail precisam ter o formato username@yourdomain, por exemplo, [e-mail].

Excluir um aplicativo

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

Console

1. Na página Bem-vindo do console do Google Cloud , use o seletor de projetos para escolher seu projeto de gerenciamento ou host:

   Acessar "Conheça"

2. Acesse a página Aplicativos do 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 recursos associados ao 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 ou host.

2. Verifique se você cancelou o registro de todos os recursos associados ao 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 recursos 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 projeto host ou 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.

A seguir

• Gerenciar serviços e cargas de trabalho
• Otimizar um aplicativo com recomendações de design
• Monitore seus aplicativos