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

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

  • Atualize e anule o registo de serviços e cargas de trabalho: Editor do App Hub (roles/apphub.editor)
  • Veja serviços, cargas de trabalho e respetivos detalhes: App Hub Viewer (roles/apphub.viewer)

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, o estado de registo numa aplicação, os atributos e as propriedades, dentro do limite de gestão de aplicações. Para mais informações acerca destes detalhes, consulte o artigo Conceitos e modelo de dados do App Hub.

Consola

Veja detalhes dos serviços e cargas de trabalho de uma aplicação com um valor de estado de registo de registado ou desanexado:

  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 a partir da qual quer ver os detalhes do serviço ou da carga 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 componente, pode consultar informações como o nome a apresentar, a localização, o estado de registo, as propriedades 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 a partir 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 propriedades, atributos ou estado, usando valores como Ambiente, Proprietários ou Estado de registo.

gcloud

Veja detalhes dos serviços e cargas de trabalho de uma aplicação com um valor de estado de registo de registado ou desanexado:

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

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

    • 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 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 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 componente, como o nome a apresentar, a localização e o estado de registo. Também inclui propriedades e atributos, se estiverem presentes no recurso.

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:

Descoberto

Os recursos Google Cloud descobertos no limite de gestão da sua aplicação estão disponíveis para serem registados como serviços ou cargas de trabalho 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 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

Registado

Os serviços e as cargas de trabalho registados fazem parte de uma aplicação. Siga estes passos para listar os componentes registados de uma determinada aplicação. Pode filtrar a lista com base em atributos através da flag --filter:

  1. Apresente uma lista dos 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 gestão.
    • LOCATION: a localização do componente. Use global para componentes globais ou uma região específica, como us-east1, para componentes regionais.
    • Opcional: FILTER_EXPRESSION: a expressão de filtro para especificar atributos. Por exemplo, para listar componentes 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 numa aplicação pode mudar para desassociado se mover um projeto ou uma pasta para fora do limite de gestão da aplicação ou eliminar o recurso subjacente. Os serviços e as cargas de trabalho separados permanecem na aplicação até anular o registo, mas o App Hub já não os pode gerir nem 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.

Atualize os atributos de serviços e cargas de trabalho

Para modificar os atributos dos serviços e das cargas de trabalho registados numa aplicação, 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. 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.

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

      • Opcional: CRITICALITY_LEVEL: o nível de importância do componente. 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. Se ainda estiver dentro do limite de gestão da sua aplicação, torna-se um recurso com um valor de estado de registo de 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 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 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 componente, clique em Anular registo.

gcloud

  1. Encontre o ID do projeto do seu projeto de gestã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 de gestão.
      • LOCATION: a localização do componente. Use global para componentes globais ou uma região específica, como us-east1, para componentes 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?