Gerenciar serviços e cargas de trabalho

Ao escolher seu modelo de configuração de aplicativo, você define um limite de gerenciamento de aplicativos para seus aplicativos do App Hub em um projeto de gerenciamento. Em seguida, você pode registrar serviços e cargas de trabalho em aplicativos dentro desse limite. Para conferir casos de uso recomendados para introduzir práticas de gerenciamento de aplicativos, consulte Preparar para o gerenciamento do ciclo de vida de aplicativos.

Para evitar a deriva de configuração e manter uma fonte de verdade clara, recomendamos que você gerencie os componentes 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 ao registrar recursos no App Hub: gerencie aplicativos, serviços e cargas de trabalho diretamente no App Hub.

    Acessar o App Hub

Nesta página, descrevemos como gerenciar serviços e cargas de trabalho descobertos ou 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 Application Design Center.

Antes de começar

Este documento pressupõe que você tenha um aplicativo com recursos compatíveis registrados nele.

Funções exigidas

Para receber as permissões necessárias para gerenciar serviços e cargas de trabalho no App Hub, peça ao administrador para conceder a você os seguintes papéis do IAM no projeto de gerenciamento que define o limite de gerenciamento de aplicativos :

  • Atualizar e cancelar o registro de serviços e cargas de trabalho: Editor do App Hub (roles/apphub.editor)
  • Confira serviços, cargas de trabalho e detalhes: 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.

Ver detalhes de serviços e cargas de trabalho

Siga estas etapas para conferir detalhes de serviços e cargas de trabalho, incluindo local, status de registro em um aplicativo, atributos e propriedades, dentro do limite de gerenciamento de aplicativos. Para mais informações sobre esses detalhes, consulte Conceitos e modelo de dados do App Hub.

Console

Confira detalhes de serviços e cargas de trabalho de um aplicativo com um valor de status de registro registrado ou desanexado:

  1. No console Google Cloud , use o seletor de projetos para escolher seu projeto de gerenciamento.

  2. Acesse a página Aplicativos no App Hub:

    Acesse Aplicativos

    A página mostra uma lista dos seus aplicativos.

  3. Clique no nome do aplicativo em que você quer ver os detalhes do serviço ou da carga de trabalho.

  4. Na guia Serviços e cargas de trabalho, clique no nome do serviço ou da carga de trabalho que você quer visualizar.

  5. Na página Detalhes do componente, você pode conferir informações como nome de exibição, local, status de registro, propriedades e atributos.

Como alternativa, veja uma lista de todos os serviços e cargas de trabalho com um valor de status de registro descoberto ou registrado:

  1. Acesse a página Serviços e cargas de trabalho no App Hub:

    Acesse "Serviços e cargas de trabalho"

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

  2. Use o campo Filtro para restringir os resultados por propriedades, atributos ou status, usando valores como Ambiente, Proprietários ou Status de registro.

gcloud

Confira detalhes de serviços e cargas de trabalho de um aplicativo com um valor de status de registro registrado ou desanexado:

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

  2. Descreva um serviço ou uma carga de trabalho de um aplicativo para analisar os detalhes, incluindo propriedades e atributos:

    • Descrever um serviço:

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

      Substitua:

      • SERVICE: o ID do serviço.
      • PROJECT_ID: o ID do seu projeto de gerenciamento.
      • APPLICATION: o ID do aplicativo em que o serviço está registrado.
      • LOCATION: o local 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:

      • WORKLOAD: o ID da carga de trabalho.
      • PROJECT_ID: o ID do seu projeto de gerenciamento.
      • APPLICATION: o ID do aplicativo em que a carga de trabalho está registrada.
      • LOCATION: o local da carga de trabalho. Use global para recursos globais ou uma região específica, como us-east1, para recursos regionais.

A saída mostra detalhes do componente, como nome de exibição, local e status de registro. Ele também inclui propriedades e atributos, se estiverem presentes no recurso.

Como alternativa, veja uma lista de todos os serviços e cargas de trabalho com um valor de status de registro descoberto ou registrado:

Descoberto

Os recursos Google Cloud descobertos no limite de gerenciamento de aplicativos podem ser registrados como serviços ou cargas de trabalho em um aplicativo. Siga estas etapas para listar os recursos descobertos:

  1. Listar serviços descobertos:

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

    Substitua:

    • PROJECT_ID: o ID do seu projeto de gerenciamento.
    • LOCATION: o local em que você quer descobrir recursos. Use global para recursos globais ou uma região específica, como us-east1, para recursos regionais.

  2. Liste as cargas de trabalho descobertas:

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

Registrado

Os serviços e as cargas de trabalho registrados fazem parte de um aplicativo. Siga estas etapas para listar os componentes registrados de um aplicativo específico. É possível filtrar a lista com base em atributos usando a flag --filter:

  1. Listar serviços registrados em um aplicativo:

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

    Substitua:

    • APPLICATION_NAME: o nome do seu aplicativo. Você especifica esse valor ao criar um aplicativo.
    • PROJECT_ID: o ID do seu projeto de gerenciamento.
    • LOCATION: o local 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. Listar cargas de trabalho registradas em um aplicativo:

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

O status de registro de serviços e cargas de trabalho em um aplicativo pode mudar para desvinculado se você mover um projeto ou uma pasta para fora do limite de gerenciamento de aplicativos ou excluir o recurso subjacente. Os serviços e as cargas de trabalho desconectados permanecem no aplicativo até que você os cancele, mas o App Hub não pode mais gerenciar ou monitorá-los. Para mais informações, consulte Status de registro de serviços e cargas de trabalho.

Para anexar serviços ou cargas de trabalho a um aplicativo, é necessário registrá-los novamente.

Atualizar atributos de serviço e carga de trabalho

Para modificar os atributos de serviços e cargas de trabalho registrados em um aplicativo, siga estas etapas:

Console

  1. No console Google Cloud , use o seletor de projetos para escolher seu projeto de gerenciamento.

  2. Acesse a página Aplicativos no App Hub:

    Acesse Aplicativos

    A página mostra uma lista dos seus aplicativos.

  3. Clique no nome do aplicativo para o qual você quer atualizar atributos de serviço ou carga de trabalho.

  4. Na guia Serviços e cargas de trabalho, encontre o nome do serviço ou da carga de trabalho que você quer atualizar.

  5. Clique em more_vert Mais e em Editar serviço ou Editar carga de trabalho.

  6. No painel aberto, edite os campos conforme necessário e clique em Salvar.

gcloud

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

  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 você 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 você quer atualizar.

      Substitua as seguintes flags obrigatórias e opcionais:

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

Terraform

Para atualizar 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 arquivo de configuração. Quando você aplica as mudanças, o Terraform atualiza o recurso para corresponder à nova configuração.

Os exemplos a seguir atualizam os atributos de importância e ambiente dos serviços e cargas de trabalho de um aplicativo 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
    }
}

Cancelar o registro de serviços e cargas de trabalho

Ao cancelar o registro de um serviço ou carga de trabalho, ele é removido de um aplicativo. O recurso subjacente não é excluído. Se ainda estiver dentro do limite de gerenciamento de aplicativos, ele se tornará um recurso com um valor de status de registro descoberto, disponível para registro em outro aplicativo.

Siga estas etapas para cancelar o registro de serviços e cargas de trabalho:

Console

  1. No console Google Cloud , use o seletor de projetos para escolher seu projeto de gerenciamento.

  2. Acesse a página Aplicativos no App Hub:

    Acesse Aplicativos

    A página mostra uma lista dos seus aplicativos.

  3. Clique no nome do aplicativo em que você quer cancelar o registro de serviços ou cargas de trabalho.

  4. Na guia Serviços e cargas de trabalho, clique no nome do serviço ou da carga de trabalho que você quer cancelar o registro.

  5. Na página de detalhes do componente, clique em Cancelar registro.

gcloud

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

  2. Cancelar o registro de um serviço ou uma carga de trabalho:

    • Cancelar o registro de um serviço:

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

      Substitua:

      • SERVICE_NAME: o nome do serviço que você quer cancelar o registro.
      • APPLICATION_NAME: o nome do seu aplicativo. Você especifica esse valor ao criar um aplicativo.
      • PROJECT_ID: o ID do seu projeto de gerenciamento.
      • LOCATION: o local do componente. Use global para componentes globais ou uma região específica, como us-east1, para componentes regionais.

    • Cancelar o registro 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 você quer cancelar o registro.

Terraform

Para cancelar o registro de um serviço ou carga de trabalho gerenciada pelo Terraform, remova o bloco de recursos google_apphub_service ou google_apphub_workload correspondente do arquivo de configuração e execute terraform apply. Quando você aplica as mudanças, o Terraform remove o registro do App Hub.

Depois de cancelar o registro de todos os serviços e cargas de trabalho, você pode excluir o aplicativo.

A seguir