Configurare un singolo progetto

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

In questa configurazione, il Google Cloud progetto è configurato per gestire le proprie applicazioni e i propri componenti, fungendo da progetto di gestione autonomo management project. Questo approccio è il modo più rapido per iniziare a gestire le applicazioni se tutti i componenti dell'applicazione risiedono all'interno di 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 ha un supporto delle funzionalità diverso rispetto al limite a livello di cartella. App Hub, App 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 di un singolo progetto e a livello di cartella, vedi Supporto delle funzionalità per tipo di limite.

Prima di iniziare

Scegli il Google Cloud progetto che vuoi utilizzare per gestire le 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 nel 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.

Abilita 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 delle applicazioni e le configurazioni. Il progetto viene quindi chiamato progetto abilitato per le app.

Per abilitare la gestione delle applicazioni in un singolo progetto:

Console

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

  2. Vai alla pagina Panoramica da App Hub:

    Vai alla panoramica

  3. Fai clic su Configura App Hub.

    Se il progetto si trova già in una cartella app, la pagina non mostra l'opzione Configura App Hub. Ti viene invece chiesto di selezionare la cartella 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, vedi Pianificare la gerarchia delle risorse per la gestione delle applicazioni.

  4. Nella pagina Abilita 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 anticipati e, facoltativamente, l'aggiunta di altri progetti per limiti 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 da abilitare. Alcune API hanno costi associati. Scopri di più sui costi delle API o fai clic su ogni 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 le risorse. Puoi anche iniziare con una guida rapida per le applicazioni.

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

      1. Nella scheda Definisci limite, verifica le informazioni del progetto. La tabella Progetti nel limite mostra solo il progetto che definisce il limite di un singolo progetto. Per la configurazione del limite 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 incentrati sulle applicazioni consigliati per i Google Cloud prodotti, vedi Concedere ruoli incentrati sulle applicazioni agli utenti.

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

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

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

In un secondo momento, puoi concedere altri ruoli IAM alle tue entità dalla pagina IAM. Per maggiori informazioni, vedi Concedere un ruolo IAM utilizzando la Google Cloud console.

gcloud

  1. Nella Google Cloud console, attiva Cloud Shell.

    Attiva Cloud Shell

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

  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. Verifica 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 sono abilitate e puoi iniziare a utilizzare App Hub per raggruppare servizi e carichi di lavoro nelle applicazioni. Facoltativamente, esamina le API consigliate per accedere alle funzionalità avanzate.

Assegna 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 appropriate .

Segui questi passaggi:

Console

  1. Nella Google Cloud console, 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. Si apre 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 dell'entità 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.

Modifica il limite di gestione delle applicazioni

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

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

Disabilita la gestione delle applicazioni in un progetto

Puoi disabilitare la gestione delle applicazioni in un progetto se non vuoi più gestire le relative risorse nelle applicazioni App Hub.

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

Per disabilitare la gestione delle applicazioni in un singolo progetto:

Console

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

    Vai a Benvenuto

  2. Vai alla pagina Impostazioni limite da App Hub:

    Vai a Impostazioni limite

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

  4. Fai clic su Scollega progetti.

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

gcloud

  1. Nella Google Cloud console, attiva Cloud Shell.

    Attiva Cloud Shell

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

  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 limite per disabilitare la gestione delle applicazioni:

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

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

  6. Verifica il distacco descrivendo il limite:

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

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

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

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

Passaggi successivi