Configurare App Hub

Questo documento fornisce istruzioni per configurare App Hub per: per creare, eseguire e gestire applicazioni su Google Cloud. È destinato a chi configura e amministra App Hub.

Se stai configurando App Hub, le attività principali sono che segue:

  1. Decidi se creare un nuovo progetto host App Hub o se utilizzare esistente come progetto host.
    • Se prevedi di avere più di un progetto host, ti consigliamo vivamente di crearle nella stessa cartella.
    • I progetti host in App Hub non sono uguali ai Progetti host del VPC condiviso e non hanno gli stessi requisiti. Ad esempio, non è necessaria una rete VPC condiviso per utilizzare App Hub. In questo documento, tutti i riferimenti ai progetti host sono ad App Hub per i progetti host.
    • Un progetto host non può essere un progetto di servizio diverso da se stesso.
  2. Abilita l'API App Hub nel progetto host.
  3. Aggiungi uno o più progetti di servizio App Hub al progetto host.
    • I progetti di servizio in App Hub non corrispondono a Progetti di servizio VPC condiviso e non hanno gli stessi requisiti. In questo documento, tutti i riferimenti ai progetti di servizio sono progetti di servizio App Hub.
  4. Designare gli utenti di App Hub come App Hub Amministratori, editor dell'App Hub o App Hub Visualizzatori.
  5. Creare applicazioni.
  6. Registrare servizi e carichi di lavoro nell'applicazione.

Servizi e carichi di lavoro

Con App Hub, le risorse dei progetti di servizio collegati disponibili come servizi e carichi di lavoro. Registrazione in corso i tuoi servizi e carichi di lavoro a un'applicazione per consentirti di osservare e monitorare le risorse. Puoi designare le seguenti risorse come Servizi App Hub e registrali in Applicazioni App Hub:

  • Regole di forwarding
  • Mappe URL
  • Servizi di backend

Puoi designare gruppi di istanze gestite, ma non singole VM, come carichi di lavoro e registrali nelle applicazioni App Hub.

App Hub supporta le interfacce L7 (interne ed esterne) a livello di regione Bilanciatori del carico delle applicazioni con traffico HTTP o HTTPS.

I carichi di lavoro e i servizi registrati devono trovarsi nella stessa regione applicazione; quindi le istruzioni e i comandi che seguono presuppongono risorse si trovano nella stessa regione. Per informazioni sulle regioni in cui puoi designare, consulta Località.

Procedura di configurazione generale

Il seguente elenco riassume i passaggi per configurare App Hub:

  1. Determina quali risorse esistenti includere nei tuoi un'applicazione e a quali progetti appartengono.
  2. Crea un progetto host App Hub e abilita API App Hub nel progetto. Facoltativamente, in base alle struttura organizzativa dell'azienda, creare più di un progetto host. Se crei più progetti, ti consigliamo di crearli in una nuova cartella.
  3. Collega i progetti di servizio. Dopo aver configurato un progetto host, collega ai progetti di servizio con risorse sottostanti necessarie alle tue applicazioni, del progetto host. Tieni presente quanto segue:
    1. I progetti di servizio devono trovarsi nella stessa organizzazione come progetto host. Dopo aver collegato un progetto di servizio a un host non puoi spostarlo in un'altra organizzazione. Per spostare a un'altra organizzazione, devi seguire le istruzioni riportate in questo documento per rimuovi o scollega del collegamento del progetto di servizio al progetto host. Poi puoi allegare a un'altra organizzazione.
    2. Un progetto di servizio non può essere collegato a più di un progetto host.
    3. Un progetto host può essere un progetto di servizio a sé stante, ma non progetto di servizio per qualsiasi altro progetto host.
    4. Dopo aver collegato i progetti di servizio a un progetto host, esegui una query sull'host per servizi o carichi di lavoro restituisce automaticamente tutti i servizi in tutti i progetti di servizio.
  4. Crea un'applicazione per organizzare più carichi di lavoro e servizi. Nota le seguenti:
    1. Assicurati che l'applicazione abbia un nome univoco nel progetto host e la località.
    2. Un progetto di servizio può essere collegato a un progetto host con più applicazioni, ma le singole risorse possono essere registrate in una sola applicazione.
  5. Esegui query per servizi e carichi di lavoro e registrali nella tua applicazione. Dopo aver creato un'applicazione, esegui una query sul progetto host per servizi e carichi di lavoro. Le query vengono eseguite sul progetto host e su ai progetti di servizio collegati al progetto host. Restituiscono anche tutti carichi di lavoro e servizi aggiuntivi. Tieni presente quanto segue:
    1. Puoi registrare un servizio o un carico di lavoro solo in una singola applicazione.
    2. Tutti i carichi di lavoro e i servizi che registri devono trovarsi nella stessa regione come applicazione.
    3. I servizi e i carichi di lavoro registrati non sono interessati dagli aggiornamenti delle risorsa dell'infrastruttura sottostante. In altre parole, se elimini il alle risorse sottostanti che fungono da servizi e carichi di lavoro, App Hub non elimina i carichi di lavoro associati dalla tua applicazione. Devi annullare separatamente la registrazione carico di lavoro o servizio.

Prerequisiti

Prima di configurare App Hub, completa le attività seguenti.

  1. Decidi quale progetto esistente è il progetto host o creane uno nuovo sarà il progetto host. Ti consigliamo vivamente di creare un nuovo progetto.
  2. Assicurati di aver deciso quali persone devono gestire Identity and Access Management (IAM) ruoli per App Hub: Amministratore App Hub, Editor App Hub e Visualizzatore App Hub.

Tieni presente quanto segue:

  • Ai progetti host possono essere collegati uno o più progetti di servizio.
  • Un progetto di servizio non può essere collegato a più di un progetto host.
  • La persona che collega un progetto di servizio a un progetto host deve disporre Ruolo IAM Amministratore App Hub in entrambi i servizi progetto e progetto host. Per ulteriori informazioni, vedi Ruoli e autorizzazioni di App Hub.

Configurare App Hub

In questa sezione creerai un'architettura di App Hub di esempio.

Nell'esempio, un'organizzazione ha tre progetti di servizio, con di risorse di cui è stato eseguito il deployment nei progetti nel modo seguente:

  • Il progetto di servizio 1 ha due risorse di infrastruttura: servizio 1 e servizio 2.
  • Il progetto di servizio 2 ha tre risorse dell'infrastruttura: servizio 3, carico di lavoro 1, e Carico di lavoro 2.
  • Il progetto di servizio 3 ha tre risorse dell'infrastruttura: servizio 4, carico di lavoro 3, e Carico di lavoro 4.

Assicurati che i progetti scelti per la creazione dell'esempio contengano la stringa risorse descritte in questa sezione o prepararti ad adattare l'esempio come segui le istruzioni.

Le seguenti sezioni contengono le istruzioni per creare un Esempio di App Hub. Crei un progetto host e aggiungi un servizio progetti al progetto host, quindi crea un'applicazione e collega i servizi carichi di lavoro standard all'applicazione. L'esempio ha tre progetti di servizio, puoi aggiungerne di meno o di più.

L'esempio presuppone che tutti i progetti di servizio che aggiungi esistano e contenere i servizi e i carichi di lavoro che aggiungi alla tua applicazione. Prima di creare l'esempio, determinare quali progetti di servizio contengono i servizi da includere nell'applicazione.

Abilita App Hub

In questa sezione, devi selezionare o creare un nuovo progetto host, abilitare API App Hub e concedere i ruoli e le autorizzazioni appropriati persone all'interno dell'organizzazione. Inoltre, colleghi i progetti di servizio all'host progetto.

Console

  1. Nella console Google Cloud, vai alla pagina del selettore progetti.

    Vai al selettore progetti

  2. Seleziona o crea un progetto Google Cloud, in modo che sia il tuo progetto host App Hub.

  3. Attiva l'API richiesta.

    Abilita l'API

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

    Se non sei l'autore del progetto, devi concedere le autorizzazioni richieste del progetto all'entità appropriata. Ad esempio, un L'entità può essere un Account Google (per gli utenti finali) o un account di servizio (per applicazioni e carichi di lavoro di calcolo). Per ottenere le autorizzazioni necessarie per completare questo tutorial, chiedi al tuo di concederti i seguenti ruoli IAM sul 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 che amministrerà App Hub, 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 e fai clic su Salva.

    6. In ogni progetto di servizio App Hub, concedi la Amministratore App Hub per lo stesso utente.

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

    Vai alle impostazioni

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

  7. Esegui una di queste operazioni:

    • Nell'elenco dei progetti, seleziona le caselle di controllo relative ai progetti vuoi aggiungere come progetti di servizio.
    • Cerca progetti e seleziona quelli da aggiungere come servizio in modo programmatico a gestire i progetti.

  8. Fai clic su Seleziona. La tabella Progetti di servizio collegati mostra il servizio selezionato in modo programmatico a gestire i progetti.

  9. Fai clic su Chiudi.

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. Corsa il comando seguente da Cloud Shell:

    gcloud components update

  3. Crea o seleziona un nuovo progetto. HOST_PROJECT_ID, in modo che sia il 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. Abilitare l'API App Hub nel progetto host di cui è stato creato.

    gcloud services enable apphub.googleapis.com \
    --project=HOST_PROJECT_ID

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

    Se non sei l'autore del progetto, devi concedere le autorizzazioni richieste del progetto all'entità appropriata. Ad esempio, un L'entità può essere un Account Google (per gli utenti finali) o un account di servizio (per applicazioni e carichi di lavoro di calcolo). Per ottenere le autorizzazioni necessarie per completare questo tutorial, chiedi al tuo di concederti i seguenti ruoli IAM sul tuo progetto:

    1. Facoltativamente, concedi le persone che amministreranno App Hub, l'App Hub di amministratore nel progetto host. Ripeti il seguente comando per ciascun amministratore.

      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 ha il formato username@yourdomain, ad esempio robert.smith@example.com.

    2. Concedi il ruolo Amministratore App Hub nei progetti di servizio all' persone che gestiscono App Hub. Devono disporre Ruolo Amministratore App Hub per aggiungere progetti di servizio all'host progetto. È necessaria almeno una persona con questo ruolo per ogni servizio progetto. Un'unica persona può avere il ruolo in più progetti di servizio.

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

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

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

      Sostituisci quanto segue:

      • SERVICE_PROJECT_1: il primo di tre di servizio in questo esempio.
      • SERVICE_PROJECT_2: il secondo di tre di servizio in questo esempio.
      • SERVICE_PROJECT_3: il terzo di tre di servizio in questo esempio.

  6. Aggiungi i tuoi progetti di servizio al progetto host App Hub.

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

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

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

Crea un'applicazione

Se non ne hai già una, crea un'applicazione che funga da container per i 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. Il riquadro Crea applicazione visualizzati.

  4. Seleziona una Regione.

  5. Inserisci il Nome applicazione e fai clic su Continua.

  6. Nella sezione Aggiungi attributi, inserisci il Nome visualizzato.

  7. Se vuoi, aggiungi ulteriori dettagli sull'applicazione nei campi che seguono. Per ulteriori informazioni, in questo documento vedi Aggiornare un'applicazione App Hub esistente.

  8. Fai clic su Crea.

gcloud

  1. Crea una nuova applicazione denominata APPLICATION_NAME e assegnagli un nome visualizzato, APPLICATION_DISPLAY_NAME. Il flag --scope-type definisce quali servizi possono essere registrati in un'applicazione. È supportato solo REGIONAL, il che significa che solo i servizi e i carichi di lavoro della stessa regione registrare l'applicazione.

    gcloud apphub applications create APPLICATION_NAME \
  --display-name='APPLICATION_DISPLAY_NAME' \
  --scope-type=REGIONAL \
  --project=HOST_PROJECT_ID \
  --location=REGION

    Sostituisci quanto segue:

    • APPLICATION_NAME: il nome della tua applicazione. Il nome deve includere solo caratteri alfanumerici minuscoli senza spazi di archiviazione.
    • APPLICATION_DISPLAY_NAME: il nome visualizzato di la tua applicazione.
    • REGION: la regione dell'applicazione. Dai questo il valore us-east1.

  2. Elenca le applicazioni nel progetto host.

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

    L'output è simile al seguente:

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

  3. Visualizza i dettagli dell'applicazione che hai creato.

    gcloud apphub applications describe APPLICATION_NAME \
  --project=HOST_PROJECT_ID \
  --location=REGION

    Il comando restituisce informazioni in formato YAML, simili a quanto segue.

    createTime: '2023-10-31T18:33:48.199394108Z'
displayName: APPLICATION_DISPLAY_NAME
name: projects/HOST_PROJECT_ID/locations/REGION/applications/APPLICATION_NAME
scope:
  type: REGIONAL
state: ACTIVE
uid: [APPLICATION_UID]
updateTime: '2023-10-31T18:33:48.343303819Z'

Aggiorna un'applicazione App Hub esistente

Puoi anche aggiornare gli attributi dell'applicazione dopo che è stato creato.

Console

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

    Vai a Applicazioni

  2. Nell'elenco delle applicazioni, fai clic su . Modifica l'applicazione da aggiornare.

  3. Modifica i campi come richiesto e fai clic su Salva.

  4. (Facoltativo) Nell'elenco Criticità, per indicare l'importanza della classe seleziona una delle seguenti opzioni:

    • Mission critical
    • Alto
    • Medio
    • Basso

  5. (Facoltativo) Nel campo Ambiente, per indicare la fase ciclo di vita del software, seleziona una delle seguenti opzioni:

    • Produzione
    • Gestione temporanea
    • Sviluppo
    • Test

  6. (Facoltativo) Aggiungi i seguenti dettagli come richiesto per i Proprietari sviluppatori Proprietari operatori e Proprietari di attività. Tieni presente che devi inserire all'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.

  7. Ripeti questi passaggi per ciascun sviluppatore, operatore e proprietario dell'attività.

  8. Fai clic su Salva.

gcloud

  1. Aggiorna l'applicazione con criticality-type, environment-type, e di tipo proprietario:

    gcloud apphub applications update APPLICATION_NAME \
  --criticality-type='CRITICALITY_LEVEL' \
  --environment-type='ENVIRONMENT' \
  --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=REGION

    Sostituisci quanto segue:

    • CRITICALITY_LEVEL: indica quanto sia fondamentale dell'applicazione, del servizio o del carico di lavoro alle operazioni aziendali. Specifica uno dei seguenti valori:
      • MISSION_CRITICAL
      • HIGH
      • MEDIUM
      • LOW
    • ENVIRONMENT: indica le fasi del processo ciclo di vita del software. Specifica uno dei seguenti valori:
      • PRODUCTION
      • STAGING
      • DEVELOPMENT
      • TEST
    • 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 di sviluppatore, operatore e proprietari dell'attività. Questi valori deve essere nel formato username@yourdomain, ad esempio 222larabrown@gmail.com.

  2. Elenca le applicazioni in cui l'attributo environment-type ha la valore PRODUCTION.

    gcloud apphub applications list \
    --filter='attributes.environment.type=PRODUCTION' \
    --project=HOST_PROJECT_ID \
    --location=REGION

    L'output è simile al seguente:

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

Registra servizi e carichi di lavoro

Quando registri servizi di infrastruttura e carichi di lavoro in un'applicazione, e carichi di lavoro vengono registrati come risorse App Hub. Se utilizzi i segnaposto per creare l'applicazione gcloud CLI, i servizi e i carichi di lavoro nei tre progetti di servizio sono i seguenti:

  • Il progetto di servizio 1 ha due risorse di infrastruttura: servizio 1 e servizio 2.
  • Il progetto di servizio 2 ha tre risorse dell'infrastruttura: servizio 3, carico di lavoro 1, e Carico di lavoro 2.

  • Il progetto di servizio 3 ha tre risorse dell'infrastruttura: servizio 4, carico di lavoro 3, e Carico di lavoro 4.

Console

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

    Vai a Applicazioni

  2. Fai clic sul nome dell'applicazione. Viene visualizzata la scheda Servizi e carichi di lavoro con un elenco di e carichi di lavoro nei tuoi progetti di servizio.

  3. Per ogni servizio o carico di lavoro che vuoi registrare:

    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, nel Scegli il servizio o il carico di lavoro e seleziona il servizio o il carico di lavoro e fai clic su Continua.
    3. Nella sezione Aggiungi attributi, inserisci un Nome per il servizio oppure carico di lavoro.
    4. Se vuoi, aggiungi ulteriori dettagli sul servizio o sul carico di lavoro nei campi che seguono. Per ulteriori informazioni, in questo documento vedi Aggiornare un'applicazione App Hub esistente. Tieni presente che devi fornire uno dei valori specificati per Criticità e Ambiente, ma il valore può essere diversi da quelli impostati durante la creazione dell'applicazione.
    5. Fai clic su Registrati. La scheda Servizi e carichi di lavoro mostra il servizio registrato o carico di lavoro. Per ulteriori informazioni sugli stati della registrazione, consulta proprietà e attributi di App Hub.

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

  2. Elenca i carichi di lavoro rilevati dal progetto di servizio 2, collegato a del progetto host. Questo comando restituisce carichi di lavoro registrati in un'applicazione.

    gcloud apphub discovered-workloads list \
  --filter='workload_properties.gcp_project=projects/SERVICE_PROJECT_2' \
  --project=HOST_PROJECT_ID \
  --location=REGION

    L'output è simile al seguente, che include gruppi di istanze gestite non registrati:

    ID: [DISCOVERED_WORKLOAD_ID_1]
WORKLOAD_REFERENCE: {'uri': '//compute.googleapis.com/projects/[SERVICE_PROJECT_2_NUMBER]/regions/REGION/instanceGroups/testing-mig-1'}
WORKLOAD_PROPERTIES: {'gcpProject': 'projects/SERVICE_PROJECT_2', 'location': 'REGION'}

ID: [DISCOVERED_WORKLOAD_ID_2]
WORKLOAD_REFERENCE: {'uri': '//compute.googleapis.com/projects/[SERVICE_PROJECT_2_NUMBER]/regions/REGION/instanceGroups/testing-mig-2'}
WORKLOAD_PROPERTIES: {'gcpProject': 'projects/SERVICE_PROJECT_2', 'location': 'REGION'}

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

  3. Registra un carico di lavoro dal passaggio precedente alla tua applicazione.

    gcloud apphub applications workloads create WORKLOAD_NAME \
  --discovered-workload='projects/HOST_PROJECT_ID/locations/REGION/discoveredWorkloads/DISCOVERED_WORKLOAD_ID_2' \
  --display-name='mywebserver-deployment1' \
  --application=APPLICATION_NAME \
  --project=HOST_PROJECT_ID \
  --location=REGION

    Sostituisci quanto segue:

    • WORKLOAD_NAME: un nome per registrare il carico di lavoro.
    • DISCOVERED_WORKLOAD_ID_2: l'ID carico di lavoro di l'output del passaggio precedente.

  4. Ripeti i due passaggi precedenti per filtrare e registrare i carichi di lavoro desiderati del progetto di servizio 3.

  5. (Facoltativo) Puoi aggiornare i carichi di lavoro con criticality-type, environment-type e attributi del proprietario.

    gcloud apphub applications workloads update WORKLOAD_NAME \
  --application=APPLICATION_NAME \
  --criticality-type='CRITICALITY_LEVEL' \
  --environment-type='ENVIRONMENT' \
  --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=REGION

    Tieni presente che devi fornire uno dei valori specificati per criticality-type e environment-type, ma il valore può essere diversi da quelli impostati durante la creazione dell'applicazione.

  6. Elenca i carichi di lavoro registrati nell'applicazione.

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

    L'output è simile al seguente:

    ID: WORKLOAD_NAME
DISPLAY_NAME: mywebserver-deployment1
WORKLOAD_REFERENCE: {'uri': '//compute.googleapis.com/projects/[SERVICE_PROJECT_2_NUMBER]/regions/REGION/instanceGroups/testing-mig-2'}
CREATE_TIME: 2023-10-31T18:34:23

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

  7. Elenca i servizi rilevati con regole di forwarding nel progetto di servizio 1 collegato al progetto host. Questo comando restituisce servizi disponibili per la registrazione in un'applicazione.

    gcloud apphub discovered-services list \
  --filter='service_properties.gcp_project=projects/SERVICE_PROJECT_1 AND service_reference.uri~"forwardingRules"' \
  --project=HOST_PROJECT_ID \
  --location=REGION

    L'output è simile al seguente:

    ID: [DISCOVERED_SERVICE_ID_1]
SERVICE_REFERENCE: {'uri': '//compute.googleapis.com/projects/[SERVICE_PROJECT_1_NUMBER]/regions/REGION/forwardingRules/testing-forwarding-rule-1'}
SERVICE_PROPERTIES: {'gcpProject': 'projects/SERVICE_PROJECT_1', 'location': 'REGION'}

ID: [DISCOVERED_SERVICE_ID_2]
SERVICE_REFERENCE: {'uri': '//compute.googleapis.com/projects/[SERVICE_PROJECT_1_NUMBER]/regions/REGION/forwardingRules/testing-forwarding-rule-2'}
SERVICE_PROPERTIES: {'gcpProject': 'projects/SERVICE_PROJECT_1', 'location': 'REGION'}

    Copia l'ID servizio DISCOVERED_SERVICE_ID_2 dall'output per utilizzarlo in al passaggio successivo.

  8. Registra la regola di forwarding, testing-forwarding-rule-2 nel servizio progetto 1 come servizio.

    gcloud apphub applications services create SERVICE_NAME \
  --discovered-service='projects/HOST_PROJECT_ID/locations/REGION/discoveredServices/DISCOVERED_SERVICE_ID_2' \
  --display-name='mywebserver-service1' \
  --application=APPLICATION_NAME \
  --project=HOST_PROJECT_ID \
  --location=REGION

    Sostituisci quanto segue:

    • SERVICE_NAME: un nome per registrare il come servizio.
    • DISCOVERED_SERVICE_ID_2: l'ID servizio di l'output del passaggio precedente.

  9. Ripeti i passaggi precedenti che elencano i servizi, li filtrano e registrare i servizi nei progetti di servizio 1, 2 e 3.

  10. Aggiorna un servizio con l'attributo criticality-type e la proprietà Attributo environment-type.

    gcloud apphub applications services update SERVICE_NAME \
  --criticality-type='CRITICALITY_LEVEL' \
  --environment-type='ENVIRONMENT' \
  --application=APPLICATION_NAME \
  --project=HOST_PROJECT_ID  \
  --location=REGION

  11. Elenca i servizi registrati in APPLICATION_NAME dell'applicazione e HOST_PROJECT_ID progetto host.

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

    L'output è simile al seguente per ogni servizio:

    ID: SERVICE_NAME
DISPLAY_NAME: mywebserver-service1
SERVICE_REFERENCE: {'uri': '//compute.googleapis.com/projects/[SERVICE_PROJECT_1_NUMBER]/regions/REGION/forwardingRules/testing-forwarding-rule-2'}
CREATE_TIME: 2023-11-01T21:38:08

    I servizi registrati, ma scollegati, sono indicati con un valore vuoto nel campo campo SERVICE_REFERENCE.

  12. Filtra i servizi nel APPLICATION_NAME applicazione e HOST_PROJECT_ID progetto host a quelli in cui l'attributo environment-type è impostato su PRODUCTION.

    gcloud apphub applications services list \
  --filter='attributes.environment.type=PRODUCTION' \
  --application=APPLICATION_NAME \
  --project=HOST_PROJECT_ID \
  --location=REGION

La procedura di configurazione di App Hub è stata completata.

Aggiungi o rimuovi progetti di servizio

Puoi modificare i collegamenti del progetto di servizio per creare un'infrastruttura diversa di risorse disponibili per essere raggruppate in un'applicazione.

Console

Per aggiungere un progetto di servizio a un progetto host:

  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 nell'elenco visualizzato e seleziona le caselle di controllo relative ai progetti che vuoi aggiungere come servizio in modo programmatico a gestire i progetti.

  4. Fai clic su Seleziona. La tabella Progetti di servizio collegati mostra i progetti selezionati come progetti di servizio per il progetto host.

  5. Fai clic su Chiudi.

Per rimuovere un progetto di servizio da un progetto host:

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

    Vai alle impostazioni

  2. Nella pagina Impostazioni, seleziona le caselle di controllo relative ai progetti che vuoi da rimuovere come progetti di servizio.

  3. Fai clic su Scollega progetti. La tabella Progetti di servizio collegati viene aggiornata per visualizzare solo ai progetti che rimangono collegati al progetto host.

gcloud

Per aggiungere un progetto di servizio a un progetto host:

gcloud apphub service-projects add SERVICE_PROJECT_ID \
   --project=HOST_PROJECT_ID
Sostituisci SERVICE_PROJECT_ID con il nome del che vuoi aggiungere al progetto host. Per rimuovere un progetto di servizio dal progetto host: 
gcloud apphub service-projects remove SERVICE_PROJECT_ID \
   --project=HOST_PROJECT_ID

Visualizza applicazioni, servizi e carichi di lavoro esistenti

Puoi visualizzare le applicazioni di un progetto ed elencare i servizi e i carichi di lavoro in un un'applicazione.

Console

  • Per visualizzare le applicazioni in un progetto, nella console Google Cloud vai alla Pagina Applicazioni di App Hub.

    Vai a Applicazioni

  • Per elencare servizi e carichi di lavoro:

    Applicazioni

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

      Vai a Applicazioni

    2. Fai clic sul nome di un'applicazione. Una pagina con un elenco di servizi e carichi di lavoro registrati nel tuo viene visualizzata l'applicazione.

    3. (Facoltativo) Per filtrare i servizi o i carichi di lavoro:

      1. Nel campo Filtro, seleziona un filtro, ad esempio Criticità.
      2. Seleziona Alto come valore.
        Un elenco di servizi e carichi di lavoro ad alta criticità, registrati nell'applicazione.

    Servizi e carichi di lavoro

    1. Nella console Google Cloud, vai all'App Hub Servizi e carichi di lavoro.

      Vai a Servizi e carichi di lavoro

    2. Nell'elenco Regione, seleziona le regioni da cui vuoi per visualizzare i servizi e i carichi di lavoro. Ad esempio, seleziona us-east1.
      La pagina Servizi e carichi di lavoro mostra tutti i servizi e dai progetti di servizio collegati associati us-east1.

    3. (Facoltativo) Per filtrare i servizi o i carichi di lavoro:

      1. Nel campo Filtro, seleziona un filtro, ad esempio Ambiente.
      2. Seleziona Produzione come valore.
        un elenco di servizi e carichi di lavoro nell'ambiente di produzione che è registrato in un'applicazione.

gcloud

Per visualizzare le applicazioni in un progetto:

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

Per elencare i servizi registrati in un'applicazione:

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

Per elencare i carichi di lavoro registrati in un'applicazione:

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

Esegui la pulizia

Esegui la pulizia di un'applicazione esistente e rimuovi il collegamento a un progetto di servizio da il progetto host per rimuovere le risorse associate al progetto. In questo modo per il rilevamento automatico delle risorse nel progetto di servizio.

Per farlo, devi prima eliminare i carichi di lavoro e i servizi registrati un'applicazione.

Console

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

    Vai a Applicazioni

  2. Fai clic sul nome di un'applicazione. Viene visualizzato un elenco di servizi e carichi di lavoro registrati nell'applicazione.

  3. Annullare la registrazione di un servizio o di un carico di lavoro.

    1. Nella scheda Servizi e carichi di lavoro, dal Servizi e carichi di lavoro registrati, fai clic sul nome servizio o carico di lavoro per cui vuoi annullare la registrazione.
    2. Nella scheda Dettagli, fai clic su Annulla registrazione del servizio oppure Annulla la registrazione del carico di lavoro per aggiornare il servizio o il carico di lavoro come Risorsa Rilevata.
      Nella scheda Servizi e carichi di lavoro, un avviso notifica che la registrazione del carico di lavoro è stata annullata.
    3. Ripeti queste istruzioni per ciascun servizio e carico di lavoro.

  4. Vai alla pagina Applicazioni dell'App Hub.

    Vai a Applicazioni

  5. Fai clic sul nome di un'applicazione.

  6. Nella pagina con i dettagli dell'applicazione, fai clic su Elimina.

  7. In questo documento, utilizza le istruzioni in Aggiungi o rimuovi progetti di servizio da rimuovere ai progetti di servizio del progetto host.

gcloud

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

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

  2. Annulla la registrazione del carico di lavoro dall'applicazione:

    gcloud apphub applications workloads delete WORKLOAD_NAME \
  --application=APPLICATION_NAME \
  --project=HOST_PROJECT_ID \
  --location=REGION

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

  3. Ripeti il comando precedente per eliminare i carichi di lavoro registrati rimanenti dall'applicazione.

  4. Elenca i servizi registrati nell'applicazione:

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

  5. Annulla la registrazione del servizio dall'applicazione:

    gcloud apphub applications services delete SERVICE_NAME \
  --application=APPLICATION_NAME \
  --project=HOST_PROJECT_ID \
  --location=REGION

    Il servizio è ora rilevato e può essere registrato un'applicazione.

  6. Ripeti il comando precedente per annullare la registrazione dei rimanenti servizi dall'applicazione.

  7. Elimina l'applicazione:

    gcloud apphub applications delete APPLICATION_NAME \
  --project=HOST_PROJECT_ID \
  --location=REGION

  8. Rimuovi un progetto di servizio dal progetto host:

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

  9. Ripeti il comando precedente per rimuovere tutti i progetti di servizio dall'host progetto.

Passaggi successivi