Esta página foi traduzida pela API Cloud Translation.

Registrar recursos atuais em um aplicativo

Ao registrar seus serviços e cargas de trabalho atuais em um aplicativo, você simplifica o gerenciamento organizando os recursos com base na finalidade comercial deles. Essa abordagem oferece visibilidade, monitoramento, governança e controle operacional unificados.

Neste guia, mostramos como agrupar serviços e cargas de trabalho em execução em Google Cloud que ainda não estão formalmente definidos como um aplicativo.

Antes de começar

É preciso concluir a configuração inicial do gerenciamento de aplicativos antes de organizar recursos em aplicativos. Esse processo geralmente envolve as seguintes funções e etapas:

Para administradores:
1. Configure o gerenciamento de aplicativos. Configure uma pasta ativada por apps ou um projeto host para atuar como o limite administrativo dos seus aplicativos.
2. Ative as APIs obrigatórias. Ative as APIs para todos os recursos que você pretende usar.
3. Conceda acesso aos usuários. Atribua os papéis apropriados do IAM com base nas responsabilidades do usuário no ciclo de vida do aplicativo.
Para desenvolvedores e operadores:
1. Confirme com seu administrador se a configuração inicial foi concluída.
2. Verifique se você tem os papéis do IAM necessários para as tarefas que quer realizar.
3. Abra a pasta ou o projeto host ativado para apps, dependendo do seu modelo de configuração.

Criar um aplicativo

Crie um aplicativo no App Hub para atuar como um contêiner lógico para seus serviços e cargas de trabalho atuais:

Console

No console do Google Cloud , use o seletor de projetos para escolher o projeto host ou o projeto de gerenciamento da pasta ativada para apps, dependendo do seu modelo de configuração.
Acesse a página Aplicativos no App Hub:

Acesse Aplicativos
Clique em Criar aplicativo.
No painel Escolha a região e o nome do aplicativo, selecione o melhor local para seu aplicativo com base nos requisitos de distribuição geográfica:
- Selecione Regional para criar um aplicativo regional. Em seguida, selecione a região específica do aplicativo com base nas regiões compatíveis com o App Hub.
- Selecione Global para criar um aplicativo global.
Para mais informações sobre o melhor local para seu aplicativo, consulte Aplicativos globais e regionais.

Importante: depois de criar um aplicativo, não é possível mudar o local dele.
Insira o Nome do aplicativo e clique em Continuar.
Opcional: defina os atributos de nível superior do aplicativo para oferecer suporte à capacidade de descoberta e à governança:
- Na seção Adicionar atributos, insira o Nome de exibição.
- Na lista Gravidade, selecione um valor para indicar a importância do aplicativo.
- Na lista Ambiente, selecione um valor para indicar a etapa do ciclo de vida do software.
- Adicione detalhes de dados de contato dos proprietários, incluindo nome de exibição e endereço de e-mail. Os endereços de e-mail precisam ter o formato username@yourdomain, por exemplo, jane-doe@gmail.com.
Clique em Criar.

gcloud

Use a Google Cloud CLI para criar um aplicativo no terminal ou no Cloud Shell:
```
gcloud apphub applications create APPLICATION_NAME \
  --project=PROJECT_ID \
  --scope-type=LOCATION \
  --location=REGION \
  --display-name=DISPLAY_NAME \
  --criticality-type=CRITICALITY \
  --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 APPLICATION_NAME pelo nome do aplicativo. O nome precisa incluir apenas caracteres alfanuméricos minúsculos sem espaços.

Use flags opcionais, como --criticality-type, para definir os atributos de nível superior do aplicativo e apoiar a capacidade de descoberta e a governança.

Para flags obrigatórias e opcionais, substitua o seguinte:
- Obrigatório: PROJECT_ID: o ID do projeto host ou de gerenciamento, dependendo do seu modelo de configuração.
- Obrigatório: LOCATION: o local do seu aplicativo com base nos requisitos de distribuição geográfica. Use um dos seguintes valores:
  - REGIONAL para aplicativos regionais.
  - GLOBAL para aplicativos globais.
  Para mais informações sobre o melhor local para seu aplicativo, consulte Aplicativos globais e regionais.
- Obrigatório: REGION, a região específica do seu aplicativo. Use um dos seguintes valores:
  - Se o local --scope-type do seu aplicativo estiver definido como REGIONAL, especifique um nome de região compatível com o App Hub.
  - Se o local --scope-type do seu aplicativo estiver definido como GLOBAL, use global.
- Opcional: DISPLAY_NAME: o nome de exibição do aplicativo.
- Opcional: CRITICALITY: o nível de importância do aplicativo para suas operações. 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.
Observação: os endereços de e-mail precisam ter o formato username@yourdomain, por exemplo, jane-doe@gmail.com.

Liste os aplicativos no seu projeto:

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

Você vai receber uma saída semelhante a esta:

ID                 DISPLAY_NAME   CREATE_TIME
APPLICATION_NAME   DISPLAY_NAME   2023-10-31T18:33:48

Registrar serviços e cargas de trabalho

Depois de criar um aplicativo, registre nele os serviços e cargas de trabalho atuais:

Console

No console do Google Cloud , use o seletor de projetos para escolher o projeto host ou o projeto de gerenciamento da pasta ativada para apps, dependendo do seu modelo de configuração.
Acesse a página Aplicativos no App Hub:

Acesse Aplicativos
Clique no nome do aplicativo para o qual você quer registrar serviços e cargas de trabalho atuais.
Na página de detalhes do aplicativo, selecione a guia Serviços e cargas de trabalho. Essa guia mostra a lista de recursos que podem ser registrados no aplicativo. Com o App Hub, é possível selecionar recursos compatíveis localizados na hierarquia de recursos como serviços e cargas de trabalho.
Para cada serviço ou carga de trabalho que você quer registrar, faça o seguinte:
1. Na guia Serviços e cargas de trabalho, clique em Registrar serviço/carga de trabalho.
2. Navegue até o painel Selecionar recurso e clique em Procurar para encontrar o serviço ou a carga de trabalho que você quer registrar.
3. Escolha o serviço ou a carga de trabalho e clique em Selecionar.
4. No painel Selecionar recurso, insira um nome para o serviço ou carga de trabalho e clique em Continuar.
5. Opcional: no painel Adicionar atributos, defina os atributos de nível superior do recurso para apoiar a capacidade de descoberta e a governança.
  
  Observação: é possível selecionar valores diferentes para a gravidade e o ambiente do serviço ou da carga de trabalho em relação aos valores definidos para o aplicativo.
6. Clique em Continuar.
7. Opcional: na seção Adicionar proprietários, adicione mais detalhes sobre os proprietários do serviço ou da carga de trabalho.
8. Clique em Registrar.

A guia Serviços e cargas de trabalho mostra o serviço ou a carga de trabalho registrada.

gcloud

Com o App Hub, é possível selecionar recursos compatíveis localizados na hierarquia de recursos como serviços e cargas de trabalho. Use a Google Cloud CLI para listar serviços ou cargas de trabalho que podem ser registradas no aplicativo no seu terminal ou Cloud Shell. Os comandos são um pouco diferentes para serviços e cargas de trabalho:

Registrar serviços

Liste os serviços disponíveis que podem ser registrados em um aplicativo:
```
gcloud apphub discovered-services list \
  --project=PROJECT_ID \
  --location=REGION \
  --filter=FILTER_EXPRESSION
```
Para flags obrigatórias e opcionais, substitua o seguinte:
- Obrigatório: PROJECT_ID: o ID do projeto host ou de gerenciamento, dependendo do seu modelo de configuração.
- Obrigatório: REGION, a região específica do seu serviço com base na sua distribuição geográfica. Use um dos seguintes valores:
  - Se o serviço for regional, especifique o nome da região compatível com o App Hub.
  - Se o serviço for global, use global.
- Opcional: FILTER_EXPRESSION: a expressão de filtro para a flag --filter para mostrar apenas serviços de um projeto especificado ou com uma propriedade específica. Por exemplo:
  - service_properties.gcp_project=projects/PROJECT_ID
  - service_properties.gcp_project=projects/PROJECT_ID AND service_reference.uri~"forwardingRules"
A resposta será semelhante a:
```
ID            SERVICE_REFERENCE                                                                                             SERVICE_PROPERTIES
SERVICE_ID    {'uri': '//compute.googleapis.com/projects/PROJECT_NUMBER/regions/REGION/forwardingRules/forwarding-rule'}    {'gcpProject': 'projects/PROJECT_ID', 'location': 'REGION'}
```
Copie o ID do serviço, SERVICE_ID, da saída.
Registre o serviço no seu aplicativo:
```
gcloud apphub applications services create SERVICE_NAME \
  --project=PROJECT_ID \
  --location=REGION \
  --application=APPLICATION_NAME \
  --discovered-service=projects/PROJECT_ID/locations/REGION/discoveredServices/SERVICE_ID \
  --display-name=SERVICE_DISPLAY_NAME \
  --criticality-type=CRITICALITY \
  --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 que você quer usar para registrar o serviço no aplicativo.

Use flags opcionais, como --criticality-type, para definir os atributos de nível superior do serviço e apoiar a capacidade de descoberta e a governança.

Observação: é possível selecionar valores diferentes para a gravidade e o ambiente do serviço ou da carga de trabalho em relação aos valores definidos para o aplicativo.

Para flags obrigatórias e opcionais, substitua o seguinte:
- Obrigatório: PROJECT_ID: o ID do projeto host ou de gerenciamento, dependendo do seu modelo de configuração.
- Obrigatório: REGION, a região específica do seu serviço com base na sua distribuição geográfica. Use um dos seguintes valores:
  - Se o serviço for regional, especifique o nome da região compatível com o App Hub.
  - Se o serviço for global, use global.
- Obrigatório: APPLICATION_NAME: o nome do aplicativo em que você quer registrar o serviço.
- Obrigatório: SERVICE_ID: o ID do serviço que você copiou da saída anterior.
- Opcional: SERVICE_DISPLAY_NAME: o nome de exibição do seu serviço.
- Opcional: CRITICALITY: o nível de importância do serviço para suas operações. 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.
Observação: os endereços de e-mail precisam ter o formato username@yourdomain, por exemplo, jane-doe@gmail.com.

Liste os serviços registrados no seu aplicativo:

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

Você precisa receber uma saída semelhante à seguinte para cada serviço registrado:

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

Registrar cargas de trabalho

Liste as cargas de trabalho disponíveis que podem ser registradas em um aplicativo:
```
gcloud apphub discovered-workloads list \
  --project=PROJECT_ID \
  --location=REGION \
  --filter=FILTER_EXPRESSION
```
Para flags obrigatórias e opcionais, substitua o seguinte:
- Obrigatório: PROJECT_ID: o ID do projeto host ou de gerenciamento, dependendo do seu modelo de configuração.
- Obrigatório: REGION, a região específica da sua carga de trabalho com base na distribuição geográfica. Use um dos seguintes valores:
  - Se a carga de trabalho for regional, especifique o nome da região compatível com o App Hub.
  - Se a carga de trabalho for global, use global.
- Opcional: FILTER_EXPRESSION: a expressão de filtro para a flag --filter para mostrar apenas cargas de trabalho de um projeto especificado ou com uma propriedade específica, por exemplo, workload_properties.gcp_project=projects/PROJECT_ID.
A resposta será semelhante a:
```
ID             WORKLOAD_REFERENCE                                                                                    WORKLOAD_PROPERTIES
WORKLOAD_ID    {'uri': '//compute.googleapis.com/projects/PROJECT_NUMBER/regions/REGION/instanceGroups/mig-name'}    {'gcpProject': 'projects/PROJECT_ID', 'location': 'REGION'}
```
Copie o ID da carga de trabalho, WORKLOAD_ID, da saída.
Registre a carga de trabalho no seu aplicativo:
```
gcloud apphub applications workloads create WORKLOAD_NAME \
  --project=PROJECT_ID \
  --location=REGION \
  --application=APPLICATION_NAME \
  --discovered-workload=projects/PROJECT_ID/locations/REGION/discoveredWorkloads/WORKLOAD_ID \
  --display-name=WORKLOAD_DISPLAY_NAME \
  --criticality-type=CRITICALITY \
  --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 que você quer usar para registrar a carga de trabalho no aplicativo.

Use flags opcionais, como --criticality-type, para definir os atributos de nível superior da carga de trabalho e apoiar a capacidade de descoberta e a governança.

Observação: é possível selecionar valores diferentes para a gravidade e o ambiente do serviço ou da carga de trabalho em relação aos valores definidos para o aplicativo.

Para flags obrigatórias e opcionais, substitua o seguinte:
- Obrigatório: PROJECT_ID: o ID do projeto host ou de gerenciamento, dependendo do seu modelo de configuração.
- Obrigatório: REGION, a região específica da sua carga de trabalho com base na distribuição geográfica. Use um dos seguintes valores:
  - Se a carga de trabalho for regional, especifique o nome da região compatível com o App Hub.
  - Se a carga de trabalho for global, use global.
- Obrigatório: APPLICATION_NAME: o nome do aplicativo para o qual você quer registrar a carga de trabalho.
- Obrigatório: WORKLOAD_ID: o ID da carga de trabalho copiado da saída anterior.
- Opcional: WORKLOAD_DISPLAY_NAME: o nome de exibição da sua carga de trabalho.
- Opcional: CRITICALITY: o nível de importância da carga de trabalho para suas operações. 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.
Observação: os endereços de e-mail precisam ter o formato username@yourdomain, por exemplo, jane-doe@gmail.com.

Liste as cargas de trabalho registradas no seu aplicativo:

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

Você precisa receber uma saída semelhante à seguinte para cada carga de trabalho registrada:

ID               DISPLAY_NAME             WORKLOAD_REFERENCE                                                                                    CREATE_TIME
WORKLOAD_NAME    WORKLOAD_DISPLAY_NAME    {'uri': '//compute.googleapis.com/projects/PROJECT_NUMBER/regions/REGION/instanceGroups/mig-name'}    2023-11-01T21:38:08

Conceder permissões e iniciar operações

Depois de criar um aplicativo e registrar seus recursos no App Hub, conceda acesso aos usuários com base nas responsabilidades e gerencie esse agrupamento lógico como uma única unidade:

Dependendo das suas necessidades de acesso, você pode conceder permissões ao aplicativo. Para ver uma lista de funções recomendadas, consulte Conceder funções centradas em aplicativos aos usuários.
Acesse o Cloud Hub para conferir um painel operacional unificado do aplicativo definido, incluindo dados de integridade, desempenho e custo.

Registrar recursos atuais em um aplicativo Mantenha tudo organizado com as coleções Salve e categorize o conteúdo com base nas suas preferências.

Antes de começar

Criar um aplicativo

Console

gcloud

Registrar serviços e cargas de trabalho

Console

gcloud

Registrar serviços

Registrar cargas de trabalho

Conceder permissões e iniciar operações

Registrar recursos atuais em um aplicativo