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

Quando escolhe o modelo de configuração da aplicação, define um limite de gestão de aplicações para as suas aplicações do App Hub num projeto de gestão. Em seguida, pode registar serviços e cargas de trabalho em aplicações dentro deste limite. Para ver exemplos de utilização recomendados para introduzir práticas de gestão de aplicações, consulte o artigo Prepare-se para a gestão do ciclo de vida das aplicações.

Para evitar a deriva da configuração e manter uma origem de verdade clara, recomendamos que faça a gestão dos componentes 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 existentes no App Hub: faça a gestão de aplicações, serviços e cargas de trabalho diretamente no App Hub.

    Aceda ao App Hub

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

Antes de começar

Este documento pressupõe que tem uma aplicação com recursos suportados registados na mesma.

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 da IAM no projeto de gestão que define o limite de gestão da sua aplicaçã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 seu limite de gestão de aplicações:

Consola

  1. Na Google Cloud consola, use o seletor de projetos para selecionar o seu projeto de gestão.

  2. Navegue para a página Aplicações a partir 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.

  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 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 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 Google Cloud consola, use o seletor de projetos para selecionar o seu projeto de gestão.

  2. Navegue para a página Aplicações a partir 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.

  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 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

Para modificar os atributos de uma aplicação depois de ter sido criada, siga estes passos:

Consola

  1. Na Google Cloud consola, use o seletor de projetos para selecionar o seu projeto de gestão.

  2. Navegue para a página Aplicações a partir 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.

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

Terraform

Para atualizar os atributos da aplicação com o Terraform, modifique os argumentos no bloco de recursos google_apphub_application no ficheiro de configuração. Quando aplica as alterações, o Terraform atualiza a aplicação para corresponder à nova configuração.

O exemplo seguinte atualiza os atributos de nível de importância e ambiente de uma aplicação 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
    }
}

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. Depois, siga estes passos para eliminar a aplicação:

Consola

  1. Na Google Cloud consola, use o seletor de projetos para selecionar o seu projeto de gestão.

  2. Navegue para a página Aplicações a partir 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 componentes 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.

  2. Certifique-se de que anula o registo de todos os componentes da 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 componentes 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 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.

Terraform

Para eliminar uma aplicação gerida pelo Terraform, tem as seguintes opções:

  • Remova o recurso da sua configuração: elimine o bloco de recursos google_apphub_application do seu ficheiro Terraform e, em seguida, execute terraform apply. O Terraform reconhece que o recurso já não está na configuração e elimina-o do seu projeto.
  • Termine todos os recursos: execute o comando terraform destroy para terminar todos os recursos geridos pela sua configuração do Terraform, incluindo a aplicação.

O que se segue?