Gerenciar serviços e cargas de trabalho

Ao configurar o App Hub, você cria um limite administrativo para seus aplicativos. Esse limite é o projeto de gerenciamento ou o conjunto de projetos host e de serviço que você configurou para o gerenciamento de aplicativos, dependendo do modelo de configuração. Os serviços e as cargas de trabalho são registrados como aplicativos dentro desse limite administrativo.

Para evitar a deriva de configuração e manter uma fonte de verdade clara, recomendamos que você gerencie os recursos do aplicativo no ambiente em que foram definidos originalmente:

  • Para aplicativos implantados com 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 registrando recursos no App Hub: gerencie o aplicativo, os serviços e as 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 como aplicativos. É 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 App Design Center.

Antes de começar

Antes de visualizar, atualizar e cancelar o registro de serviços e cargas de trabalho no App Hub, siga estas etapas:

  1. Configure o App Hub usando um dos modelos de configuração compatíveis.
  2. Registrar recursos compatíveis em um aplicativo.

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 limite administrativo do aplicativo do modelo de configuração (o projeto de gerenciamento ou os projetos de host e serviço):

  • Atualizar e cancelar o registro de serviços e cargas de trabalho: Editor do App Hub (roles/apphub.editor)
  • Ver serviços e cargas de trabalho: 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 a localização e o status de registro em um aplicativo, no limite administrativo do App Hub:

Console

Confira detalhes de serviços e cargas de trabalho registrados ou desvinculados de um aplicativo:

  1. Na página Bem-vindo do console do Google Cloud , use o seletor de projetos para escolher seu projeto de gerenciamento ou host:

    Acessar "Boas-vindas"

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

    Acesse Aplicativos

    A página mostra uma lista dos seus aplicativos.

  3. Clique no nome do aplicativo em que você quer ver 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 visualizar.

  5. Na página Detalhes do recurso, você pode conferir informações como nome de exibição, local, status de registro 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 do 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 atributos como Ambiente ou Status do registro.

gcloud

Confira detalhes de serviços e cargas de trabalho registrados ou desvinculados de um aplicativo:

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

  2. Descreva um serviço ou uma carga de trabalho de um aplicativo para analisar os detalhes dele:

    • Descreva 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 projeto host ou 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 projeto host ou 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 recurso, como nome de exibição, local, status de registro 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:

Recursos descobertos

Os recursos descobertos podem ser registrados 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 projeto host ou 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

Recursos registrados

Os recursos registrados fazem parte de um aplicativo. Siga estas etapas para listar os recursos 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 projeto host ou de gerenciamento.
    • LOCATION: o local 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. 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 de um aplicativo pode mudar para desvinculado se você modificar a estrutura organizacional dos seus recursos do Google Cloud ou excluir o recurso subjacente. Os serviços e as cargas de trabalho desconectados permanecem no aplicativo até serem cancelados, mas o App Hub não pode mais gerenciar ou monitorar esses itens. Para mais informações, consulte Status de registro de serviços e cargas de trabalho.

Para anexar novamente serviços ou cargas de trabalho a um aplicativo, é necessário registrá-los de novo com base na hierarquia de recursos do modelo de configuração.

Atualizar atributos de serviço e de carga de trabalho

Siga estas etapas para modificar os atributos definidos pelo usuário de serviços e cargas de trabalho registrados em um aplicativo:

Console

  1. Na página Bem-vindo do console do Google Cloud , use o seletor de projetos para escolher seu projeto de gerenciamento ou host:

    Acessar "Boas-vindas"

  2. Acesse a página Aplicativos do 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 ou host.

  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 host ou de gerenciamento.
      • 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 de exibição 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: 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 de 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 e volta a ser um recurso descoberto, disponível para registro em outro aplicativo.

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

Console

  1. Na página Bem-vindo do console do Google Cloud , use o seletor de projetos para escolher seu projeto de gerenciamento ou host:

    Acessar "Boas-vindas"

  2. Acesse a página Aplicativos do 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 recurso, clique em Cancelar registro.

gcloud

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

  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 projeto host ou de gerenciamento.
      • LOCATION: o local do recurso. Use global para recursos globais ou uma região específica, como us-east1, para recursos 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