Configurare App Hub per le cartelle abilitate per le app

Questo documento fornisce istruzioni per configurare App Hub utilizzando una cartella abilitata per le app per creare, gestire e gestire le applicazioni App Hub su Google Cloud. È destinato a chi configura e amministra App Hub.

Puoi anche configurare App Hub in un progetto host. Tuttavia, per gestire le tue applicazioni ti consigliamo di utilizzare le cartelle abilitate per le app anziché i progetti host, poiché queste cartelle hanno accesso a funzionalità come Application Design Center e Gemini Cloud Assist. Per ulteriori informazioni su come configurare App Hub in un progetto host, consulta Configurare App Hub nei progetti host.

Dopo aver configurato un'applicazione App Hub in una cartella abilitata per le app, puoi utilizzare l'assistenza con linguaggio naturale per recuperare informazioni sulla sua applicazione. Per saperne di più, consulta Utilizzare Gemini Cloud Assist nella console Google Cloud.

Servizi e workload

Con App Hub, le risorse dei progetti Google Cloud che sono decedenti della cartella abilitata per l'app sono disponibili come servizi e carichi di lavoro. La registrazione di servizi e carichi di lavoro a un'applicazione ti consente di osservare e monitorare le risorse. App Hub supporta risorse globali e regionali. Per ulteriori informazioni sulle risorse che puoi aggiungere alle applicazioni, consulta Risorse supportate di App Hub.

Procedura di configurazione complessiva

L'elenco seguente riassume i passaggi per configurare App Hub:

  1. Determina quali risorse esistenti includere nella applicazione e a quali progetti appartengono. Per maggiori informazioni su come gestire la tua applicazione, consulta la pagina Gestione delle applicazioni.
  2. Abilita la gestione delle app in una cartella. Ora puoi gestire le risorse di tutti i progetti discendenti della cartella abilitata per le app. Se alla cartella vengono aggiunti nuovi progetti con le risorse di base necessarie per le tue applicazioni, questi progetti vengono attivati automaticamente per la gestione delle applicazioni.
    Tieni presente quanto segue:
    1. I progetti devono trovarsi nella stessa organizzazione della cartella abilitata per le app. Dopo aver collegato un progetto a una cartella abilitata per le app, se vuoi trasferirlo a un'altra organizzazione, devi eseguirne la migrazione. Per scoprire di più, consulta la sezione Eseguire la migrazione dei progetti tra le risorse dell'organizzazione.
    2. Dopo aver associato i progetti a una cartella abilitata per le app, eseguire una query sulla cartella abilitata per le app per servizi o carichi di lavoro restituisce automaticamente tutti i servizi e i carichi di lavoro in tutti i progetti associati alla cartella abilitata per le app.
    3. Se una cartella abilitata per le app viene spostata in un'altra organizzazione, tutti i servizi e i carichi di lavoro registrati verranno scollegati.
  3. Designa gli utenti di App Hub come amministratori, editor o visualizzatori di App Hub.
  4. Crea un'applicazione per organizzare più servizi e carichi di lavoro.
    Tieni presente quanto segue:
    1. Assicurati che l'applicazione abbia un nome univoco nella cartella e nella posizione abilitata per le app.
    2. Un progetto può essere collegato a una cartella abilitata per le app con più applicazioni, ma le singole risorse possono essere registrate in una sola applicazione.
    3. Se un progetto viene spostato in un'altra cartella o organizzazione, l'applicazione continuerà a esistere nella cartella abilitata per le app con i relativi servizi e workload in uno stato scollegato.
  5. Esegui query su servizi e carichi di lavoro e registrali nella tua applicazione. Dopo aver creato un'applicazione, puoi eseguire query sulla cartella abilitata per le app per trovare i servizi e i workload disponibili. Le query vengono eseguite nella cartella abilitata per le app e in tutti i progetti collegati alla cartella abilitata per le app. La query restituisce anche tutti i servizi e i workload di questi progetti. Tieni presente quanto segue:
    1. Puoi registrare un servizio o un carico di lavoro solo in una singola applicazione.
    2. Devi registrare i servizi e i carichi di lavoro di una regione specifica in un'applicazione regionale nella stessa regione o in un'applicazione globale. Le istruzioni e i comandi che seguono presuppongono che tutte le risorse si trovino nella stessa regione. Per informazioni sulle regioni che puoi designare, consulta Località.
    3. I servizi e i workload registrati non sono interessati dagli aggiornamenti della risorsa dell'infrastruttura di base. In altre parole, se elimini le risorse di base che fungono da servizi e workload, App Hub non elimina i workload e i servizi associati dalla tua applicazione. Devi annullare la registrazione del workload o del servizio separatamente.

Prerequisiti

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

  1. Assicurati di disporre del ruolo IAM richiesto per attivare o creare un account di fatturazione per il tuo progetto di gestione.
  2. Scegli una cartella esistente o creane una nuova su cui puoi attivare la gestione delle app. Per scoprire di più su come creare una cartella, consulta Creare cartelle.
  3. Assicurati di aver deciso chi detiene i ruoli IAM (Identity and Access Management) per App Hub: Amministratore App Hub, Editor App Hub e Visualizzatore App Hub. Per ulteriori informazioni sui ruoli e sulle autorizzazioni, consulta Ruoli e autorizzazioni di App Hub.

Ruoli obbligatori

Per ottenere le autorizzazioni necessarie per modificare le risorse di App Hub, chiedi all'amministratore di concederti i seguenti ruoli IAM nella cartella abilitata per le app:

  • Per creare e aggiornare le applicazioni e registrare e annullare la registrazione di servizi e carichi di lavoro:
  • Per attivare la gestione delle app in una cartella: Amministratore della cartella (resourcemanager.folderAdmin)
  • Per visualizzare applicazioni, servizi e workload e i relativi attributi nei Google Cloud servizi che supportano la gestione delle applicazioni: App Hub Management Viewer (roles/apphub.appManagementViewer)

Per ulteriori informazioni 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.

Abilita la gestione delle app

In questa sezione, seleziona una cartella e abilita la gestione delle app al suo interno. Quando configuri la gestione delle applicazioni per una cartella, la procedura di abilitazione include le seguenti azioni:

  • Creazione di un nuovo progetto di gestione nella cartella. Il progetto di gestione è un progetto di proprietà di Google che non puoi spostare o eliminare. A una cartella abilitata per le app è associato un solo progetto di gestione. Il progetto di gestione viene utilizzato per gestire la quota e la fatturazione per tutti i progetti discendenti associati alla cartella abilitata per le app.
  • Attivazione di API per servizi come App Hub e Gemini Cloud Assist che supportano la gestione delle applicazioni.
  1. Nella console Google Cloud, vai alla pagina App Hub.

    Vai ad App Hub

  2. In base ai seguenti scenari, segui questi passaggi:

    • Se ti trovi in un Google Cloud progetto o in una Google Cloud cartella non abilitata per l'app:
      1. Fai clic su Seleziona una cartella.
      2. Nella finestra di dialogo Seleziona una cartella, seleziona una cartella abilitata per le app. Se hai bisogno di informazioni sulle cartelle abilitate per le app, rivolgiti all'amministratore. Se hai selezionato una cartella non abilitata per le app e disponi del ruolo IAM Amministratore della cartella (resourcemanager.folderAdmin), attiva la gestione delle app nella cartella. Per ulteriori informazioni, consulta Attivare la gestione delle app e le API in una cartella.
    • Se ti trovi in una Google Cloud cartella abilitata per le app, in questa pagina, vai a Designare gli utenti di App Hub.

    L'attivazione della gestione delle applicazioni in una cartella crea un progetto di proprietà di Google chiamato progetto di gestione con il seguente formato FOLDER_DISPLAY_NAME-mp. Il progetto di gestione ospita i progetti discendenti della cartella abilitata per le app e aiuta a gestire le funzionalità tra progetti. Ora puoi creare applicazioni App Hub per i progetti diretti in questa cartella abilitata per le app.

  3. (Facoltativo) Attiva la rete VPC condivisa in questo progetto di gestione. Per maggiori informazioni, consulta Utilizzare i Controlli di servizio VPC con App Hub.

  4. (Facoltativo) Puoi creare progetti o spostarli da un'altra cartella alla cartella abilitata per l'app. Puoi quindi creare applicazioni nella cartella abilitata per le app per gestire i servizi e i carichi di lavoro nel progetto. Per scoprire di più sulla creazione di progetti, consulta la sezione Creare progetti. Per ulteriori informazioni su come spostare un progetto, consulta Spostamento di un progetto.

Designare gli utenti di App Hub

Se sei l'autore del progetto, ti viene concesso il ruolo di proprietario di base (roles/owner). Per impostazione predefinita, questo ruolo IAM include le autorizzazioni necessarie per l'accesso completo alla maggior parte delle risorseGoogle Cloud .

Se non sei l'autore del progetto, le autorizzazioni richieste devono essere concesse al principale appropriato nel progetto. 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 di calcolo). Per ottenere le autorizzazioni necessarie per completare questo tutorial, chiedi all'amministratore di concederti il seguente ruolo IAM nel progetto:

Console

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

    Vai a IAM

  2. Assicurati che il selettore di progetti nella barra di navigazione superiore mostri la cartella abilitata per l'app. Il selettore di ambito ti consente di sapere in quale organizzazione, cartella o progetto lavori. Se non sei nella cartella abilitata per le app, segui questi passaggi per selezionarne una:

    1. Nel selettore Ambito, fai clic sull'opzione selezionata.
    2. Nella finestra di dialogo Seleziona una risorsa, esegui una delle seguenti operazioni:
      • Dall'elenco delle cartelle, seleziona la cartella FOLDER_DISPLAY_NAME.
      • Cerca la cartella FOLDER_DISPLAY_NAME e selezionala.
  3. Nella pagina IAM, fai clic su Concedi l'accesso. Viene visualizzato il riquadro Concedi l'accesso.

  4. Nel campo Nuove entità, inserisci l'indirizzo email della persona responsabile dell'amministrazione di App Hub, ovvero il ruolo Amministratore di App Hub nella cartella abilitata per le app.

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

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

  7. Ripeti i passaggi per concedere ai singoli il ruolo Visualizzatore per la gestione delle app per visualizzare i dati delle applicazioni e i relativi attributi neiGoogle Cloud servizi che supportano la gestione delle app. Questo ruolo viene concesso alla persona in tutti i progetti e le sottocartelle della cartella abilitata per l'app.

  8. Fai clic su Salva.

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. Concedi alle persone che amministreranno App Hub il ruolo di amministratore di App Hub nella cartella abilitata per le app. Ripeti il seguente comando per ogni amministratore. Per creare applicazioni, devono disporre del ruolo di amministratore di App Hub.

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

    Sostituisci quanto segue:

    • MANAGEMENT_PROJECT_ID: l'ID del progetto di gestione nel formatogoogle-mpf-FOLDER_ID. Puoi trovare l'ID progetto di gestione nella pagina Impostazioni di IAM (Identity and Access Management) e amministrazione della console Google Cloud. Se non riesci a trovare l'ID progetto di gestione, è possibile che non ti trovi in una cartella con l'app abilitata. Dal selettore di progetti, seleziona la cartella abilitata per le app.
    • MANAGEMENT_PROJECT_ADMIN: l'utente che ha il ruolo App Hub Admin nel progetto. Questo valore ha il formato username@yourdomain, ad esempio robert.smith@example.com.
  4. Concedi il ruolo Visualizzatore della gestione delle app nella cartella abilitata per le app per consentire alle persone di visualizzare i dati dell'applicazione e i relativi attributi nei Google Cloud servizi che supportano la gestione delle applicazioni. Questo ruolo viene concesso alla persona in tutti i progetti e le sottocartelle della cartella abilitata per l'app.

    gcloud resource-manager folders add-iam-policy-binding FOLDER_ID \
        --member='user:MANAGEMENT_PROJECT_ADMIN' \
        --role='roles/apphub.appManagementViewer'
    

    Sostituisci FOLDER_ID con l'ID del progetto. Puoi trovare l'ID cartella abilitata per le app nella pagina Impostazioni di IAM e amministrazione della console Google Cloud. Per assicurarti che la cartella sia attivata per le app, nella pagina Impostazioni deve essere visualizzato l'ID progetto di gestione. Se non riesci a trovare l'ID progetto di gestione, è possibile che non ti trovi in una cartella con l'app abilitata. Dal selettore di progetti, seleziona la cartella abilitata per l'app.

Crea un'applicazione

Se non ne hai già una, crea un'applicazione che fungerà da contenitore per i tuoi servizi e carichi di lavoro. In base all'ambito dei servizi e dei carichi di lavoro nella cartella abilitata per le app, crea un'applicazione globale o regionale.

  • Un'applicazione globale ti consente di registrare i servizi e i workload rilevati dalle risorse Google Cloud regionali e globali.
  • Un'applicazione regionale ti consente di registrare i servizi e i carichi di lavoro rilevati dalle risorse Google Cloud regionali.

Tieni presente che dopo aver creato un'applicazione, non puoi modificarne l'ambito. Per ulteriori informazioni sulle applicazioni globali e regionali, consulta Applicazioni App Hub globali e regionali.

Console

  1. Assicurati di trovarti in una cartella con app abilitate.
  2. Nella console Google Cloud, vai alla pagina App di App Hub.

    Vai a Applicazioni

  3. Fai clic su Crea applicazione.

  4. Nella pagina Crea applicazione, nel riquadro Scegli la regione e il nome dell'applicazione, in base all'ambito dei servizi e dei carichi di lavoro che vuoi registrare nell'applicazione, esegui una delle seguenti operazioni:

    • Per creare un'applicazione che ti consenta di registrare servizi e workload da una località globale, seleziona Globale.

    • Per creare un'applicazione che ti consenta di registrare servizi e workload da un'unica posizione:

      1. Seleziona Regionale.
      2. Seleziona una Regione.
  5. Inserisci il nome dell'applicazione e fai clic su Continua.

  6. (Facoltativo) Nella sezione Aggiungi attributi, inserisci il nome visualizzato.

  7. (Facoltativo) Nell'elenco Criticità, per indicare l'importanza dell'applicazione, seleziona una delle seguenti opzioni:

    • Mission critical
    • Alta
    • Medio
    • Bassa
  8. (Facoltativo) Nell'elenco Ambiente, per indicare la fase del ciclo di vita del software, seleziona una delle seguenti opzioni:

    • Produzione
    • Staging
    • Sviluppo
    • Test
  9. (Facoltativo) Aggiungi i seguenti dettagli come richiesto per i 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 di un proprietario.
    2. Inserisci l'indirizzo email del proprietario. Questo valore deve avere il formato username@yourdomain, ad esempio 222larabrown@gmail.com.
  10. Ripeti questi passaggi per ogni sviluppatore, operatore e proprietario dell'attività.

  11. Fai clic su Crea.

gcloud

  1. Crea una nuova applicazione chiamata APPLICATION_NAME e assegnale un nome visualizzato, APPLICATION_DISPLAY_NAME.

    gcloud apphub applications create APPLICATION_NAME \
        --display-name='APPLICATION_DISPLAY_NAME' \
        --scope-type=SCOPE_TYPE \
        --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=MANAGEMENT_PROJECT_ID \
        --location=REGION
    

    Sostituisci quanto segue:

    • APPLICATION_NAME: il nome dell'applicazione. Il nome deve includere solo caratteri alfanumerici minuscoli senza spazi.
    • APPLICATION_DISPLAY_NAME: il nome visualizzato dell'applicazione.
    • SCOPE_TYPE: l'ambito della tua applicazione che definisce quali servizi e carichi di lavoro sono disponibili per la registrazione all'applicazione. Utilizza uno dei seguenti valori:
      • REGIONAL
      • GLOBAL
    • CRITICALITY_LEVEL: (facoltativo) indica quanto è critica un'applicazione, un servizio o un carico di lavoro per le operazioni aziendali. Fornisci uno dei seguenti valori:
      • MISSION_CRITICAL
      • HIGH
      • MEDIUM
      • LOW
    • ENVIRONMENT: (facoltativo) indica le fasi del ciclo di vita del software. Fornisci uno dei seguenti valori:
      • PRODUCTION
      • STAGING
      • DEVELOPMENT
      • TEST
    • DISPLAY-NAME-DEVELOPER, DISPLAY-NAME-OPERATOR e DISPLAY-NAME-BUSINESS: (facoltativi) nomi visualizzati rispettivamente dello sviluppatore, dell'operatore e dei proprietari dell'attività.
    • EMAIL-NAME-DEVELOPER, EMAIL-NAME-OPERATOR e EMAIL-NAME-BUSINESS: (facoltativi) indirizzi email rispettivamente dello sviluppatore, dell'operatore e dei proprietari dell'attività. Questi valori devono avere il formato username@yourdomain, ad esempio 222larabrown@gmail.com.
    • MANAGEMENT_PROJECT_ID: l'ID del progetto di gestione nel formatogoogle-mpf-FOLDER_ID.
    • REGION: la regione dell'applicazione. A seconda di --scope-type, assegna il valore us-east1 o global.

    Ad esempio:

    gcloud apphub applications create my-application \
        --display-name='application-display-name' \
        --scope-type=REGIONAL \
        --criticality-type='MEDIUM' \
        --environment-type='STAGING' \
        --developer-owners=display-name=developer-name,email=username@yourdomain \
        --project=host-project \
        --location=us-east1
    
  2. Elenca le applicazioni nella cartella abilitata per le app.

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

    L'output è simile al seguente:

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

Registra servizi e workload

Quando registri servizi e carichi di lavoro di infrastruttura a un'applicazione, questi vengono registrati come risorse di App Hub. Utilizza un'applicazione globale per registrare risorse globali o distribuite in più regioni. Utilizza un'applicazione regionale per registrare le risorse della stessa regione dell'applicazione.

Console

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

    Vai a Applicazioni

  2. Fai clic sul nome della tua applicazione. La scheda Servizi e carichi di lavoro mostra un elenco di servizi e carichi di lavoro registrati che si trovano nella cartella abilitata per le app.

  3. Per ogni servizio o carico di lavoro da registrare:

    1. Nella scheda Servizi e workload, fai clic su Registra servizio/workload.
    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 un servizio o un carico di lavoro e fai clic su Seleziona.
    4. Nel riquadro Seleziona risorsa, inserisci un Nome per il servizio o il carico di lavoro e fai clic su Continua.
    5. Facoltativamente, nel riquadro Aggiungi attributi, aggiungi ulteriori dettagli per il servizio o il carico di lavoro nei campi che seguono. Per saperne di più, consulta la sezione Creare un'applicazione in questo documento. Tieni presente che puoi selezionare valori per i campi Criticità e Ambiente diversi da quelli impostati quando crei l'applicazione.
    6. Fai clic su Continua.
    7. Se vuoi, nella sezione Aggiungi proprietari, aggiungi ulteriori dettagli sui proprietari del servizio o del workload nei campi che seguono. Per saperne di più, consulta la sezione Creare un'applicazione in questo documento.
    8. Fai clic su Registrati.

La scheda Servizi e carichi di lavoro mostra il servizio o il workload registrato. Per ulteriori informazioni sugli stati di registrazione, consulta le proprietà e gli attributi di App Hub.

gcloud

  1. Elenca i servizi rilevati da una cartella abilitata per le app. Nel seguente comando, se vuoi, puoi specificare il flag filter per restituire i servizi del progetto specificato che sono disponibili per la registrazione a un'applicazione.

    gcloud apphub discovered-services list \
        --filter='FILTER_RESOURCES' \
        --project=MANAGEMENT_PROJECT_ID \
        --location=REGION
    

    Sostituisci FILTER_RESOURCES con filtri come:

    • service_properties.gcp_project=projects/PROJECT_ID
    • service_properties.gcp_project=projects/PROJECT_ID AND service_reference.uri~"forwardingRules" L'output è simile al seguente:
    ID                           SERVICE_REFERENCE                                                                                                                    SERVICE_PROPERTIES
    [DISCOVERED_SERVICE_ID]    {'uri': '//compute.googleapis.com/projects/[PROJECT_NUMBER]/regions/REGION/forwardingRules/forwarding-rule'}     {'gcpProject': 'projects/PROJECT_1', 'location': 'REGION'}
    

    Copia l'ID servizio DISCOVERED_SERVICE_ID dall'output da utilizzare nel passaggio successivo.

  2. Registra la regola di inoltro forwarding-rule-name in un progetto come servizio per la tua applicazione.

    gcloud apphub applications services create SERVICE_NAME \
        --discovered-service='projects/MANAGEMENT_PROJECT_ID/locations/REGION/discoveredServices/DISCOVERED_SERVICE' \
        --display-name='SERVICE_DISPLAY_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=MANAGEMENT_PROJECT_ID \
        --location=REGION
    

    Sostituisci quanto segue:

    • SERVICE_NAME: un nome con cui registrare il servizio.
    • DISCOVERED_SERVICE_ID: l'ID servizio ricavato dall'output del passaggio precedente.
    • SERVICE_DISPLAY_NAME: il nome visualizzato della tua applicazione.

    Note:

    • criticality-type e environment-type: (facoltativo) devi fornire uno dei valori specificati, che possono essere diversi da quelli impostati durante la creazione dell'applicazione. Per ulteriori informazioni, consulta Creare un'applicazione in questo documento.
    • developer-owners, operator-owners e business-owners: (facoltativo). Per saperne di più, consulta la sezione Creare un'applicazione in questo documento.

    Ad esempio:

    gcloud apphub applications services create my-service \
        --display-name='mywebserver-service' \
        --application=my-application \
        --criticality-type='MEDIUM' \
        --environment-type='STAGING' \
        --developer-owners=display-name=developer-name,email=username@yourdomain \
        --folder=folder-ID \
        --location=us-east1
    
  3. Elenca i workload rilevati da una cartella abilitata per le app. Nel seguente comando, puoi specificare facoltativamente il filter per restituire i carichi di lavoro del progetto specificato che possono essere registrati a un'applicazione.

    gcloud apphub discovered-workloads list \
        --filter='FILTER_RESOURCES' \
        --project=MANAGEMENT_PROJECT_ID \
        --location=REGION
    

    Sostituisci FILTER_RESOURCES con un filtro come workload_properties.gcp_project=projects/PROJECT_ID.

    Viene visualizzato un output simile al seguente, che include un gruppo di istanze gestite non registrato:

    ID                           WORKLOAD_REFERENCE                                                                                                      WORKLOAD_PROPERTIES
    [DISCOVERED_WORKLOAD]   {'uri': '//compute.googleapis.com/projects/[PROJECT_NUMBER]/regions/REGION/instanceGroups/mig-name'}     {'gcpProject': 'projects/PROJECT', 'location': 'REGION'}
    

    Copia l'ID del carico di lavoro dall'output da utilizzare nel passaggio successivo.

  4. Registra il bilanciatore del carico mig-name del progetto come workload per la tua applicazione.

    gcloud apphub applications workloads create WORKLOAD_NAME \
        --discovered-workload='projects/MANAGEMENT_PROJECT_ID/locations/REGION/discoveredWorkloads/DISCOVERED_WORKLOAD_ID' \
        --display-name=WORKLOAD_DISPLAY_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=MANAGEMENT_PROJECT_ID \
        --location=REGION
    

    Sostituisci quanto segue:

    • WORKLOAD_NAME: un nome con cui registrare il carico di lavoro.
    • DISCOVERED_WORKLOAD_ID: l'ID del workload dall'output del passaggio precedente.
    • WORKLOAD_DISPLAY_NAME: il nome visualizzato della tua applicazione.

    Note:

    • criticality-type e environment-type: (facoltativo) devi fornire uno dei valori specificati, che possono essere diversi da quelli impostati durante la creazione dell'applicazione. Per ulteriori informazioni, consulta Creare un'applicazione in questo documento.
    • developer-owners, operator-owners e business-owners: (facoltativo). Per saperne di più, consulta la sezione Creare un'applicazione in questo documento.

    Ad esempio:

    gcloud apphub applications workloads create my-workload \
        --display-name='mywebserver-deployment1' \
        --application=my-application \
        --criticality-type='MEDIUM' \
        --environment-type='STAGING' \
        --developer-owners=display-name=developer-name,email=username@yourdomain \
        --folder=folder-ID \
        --location=us-east1
    

La procedura di configurazione di App Hub è completata.

Aggiungere o rimuovere progetti

Puoi modificare gli allegati del progetto per rendere disponibili diverse risorse di infrastruttura da raggruppare in un'applicazione.

Console

Aggiungere un progetto a una cartella abilitata per le app

  1. In the Google Cloud console, go to the project selector page.

    Go to project selector

  2. Click Create project.

  3. Name your project. Make a note of your generated project ID.

  4. Edit the other fields as needed.

  5. Click Create.

Rimuovere un progetto da una cartella abilitata per l'app

  1. In the Google Cloud console, go to the Manage resources page.

    Go to Manage resources

  2. In the project list, select the project that you want to delete, and then click Delete.
  3. In the dialog, type the project ID, and then click Shut down to delete the project.

gcloud

Aggiungere un progetto a una cartella abilitata per le app

gcloud projects create PROJECT_ID \
    --folder FOLDER_ID

Rimuovere un progetto da una cartella abilitata per l'app

    Delete a Google Cloud project:

    gcloud projects delete PROJECT_ID

Passaggi successivi