Modificar recursos do App Hub

É possível listar, visualizar, atualizar e excluir recursos do App Hub em uma pasta habilitada para apps usando o console Google Cloud ou a Google Cloud CLI no seu 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ê executou 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 habilitada para apps:

  • Para criar e atualizar aplicativos, registrar e cancelar o registro de serviços e cargas de trabalho e atualizar atributos associados:
  • Para conferir aplicativos, serviços, cargas de trabalho e seus atributos: Leitor do App Hub (roles/apphub.viewer)
  • Para acessar dados no nível do aplicativo e do projeto no Cloud Hub: Operador do Cloud Hub (roles/cloudhub.operator)

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.

Listar aplicativos

É possível listar e filtrar aplicativos em uma pasta compatível com apps.

Console

  1. Para conferir os aplicativos em uma pasta ativada por apps, acesse a página Aplicativos do App Hub no consoleGoogle Cloud .

    Acesse Aplicativos

    Uma lista de aplicativos vai aparecer.

  2. Para filtrar aplicativos:

    1. No campo Filtro, selecione uma opção como Gravidade.
    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 é exibida.

gcloud

  1. Para acessar os aplicativos em uma pasta habilitada para apps:

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

    Substitua:

    • MANAGEMENT_PROJECT_ID: o ID do seu projeto de gerenciamento. Você pode encontrar o ID do projeto de gerenciamento na página Identity and Access Management (IAM) e administrador Configurações do console do Google Cloud . Se você não encontrar o ID do projeto de gerenciamento, talvez não esteja em uma pasta ativada para apps. No seletor de Purview (ou seletor de projeto), selecione sua pasta habilitada para apps. 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 da --scope-type do aplicativo, atribua a ele o valor global ou a região do aplicativo, por exemplo, us-east1. Para mais informações sobre como definir o --scope-type do aplicativo, consulte Criar um aplicativo.

  2. Para filtrar os aplicativos com base em atributos de 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

Ver um aplicativo

Você pode descrever um aplicativo em uma pasta habilitada para apps.

Console

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

    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 aplicativo depois que ele for criado.

Console

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

    Acesse Aplicativos

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

  3. Edite os campos conforme necessário.

  4. Clique em Salvar.

gcloud

  1. Atualize seu aplicativo 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 suas operações comerciais. Forneça um dos seguintes valores:
      • MISSION_CRITICAL
      • HIGH
      • MEDIUM
      • LOW
    • ENVIRONMENT: indica as etapas 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: nomes de exibição do desenvolvedor, do operador e dos proprietários da empresa, respectivamente.
    • EMAIL-NAME-DEVELOPER, EMAIL-NAME-OPERATOR e EMAIL-NAME-BUSINESS: endereços de e-mail do desenvolvedor, operador e proprietários 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

Ver serviços e cargas de trabalho

É possível ver, 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 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 de onde você quer ver os serviços e as cargas de trabalho. 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 ver serviços e cargas de trabalho em produção, selecione Produção como o valor.
      Uma lista de serviços e cargas de trabalho que correspondem ao filtro especificado aparece.

gcloud

Listar serviços descobertos

Os serviços descobertos podem ser registrados 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 para apps:

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

Listar serviços registrados

Liste e filtre 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

    Registrado, mas os serviços 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 podem ser registradas 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 registrados:

    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 descobertas com recursos de computação em uma pasta habilitada para apps:

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

Listar cargas de trabalho registradas

Liste e filtre as cargas de trabalho registradas do App Hub em um aplicativo.

  1. Para listar 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 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 Google Cloud , acesse a página Aplicativos do App Hub.

    Acesse Aplicativos

  2. Clique no nome do seu aplicativo.
    A guia Serviços e cargas de trabalho aparece 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 cargas de trabalho, clique em more_vert no serviço ou na carga de trabalho que você quer atualizar e selecione Editar serviço ou Editar carga de trabalho.
    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 suas operações comerciais. Forneça um dos seguintes valores:
      • MISSION_CRITICAL
      • HIGH
      • MEDIUM
      • LOW
    • ENVIRONMENT: indica as etapas 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: nomes de exibição do desenvolvedor, do operador e dos proprietários da empresa, respectivamente.
    • EMAIL-NAME-DEVELOPER, EMAIL-NAME-OPERATOR e EMAIL-NAME-BUSINESS: endereços de e-mail do desenvolvedor, operador e proprietários 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 suas operações comerciais. Forneça um dos seguintes valores:
      • MISSION_CRITICAL
      • HIGH
      • MEDIUM
      • LOW
    • ENVIRONMENT: indica as etapas 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: nomes de exibição do desenvolvedor, do operador e dos proprietários da empresa, respectivamente.
    • EMAIL-NAME-DEVELOPER, EMAIL-NAME-OPERATOR e EMAIL-NAME-BUSINESS: endereços de e-mail do desenvolvedor, operador e proprietários 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 para apps. Para isso, primeiro cancele o registro das cargas de trabalho e dos serviços registrados no aplicativo.

Console

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

    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 o registro de um serviço ou uma 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 Cancelar registro 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 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 todas as cargas de trabalho registradas restantes do aplicativo.

  7. Exclua o aplicativo:

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

A seguir