Modificar recursos do App Hub em pastas com app ativado

É possível listar, visualizar, atualizar e excluir recursos do App Hub em uma pasta ativada para apps usando o console do Google Cloud ou a CLI do Google Cloud no terminal ou no Cloud Shell.

Pré-requisitos

Antes de modificar os recursos do App Hub, conclua as seguintes tarefas:

  1. Siga os pré-requisitos para configurar o App Hub.
  2. Dependendo do tipo de recurso que você quer modificar, verifique se você seguiu as etapas para configurar o App Hub. Para mais informações, consulte Configurar o App Hub.

Funções exigidas

Para receber as permissões necessárias para modificar recursos do App Hub, peça ao administrador para conceder a você os seguintes papéis do IAM na pasta ativada para apps:

  • Para criar e atualizar aplicativos, registrar e cancelar o registro de serviços e cargas de trabalho e atualizar os atributos associados:
  • Para conferir aplicativos, serviços e cargas de trabalho e os atributos deles: Visualizador do App Hub (roles/apphub.viewer)
  • Para conferir aplicativos, serviços e cargas de trabalho e os atributos deles em Google Cloud serviços que oferecem suporte ao gerenciamento de aplicativos: Leitor de gerenciamento do App Hub (roles/apphub.appManagementViewer)

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 por meio de papéis personalizados ou de outros papéis predefinidos.

Listar aplicativos

É possível listar e filtrar aplicativos em uma pasta ativada para apps.

Console

  1. Para conferir os aplicativos em uma pasta ativada para apps, no console do Google Cloud, acesse a página Applications do App Hub.

    Acesse Aplicativos

    Você vai encontrar uma lista de aplicativos.

  2. Para filtrar aplicativos:

    1. No campo Filtro, selecione uma opção, como Critério.
    2. Especifique um valor para o filtro. Por exemplo, para mostrar aplicativos com alta criticidade, selecione Alta como o valor.
      Uma lista de aplicativos que correspondem ao filtro especificado aparece.

gcloud

  1. Para acessar os aplicativos em uma pasta com app ativado:

    gcloud apphub applications list \
        --project=MANAGEMENT_PROJECT_ID \
        --location=REGION
    

    Substitua:

    • MANAGEMENT_PROJECT_ID: o ID do projeto de gerenciamento. Encontre o ID do projeto de gerenciamento na página Configurações de IAM e do administrador do console do Google Cloud. Se você não encontrar o ID do projeto de gerenciamento, talvez não esteja em uma pasta ativada pelo app. No seletor de Purview (ou seletor de projeto), selecione sua pasta com app ativado. Para mais informações sobre como ativar uma pasta para gerenciamento de aplicativos, consulte Ativar o gerenciamento de aplicativos.
    • REGION: a região do aplicativo. Dependendo do --scope-type do aplicativo, atribua o valor global ou a região do aplicativo, por exemplo, us-east1. Para mais informações sobre como definir o --scope-type para o aplicativo, consulte Criar um aplicativo.
  2. Para filtrar os aplicativos com base em atributos variáveis, use a flag --filter. Por exemplo, para listar todos os aplicativos em que o atributo environment-type está definido como PRODUCTION:

    gcloud apphub applications list \
        --filter='attributes.environment.type=PRODUCTION' \
        --project=MANAGEMENT_PROJECT_ID \
        --location=REGION
    

Conferir uma inscrição

É possível descrever um aplicativo em uma pasta ativada por apps.

Console

  1. No console do Google Cloud, acesse a página Aplicativos do Hub de apps.

    Acesse Aplicativos

  2. Na lista de aplicativos, clique no aplicativo sobre o qual você quer saber os detalhes.

  3. Clique na guia Detalhes para mostrar os detalhes do aplicativo.

gcloud

gcloud apphub applications describe APPLICATION_NAME \
    --project=MANAGEMENT_PROJECT_ID \
    --location=REGION

Substitua APPLICATION_NAME pelo nome do aplicativo. O nome precisa incluir apenas caracteres alfanuméricos minúsculos sem espaços.

Atualizar um aplicativo do App Hub

É possível atualizar os atributos do app depois que ele é criado.

Console

  1. No console do Google Cloud, acesse a página Aplicativos do Hub de apps.

    Acesse Aplicativos

  2. Na lista de aplicativos, clique em Editar para o aplicativo que você quer atualizar.

  3. Edite os campos conforme necessário.

  4. Clique em Salvar.

gcloud

  1. Atualize seu app com os atributos criticality-type, environment-type e tipo de proprietário:

    gcloud apphub applications update APPLICATION_NAME \
        --display-name='APPLICATION_DISPLAY_NAME' \
        --criticality-type='CRITICALITY_LEVEL' \
        --environment-type='ENVIRONMENT' \
        --developer-owners=display-name=DISPLAY-NAME-DEVELOPER,email=EMAIL-DEVELOPER \
        --operator-owners=display-name=DISPLAY-NAME-OPERATOR,email=EMAIL-OPERATOR \
        --business-owners=display-name=DISPLAY-NAME-BUSINESS,email=EMAIL-BUSINESS \
        --project=MANAGEMENT_PROJECT_ID \
        --location=REGION
    

    Substitua:

    • APPLICATION_NAME: o nome do seu aplicativo. O nome precisa incluir apenas caracteres alfanuméricos minúsculos sem espaços.
    • REGION: a região do aplicativo.

    Você pode atualizar qualquer um dos seguintes itens:

    • APPLICATION_DISPLAY_NAME: indica o nome de exibição do aplicativo.
    • CRITICALITY_LEVEL: indica a importância de um aplicativo, serviço ou carga de trabalho para as operações de negócios. Forneça um dos seguintes valores:
      • MISSION_CRITICAL
      • HIGH
      • MEDIUM
      • LOW
    • ENVIRONMENT: indica os estágios do ciclo de vida do software. Forneça um dos seguintes valores:
      • PRODUCTION
      • STAGING
      • DEVELOPMENT
      • TEST
    • DISPLAY-NAME-DEVELOPER, DISPLAY-NAME-OPERATOR e DISPLAY-NAME-BUSINESS: mostram os nomes dos proprietários do desenvolvedor, do operador e da empresa, respectivamente.
    • EMAIL-NAME-DEVELOPER, EMAIL-NAME-OPERATOR e EMAIL-NAME-BUSINESS: endereços de e-mail dos proprietários do desenvolvedor, do operador e da empresa, respectivamente. Esses valores precisam ter o formato username@yourdomain, por exemplo, 222larabrown@gmail.com.

    Exemplo:

    gcloud apphub applications update my-application \
        --criticality-type='MEDIUM' \
        --environment-type='STAGING' \
        --developer-owners=display-name=developer-name,email=username@yourdomain \
        --project=google-mpf-FOLDER-ID \
        --location=us-east1
    

Conferir serviços e cargas de trabalho

É possível conferir, listar e filtrar serviços e cargas de trabalho em um aplicativo.

Console

  1. Para listar serviços e cargas de trabalho:

    1. No console do Google Cloud, acesse a página Serviços e cargas de trabalho do App Hub.

      Acesse "Serviços e cargas de trabalho"

    2. Na lista Região, selecione as regiões em que você quer acessar os serviços e os workloads. Por exemplo, selecione us-east1.
      A página Serviços e cargas de trabalho mostra todos os serviços e cargas de trabalho dos projetos de serviço anexados associados a us-east1.

  2. Para filtrar os serviços ou cargas de trabalho:

    1. No campo Filtro, selecione uma opção, como Ambiente.
    2. Especifique um valor para o filtro. Por exemplo, para conferir serviços e cargas de trabalho em produção, selecione Produção como valor.
      Uma lista de serviços e workloads que correspondem ao filtro especificado aparece.

gcloud

Listar os serviços descobertos

Os serviços descobertos estão disponíveis para registro em um aplicativo.

  1. Para listar os serviços descobertos:

    gcloud apphub discovered-services list \
        --project=MANAGEMENT_PROJECT_ID \
        --location=REGION

    Você verá uma saída semelhante a esta:

    ID                      SERVICE_REFERENCE                                                                                                                   SERVICE_PROPERTIES
    [DISCOVERED_SERVICE_ID] {'uri': '//compute.googleapis.com/projects/[PROJECT_NUMBER]/regions/REGION/forwardingRules/testing-forwarding-rule-1'}    {'gcpProject': 'projects/PROJECT_ID', 'location': 'REGION'}
    
  2. Opcional: filtre a lista de serviços descobertos. Por exemplo, para filtrar os serviços descobertos com regras de encaminhamento na pasta ativada pelo app:

    gcloud apphub discovered-services list \
        --filter='service_reference.uri~"forwardingRules"' \
        --project=MANAGEMENT_PROJECT_ID \
        --location=REGION

Listar serviços registrados

Listar e filtrar os serviços registrados do App Hub em um aplicativo.

  1. Para listar os serviços registrados em um aplicativo:

    gcloud apphub applications services list \
        --application=APPLICATION_NAME \
        --project=MANAGEMENT_PROJECT_ID \
        --location=REGION
    

    Você verá uma saída semelhante a esta:

    ID             DISPLAY_NAME            SERVICE_REFERENCE                                                                                                                CREATE_TIME
    SERVICE_NAME   mywebserver-service1    {'uri': '//compute.googleapis.com/projects/[PROJECT_NUMBER]/regions/REGION/forwardingRules/testing-forwarding-rule'}   2023-11-01T21:38:08
    

    Os serviços registrados, mas separados, são indicados por um valor vazio no campo SERVICE_REFERENCE.

  2. Opcional: filtre a lista de serviços registrados. Por exemplo, para filtrar os serviços registrados em um aplicativo em que o atributo environment-type está definido como PRODUCTION:

    gcloud apphub applications services list \
        --filter='attributes.environment.type=PRODUCTION' \
        --application=APPLICATION_NAME \
        --project=MANAGEMENT_PROJECT_ID \
        --location=REGION
    

Listar cargas de trabalho descobertas

As cargas de trabalho descobertas estão disponíveis para registro em um aplicativo.

  1. Para listar as cargas de trabalho descobertas:

    gcloud apphub discovered-workloads list \
        --project=MANAGEMENT_PROJECT_ID \
        --location=REGION
    

    Você vai ver uma saída semelhante a esta, que inclui MIGs não registradas:

    ID                        WORKLOAD_REFERENCE                                                                                                   WORKLOAD_PROPERTIES
    [DISCOVERED_WORKLOAD_ID]  {'uri': '//compute.googleapis.com/projects/[PROJECT_NUMBER]/regions/REGION/instanceGroups/testing-mig'}    {'gcpProject': 'projects/PROJECT_ID', 'location': 'REGION'}
    
  2. Opcional: filtre a lista de cargas de trabalho descobertas. Por exemplo, para filtrar a lista de cargas de trabalho detectadas com recursos de computação em uma pasta ativada pelo app:

    gcloud apphub discovered-workloads list \
        --filter='workload_reference.uri~"compute"'
        --project=MANAGEMENT_PROJECT_ID \
        --location=REGION
    

Listar cargas de trabalho registradas

Listar e filtrar cargas de trabalho registradas do App Hub em um aplicativo.

  1. Para listar as cargas de trabalho registradas em um aplicativo:

    gcloud apphub applications workloads list \
        --application=APPLICATION_NAME \
        --project=MANAGEMENT_PROJECT_ID \
        --location=REGION
    

    Você verá uma saída semelhante a esta:

    ID               DISPLAY_NAME               WORKLOAD_REFERENCE                                                                                                     CREATE_TIME
    WORKLOAD_NAME    mywebserver-deployment1    {'uri': '//compute.googleapis.com/projects/[PROJECT_NUMBER]/regions/REGION/instanceGroups/testing-mig'}    2023-10-31T18:34:23
    

    As cargas de trabalho registradas, mas separadas, são indicadas por um valor vazio no campo WORKLOAD_REFERENCE. Para mais informações sobre os status de registro, consulte as propriedades e os atributos do App Hub.

  2. Opcional: filtre a lista de cargas de trabalho registradas. Por exemplo, para filtrar as cargas de trabalho em um aplicativo em que o atributo environment-type está definido como PRODUCTION:

    gcloud apphub applications workloads list \
        --filter='attributes.environment.type=PRODUCTION' \
        --application=APPLICATION_NAME \
        --project=MANAGEMENT_PROJECT_ID \
        --location=REGION
    

Atualizar serviços e cargas de trabalho

É possível atualizar os serviços e as cargas de trabalho registrados em um aplicativo.

Console

  1. No console do Google Cloud, acesse a página Aplicativos do App Hub.

    Acesse Aplicativos

  2. Clique no nome do seu app.
    A guia Serviços e cargas de trabalho é exibida com uma lista de serviços e cargas de trabalho registrados nos seus projetos de serviço.

  3. Para cada serviço ou carga de trabalho que você quer atualizar, faça o seguinte:

    1. Na guia Serviços e workloads, para o serviço ou workload que você quer atualizar, clique em more_vert e, em seguida, em Edit service ou Edit workload.
    2. No painel Editar serviço ou Editar carga de trabalho, edite os campos conforme necessário e clique em Salvar.

gcloud

  1. Atualize seu serviço com os atributos criticality-type, environment-type e tipo de proprietário:

    gcloud apphub applications services update SERVICE_NAME \
        --application=APPLICATION_NAME \
        --display-name='SERVICE_DISPLAY_NAME' \
        --criticality-type='CRITICALITY_LEVEL' \
        --environment-type='ENVIRONMENT' \
        --developer-owners=display-name=DISPLAY-NAME-DEVELOPER,email=EMAIL-DEVELOPER \
        --operator-owners=display-name=DISPLAY-NAME-OPERATOR,email=EMAIL-OPERATOR \
        --business-owners=display-name=DISPLAY-NAME-BUSINESS,email=EMAIL-BUSINESS \
        --project=MANAGEMENT_PROJECT_ID \
        --location=REGION
    

    Substitua SERVICE_NAME por um nome do serviço do App Hub.

    Você pode atualizar qualquer um dos seguintes itens:

    • SERVICE_DISPLAY_NAME: indica um nome de exibição para o serviço.
    • CRITICALITY_LEVEL: indica a importância de um aplicativo, serviço ou carga de trabalho para as operações de negócios. Forneça um dos seguintes valores:
      • MISSION_CRITICAL
      • HIGH
      • MEDIUM
      • LOW
    • ENVIRONMENT: indica os estágios do ciclo de vida do software. Forneça um dos seguintes valores:
      • PRODUCTION
      • STAGING
      • DEVELOPMENT
      • TEST
    • DISPLAY-NAME-DEVELOPER, DISPLAY-NAME-OPERATOR e DISPLAY-NAME-BUSINESS: mostram os nomes dos proprietários do desenvolvedor, do operador e da empresa, respectivamente.
    • EMAIL-NAME-DEVELOPER, EMAIL-NAME-OPERATOR e EMAIL-NAME-BUSINESS: endereços de e-mail dos proprietários do desenvolvedor, do operador e da empresa, respectivamente. Esses valores precisam ter o formato username@yourdomain, por exemplo, 222larabrown@gmail.com.

    Exemplo:

    gcloud apphub applications workloads update my-application \
        --criticality-type='MEDIUM' \
        --environment-type='STAGING' \
        --developer-owners=display-name=developer-name,email=username@yourdomain \
        --project=google-mpf-FOLDER-ID \
        --location=us-east1
    
  2. Atualize sua carga de trabalho com os atributos criticality-type, environment-type e tipo de proprietário:

    gcloud apphub applications workloads update WORKLOAD_NAME \
        --application=APPLICATION_NAME \
        --display-name='WORKLOAD_DISPLAY_NAME' \
        --criticality-type='CRITICALITY_LEVEL' \
        --environment-type='ENVIRONMENT' \
        --developer-owners=display-name=DISPLAY-NAME-DEVELOPER,email=EMAIL-DEVELOPER \
        --operator-owners=display-name=DISPLAY-NAME-OPERATOR,email=EMAIL-OPERATOR \
        --business-owners=display-name=DISPLAY-NAME-BUSINESS,email=EMAIL-BUSINESS \
        --project=MANAGEMENT_PROJECT_ID \
        --location=REGION
    

    Substitua WORKLOAD_NAME pelo nome da carga de trabalho do App Hub.

    Você pode atualizar qualquer um dos seguintes itens:

    • WORKLOAD_DISPLAY_NAME: indica um nome de exibição para o serviço.
    • CRITICALITY_LEVEL: indica a importância de um aplicativo, serviço ou carga de trabalho para as operações de negócios. Forneça um dos seguintes valores:
      • MISSION_CRITICAL
      • HIGH
      • MEDIUM
      • LOW
    • ENVIRONMENT: indica os estágios do ciclo de vida do software. Forneça um dos seguintes valores:
      • PRODUCTION
      • STAGING
      • DEVELOPMENT
      • TEST
    • DISPLAY-NAME-DEVELOPER, DISPLAY-NAME-OPERATOR e DISPLAY-NAME-BUSINESS: mostram os nomes dos proprietários do desenvolvedor, do operador e da empresa, respectivamente.
    • EMAIL-NAME-DEVELOPER, EMAIL-NAME-OPERATOR e EMAIL-NAME-BUSINESS: endereços de e-mail dos proprietários do desenvolvedor, do operador e da empresa, respectivamente. Esses valores precisam ter o formato username@yourdomain, por exemplo, 222larabrown@gmail.com.

    Exemplo:

    gcloud apphub applications workloads update my-application \
        --criticality-type='MEDIUM' \
        --environment-type='STAGING' \
        --developer-owners=display-name=developer-name,email=username@yourdomain \
        --project=google-mpf-FOLDER-ID \
        --location=us-east1
    

Excluir aplicativos, serviços e cargas de trabalho

Exclua um aplicativo para remover os recursos registrados associados à pasta ativada pelo app. Para fazer isso, primeiro descadastre as cargas de trabalho e os serviços registrados no aplicativo.

Console

  1. No console do Google Cloud, acesse a página Aplicativos do Hub de apps.

    Acesse Aplicativos

  2. Clique no nome de um aplicativo. Uma lista de serviços e cargas de trabalho registrados no aplicativo vai aparecer.

  3. Cancelar a inscrição de um serviço ou carga de trabalho.

    1. Na guia Serviços e cargas de trabalho, na seção Serviços e cargas de trabalho registrados, clique no nome do serviço ou da carga de trabalho que você quer cancelar o registro.
    2. Na página do serviço ou da carga de trabalho registrada que abrir, clique em Unregister para atualizar o serviço ou a carga de trabalho como um recurso Descoberto. Na guia Serviços e cargas de trabalho, um alerta notifica que a carga de trabalho não está registrada.
    3. Repita essas instruções para cada serviço e carga de trabalho.
  4. Acesse a página Aplicativos do App Hub.

    Acesse Aplicativos

  5. Clique no nome de um aplicativo.

  6. Na página com os detalhes do aplicativo, clique em Excluir.

gcloud

  1. Liste os serviços registrados no aplicativo:

    gcloud apphub applications services list \
        --application=APPLICATION_NAME \
        --project=MANAGEMENT_PROJECT_ID \
        --location=REGION
    
  2. Cancele o registro do serviço no aplicativo:

    gcloud apphub applications services delete SERVICE_NAME \
        --application=APPLICATION_NAME \
        --project=MANAGEMENT_PROJECT_ID \
        --location=REGION
    

    O serviço agora é um serviço descoberto que pode ser registrado no aplicativo.

  3. Repita o comando anterior para cancelar o registro de todos os serviços registrados restantes do aplicativo.

  4. Liste as cargas de trabalho registradas no aplicativo:

    gcloud apphub applications workloads list \
        --application=APPLICATION_NAME \
        --project=MANAGEMENT_PROJECT_ID \
        --location=REGION
    
  5. Cancele o registro da carga de trabalho no aplicativo:

    gcloud apphub applications workloads delete WORKLOAD_NAME \
        --application=APPLICATION_NAME \
        --project=MANAGEMENT_PROJECT_ID \
        --location=REGION
    

    A carga de trabalho agora é uma carga de trabalho descoberta que pode ser registrada no aplicativo.

  6. Repita o comando anterior para excluir os workloads registrados restantes do aplicativo.

  7. Exclua o aplicativo:

    gcloud apphub applications delete APPLICATION_NAME \
        --project=MANAGEMENT_PROJECT_ID \
        --location=REGION
    

A seguir