Creare un'applicazione App Hub utilizzando un singolo progetto


Questo tutorial mostra come configurare un'applicazione App Hub in un singolo progetto. In un progetto host App Hub che funge da di servizio, esegui il deployment di un gruppo di istanze gestite con bilanciamento del carico. Poi, in un'applicazione sul progetto host App Hub, registri e per monitorare tutte le risorse di infrastruttura del progetto di servizio Servizi e carichi di lavoro di App Hub.

Questo tutorial è rivolto a chi configura e amministra App Hub. Dovresti avere una certa esperienza con Cloud Load Balancing.

Obiettivi

Questo tutorial mostra come completare le seguenti attività:

  1. Crea o seleziona un progetto Google Cloud. Questo progetto è il tuo Progetto host App Hub.
  2. Nel progetto host, utilizza Terraform per eseguire il deployment di una rete VPC, un bilanciatore del carico delle applicazioni esterno regionale e un backend MIG per il bilanciatore del carico. Il bilanciatore del carico delle applicazioni esterno regionale include le seguenti risorse:

    • Controllo di integrità HTTP
    • Regola di forwarding
    • Mappa URL
    • Proxy di destinazione
    • Servizio di backend con un gruppo di istanze gestite come backend
    • Certificato SSL (per HTTPS)

    Solo la regola di forwarding, la mappa URL, il servizio di backend e il gruppo di istanze gestite diventano disponibili come scoprito di risorse su App Hub. Per ulteriori informazioni, vedi concetti e modello dei dati.

  3. Fornisci i ruoli e le autorizzazioni appropriati per il progetto host.

  4. Collega il progetto host App Hub come progetto di servizio.

  5. Creare un'applicazione nel progetto host App Hub.

  6. Scopri le risorse dell'infrastruttura come servizi App Hub carichi di lavoro con scale out impegnativi.

  7. Registra i servizi e un carico di lavoro dal progetto di servizio nel applicazioni e assegnare gli attributi.

  8. Visualizza i dettagli dei servizi e dei carichi di lavoro registrati su App Hub.

Costi

Per una stima del costo delle risorse Google Cloud che per gli utilizzi di soluzioni VM gestite con bilanciamento del carico, consulta la stima precalcolata nel Calcolatore prezzi di Google Cloud.

Utilizza questa stima come punto di partenza per calcolare il costo del deployment. Puoi modificare la stima in base alle modifiche di configurazione che prevedi di apportare alle risorse utilizzate nella soluzione.

La stima precalcolata si basa su ipotesi relative a determinati fattori, tra cui:

  • Le località Google Cloud in cui viene eseguito il deployment delle risorse.
  • La quantità di tempo di utilizzo delle risorse.

Per ulteriori informazioni sui costi di App Hub, consulta la pagina Prezzi.

Prima di iniziare

Se sei l'autore del progetto, puoi ricevere ruolo Proprietario di base (roles/owner). Per impostazione predefinita, questo ruolo IAM (Identity and Access Management) include le autorizzazioni necessarie per l'accesso completo alla maggior parte dei servizi Google Cloud Google Cloud.

Se non sei il creator del progetto, le autorizzazioni richieste devono essere concesse al principale appropriato. Ad esempio, un'entità può essere un Account Google (per gli utenti finali) o un account di servizio (per le applicazioni e i carichi di lavoro).

Per ottenere le autorizzazioni necessarie per completare questo tutorial, chiedi all'amministratore di concederti i seguenti ruoli IAM nel progetto:

Per saperne di più sulla concessione dei ruoli, consulta Gestire l'accesso a progetti, cartelle e organizzazioni.

Potresti anche riuscire a ottenere le autorizzazioni richieste tramite i ruoli personalizzati o altri ruoli predefiniti.

Console

  1. Nella console Google Cloud, vai alla pagina di selezione del progetto.

    Vai al selettore progetti

  2. Seleziona o crea un progetto Google Cloud, che sarà il progetto host di App Hub.

  3. Enable the required APIs.

    Enable the APIs

gcloud

  1. In the Google Cloud console, activate Cloud Shell.

    Activate Cloud Shell

    At the bottom of the Google Cloud console, a Cloud Shell session starts and displays a command-line prompt. Cloud Shell is a shell environment with the Google Cloud CLI already installed and with values already set for your current project. It can take a few seconds for the session to initialize.

  2. Assicurati che sia installata la versione più recente di Google Cloud CLI. Esegui il seguente comando da Cloud Shell:

      gcloud components update

  3. Crea o seleziona un nuovo progetto,HOST_PROJECT_ID, da utilizzare come progetto host per App Hub.

    • Crea un progetto Google Cloud:

      gcloud projects create HOST_PROJECT_ID
    • Seleziona il progetto Google Cloud che hai creato:

      gcloud config set project HOST_PROJECT_ID
  4. Abilita le API:

    gcloud services enable apphub.googleapis.com \
       cloudresourcemanager.googleapis.com \
       compute.googleapis.com \
       config.googleapis.com \
       serviceusage.googleapis.com

preparazione dell'ambiente

Per aiutarti a eseguire il deployment di questa soluzione con il minimo sforzo, su GitHub è disponibile una configurazione Terraform. La configurazione di Terraform definisce Le risorse Google Cloud necessarie per la soluzione. Scarica la configurazione Terraform da GitHub, personalizza facoltativamente il codice in base alle esigenze e poi esegui il deployment della soluzione utilizzando Terraform CLI. Dopo aver eseguito il deployment della soluzione, puoi continuare a utilizzare Terraform per gestirla.

Carichi di lavoro e servizi di App Hub con un bilanciatore del carico e un gruppo di istanze gestite.
Figura 1. Carichi di lavoro e servizi App Hub con un bilanciatore del carico e un gruppo di istanze gestite.

Di seguito è riportato il flusso di elaborazione delle richieste della topologia di cui viene eseguito il deployment dalla soluzione di VM gestite con bilanciamento del carico.

  1. L'utente invia una richiesta all'applicazione di cui è stato eseguito il deployment su Compute Engine. Cloud Load Balancing riceve questa richiesta.

  2. Cloud Load Balancing instrada il traffico ai gruppi di istanze gestite di Compute Engine utilizzando le informazioni nella regola di inoltro, nella mappa URL e nel servizio di backend.

Configura il client Terraform

Puoi eseguire Terraform in Cloud Shell o sul tuo host locale. Questo descrive come eseguire Terraform in Cloud Shell, Terraform è preinstallato e configurato per l'autenticazione con Google Cloud.

Il codice Terraform per questa soluzione è disponibile in un repository GitHub.

  1. In Cloud Shell, clona il repository GitHub in Cloud Shell.

    git clone https://github.com/terraform-google-modules/terraform-docs-samples
    
  2. In Cloud Shell, controlla se la directory di lavoro attuale è terraform-docs-samples/lb/regional_external_http_load_balancer. Questa è la directory che contiene i file di configurazione Terraform per la soluzione. Se devi passare a questa directory, esegui il seguente comando:

    cd terraform-docs-samples/lb/regional_external_http_load_balancer 
    
  3. Inizializza Terraform eseguendo il seguente comando:

    terraform init
    

    Attendi finché non viene visualizzato il seguente messaggio:

    Terraform has been successfully initialized!
    

Convalida e rivedi la configurazione di Terraform

  1. Assicurati che la directory di lavoro attuale sia terraform-docs-samples/lb/regional_external_http_load_balancer. Se non lo è, vai a quella directory.

  2. Verifica che la configurazione Terraform non contenga errori:

    terraform validate
    

    Se il comando restituisce errori, apporta le correzioni necessarie nella configurazione ed esegui di nuovo il comando terraform validate. Ripeti questo passaggio finché il comando non restituisce il seguente messaggio:

    Success! The configuration is valid.
    
  3. Esamina le risorse definite nella configurazione:

    terraform plan
    

    L'output del comando terraform plan è un elenco delle risorse di cui Terraform esegue il provisioning quando applichi la configurazione.

    Se vuoi apportare modifiche, modifica la configurazione ed esegui di nuovo i comandi terraform validate e terraform plan.

Esegui il provisioning delle risorse

Quando non sono necessarie ulteriori modifiche alla configurazione Terraform, esegui il deployment le risorse.

  1. Assicurati che la directory di lavoro attuale sia terraform-docs-samples/lb/regional_external_http_load_balancer. Se non lo è, vai a quella directory.

  2. Applica la configurazione Terraform:

    terraform apply
    

    Terraform mostra un elenco delle risorse che verranno create.

  3. Quando ti viene chiesto di eseguire le azioni, inserisci yes.

    Terraform visualizza dei messaggi che mostrano l'avanzamento del deployment.

    Se il deployment non può essere completato, Terraform visualizza gli errori che ha causato l'errore. Esamina i messaggi di errore e aggiorna la configurazione per correggere gli errori. Quindi esegui di nuovo il comando terraform apply.

    Al termine della creazione di tutte le risorse, Terraform visualizza quanto segue messaggio:

    Apply complete!
    

Attendi finché Terraform non visualizzi il messaggio "Applicazione completata!". per creare un nuovo messaggio email.

Il bilanciamento del carico Cloud distribuisce il traffico alla regola di inoltro, alla mappa URL, al servizio di backend e a un gruppo di istanze gestite Compute Engine. Il backend servizio, mappa URL e regole di forwarding diventano rilevati nel progetto host App Hub. La Il gruppo di istanze gestite di Compute Engine diventa un carico di lavoro rilevato Progetto host App Hub.

Quando la soluzione non ti serve più, puoi eliminare il deployment per evitare e la fatturazione continua per le risorse Google Cloud. Per ulteriori informazioni, vedi Elimina il deployment.

Concedi autorizzazioni IAM

Fornisci i ruoli e le autorizzazioni IAM appropriati Progetto host App Hub.

Console

  1. Per ottenere le autorizzazioni necessarie per completare questo tutorial, chiedi all'amministratore di concederti i ruoli IAM richiesti nel progetto:

    1. Nella console Google Cloud, vai alla pagina IAM.

      Vai a IAM

    2. Fai clic su Concedi l'accesso. Viene visualizzato il riquadro Concedi l'accesso.

    3. Nel campo Nuove entità, inserisci l'indirizzo email della persona che amministrerà App Hub, ovvero il ruolo Amministratore App Hub nel progetto host.

    4. Fai clic su Seleziona un ruolo e nel campo Filtro inserisci App Hub.

    5. Seleziona il ruolo Amministratore App Hub.

    6. Fai clic su Aggiungi un altro ruolo e dall'elenco Seleziona un ruolo, seleziona Visualizzatore monitoraggio.

    7. Fai clic su Salva.

gcloud

  1. Per concedere i ruoli alle persone che utilizzeranno App Hub, ripeti questo comando sostituendo il i ruoli IAM, se richiesto. Per ulteriori informazioni, vedi Ruoli e autorizzazioni di App Hub.

    gcloud projects add-iam-policy-binding HOST_PROJECT_ID \
        --member='user:HOST_PROJECT_ADMIN' \
        --role='roles/apphub.admin'

    Sostituisci HOST_PROJECT_ADMIN con l'utente che ha il ruolo Amministratore App Hub nel progetto host. Questo valore ha il formato username@yourdomain, ad esempio 222larabrown@gmail.com.

  2. Concedi il ruolo Amministratore di App Hub nel progetto di servizio alle persone che amministrano App Hub. Deve disporre del ruolo di amministratore di App Hub per aggiungere progetti di servizio al progetto host. È necessaria almeno una persona con questo ruolo per ogni servizio progetto. In questo esempio, il progetto host funge da progetto di servizio.

    gcloud projects add-iam-policy-binding SERVICE_PROJECT_ID \
       --member='user:HOST_PROJECT_ADMIN' \
       --role='roles/apphub.admin'

    Sostituisci SERVICE_PROJECT_ID con il nome del HOST_PROJECT_ID.

  3. Concedi il ruolo Visualizzatore Monitoring nel progetto host all' persone che gestiscono App Hub. Per visualizzare le metriche, deve disporre del ruolo Visualizzatore monitoraggio nel progetto host.

    gcloud projects add-iam-policy-binding SERVICE_PROJECT_ID \
       --member='user:HOST_PROJECT_ADMIN' \
       --role='roles/monitoring.viewer'

Collega un progetto di servizio

Collega il progetto host su cui hai eseguito il deployment delle risorse come progetto di servizio.

Console

  1. Nella console Google Cloud, vai alle Impostazioni di App Hub .

    Vai alle impostazioni

  2. Nella pagina Impostazioni, fai clic su Collega progetti.

  3. Nel riquadro che si apre, cerca i progetti nell'elenco visualizzato e seleziona le caselle di controllo per i progetti di servizi App Hub.

  4. Fai clic su Seleziona. La tabella Progetti di servizio collegati mostra il progetto host selezionato come progetto di servizio.

  5. Fai clic su Chiudi.

gcloud

Aggiungi il progetto host come progetto di servizio all'App Hub progetto host.

gcloud apphub service-projects add HOST_PROJECT_ID \
  --project=HOST_PROJECT_ID

Crea un'applicazione

Crea un'applicazione da utilizzare come container dei tuoi servizi e carichi di lavoro.

Console

  1. Assicurati di essere nel progetto host App Hub.
  2. Nella console Google Cloud, vai alla pagina Applications (Applicazioni) di App Hub.

    Vai a Applicazioni

  3. Fai clic su Crea applicazione.

  4. Nella pagina Crea applicazione, seleziona Regionale nel riquadro Scegli la regione e il nome dell'applicazione.

  5. Nell'elenco Regione, seleziona us-west1.

  6. Nel campo Nome applicazione, inserisci tutorial-application.

  7. Inserisci un Nome visualizzato, Tutorial e fai clic su Continua.

  8. Nel riquadro Aggiungi attributi, dall'elenco Criticità, seleziona Alto. La criticità indica quanto sono critici un'applicazione, un servizio o carico di lavoro è alle tue operazioni aziendali.

  9. Nel campo Ambiente, per indicare la fase del software del ciclo di vita, seleziona Produzione.

  10. Fai clic su Continua.

  11. Nel riquadro Aggiungi proprietari, aggiungi i seguenti dettagli per Proprietari sviluppatori, Proprietari operatori e Proprietari di attività. Tieni presente che devi inserire l'indirizzo email del proprietario se aggiungi un nome visualizzato.

    1. Inserisci il nome visualizzato del proprietario.
    2. Inserisci l'indirizzo email del proprietario. Questo valore deve avere nel formato username@yourdomain, ad esempio 222larabrown@gmail.com.
  12. Ripeti questi passaggi per ogni sviluppatore, operatore e proprietario dell'attività.

  13. Fai clic su Crea.

La nuova applicazione viene creata ed è elencata nella pagina Applicazioni.

gcloud

  1. Seleziona il progetto host App Hub che hai creato:

    gcloud config set project HOST_PROJECT_ID
  2. Crea una nuova applicazione denominata tutorial-application nella regione us-west1 e assegnargli un nome visualizzato, Tutorial:

    gcloud apphub applications create tutorial-application \
        --display-name='Tutorial' \
        --scope-type=REGIONAL \
        --project=HOST_PROJECT_ID \
        --location=us-west1
    
  3. Elenca le applicazioni nel tuo progetto host App Hub:

    gcloud apphub applications list \
        --project=HOST_PROJECT_ID \
        --location=us-west1
    

    Verrà visualizzato un output simile al seguente:

    ID                    DISPLAY_NAME  CREATE_TIME
    tutorial-application  Tutorial      2023-10-31T18:33:48
    
  4. Aggiorna l'applicazione con criticality-type, environment-type, e gli attributi del proprietario:

    gcloud apphub applications update tutorial-application \
      --criticality-type='HIGH' \
      --environment-type='PRODUCTION' \
      --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=HOST_PROJECT_ID \
      --location=us-west1
    

    Sostituisci quanto segue:

    • DISPLAY-NAME-DEVELOPER, DISPLAY-NAME-OPERATOR e DISPLAY-NAME-BUSINESS: i nomi visualizzati dei sviluppatore, operatore e proprietari dell'attività.
    • EMAIL-NAME-DEVELOPER, EMAIL-NAME-OPERATOR e EMAIL-NAME-BUSINESS: indirizzi email dello sviluppatore, dell'operatore e dei proprietari dell'attività, rispettivamente. Questi valori devono avere il formato username@yourdomain, ad esempio 222larabrown@gmail.com.

    Note:

    • criticality-type: indica quanto è critica un'applicazione, o carico di lavoro è alle tue operazioni aziendali.
    • environment-type: indica le fasi del ciclo di vita del software.
  5. Visualizza i dettagli dell'applicazione che hai creato:

    gcloud apphub applications describe tutorial-application \
      --project=HOST_PROJECT_ID \
      --location=us-west1
    

    Il comando restituisce informazioni in formato YAML, simili al seguente:

    attributes:
    businessOwners:
    – displayName: [DISPLAY-NAME-BUSINESS]
      email: [EMAIL-BUSINESS]
    criticality:
      type: HIGH
    developerOwners:
    – displayName: [DISPLAY-NAME-DEVELOPER]
      email: [EMAIL-DEVELOPER]
    environment:
      type: PRODUCTION
    operatorOwners:
    – displayName: [DISPLAY-NAME-OPERATOR]
      email: [EMAIL-OPERATOR]
    createTime: '2023-10-31T18:33:48.199394108Z'
    displayName: Tutorial
    name: projects/HOST_PROJECT_ID/locations/us-west1/applications/tutorial-application
    scope:
      type: REGIONAL
    state: ACTIVE
    uid: 9d991a9d-5d8a-4c0d-b5fd-85e39fb58c73
    updateTime: '2023-10-31T18:33:48.343303819Z'
    

Registra i servizi e un carico di lavoro

La registrazione di servizi e carichi di lavoro li aggiunge a un'applicazione.

Console

  1. Nella console Google Cloud, vai alla pagina Applications (Applicazioni) di App Hub.

    Vai a Applicazioni

  2. Fai clic sul nome della tua applicazione, Tutorial. La scheda Servizi e carichi di lavoro mostra un elenco di servizi e carichi di lavoro registrati nei progetti di servizi App Hub.

  3. Registra un servizio:

    1. Nella scheda Servizi e carichi di lavoro, fai clic su Registra servizio/carico di lavoro.
    2. Nella pagina Registra servizio o carico di lavoro, nel riquadro Seleziona risorsa, fai clic su Sfoglia per selezionare il servizio o il carico di lavoro come Risorsa.
    3. Nel riquadro Seleziona risorsa, scegli il Nome della risorsa service, l7-xlb-backend-service, quindi fai clic su Seleziona.
    4. Nel riquadro Seleziona risorsa, inserisci il nome della risorsa. tutorial-service-backend.
    5. Inserisci un nome visualizzato, Backend service e fai clic su Continua.
    6. Nel riquadro Aggiungi attributi, nell'elenco Criticità, per indica l'importanza dell'applicazione, seleziona Alta.
    7. Nel campo Ambiente, per indicare la fase del ciclo di vita del software, seleziona Produzione.
    8. Fai clic su Continua.
    9. Nel riquadro Aggiungi proprietari, aggiungi i seguenti dettagli come necessario per Proprietari sviluppatori, Proprietari operatori e Proprietari di attività. Tieni presente che devi inserire l'indirizzo email del proprietario se aggiungi un nome visualizzato.
      1. Inserisci il nome visualizzato del proprietario.
      2. Inserisci l'indirizzo email del proprietario. Questo valore deve avere nel formato username@yourdomain, ad esempio 222larabrown@gmail.com.
    10. Ripeti questi passaggi per ogni sviluppatore, operatore e proprietario dell'attività.
    11. Fai clic su Registrati.

    Nella scheda Servizi e carichi di lavoro, nella sezione Servizi e carichi di lavoro registrati, puoi vedere il nuovo servizio aggiunto.

  4. Ripeti i passaggi precedenti per registrare gli altri servizi come tutorial-service-forwarding-rule e tutorial-service-url-map, rispettivamente.

  5. Registra un carico di lavoro ripetendo i passaggi precedenti per registrare un servizio con le seguenti eccezioni:

    1. Nel riquadro Registra servizio o carico di lavoro, nella sezione Scegli servizio o carico di lavoro, seleziona il Nome del carico di lavoro, l7-xlb-backend-example, e fai clic su Continua.
    2. Nel riquadro Seleziona risorsa, inserisci il nome della risorsa. tutorial-workload-mig.
    3. Inserisci un nome visualizzato, Workload instance group e fai clic su Continua. Nella scheda Servizi e carichi di lavoro, nel Servizi e carichi di lavoro registrati, puoi vedere il nuovo carico di lavoro aggiunto.

gcloud

  1. Aggiungi una persona con autorizzazioni di editor dell'hub di app:

    gcloud projects add-iam-policy-binding HOST_PROJECT_ID \
      --member='user:APP_HUB_EDITOR' \
      --role='roles/apphub.editor'
    

    Sostituisci APP_HUB_EDITOR con l'utente che ha il ruolo Editor di App Hub nel progetto dell'host di App Hub. Questo valore ha il formato username@yourdomain, ad esempio 222larabrown@gmail.com.

  2. Elenca tutti i servizi rilevati nel progetto host App Hub. Questo comando restituisce i servizi che possono essere registrati in un un'applicazione.

    gcloud apphub discovered-services list \
        --project=HOST_PROJECT_ID \
        --location=us-west1
    

    Viene visualizzato un output simile al seguente:

    ID                             SERVICE_REFERENCE                                                                                                              SERVICE_PROPERTIES
    BACKEND_SERVICE_ID          {'uri': '//compute.googleapis.com/projects/[SERVICE_PROJECT_NUMBER]/regions/us-west1/backendServices/l7-xlb-backend-service'}  {'gcpProject': 'projects/SERVICE_PROJECT_ID', 'location': 'us-west1'}
    FORWARDING_RULE_SERVICE_ID" {'uri': '//compute.googleapis.com/projects/[SERVICE_PROJECT_NUMBER]/regions/us-west1/forwardingRules/l7-xlb-forwarding-rule'}  {'gcpProject': 'projects/SERVICE_PROJECT_ID', 'location': 'us-west1'}
    URL_MAP_SERVICE_ID          {'uri': '//compute.googleapis.com/projects/[SERVICE_PROJECT_NUMBER]/regions/us-west1/urlMaps/regional-l7-xlb-map'}             {'gcpProject': 'projects/SERVICE_PROJECT_ID', 'location': 'us-west1'}
    

    Copia il servizio IDs, ad esempio BACKEND_SERVICE_SP2_ID dall'output per utilizzarlo nel passaggio successivo.

  3. Registra i servizi del passaggio precedente nella tua applicazione. Copia gli ID servizio del campo di output nel passaggio precedente.

    gcloud apphub applications services create tutorial-service-backend \
        --discovered-service='projects/HOST_PROJECT_ID/locations/us-west1/discoveredServices/BACKEND_SERVICE_ID' \
        --display-name='Backend service' \
        --criticality-type='HIGH' \
        --environment-type='PRODUCTION' \
        --application=tutorial-application \
        --project=HOST_PROJECT_ID \
        --location=us-west1
    
    gcloud apphub applications services create tutorial-service-forwarding-rule \
        --discovered-service='projects/HOST_PROJECT_ID/locations/us-west1/discoveredServices/FORWARDING_RULE_SERVICE_ID' \
        --display-name='Forwarding rule' \
        --criticality-type='HIGH' \
        --environment-type='PRODUCTION' \
        --application=tutorial-application \
        --project=HOST_PROJECT_ID \
        --location=us-west1
    
    gcloud apphub applications services create tutorial-service-url-map \
        --discovered-service='projects/HOST_PROJECT_ID/locations/us-west1/discoveredServices/URL_MAP_SERVICE_ID' \
        --display-name='URL map' \
        --criticality-type='HIGH' \
        --environment-type='PRODUCTION' \
        --application=tutorial-application \
        --project=HOST_PROJECT_ID \
        --location=us-west1
    

    Sostituisci quanto segue:

    • BACKEND_SERVICE_ID: il servizio ID del servizio di backend che vuoi registrare.
    • FORWARDING_RULE_SERVICE_ID: il servizio ID della regola di inoltro che vuoi registrare.
    • URL_MAP_SERVICE_ID: il servizio ID dell'URL mappa che desideri registrare.
  4. Elenca tutti i servizi registrati nell'applicazione.

    gcloud apphub applications services list \
        --application=tutorial-application \
        --project=HOST_PROJECT_ID \
        --location=us-west1
    

    Viene visualizzato un output simile al seguente:

    ID                               DISPLAY_NAME      SERVICE_REFERENCE                                                                                                              CREATE_TIME
    tutorial-service-backend         Backend service   {'uri': '//compute.googleapis.com/projects/[SERVICE_PROJECT_NUMBER]/regions/us-west1/backendServices/l7-xlb-backend-service'}  2024-02-13T00:31:45
    tutorial-service-forwarding-rule Forwarding rule   {'uri': '//compute.googleapis.com/projects/[SERVICE_PROJECT_NUMBER]/regions/us-west1/forwardingRules/l7-xlb-forwarding-rule'}  2024-02-13T00:31:45
    tutorial-service-url-map         URL map           {'uri': '//compute.googleapis.com/projects/[SERVICE_PROJECT_NUMBER]/regions/us-west1/urlMaps/regional-l7-xlb-map'}             2024-02-13T00:31:45
    

    I servizi registrati, ma scollegati, sono indicati da un valore vuoto nel SERVICE_REFERENCE. Per ulteriori informazioni sugli stati di registrazione, consulta le proprietà e gli attributi di App Hub.

  5. Elenca tutti i carichi di lavoro rilevati nel progetto host di App Hub. Questo comando restituisce i carichi di lavoro che possono essere registrati in un'applicazione.

    gcloud apphub discovered-workloads list \
        --project=HOST_PROJECT_ID \
        --location=us-west1
    

    Verrà visualizzato un output simile al seguente:

    ID                            WORKLOAD_REFERENCE                                                                                                            WORKLOAD_PROPERTIES
    INSTANCE_GROUP_ID          {'uri': '//compute.googleapis.com/projects/[SERVICE_PROJECT_NUMBER]/zones/us-west1-a/instanceGroups/l7-xlb-backend-example'}  {'gcpProject': 'projects/SERVICE_PROJECT_ID', 'location': 'us-west1', 'zone': 'us-west1-a'}
    

    Copia l'ID carico di lavoro dall'output per utilizzarlo nel al passaggio successivo.

  6. Registra il carico di lavoro del passaggio precedente nella tua applicazione come sample-workload. Copia l'ID del carico di lavoro dal campo di output del passaggio precedente.

    gcloud apphub applications workloads create tutorial-workload \
        --discovered-workload='projects/HOST_PROJECT_ID/locations/us-west1/discoveredWorkloads/WORKLOAD_ID' \
        --display-name='Workload instance group' \
        --application=tutorial-application \
        --project=HOST_PROJECT_ID \
        --location=us-west1
    

    Sostituisci WORKLOAD_ID con l'ID del workload che vuoi registrare.

  7. Elenca tutti i carichi di lavoro registrati nell'applicazione.

    gcloud apphub applications workloads list \
        --application=tutorial-application \
        --project=HOST_PROJECT_ID \
        --location=us-west1
    

    Verrà visualizzato un output simile al seguente:

    ID                        DISPLAY_NAME              WORKLOAD_REFERENCE                                                                                                            CREATE_TIME
    tutorial-workload-mig     Workload instance group   {'uri': '//compute.googleapis.com/projects/[SERVICE_PROJECT_NUMBER]/zones/us-west1-a/instanceGroups/l7-xlb-backend-example'}  2024-02-13T00:31:45
    

    I carichi di lavoro registrati, ma scollegati, sono indicati da un valore vuoto nel WORKLOAD_REFERENCE campo. Per ulteriori informazioni sugli stati di registrazione, consulta le proprietà e gli attributi di App Hub.

Visualizza tutti i servizi e i carichi di lavoro

Puoi visualizzare i dettagli dei servizi e dei carichi di lavoro dai progetti di servizio associati al progetto host App Hub.

  1. Nella console Google Cloud, vai alla pagina Servizi e carichi di lavoro di App Hub.

    Vai a Servizi e carichi di lavoro

    Tutti i servizi e i carichi di lavoro dall'App Hub collegato vengono visualizzati i progetti di servizio.

  2. Nell'elenco Regione, seleziona us-west1. Viene visualizzato il carico di lavoro Gruppo di istanze di carico di lavoro con dettagli come Tipo App Hub, Criticità e Registrato in.

  3. Per filtrare i servizi o i carichi di lavoro in base allo stato:

    1. Nel campo Filtro, seleziona i filtri, ad esempio Stato registrazione.
    2. Fai clic su Registrato. Un elenco di servizi e carichi di lavoro registrati all'applicazione.

Visualizza metriche dell'applicazione

Puoi visualizzare le metriche di sistema per le applicazioni create nel progetto host di App Hub. Queste metriche corrispondono indicatori aurei: traffico, errori, latenza e saturazione che consentono di monitorare le prestazioni e l'integrità dell'applicazione.

  1. Nella console Google Cloud, vai alla pagina Applicazioni di App Hub.

    Vai a Applicazioni

  2. Fai clic sul nome dell'applicazione, Tutorial.

    Viene visualizzata la scheda Servizi e carichi di lavoro con i metadati dei servizi e carichi di lavoro registrati nella tua applicazione.

  3. Per visualizzare le metriche di sistema dei servizi e dei carichi di lavoro registrati, fai clic su Metriche.

Esegui la pulizia

Per evitare che al tuo account Google Cloud vengano addebitati costi relativi alle risorse utilizzate in questo tutorial, elimina il progetto che contiene le risorse oppure mantieni il progetto ed elimina le singole risorse.

Elimina le risorse App Hub

Console

  1. Nella console Google Cloud, vai alla pagina App di App Hub.

    Vai a Applicazioni

  2. Fai clic sul nome di un'applicazione, Tutorial.

  3. Nella scheda Servizi e carichi di lavoro, dal Servizi e carichi di lavoro registrati, fai clic sul nome di un completamente gestito di Google Cloud.

  4. Nella pagina Servizi e carichi di lavoro, fai clic su Annulla registrazione.

    Un avviso notifica l'annullamento della registrazione del servizio.

  5. Nella scheda Servizi e carichi di lavoro, fai clic sul nome di un carico di lavoro nella sezione Servizi e carichi di lavoro registrati.

  6. Nella scheda Dettagli, fai clic su Disregistra.

    Un avviso notifica l'annullamento della registrazione del carico di lavoro.

  7. Vai alla pagina Applicazioni dell'App Hub.

    Vai a Applicazioni

  8. Fai clic sul nome di un'applicazione.

  9. Nella pagina tutorial-application, fai clic su Elimina.

  10. Nella console Google Cloud, vai alle Impostazioni di App Hub .

    Vai alle impostazioni

  11. Nella pagina Impostazioni, seleziona la casella di controllo per il progetto di servizio che vuoi rimuovere dal progetto host App Hub.

  12. Fai clic su Scollega progetti.

gcloud

  1. Elenca i servizi registrati nell'applicazione:

    gcloud apphub applications services list \
      --application=tutorial-application --project=HOST_PROJECT_ID \
      --location=us-west1
    
  2. Annulla la registrazione dei servizi dall'applicazione:

    gcloud apphub applications services delete SERVICE_NAME \
      --application=tutorial-application --project=HOST_PROJECT_ID \
      --location=us-west1
    

    Sostituisci SERVICE_NAME con il nome del servizio.

    Vengono individuati i servizi che possono essere registrati nell'account un'applicazione.

  3. Elenca i carichi di lavoro registrati nell'applicazione:

    gcloud apphub applications workloads list \
      --application=tutorial-application --project=HOST_PROJECT_ID \
      --location=us-west1
    
  4. Annullare la registrazione del carico di lavoro dall'applicazione:

    gcloud apphub applications workloads delete WORKLOAD_NAME \
      --application=tutorial-application --project=HOST_PROJECT_ID \
      --location=us-west1
    

    Sostituisci WORKLOAD_NAME con il nome del tuo carico di lavoro.

    Il carico di lavoro è ora rilevato e può essere registrato un'applicazione.

  5. Elimina l'applicazione:

    gcloud apphub applications delete tutorial-application \
      --project=HOST_PROJECT_ID \
      --location=us-west1
    
  6. Rimuovi il progetto di servizio dal progetto host App Hub:

    gcloud apphub service-projects remove SERVICE_PROJECT_ID \
      --project=HOST_PROJECT_ID
    

Elimina il deployment

Quando non hai più bisogno della soluzione, per evitare la fatturazione continua per il a quelle create in questa soluzione, elimina tutte le risorse.

Utilizza questa procedura se hai eseguito il deployment della soluzione mediante l'interfaccia a riga di comando di Terraform.

  1. In Cloud Shell, assicurati che la directory di lavoro corrente sia terraform-docs-samples/lb/regional_external_http_load_balancer. Se non è così, vai a quella directory.

  2. Rimuovi le risorse di cui è stato eseguito il provisioning da Terraform:

    terraform destroy
    

    Terraform visualizza un elenco delle risorse che verranno eliminate.

  3. Quando ti viene chiesto di eseguire le azioni, inserisci yes.

    Terraform mostra messaggi che indicano l'avanzamento. Dopo che tutte le risorse vengono eliminati, Terraform visualizza il seguente messaggio:

    Destroy complete!
    

Quando non hai più bisogno del progetto Google Cloud che hai utilizzato per la soluzione, possono eliminare il progetto.

Elimina il progetto

Console

  1. Nella console Google Cloud, vai alla pagina Gestisci risorse.

    Vai a Gestisci risorse

  2. Nell'elenco dei progetti, seleziona il progetto che vuoi eliminare, quindi fai clic su Elimina.
  3. Nella finestra di dialogo, digita l'ID progetto e fai clic su Chiudi per eliminare il progetto.

gcloud

Elimina un progetto Google Cloud:

gcloud projects delete PROJECT_ID

Sostituisci PROJECT_ID con gli ID progetto di hosting o di servizio.

Passaggi successivi