Configurare un singolo progetto

Questo documento descrive come configurare un singolo progetto Google Cloud per gestire le applicazioni. Questa configurazione è nota anche come limite di un singolo progetto.

In questa configurazione, il progetto Google Cloud è configurato per gestire le proprie applicazioni e i propri componenti, fungendo da progetto di gestione autonomo. Questo approccio è il modo più rapido per iniziare a gestire le applicazioni se tutti i componenti dell'applicazione risiedono in questo singolo progetto. App Hub rileva automaticamente tutte le risorse supportate all'interno del progetto, rendendole pronte per essere organizzate in applicazioni.

Limitazioni

Il limite di un singolo progetto offre un supporto delle funzionalità diverso rispetto al limite a livello di cartella. App Hub, Application Design Center e Application Monitoring supportano completamente i singoli progetti, ma altri servizi Google Cloud incentrati sulle applicazioni, come Cloud Hub e Gemini Cloud Assist, richiedono un limite a livello di cartella.

Per un confronto del supporto delle funzionalità tra i modelli a livello di singolo progetto e cartella, vedi Supporto delle funzionalità per tipo di limite.

Prima di iniziare

Scegli il Google Cloud progetto che vuoi utilizzare per gestire le tue applicazioni. Questo progetto fungerà da progetto di gestione autonomo. Puoi utilizzare un progetto esistente o crearne uno nuovo.

Ruoli obbligatori

Per ottenere le autorizzazioni necessarie per configurare un singolo progetto per la gestione delle applicazioni, chiedi all'amministratore di concederti i seguenti ruoli IAM sul progetto che vuoi configurare come progetto di gestione autonomo:

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

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

Abilitare la gestione delle applicazioni in un progetto

Questa azione configura il progetto come progetto di gestione autonomo e abilita le API richieste per i metadati e le configurazioni dell'applicazione. Il progetto viene quindi chiamato progetto abilitato per le app.

Per abilitare la gestione delle applicazioni in un singolo progetto:

Console

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

  2. Vai alla pagina Panoramica da App Hub:

    Vai alla panoramica

  3. Fai clic su Configura Hub app.

    Se il tuo progetto si trova già all'interno di una cartella abilitata alle app, la pagina non mostra l'opzione Configura App Hub. Ti viene chiesto di selezionare la cartella abilitata per le app o di utilizzare il progetto corrente da un menu. Seleziona il progetto corrente per continuare con la configurazione di un singolo progetto. Per scoprire di più sulle considerazioni relative alla gerarchia delle risorse per la gestione delle applicazioni, consulta Pianificare la gerarchia delle risorse per la gestione delle applicazioni.

  4. Nella pagina Attiva App Hub, scegli una delle seguenti opzioni:

    • Configurazione rapida: gestisci una configurazione predefinita per le risorse in questo progetto e definisci la tua prima applicazione per l'adozione iniziale.
    • Configurazione completa: gestisci le configurazioni personalizzate per le tue applicazioni, inclusa la configurazione dei controlli di accesso iniziali e, facoltativamente, l'aggiunta di altri progetti per confini di più progetti.

  5. Prendi nota del nome e dell'ID del progetto. Queste informazioni identificano il progetto di gestione e utilizzerai questi valori per concedere l'accesso.

  6. Esamina l'elenco delle API in fase di abilitazione. Alcune API hanno costi associati. Scopri di più sui costi delle API o fai clic su ciascuna API per visualizzare i costi associati.

  7. Fai clic su Continua.

  8. Completa la configurazione in base alla tua selezione:

    • Se hai selezionato Configurazione rapida, la scheda Definisci applicazione ti consente di definire facoltativamente un'applicazione ora o di completare la configurazione senza crearne una. Ora puoi creare applicazioni e registrarvi risorse. Puoi anche iniziare con una guida rapida per le applicazioni.

    • Se hai selezionato Configurazione completa, concedi l'accesso personalizzato incentrato sulle applicazioni per i tuoi amministratori:

      1. Nella scheda Definisci confine, verifica i dati del progetto. La tabella Progetti nel confine mostra solo il progetto che definisce il confine del progetto singolo. Per la configurazione del confine di un singolo progetto, non aggiungere altri progetti.

      2. Fai clic su Continua.

      3. Nella scheda Concedi accesso, scegli i ruoli e le autorizzazioni IAM appropriati per gli amministratori del progetto. Per un elenco dei ruoli consigliati incentrati sulle applicazioni nei prodottiGoogle Cloud , vedi Concedere ruoli incentrati sulle applicazioni agli utenti.

      4. Nella casella Nuove entità, inserisci gli utenti, i gruppi o i service account che devono disporre dell'accesso amministrativo alle attività incentrate sulle applicazioni nel progetto.

      5. Fai clic su Concedi ruoli e poi su Completa.

      Ora puoi registrare risorse esistenti in un'applicazione o creare un modello di applicazione con Application Design Center.

In un secondo momento, puoi concedere ruoli IAM aggiuntivi alle tue entità dalla pagina IAM. Per ulteriori informazioni, consulta Concedi un ruolo IAM utilizzando la console Google Cloud .

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:

    gcloud components update

  3. Trova l'ID progetto.

  4. Imposta il progetto come progetto predefinito per i comandi:

    gcloud config set project PROJECT_ID

    Sostituisci PROJECT_ID con l'ID del progetto.

  5. Abilita l'API App Hub:

    gcloud services enable apphub.googleapis.com \
    --project PROJECT_ID

  6. Collega il progetto a se stesso per creare un limite di gestione delle applicazioni:

    gcloud apphub boundary update \
    --crm-node=projects/PROJECT_ID \
    --project=PROJECT_ID \
    --location=global

    Questo comando configura il progetto come progetto di gestione autonomo, consentendo ad App Hub di rilevare automaticamente tutte le risorse supportate al suo interno.

  7. Conferma lo stato dell'allegato:

    gcloud apphub boundary describe \
    --project=PROJECT_ID \
    --location=global

    Ottieni un output simile al seguente esempio:

    name: projects/PROJECT_ID/locations/LOCATION/boundary
crmNode: projects/PROJECT_ID
createTime: 2025-08-28T19:04:47Z
updateTime: 2025-08-28T19:04:47Z
type: AUTOMATIC

Al termine della configurazione del progetto di gestione, le API richieste per la gestione delle applicazioni vengono abilitate e puoi iniziare a utilizzare App Hub per raggruppare servizi e carichi di lavoro nelle applicazioni. (Facoltativo) Esamina le API consigliate per accedere alle funzionalità avanzate.

Assegnare ruoli e autorizzazioni di App Hub

Per consentire agli utenti di scoprire, registrare e gestire i componenti dell'applicazione all'interno di questo progetto utilizzando App Hub, devi concedere loro i ruoli e le autorizzazioni di App Hub appropriati.

Segui questi passaggi:

Console

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

  2. Vai alla pagina IAM:

    Vai a IAM

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

  4. Nel campo Nuove entità, inserisci l'indirizzo email dell'entità a cui vuoi concedere l'accesso ad App Hub.

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

  6. Seleziona il ruolo IAM di App Hub che intendi assegnare all'entità e fai clic su Salva.

gcloud

  1. Concedi l'accesso alle entità nel progetto di gestione:

    gcloud projects add-iam-policy-binding PROJECT_ID \
    --member='user:EMAIL_ADDRESS' \
    --role='ROLE_NAME'

    Sostituisci quanto segue:

    • PROJECT_ID: l'ID del progetto di gestione.
    • EMAIL_ADDRESS: l'indirizzo email del dirigente che deve ottenere l'accesso ad App Hub. Questo valore deve avere il formato username@yourdomain, ad esempio, my.user@example.com.
    • ROLE_NAME: il ruolo IAM di App Hub che vuoi assegnare all'entità, ad esempio roles/apphub.admin.

Modificare il confine della gestione delle applicazioni

Se vuoi modificare il progetto che definisce il limite di un singolo progetto, disattiva la gestione delle applicazioni nel vecchio progetto e attivala nel nuovo. I dati delle applicazioni non vengono migrati e devi ricreare le applicazioni nel nuovo progetto.

Per passare da un confine a un singolo progetto a un confine a livello di cartella, configura una cartella abilitata alle app. Questa azione configura un nuovo progetto di gestione nella cartella. Dovrai ricreare le applicazioni in questo nuovo progetto di gestione.

Disattivare la gestione delle applicazioni in un progetto

Puoi disattivare la gestione delle applicazioni in un progetto se non vuoi più gestirne le risorse nelle applicazioni App Hub.

Quando disabiliti la gestione delle applicazioni nel progetto, questo viene scollegato dal relativo confine di gestione delle applicazioni. I servizi e i workload nelle tue applicazioni continuano a esistere, ma il loro stato di registrazione cambia in detached. Se decidi di riattivare la gestione delle applicazioni nel progetto, App Hub può rilevare nuovamente le applicazioni, i servizi e i carichi di lavoro e aggiornare lo stato di registrazione se le risorse sottostanti esistono ancora.

Per disattivare la gestione delle applicazioni in un singolo progetto:

Console

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

    Vai a Benvenuto

  2. Vai alla pagina Impostazioni perimetri dall'App Hub:

    Vai alle impostazioni del confine

  3. Seleziona la casella di controllo del progetto per scollegarlo dal confine e disattivare la gestione delle applicazioni.

  4. Fai clic su Scollega progetti.

    La tabella Progetti nel confine viene aggiornata e non mostra più le informazioni del progetto.

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:

    gcloud components update

  3. Trova l'ID progetto.

  4. Imposta il progetto come progetto predefinito per i comandi:

    gcloud config set project PROJECT_ID

    Sostituisci PROJECT_ID con l'ID del progetto.

  5. Scollega il progetto dal relativo confine per disattivare la gestione delle applicazioni:

    gcloud apphub boundary update \
    --project=PROJECT_ID \
    --location=global \
    --crm-node=""

    Questo comando aggiorna la risorsa di confine e rimuove l'allegato, disabilitando la gestione delle applicazioni per il progetto.

  6. Conferma il distacco descrivendo il confine:

    gcloud apphub boundary describe \
    --project=PROJECT_ID \
    --location=global

    L'output non contiene un campo crmNode, a conferma che la gestione delle applicazioni è disattivata nel progetto.

  7. (Facoltativo) Elimina tutte le applicazioni nel progetto e poi disabilita l'API App Hub se non utilizzerai più le funzionalità delle applicazioni in questo progetto:

    gcloud services disable apphub.googleapis.com \
    --project=PROJECT_ID

Passaggi successivi