Registe recursos existentes numa aplicação

Consola

1. Na Google Cloud consola, use o seletor de projetos para selecionar o seu projeto de gestão.

2. Aceda à página Aplicações a partir do App Hub:

   Aceda a Aplicações

3. Clique em add Criar aplicação.

4. No separador Detalhes da aplicação, selecione a melhor localização para a sua aplicação com base nos requisitos de distribuição geográfica:

   • Selecione Global para criar uma aplicação global.
   • Selecione Regional para criar uma aplicação regional. Em seguida, selecione a região específica da sua aplicação com base nas regiões suportadas pelo App Hub.

   Para mais informações sobre a melhor localização para a sua aplicação, consulte o artigo Aplicações globais e regionais.

5. Introduza um nome para a sua aplicação.

   Este nome é um identificador exclusivo que só pode conter letras minúsculas, números ou hífens. Não pode alterar este nome depois de criar a aplicação.

6. Opcionalmente, adicione um nome a apresentar e uma descrição para a aplicação.

   Estes não são identificadores exclusivos e pode alterá-los depois de criar a aplicação.

7. Clique em Continuar.

8. No separador Recursos da aplicação, procure os recursos de infraestrutura e selecione as caixas de verificação dos recursos que quer registar como serviços e cargas de trabalho da aplicação.

   Pode selecionar até 10 recursos de cada vez.

9. Clique em Continuar.

10. No separador Atributos e proprietários, pode adicionar atributos para a aplicação, como criticidade, ambiente e proprietários da aplicação.

    Pode optar por usar os mesmos atributos e proprietários para os recursos que está a registar na aplicação ou defini-los mais tarde.

11. Clique em Criar.

Quando a aplicação é criada, a página Aplicações apresenta os respetivos detalhes, incluindo os recursos que registou como serviços e cargas de trabalho. Depois de criar a aplicação, pode registar mais serviços e cargas de trabalho na mesma.

gcloud

1. Use a CLI do Google Cloud para criar uma aplicação a partir do terminal ou do 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 da sua aplicação. Este nome é um identificador exclusivo que só pode conter letras minúsculas, números ou hífenes.

   Use flags opcionais, como --criticality-type, para definir os atributos de nível superior da aplicação e suportar a capacidade de descoberta e a governação.

   Para as flags obrigatórias e opcionais, substitua o seguinte:

   • Obrigatório: PROJECT_ID: o ID do projeto de gestão.

   • Obrigatório: LOCATION: a localização da sua aplicação com base nos requisitos de distribuição geográfica. Use um dos seguintes valores:

     • REGIONAL para candidaturas regionais.
     • GLOBAL para candidaturas globais.

     Para mais informações sobre a melhor localização para a sua aplicação, consulte o artigo Aplicações globais e regionais.

   • Obrigatório: REGION: a região específica da sua aplicação. Use um dos seguintes valores:

     • Se a --scope-typelocalização da sua aplicação estiver definida como REGIONAL, especifique um nome de região suportado pelo App Hub.
     • Se a localização --scope-type da sua aplicação estiver definida como GLOBAL, use global.

   • Opcional: DISPLAY_NAME: o nome a apresentar da sua aplicação. O nome a apresentar não é um identificador exclusivo e pode alterá-lo depois de criar a aplicação.

   • Opcional: CRITICALITY: o nível de importância da aplicação para as suas operações. Use um dos seguintes valores:

     • MISSION_CRITICAL
     • HIGH
     • MEDIUM
     • LOW

   • Opcional: ENVIRONMENT: a fase do ciclo de vida do software. Use um dos seguintes valores:

     • PRODUCTION
     • STAGING
     • DEVELOPMENT
     • TEST

   • Opcional: DEV_NAME e DEV_EMAIL: o nome a apresentar e o endereço de email do proprietário programador, respetivamente.

   • Opcional: OPERATOR_NAME e OPERATOR_EMAIL: o nome a apresentar e o endereço de email do proprietário do operador, respetivamente.

   • Opcional: BUSINESS_NAME e BUSINESS_EMAIL: o nome a apresentar e o endereço de email do proprietário da empresa, respetivamente.

2. Liste as aplicações no seu projeto:

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

   Tem de obter um resultado semelhante ao seguinte:

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

Terraform

Para criar uma aplicação com o Terraform, use o recurso google_apphub_application. Este recurso permite-lhe definir as propriedades da aplicação, incluindo o respetivo nome, localização e atributos.

O exemplo seguinte cria uma aplicação regional em us-central1 com atributos de criticidade, ambiente e proprietário definidos:

resource "google_apphub_application" "example" {
    project        = "my-project-id"
    location       = "us-central1"
    application_id = "my-application"
    display_name   = "My Application"
    description    = "This application represents our platform."
    scope {
        type = "REGIONAL"
    }
    attributes {
        criticality {
            type = "MISSION_CRITICAL"
        }
        environment {
            type = "PRODUCTION"
        }
        business_owners {
            display_name = "Alice"
            email        = "alice@example.com"
        }
        developer_owners {
            display_name = "Bob"
            email        = "bob@example.com"
        }
        operator_owners {
            display_name = "Charlie"
            email        = "charlie@example.com"
        }
    }
}

Consola

Depois de criar uma aplicação, pode registar vários recursos na mesma:

1. Na Google Cloud consola, use o seletor de projetos para selecionar o seu projeto de gestão.

2. Aceda à página Aplicações a partir do App Hub:

   Aceda a Aplicações

3. Clique no nome da aplicação para a qual quer registar Google Cloud recursos.

4. Na página da aplicação, selecione o separador Serviços e cargas de trabalho.

5. Clique em add Registar serviços ou cargas de trabalho.

6. No separador Serviços e cargas de trabalho, procure os recursos de infraestrutura e selecione as caixas de verificação dos recursos que quer registar como serviços ou cargas de trabalho da aplicação.

   Pode selecionar até 10 recursos de cada vez.

7. Clique em Continuar.

8. No separador Atributos e proprietários, pode adicionar atributos para estes recursos, como criticidade, ambiente e proprietários de recursos.

   Pode optar por usar os mesmos atributos e proprietários da aplicação ou definir atributos diferentes mais tarde.

9. Clique em Registar.

O separador Serviços e cargas de trabalho apresenta todos os serviços e cargas de trabalho registados da aplicação.

gcloud

O App Hub permite-lhe selecionar recursos suportados localizados no limite de gestão da sua aplicação como serviços ou cargas de trabalho. Use a CLI do Google Cloud para listar os serviços ou as cargas de trabalho que pode registar na aplicação a partir do terminal ou do Cloud Shell. Os comandos são ligeiramente diferentes para serviços e cargas de trabalho: