Faça a gestão de aplicações do App Hub

Quando configura o App Hub, cria um limite administrativo para as suas aplicações. Este limite é o projeto de gestão ou a coleção de projetos de anfitrião e de serviço que configurou para a gestão de aplicações, consoante o seu modelo de configuração. Os serviços e as cargas de trabalho estão registados como aplicações dentro deste limite administrativo.

Para evitar a deriva da configuração e manter uma fonte de verdade clara, recomendamos que faça a gestão dos recursos da aplicação no ambiente onde foram originalmente definidos:

  • Para aplicações implementadas a partir de um modelo do Application Design Center: use o Application Design Center para gerir e atualizar a aplicação. Pode rever o modelo para alterações ao design da aplicação ou criar uma revisão da aplicação para atualizar definições, como detalhes da aplicação e dos componentes.

    Aceder ao Centro de design de aplicações

  • Para aplicações criadas através do registo de recursos no App Hub: Faça a gestão da aplicação, dos respetivos serviços e cargas de trabalho diretamente no App Hub.

    Aceda ao App Hub

Esta página descreve como gerir as aplicações que foram registadas diretamente no App Hub. Pode realizar estas ações através da consola Google Cloud ou da CLI Google Cloud. Para aplicações implementadas a partir de um modelo, consulte a documentação do Centro de design de aplicações.

Antes de começar

Antes de poder listar, ver, atualizar e eliminar aplicações no App Hub, conclua os seguintes passos:

  1. Configure o App Hub através de um dos modelos de configuração suportados.
  2. Crie uma aplicação e registe os recursos suportados na aplicação que quer gerir.

Funções necessárias

Para receber as autorizações de que precisa para gerir aplicações no App Hub, peça ao seu administrador que lhe conceda as seguintes funções do IAM no limite administrativo da aplicação a partir do seu modelo de configuração (o projeto de gestão ou os projetos de anfitrião e de serviço) :

Para mais informações sobre a atribuição de funções, consulte o artigo Faça a gestão do acesso a projetos, pastas e organizações.

Também pode conseguir as autorizações necessárias através de funções personalizadas ou outras funções predefinidas.

Para mais informações sobre as funções do App Hub, consulte o artigo Funções e autorizações de IAM do App Hub.

Apresentar aplicações

Siga estes passos para listar e filtrar todas as aplicações dentro do limite administrativo do App Hub:

Consola

  1. Na página Boas-vindas da consola, use o seletor de projetos para selecionar o projeto de gestão ou o projeto anfitrião: Google Cloud

    Aceder a Boas-vindas

  2. Navegue para a página Aplicações do App Hub:

    Aceda a Aplicações

    A página apresenta uma lista das suas aplicações.

  3. Para filtrar a lista, use o campo Filtro. Pode filtrar por atributos como Criticidade ou Ambiente.

gcloud

  1. Encontre o ID do projeto do seu projeto de gestão ou projeto anfitrião.

  2. Apresente uma lista das suas aplicações através de uma das seguintes opções:

    • Listar todas as aplicações:

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

      Substitua o seguinte:

      • PROJECT_ID: o ID do seu projeto anfitrião ou projeto de gestão.
      • LOCATION: a localização das suas aplicações. Use global para aplicações globais ou uma região específica, como us-east1, para aplicações regionais.

    • Filtre a lista de aplicações com base em atributos, usando a flag --filter:

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

      Substitua o seguinte:

      • PROJECT_ID: o ID do seu projeto anfitrião ou projeto de gestão.
      • LOCATION: a localização das suas aplicações. Use global para aplicações globais ou uma região específica, como us-east1, para aplicações regionais.
      • FILTER_EXPRESSION: a expressão de filtro para especificar atributos. Por exemplo, para listar todas as aplicações com um tipo de ambiente PRODUCTION, use attributes.environment.type=PRODUCTION.

Veja os detalhes da aplicação

Siga estes passos para ver as informações detalhadas de uma aplicação específica, incluindo os respetivos atributos e metadados:

Consola

  1. Na página Boas-vindas da consola, use o seletor de projetos para selecionar o projeto de gestão ou o projeto anfitrião: Google Cloud

    Aceder a Boas-vindas

  2. Navegue para a página Aplicações do App Hub:

    Aceda a Aplicações

    A página apresenta uma lista das suas aplicações.

  3. Clique no nome da aplicação que quer ver.

    É apresentado o separador Detalhes da aplicação.

gcloud

  1. Encontre o ID do projeto do seu projeto de gestão ou projeto anfitrião.

  2. Descreva uma aplicação:

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

    Substitua o seguinte:

    • APPLICATION_NAME: o nome da sua aplicação. Especifica este valor quando cria uma aplicação.
    • PROJECT_ID: o ID do seu projeto anfitrião ou projeto de gestão.
    • LOCATION: a localização da sua aplicação. Use global para aplicações globais ou uma região específica, como us-east1, para aplicações regionais.

Atualize os atributos da aplicação

Siga estes passos para modificar os atributos definidos pelo utilizador de uma aplicação depois de ter sido criada:

Consola

  1. Na página Boas-vindas da consola, use o seletor de projetos para selecionar o projeto de gestão ou o projeto anfitrião: Google Cloud

    Aceder a Boas-vindas

  2. Navegue para a página Aplicações do App Hub:

    Aceda a Aplicações

    A página apresenta uma lista das suas aplicações.

  3. Na aplicação que quer atualizar, clique em Editar.

  4. No painel Editar aplicação, modifique os campos conforme necessário.

  5. Clique em Guardar.

gcloud

  1. Encontre o ID do projeto do seu projeto de gestão ou projeto anfitrião.

  2. Atualize os atributos da aplicação. Pode 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 o seguinte:

    • Obrigatório: APPLICATION_NAME: o nome da sua aplicação. Especifica este valor quando cria uma aplicação.
    • Obrigatório: PROJECT_ID: o ID do seu projeto de anfitrião ou projeto de gestão.
    • Obrigatório: LOCATION: a localização da sua aplicação. Use global para aplicações globais ou uma região específica, como us-east1, para aplicações regionais.
    • Opcional: DISPLAY_NAME: o nome a apresentar da sua aplicação.

    • Opcional: CRITICALITY_LEVEL: o nível de importância da aplicação. Use um dos seguintes valores:

      • MISSION_CRITICAL
      • HIGH
      • MEDIUM
      • LOW

    • Opcional: ENVIRONMENT: a fase do ciclo de vida do software. Use um dos seguintes valores:

      • PRODUCTION
      • STAGING
      • DEVELOPMENT
      • TEST

    • Opcional: DEV_NAME e DEV_EMAIL: o nome a apresentar e o endereço de email do proprietário do programador, respetivamente.

    • Opcional: OPERATOR_NAME e OPERATOR_EMAIL: o nome a apresentar e o endereço de email do proprietário do operador, respetivamente.

    • Opcional: BUSINESS_NAME e BUSINESS_EMAIL: o nome a apresentar e o endereço de email do proprietário da empresa, respetivamente.

Elimine uma aplicação

Antes de poder eliminar uma aplicação, tem de anular o registo de todos os respetivos serviços e cargas de trabalho associados. Depois, siga estes passos para eliminar a aplicação:

Consola

  1. Na página Boas-vindas da consola, use o seletor de projetos para selecionar o projeto de gestão ou o projeto anfitrião: Google Cloud

    Aceder a Boas-vindas

  2. Navegue para a página Aplicações do App Hub:

    Aceda a Aplicações

    A página apresenta uma lista das suas aplicações.

  3. Clique no nome da aplicação que quer eliminar.

  4. Aceda ao separador Serviços e cargas de trabalho e certifique-se de que anulou o registo de todos os recursos associados da aplicação. Para mais informações, consulte o artigo Anule o registo de serviços e cargas de trabalho.

  5. Depois de anular o registo de todos os serviços e cargas de trabalho, navegue novamente para os detalhes da aplicação e clique em Eliminar.

gcloud

  1. Encontre o ID do projeto do seu projeto de gestão ou projeto anfitrião.

  2. Certifique-se de que anulou o registo de todos os recursos associados à aplicação. Para mais informações, consulte o artigo Anule o registo de serviços e cargas de trabalho.

  3. Depois de a aplicação não ter recursos registados, elimine-a:

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

    Substitua o seguinte:

    • APPLICATION_NAME: o nome da sua aplicação. Especifica este valor quando cria uma aplicação.
    • PROJECT_ID: o ID do seu projeto anfitrião ou projeto de gestão.
    • LOCATION: a localização da sua aplicação. Use global para aplicações globais ou uma região específica, como us-east1, para aplicações regionais.

O que se segue?