Registra le risorse esistenti in un'applicazione

Console

1. Nella console Google Cloud , utilizza il selettore di progetti per selezionare il progetto di gestione.

2. Vai alla pagina Applicazioni da App Hub:

   Vai a Applicazioni

3. Fai clic su add Crea applicazione.

4. Nella scheda Dettagli applicazione, seleziona la posizione migliore per la tua applicazione in base ai requisiti di distribuzione geografica:

   • Seleziona Globale per creare un'applicazione globale.
   • Seleziona Regionale per creare un'applicazione regionale. Poi, seleziona la regione specifica per la tua applicazione in base alle regioni supportate da App Hub.

   Per saperne di più sulla posizione migliore per la tua applicazione, consulta Applicazioni globali e regionali.

5. Inserisci un nome per l'applicazione.

   Questo nome è un identificatore univoco che può contenere solo lettere minuscole, numeri o trattini. Non puoi modificare questo nome dopo aver creato l'applicazione.

6. Se vuoi, aggiungi un nome visualizzato e una descrizione per l'applicazione.

   Non sono identificatori unici e puoi modificarli dopo aver creato l'applicazione.

7. Fai clic su Continua.

8. Nella scheda Risorse applicazione, sfoglia le risorse dell'infrastruttura e seleziona le caselle di controllo delle risorse che vuoi registrare come servizi e workload dell'applicazione.

   Puoi selezionare fino a 10 risorse alla volta.

9. Fai clic su Continua.

10. Nella scheda Attributi e proprietari, puoi aggiungere attributi per l'applicazione, come criticità, ambiente e proprietari dell'applicazione.

    Puoi scegliere di utilizzare gli stessi attributi e proprietari per le risorse che stai registrando nell'applicazione oppure definirli in un secondo momento.

11. Fai clic su Crea.

Una volta creata l'applicazione, la pagina Applicazioni mostra i relativi dettagli, incluse le risorse registrate come servizi e workload. Dopo aver creato l'applicazione, puoi registrare altri servizi e workload.

gcloud

1. Utilizza Google Cloud CLI per creare un'applicazione dal terminale o da 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
   

   Sostituisci APPLICATION_NAME con il nome della tua applicazione. Questo nome è un identificatore univoco che può contenere solo lettere minuscole, numeri o trattini.

   Utilizza flag facoltativi come --criticality-type per definire gli attributi di primo livello dell'applicazione e supportare la rilevabilità e la governance.

   Per i flag obbligatori e facoltativi, sostituisci quanto segue:

   • Obbligatorio: PROJECT_ID: l'ID del progetto di gestione.

   • Obbligatorio: LOCATION: la posizione della tua applicazione in base ai requisiti di distribuzione geografica. Utilizza uno dei seguenti valori:

     • REGIONAL per le applicazioni regionali.
     • GLOBAL per le applicazioni globali.

     Per saperne di più sulla posizione migliore per la tua applicazione, consulta Applicazioni globali e regionali.

   • Obbligatorio: REGION: la regione specifica per la tua applicazione. Utilizza uno dei seguenti valori:

     • Se la località --scope-type per la tua applicazione è impostata su REGIONAL, specifica un nome di regione supportato da App Hub.
     • Se la posizione --scope-type per la tua applicazione è impostata su GLOBAL, utilizza global.

   • (Facoltativo) DISPLAY_NAME: il nome visualizzato della tua applicazione. Il nome visualizzato non è un identificatore univoco e puoi modificarlo dopo aver creato l'applicazione.

   • (Facoltativo) CRITICALITY: il livello di importanza dell'applicazione per le tue operazioni. Utilizza uno dei seguenti valori:

     • MISSION_CRITICAL
     • HIGH
     • MEDIUM
     • LOW

   • (Facoltativo) ENVIRONMENT: la fase del ciclo di vita del software. Utilizza uno dei seguenti valori:

     • PRODUCTION
     • STAGING
     • DEVELOPMENT
     • TEST

   • (Facoltativo) DEV_NAME e DEV_EMAIL: il nome visualizzato e l'indirizzo email del proprietario dello sviluppatore, rispettivamente.

   • (Facoltativo) OPERATOR_NAME e OPERATOR_EMAIL: il nome visualizzato e l'indirizzo email del proprietario dell'operatore, rispettivamente.

   • (Facoltativo) BUSINESS_NAME e BUSINESS_EMAIL: il nome visualizzato e l'indirizzo email del proprietario dell'attività, rispettivamente.

2. Elenca le applicazioni nel tuo progetto:

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

   Devi ottenere un output simile al seguente:

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

Terraform

Per creare un'applicazione con Terraform, utilizza la risorsa google_apphub_application. Questa risorsa consente di definire le proprietà dell'applicazione, inclusi nome, posizione e attributi.

L'esempio seguente crea un'applicazione regionale in us-central1 con attributi di criticità, ambiente e proprietario definiti:

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        = "[email protected]"
        }
        developer_owners {
            display_name = "Bob"
            email        = "[email protected]"
        }
        operator_owners {
            display_name = "Charlie"
            email        = "[email protected]"
        }
    }
}

Console

Dopo aver creato un'applicazione, puoi registrarvi più risorse:

1. Nella console Google Cloud , utilizza il selettore di progetti per selezionare il progetto di gestione.

2. Vai alla pagina Applicazioni da App Hub:

   Vai a Applicazioni

3. Fai clic sul nome dell'applicazione per cui vuoi registrare Google Cloud le risorse.

4. Nella pagina dell'applicazione, seleziona la scheda Servizi e carichi di lavoro.

5. Fai clic su add Registra servizi o workload.

6. Nella scheda Servizi e carichi di lavoro, sfoglia le risorse dell'infrastruttura e seleziona le caselle di controllo delle risorse che vuoi registrare come servizi o carichi di lavoro dell'applicazione.

   Puoi selezionare fino a 10 risorse alla volta.

7. Fai clic su Continua.

8. Nella scheda Attributi e proprietari, puoi aggiungere attributi per queste risorse, come criticità, ambiente e proprietari delle risorse.

   Puoi scegliere di utilizzare gli stessi attributi e proprietari dell'applicazione o definire attributi diversi in un secondo momento.

9. Fai clic su Register (Registrati).

La scheda Servizi e carichi di lavoro mostra tutti i servizi e i carichi di lavoro registrati dell'applicazione.

gcloud

App Hub ti consente di selezionare risorse supportate che si trovano all'interno del limite di gestione delle applicazioni come servizi o carichi di lavoro. Utilizza Google Cloud CLI per elencare i servizi o i carichi di lavoro che puoi registrare nell'applicazione dal terminale o da Cloud Shell. I comandi sono leggermente diversi per servizi e carichi di lavoro:

Terraform

Per utilizzare Terraform per registrare le risorse Google Cloud all'interno del limite di gestione delle applicazioni come servizi o workload in un'applicazione, utilizza le origini dati google_apphub_discovered_service e google_apphub_discovered_workload per recuperare dinamicamente le informazioni sulle risorse che vuoi registrare.

Quindi, utilizza le risorse google_apphub_service o google_apphub_workload per registrare rispettivamente servizi o workload.