Pré-requisitos
Antes de modificar os recursos do App Hub, conclua as seguintes tarefas:
- Siga os pré-requisitos para configurar o App Hub.
- 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:
-
Administrador do App Hub (
roles/apphub.admin
) -
Editor do App Hub (
roles/apphub.editor
)
-
Administrador do App Hub (
-
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
Para conferir os aplicativos em uma pasta ativada para apps, no console do Google Cloud, acesse a página Applications do App Hub.
Para filtrar aplicativos:
- No campo Filtro, selecione uma opção, como Critério.
- 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
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 valorglobal
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.
Para filtrar os aplicativos com base em atributos variáveis, use a flag
--filter
. Por exemplo, para listar todos os aplicativos em que o atributoenvironment-type
está definido comoPRODUCTION
: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
No console do Google Cloud, acesse a página Aplicativos do Hub de apps.
Na lista de aplicativos, clique no aplicativo sobre o qual você quer saber os detalhes.
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
No console do Google Cloud, acesse a página Aplicativos do Hub de apps.
Na lista de aplicativos, clique em
Editar para o aplicativo que você quer atualizar.Edite os campos conforme necessário.
Clique em Salvar.
gcloud
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
eDISPLAY-NAME-BUSINESS
: mostram os nomes dos proprietários do desenvolvedor, do operador e da empresa, respectivamente.EMAIL-NAME-DEVELOPER
,EMAIL-NAME-OPERATOR
eEMAIL-NAME-BUSINESS
: endereços de e-mail dos proprietários do desenvolvedor, do operador e da empresa, respectivamente. Esses valores precisam ter o formatousername@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
Para listar serviços e cargas de trabalho:
No console do Google Cloud, acesse a página Serviços e cargas de trabalho do App Hub.
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.
Para filtrar os serviços ou cargas de trabalho:
- No campo Filtro, selecione uma opção, como Ambiente.
- 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.
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'}
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.
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
.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 comoPRODUCTION
: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.
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'}
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.
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.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 comoPRODUCTION
: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
No console do Google Cloud, acesse a página Aplicativos do App Hub.
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.Para cada serviço ou carga de trabalho que você quer atualizar, faça o seguinte:
- 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.
- No painel Editar serviço ou Editar carga de trabalho, edite os campos conforme necessário e clique em Salvar.
gcloud
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
eDISPLAY-NAME-BUSINESS
: mostram os nomes dos proprietários do desenvolvedor, do operador e da empresa, respectivamente.EMAIL-NAME-DEVELOPER
,EMAIL-NAME-OPERATOR
eEMAIL-NAME-BUSINESS
: endereços de e-mail dos proprietários do desenvolvedor, do operador e da empresa, respectivamente. Esses valores precisam ter o formatousername@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
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
eDISPLAY-NAME-BUSINESS
: mostram os nomes dos proprietários do desenvolvedor, do operador e da empresa, respectivamente.EMAIL-NAME-DEVELOPER
,EMAIL-NAME-OPERATOR
eEMAIL-NAME-BUSINESS
: endereços de e-mail dos proprietários do desenvolvedor, do operador e da empresa, respectivamente. Esses valores precisam ter o formatousername@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
No console do Google Cloud, acesse a página Aplicativos do Hub de apps.
Clique no nome de um aplicativo. Uma lista de serviços e cargas de trabalho registrados no aplicativo vai aparecer.
Cancelar a inscrição de um serviço ou carga de trabalho.
- 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.
- 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.
- Repita essas instruções para cada serviço e carga de trabalho.
Acesse a página Aplicativos do App Hub.
Clique no nome de um aplicativo.
Na página com os detalhes do aplicativo, clique em Excluir.
gcloud
Liste os serviços registrados no aplicativo:
gcloud apphub applications services list \ --application=APPLICATION_NAME \ --project=MANAGEMENT_PROJECT_ID \ --location=REGION
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.
Repita o comando anterior para cancelar o registro de todos os serviços registrados restantes do aplicativo.
Liste as cargas de trabalho registradas no aplicativo:
gcloud apphub applications workloads list \ --application=APPLICATION_NAME \ --project=MANAGEMENT_PROJECT_ID \ --location=REGION
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.
Repita o comando anterior para excluir os workloads registrados restantes do aplicativo.
Exclua o aplicativo:
gcloud apphub applications delete APPLICATION_NAME \ --project=MANAGEMENT_PROJECT_ID \ --location=REGION
A seguir
- Configurar o monitoramento de aplicativos
- Papéis e permissões do IAM do App Hub
- Visão geral do App Hub
- Resolver problemas