Faça a gestão de serviços e cargas de trabalho

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 em que 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 serviços e cargas de trabalho que são descobertos ou registados diretamente no App Hub como aplicações. Pode realizar estas ações através da Google 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

Antes de poder ver, atualizar e anular o registo de serviços e cargas de trabalho no App Hub, conclua os seguintes passos:

  1. Configure o App Hub através de um dos modelos de configuração suportados.
  2. Registe recursos suportados numa aplicação.

Funções necessárias

Para receber as autorizações de que precisa para gerir serviços e cargas de trabalho no App Hub, peça ao seu administrador que lhe conceda as seguintes funções da 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.

Veja detalhes dos serviços e das cargas de trabalho

Siga estes passos para ver os detalhes dos serviços e das cargas de trabalho, incluindo a respetiva localização e estado de registo numa aplicação, dentro do limite administrativo do App Hub:

Consola

Veja detalhes de serviços e cargas de trabalho registados ou desassociados de uma aplicação:

  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 a partir da qual quer ver serviços ou cargas de trabalho.

  4. No separador Serviços e cargas de trabalho, clique no nome do serviço ou da carga de trabalho que quer ver.

  5. Na página Detalhes do recurso, pode consultar detalhes como o nome a apresentar, a localização, o estado de registo e os atributos.

Em alternativa, veja uma lista de todos os serviços e cargas de trabalho com um valor de estado de registo de descoberto ou registado:

  1. Navegue para a página Serviços e cargas de trabalho do App Hub:

    Aceda a Serviços e cargas de trabalho

    A página apresenta uma lista de todos os serviços e cargas de trabalho descobertos e registados.

  2. Use o campo Filtro para restringir os resultados por atributos como Ambiente ou Estado de registo.

gcloud

Veja detalhes de serviços e cargas de trabalho registados ou desassociados de uma aplicação:

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

  2. Descreva um serviço ou uma carga de trabalho de uma aplicação para rever os respetivos detalhes:

    • Descreva um serviço:

      gcloud apphub applications services describe SERVICE \
    --project=PROJECT_ID \
    --application=APPLICATION \
    --location=LOCATION

      Substitua o seguinte:

      • SERVICE: o ID do serviço.
      • PROJECT_ID: o ID do seu projeto anfitrião ou projeto de gestão.
      • APPLICATION: o ID da aplicação à qual o serviço está registado.
      • LOCATION: a localização do serviço. Use global para recursos globais ou uma região específica, como us-east1, para recursos regionais.

    • Descreva uma carga de trabalho:

      gcloud apphub applications workloads describe WORKLOAD \
    --project=PROJECT_ID \
    --application=APPLICATION \
    --location=LOCATION

      Substitua o seguinte:

      • WORKLOAD: o ID da carga de trabalho.
      • PROJECT_ID: o ID do seu projeto anfitrião ou projeto de gestão.
      • APPLICATION: o ID da aplicação na qual a carga de trabalho está registada.
      • LOCATION: a localização da carga de trabalho. Use global para recursos globais ou uma região específica, como us-east1, para recursos regionais.

O resultado apresenta detalhes do recurso, como o nome a apresentar, a localização, o estado de registo e os atributos.

Em alternativa, veja uma lista de todos os serviços e cargas de trabalho com um valor de estado de registo de descoberto ou registado:

Recursos descobertos

Os recursos descobertos estão disponíveis para registo numa aplicação. Siga estes passos para listar os recursos descobertos:

  1. Indique os serviços descobertos:

    gcloud apphub discovered-services list \
    --project=PROJECT_ID \
    --location=LOCATION

    Substitua o seguinte:

    • PROJECT_ID: o ID do seu projeto de anfitrião ou projeto de gestão.
    • LOCATION: a localização onde quer descobrir recursos. Use global para recursos globais ou uma região específica, como us-east1, para recursos regionais.

  2. Apresentar cargas de trabalho descobertas:

    gcloud apphub discovered-workloads list \
    --project=PROJECT_ID \
    --location=LOCATION

Recursos registados

Os recursos registados fazem parte de uma aplicação. Siga estes passos para listar os recursos registados de uma aplicação específica. Pode filtrar a lista com base nos atributos, usando a flag --filter:

  1. Apresente os serviços registados numa aplicação:

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

    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 anfitrião ou projeto de gestão.
    • LOCATION: a localização do recurso. Use global para recursos globais ou uma região específica, como us-east1, para recursos regionais.
    • Opcional: FILTER_EXPRESSION: a expressão de filtro para especificar atributos. Por exemplo, para listar recursos com um tipo de ambiente PRODUCTION, use attributes.environment.type=PRODUCTION.

  2. Apresentar cargas de trabalho registadas numa aplicação:

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

O estado de registo dos serviços e das cargas de trabalho de uma aplicação pode mudar para desassociado se modificar a estrutura organizacional dos seus recursos Google Cloudou eliminar o recurso subjacente. Os serviços e as cargas de trabalho desassociados permanecem na aplicação até os anular o registo, mas o App Hub deixa de os poder gerir ou monitorizar. Para mais informações, consulte o artigo Estado de registo de serviços e cargas de trabalho.

Para voltar a anexar serviços ou cargas de trabalho a uma aplicação, tem de os registar novamente com base na hierarquia de recursos do seu modelo de configuração.

Atualize os atributos de serviços e cargas de trabalho

Siga estes passos para modificar os atributos definidos pelo utilizador dos serviços e cargas de trabalho registados numa 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 para a qual quer atualizar os atributos de serviço ou carga de trabalho.

  4. No separador Serviços e cargas de trabalho, encontre o nome do serviço ou da carga de trabalho que quer atualizar.

  5. Clique em more_vert Mais, em seguida, clique em Editar serviço ou Editar carga de trabalho.

  6. No painel apresentado, edite os campos conforme necessário e clique em Guardar.

gcloud

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

  2. Atualize os atributos do serviço ou da carga de trabalho:

    • Atualize os atributos do serviço:

      gcloud apphub applications services update SERVICE_NAME \
    --application=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 SERVICE_NAME pelo nome do serviço que quer atualizar.

    • Atualize os atributos da carga de trabalho:

      gcloud apphub applications workloads update WORKLOAD_NAME \
    --application=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 WORKLOAD_NAME pelo nome da carga de trabalho que quer atualizar.

      Substitua as seguintes flags obrigatórias e opcionais:

      • 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 anfitrião ou projeto de gestão.
      • Obrigatório: LOCATION: a localização do recurso. Use global para recursos globais ou uma região específica, como us-east1, para recursos regionais.
      • Opcional: DISPLAY_NAME: o nome a apresentar do seu recurso.

      • Opcional: CRITICALITY_LEVEL: o nível de importância do recurso. 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 de serviço ou carga de trabalho com o Terraform, modifique os argumentos no bloco de recursos google_apphub_service ou google_apphub_workload correspondente no ficheiro de configuração. Quando aplica as alterações, o Terraform atualiza o recurso para corresponder à nova configuração.

Os exemplos seguintes atualizam os atributos de criticidade e ambiente dos serviços e das cargas de trabalho de uma aplicação regional:

  • Atualize os atributos do serviço:

    resource "google_apphub_service" "example" {
    # ... other arguments
    attributes {
        criticality {
            type = "HIGH" # Updated criticality
        }
        environment {
            type = "PRODUCTION"
        }
        # ... other attributes
    }
}

  • Atualize os atributos da carga de trabalho:

    resource "google_apphub_workload" "example" {
    # ... other arguments
    attributes {
        criticality {
            type = "HIGH" # Updated criticality
        }
        environment {
            type = "PRODUCTION"
        }
        # ... other attributes
    }
}

Anule o registo de serviços e cargas de trabalho

A anulação do registo de um serviço ou de uma carga de trabalho remove-o de uma aplicação. O recurso subjacente não é eliminado e torna-se novamente um recurso descoberto, disponível para registo noutra aplicação.

Siga estes passos para anular o registo de serviços e cargas de trabalho:

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 a partir da qual quer anular o registo de serviços ou cargas de trabalho.

  4. No separador Serviços e cargas de trabalho, clique no nome do serviço ou da carga de trabalho que quer anular o registo.

  5. Na página de detalhes do recurso, clique em Anular registo.

gcloud

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

  2. Anule o registo de um serviço ou de uma carga de trabalho:

    • Anule o registo de um serviço:

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

      Substitua o seguinte:

      • SERVICE_NAME: o nome do serviço que quer anular o registo.
      • 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 do recurso. Use global para recursos globais ou uma região específica, como us-east1, para recursos regionais.

    • Anule o registo de uma carga de trabalho:

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

      Substitua WORKLOAD_NAME pelo nome da carga de trabalho que quer anular o registo.

Terraform

Para anular o registo de um serviço ou uma carga de trabalho gerida pelo Terraform, remova o bloco de recursos google_apphub_service ou google_apphub_workload correspondente do ficheiro de configuração e execute terraform apply. Quando aplica as alterações, o Terraform remove o registo do App Hub.

Depois de anular o registo de todos os serviços e cargas de trabalho, pode eliminar a aplicação.

O que se segue?