crea un'applicazione App Hub utilizzando un singolo progetto

Questo tutorial mostra come configurare un'applicazione App Hub in un singolo progetto. In un progetto di servizio che funge da progetto host App Hub, esegui il deployment di un gruppo di istanze gestite con bilanciamento del carico. Quindi, potrai visualizzare le risorse dell'infrastruttura come servizi e carichi di lavoro nelle applicazioni nel progetto host App Hub.

Questo tutorial è destinato 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 è il tuo progetto host App Hub.

  2. Utilizza Terraform per eseguire il deployment di una rete VPC, di un bilanciatore del carico delle applicazioni esterno regionale e di un gruppo di istanze gestite, che è l'endpoint del 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 risorse rilevate in App Hub. Per ulteriori informazioni, consulta 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 sul progetto host App Hub.

  6. Scopri le risorse dell'infrastruttura come servizi e carichi di lavoro App Hub.

  7. Registra i servizi e un carico di lavoro dal progetto di servizio nell'applicazione e assegna gli attributi.

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

Costi

Per una stima del costo delle risorse Google Cloud utilizzate dalla soluzione VM gestita con bilanciamento del carico, vedi 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 modo che rifletta eventuali modifiche alla configurazione che prevedi di apportare per le risorse utilizzate nella soluzione.

La stima precalcolata si basa su ipotesi per 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, ti viene concesso il 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 delle risorse Google Cloud.

Se non sei l'autore del progetto, devi concedere le autorizzazioni richieste per il progetto all'entità appropriata. Ad esempio, un'entità può essere un Account Google (per gli utenti finali) o un account di servizio (per applicazioni e carichi di lavoro).

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

Per saperne di più sulla concessione dei ruoli, consulta Gestire l'accesso.

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 del selettore progetti.

    Vai al selettore progetti

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

  3. Abilita le API richieste.

    Abilita le API

gcloud

  1. Nella console Google Cloud, attiva Cloud Shell.

    Attiva Cloud Shell

    Nella parte inferiore della console Google Cloud viene avviata una sessione di Cloud Shell che mostra un prompt della riga di comando. Cloud Shell è un ambiente shell con Google Cloud CLI già installato e con valori già impostati per il progetto attuale. L'inizializzazione della sessione può richiedere alcuni secondi.

  2. Assicurati che sia installata la versione più recente di Google Cloud CLI. Esegui questo 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, in GitHub è fornita una configurazione Terraform. La configurazione Terraform definisce tutte le risorse Google Cloud necessarie per la soluzione. Scarica la configurazione Terraform da GitHub, personalizza il codice in base alle esigenze, quindi esegui il deployment della soluzione utilizzando l'interfaccia a riga di comando Terraform. Dopo aver eseguito il deployment della soluzione, puoi continuare a utilizzare Terraform per gestirla.

Carichi di lavoro e servizi 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 esegue il deployment la soluzione VM gestita con bilanciamento del carico.

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

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

configura il client Terraform

Puoi eseguire Terraform in Cloud Shell o sul tuo host locale. Questo tutorial descrive come eseguire Terraform in Cloud Shell, in cui 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 questo comando:

    cd terraform-docs-samples/lb/regional_external_http_load_balancer

  3. Inizializza Terraform eseguendo questo 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. In caso contrario, vai alla directory.

  2. Verifica che la configurazione Terraform non contenga errori:

    terraform validate

    Se il comando restituisce degli 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 delle risorse.

  1. Assicurati che la directory di lavoro attuale sia terraform-docs-samples/lb/regional_external_http_load_balancer. In caso contrario, vai alla 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 hanno causato l'errore. Esamina i messaggi e aggiorna la configurazione per correggerli. Quindi esegui di nuovo il comando terraform apply.

    Dopo aver creato tutte le risorse, Terraform visualizza il seguente messaggio:

    Apply complete!

Attendi finché in Terraform non viene visualizzato il messaggio "Applicazione completata!".

Cloud Load Balancing distribuisce il traffico alla regola di forwarding, alla mappa URL, al servizio di backend e a un gruppo di istanze gestite di Compute Engine. Il servizio di backend, la mappa URL e le regole di forwarding diventano servizi rilevati nel progetto host App Hub. Il gruppo di istanze gestite di Compute Engine diventa un carico di lavoro rilevato nel progetto host App Hub.

Quando la soluzione non è più necessaria, puoi eliminare il deployment per evitare che la fatturazione delle risorse Google Cloud continui. Per maggiori informazioni, consulta Eliminare il deployment.

Concedi autorizzazioni IAM

Fornisci i ruoli e le autorizzazioni IAM appropriati al 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 tuo progetto:

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

      Vai a IAM

    2. Fai clic su Concedi l'accesso. Si apre il riquadro Concedi l'accesso.

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

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

    5. Seleziona il ruolo Amministratore App Hub e fai clic su Salva.

gcloud

  1. Per concedere i ruoli alle persone che amministreranno App Hub, ripeti il comando seguente sostituendo i ruoli IAM, come richiesto.

    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 dispone del ruolo Amministratore App Hub nel progetto host. Questo valore ha il formato username@yourdomain, ad esempio robert.smith@example.com.

  2. Concedi il ruolo Amministratore App Hub nel progetto di servizio agli utenti che amministrano App Hub. Deve avere il ruolo Amministratore App Hub per aggiungere progetti di servizio al progetto host. È necessaria almeno una persona con questo ruolo per ogni progetto di servizio. 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.

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 alla pagina 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 oppure seleziona la casella di controllo relativa al progetto host dall'elenco visualizzato.

  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 tuo progetto host come progetto di servizio al progetto host App Hub.

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.

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

    Vai a Applicazioni

  3. Fai clic su Crea applicazione. Viene visualizzato il riquadro Crea applicazione.

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

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

  6. Fai clic su Continua.

  7. Nella sezione Aggiungi attributi, inserisci un Nome visualizzato, sample-application.

  8. Nell'elenco Criticità, seleziona Alta. La criticità indica quanto sia critico un'applicazione, un servizio o un carico di lavoro per le tue operazioni aziendali.

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

  10. Fai clic su Continua.

  11. Nella sezione Aggiungi proprietari, aggiungi i seguenti dettagli per Proprietari sviluppatori, Proprietari operatori e Proprietari dell'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 il formato username@yourdomain, ad esempio robert.smith@example.com.

  12. Ripeti questi passaggi per ciascun 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 che hai creato:

    gcloud config set project HOST_PROJECT_ID

  2. Crea una nuova applicazione denominata tutorial-application nella regione us-west1 e assegnale il 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 progetto host.

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

    Verrà visualizzato un output simile al seguente:

    ID: tutorial-application
DISPLAY_NAME: Tutorial
CREATE_TIME: 2023-10-31T18:33:48

  4. Aggiorna l'applicazione con gli attributi criticality-type, environment-type e 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: nomi visualizzati rispettivamente di sviluppatore, operatore e proprietari dell'attività.
    • EMAIL-NAME-DEVELOPER, EMAIL-NAME-OPERATOR e EMAIL-NAME-BUSINESS: indirizzi email rispettivamente dello sviluppatore, dell'operatore e dei proprietari dell'attività. Questi valori devono avere il formato username@yourdomain, ad esempio robert.smith@example.com.

    Note

    • criticality-type: indica quanto sia critico un'applicazione, un servizio o un carico di lavoro per le 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 Applicazioni di App Hub.

    Vai a Applicazioni

  2. Fai clic sul nome della tua applicazione, sample-application. Viene visualizzata la scheda Servizi e carichi di lavoro con un elenco di servizi e carichi di lavoro registrati presenti nei tuoi progetti di servizio.

  3. Registra un servizio:

    1. Nella scheda Servizi e carichi di lavoro, fai clic su Registra servizio/carico di lavoro.
    2. Nel riquadro Registra servizio o carico di lavoro, nella sezione Scegli servizio o carico di lavoro, seleziona il Nome del servizio l7-xlb-backend-service e fai clic su Continua.
    3. Nella sezione Aggiungi attributi, inserisci il Nome dell'attributo, sample-service-backend.
    4. Inserisci un Nome visualizzato, service-backend.
    5. Nell'elenco Criticità, seleziona Alta per indicare l'importanza dell'applicazione.
    6. Nel campo Ambiente, per indicare la fase del ciclo di vita del software, seleziona Produzione.
    7. Fai clic su Continua.
    8. Aggiungi i seguenti dettagli come richiesto 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 il formato username@yourdomain, ad esempio robert.smith@example.com.
    9. Ripeti questi passaggi per ciascun sviluppatore, operatore e proprietario dell'attività.
    10. 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 rispettivamente gli altri servizi come sample-service-forwarding-rule e sample-service-url-map.

  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. Nella sezione Aggiungi attributi, inserisci il Nome dell'attributo, sample-workload.
    3. Inserisci un Nome visualizzato, workload-instance-group.

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

gcloud

  1. Aggiungi una persona con le autorizzazioni di editor di App Hub.

    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 dispone del ruolo Editor App Hub nel progetto host. Questo valore ha il formato username@yourdomain, ad esempio robert.smith@example.com.

  2. Elenca tutti i servizi rilevati nel progetto host. Questo comando restituisce i servizi disponibili per la registrazione in un'applicazione.

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

    Verrà visualizzato un output simile al seguente:

    ID: 71dd6fa4-5644-43ee-918f-c5fda03ffe24
SERVICE_REFERENCE: {'uri': '//compute.googleapis.com/projects/[SERVICE_PROJECT_NUMBER]/regions/us-west1/backendServices/l7-xlb-backend-service'}
SERVICE_PROPERTIES: {'gcpProject': 'projects/SERVICE_PROJECT_ID', 'location': 'us-west1'}

ID: fe831ba4-ec16-4eb8-9ea4-b394fd30f561
SERVICE_REFERENCE: {'uri': '//compute.googleapis.com/projects/[SERVICE_PROJECT_NUMBER]/regions/us-west1/forwardingRules/l7-xlb-forwarding-rule'}
SERVICE_PROPERTIES: {'gcpProject': 'projects/SERVICE_PROJECT_ID', 'location': 'us-west1'}

ID: 637a3216-c6cc-410e-8bf9-83b7ef66a62f
SERVICE_REFERENCE: {'uri': '//compute.googleapis.com/projects/[SERVICE_PROJECT_NUMBER]/regions/us-west1/urlMaps/regional-l7-xlb-map'}
SERVICE_PROPERTIES: {'gcpProject': 'projects/SERVICE_PROJECT_ID', 'location': 'us-west1'}

    Copia il servizio ID, ad esempio 71dd6fa4-5644-43ee-918f-c5fda03ffe24 dall'output per utilizzarlo nel passaggio successivo.

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

    gcloud apphub applications services create sample-service-backend \
    --discovered-service='projects/HOST_PROJECT_ID/locations/us-west1/discoveredServices/BACKEND_SERVICE_ID' \
    --display-name='service-backend' \
    --criticality-type='HIGH' \
    --environment-type='PRODUCTION' \
    --application=tutorial-application \
    --project=HOST_PROJECT_ID \
    --location=us-west1

    gcloud apphub applications services create sample-service-forwarding-rule \
    --discovered-service='projects/HOST_PROJECT_ID/locations/us-west1/discoveredServices/FORWARDING_RULE_SERVICE_ID' \
    --display-name='service-forwarding-rule' \
    --criticality-type='HIGH' \
    --environment-type='PRODUCTION' \
    --application=tutorial-application \
    --project=HOST_PROJECT_ID \
    --location=us-west1

    gcloud apphub applications services create sample-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 forwarding che vuoi registrare.
    • URL_MAP_SERVICE_ID: il servizio ID della mappa URL che vuoi registrare.

  4. Elenca tutti i servizi registrati nell'applicazione.

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

    Verrà visualizzato un output simile al seguente:

    ID: sample-service-backend
DISPLAY_NAME: service-backend
SERVICE_REFERENCE:  {'uri': '//compute.googleapis.com/projects/[SERVICE_PROJECT_NUMBER]/regions/us-west1/backendServices/l7-xlb-backend-service'}
CREATE_TIME: 2024-02-13T00:31:45

ID: sample-service-forwarding-rule
DISPLAY_NAME: service-forwarding-rule
SERVICE_REFERENCE:  {'uri': '//compute.googleapis.com/projects/[SERVICE_PROJECT_NUMBER]/regions/us-west1/forwardingRules/l7-xlb-forwarding-rule'}
CREATE_TIME: 2024-02-13T00:31:45

ID: sample-service-url-map
DISPLAY_NAME: url-map
SERVICE_REFERENCE:  {'uri': '//compute.googleapis.com/projects/[SERVICE_PROJECT_NUMBER]/regions/us-west1/urlMaps/regional-l7-xlb-map'}
CREATE_TIME: 2024-02-13T00:31:45

    I servizi registrati, ma scollegati sono indicati con un valore vuoto nel campo 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. Questo comando restituisce i carichi di lavoro disponibili per 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: c9c08669-0fd2-4f7c-b2b1-2cf3c57662c2
WORKLOAD_REFERENCE: {'uri': '//compute.googleapis.com/projects/[SERVICE_PROJECT_NUMBER]/zones/us-west1-a/instanceGroups/l7-xlb-backend-example'}
WORKLOAD_PROPERTIES: {'gcpProject': 'projects/SERVICE_PROJECT_ID', 'location': 'us-west1', 'zone': 'us-west1-a'}

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

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

    gcloud apphub applications workloads create sample-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 carico di lavoro 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: sample-workload
DISPLAY_NAME: workload-instance-group
WORKLOAD_REFERENCE: {'uri': '//compute.googleapis.com/projects/[SERVICE_PROJECT_NUMBER]/zones/us-west1-a/instanceGroups/l7-xlb-backend-example'}
CREATE_TIME: 2024-02-13T00:31:45

    I carichi di lavoro registrati, ma scollegati sono indicati con un valore vuoto nel campo WORKLOAD_REFERENCE. 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 di tutti i progetti di servizio collegati al progetto host.

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

    Vai a Servizi e carichi di lavoro

    Vengono visualizzati tutti i servizi e i carichi di lavoro dei progetti di servizio collegati.

  2. Nell'elenco Regione, seleziona us-west1. Viene visualizzato il carico di lavoro workload-instance-group con dettagli quali Tipo di App Hub, Criticità e Registrato in.

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

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

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 Applicazioni di App Hub.

    Vai a Applicazioni

  2. Fai clic sul nome di un'applicazione, sample-application.

  3. Nella scheda Servizi e carichi di lavoro, nella sezione Servizi e carichi di lavoro registrati, fai clic sul nome del servizio service-forwarding-rule.

  4. Nella pagina Servizi e carichi di lavoro, fai clic su Annulla registrazione del servizio. Un avviso notifica l'annullamento della registrazione del servizio.

  5. Nella scheda Servizi e carichi di lavoro, nella sezione Servizi e carichi di lavoro registrati, fai clic sul nome del carico di lavoro, workload-instance-group.

  6. Nella scheda Dettagli, fai clic su Annulla registrazione del carico di lavoro. 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 alla pagina Impostazioni di App Hub.

    Vai alle impostazioni

  11. Nella pagina Impostazioni, seleziona la casella di controllo relativa alla SERVICE_PROJECT_ID che vuoi rimuovere dal progetto host.

  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 sample-service-backend \
  --application=tutorial-application --project=HOST_PROJECT_ID \
  --location=us-west1

    gcloud apphub applications services delete sample-service-forwarding-rule \
  --application=tutorial-application --project=HOST_PROJECT_ID \
  --location=us-west1

    gcloud apphub applications services delete sample-service-url-map \
  --application=tutorial-application --project=HOST_PROJECT_ID \
  --location=us-west1

    Vengono rilevati i servizi che possono essere registrati nell'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. Annulla la registrazione del carico di lavoro dall'applicazione:

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

    Il carico di lavoro è ora rilevato e può essere registrato nell'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:

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

Elimina il deployment

Quando non hai più bisogno della soluzione, elimina tutte le risorse per evitare la fatturazione continua per le risorse che hai creato in questa soluzione.

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 attuale sia terraform-docs-samples/lb/regional_external_http_load_balancer. In caso contrario, vai alla directory.

  2. Rimuovi le risorse di cui Terraform ha eseguito il provisioning:

    terraform destroy

    Terraform visualizza un elenco delle risorse che verranno eliminate.

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

    In Terraform vengono visualizzati dei messaggi che mostrano l'avanzamento. Dopo aver eliminato tutte le risorse, Terraform visualizza il seguente messaggio:

    Destroy complete!

Quando non hai più bisogno del progetto Google Cloud che hai utilizzato per la soluzione, puoi eliminarlo.

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, quindi fai clic su Chiudi per eliminare il progetto.

gcloud

Elimina un progetto Google Cloud:

gcloud projects delete PROJECT_ID

Sostituisci PROJECT_ID con HOST_PROJECT_ID.

Passaggi successivi