Questa pagina è stata tradotta dall'API Cloud Translation.

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:

Gestisci risorse, autorizzazioni e fatturazione del progetto: Proprietario del progetto (roles/owner)
Gestisci tutti i componenti dell'applicazione sul progetto: App Hub Admin (roles/apphub.admin)

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:

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.
Assicurati che sia installata la versione più recente di Google Cloud CLI:
```
gcloud components update
```
Trova l'ID progetto.
Imposta il progetto come progetto predefinito per i comandi:
```
gcloud config set project PROJECT_ID
```
Sostituisci PROJECT_ID con l'ID del progetto.

Abilita l'API App Hub:

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

Collega il progetto a se stesso per creare un limite di gestione delle applicazioni:
```
gcloud alpha apphub boundary update \
    --crm-node="projects/$(gcloud projects describe PROJECT_ID --format='value(projectNumber)')" \
    --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.

Conferma lo stato dell'allegato:

gcloud alpha 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_NUMBER
createTime: 2025-08-28T19:04:47Z
updateTime: 2025-08-28T19:04:47Z
type: AUTOMATIC

PROJECT_NUMBER è il numero di progetto corrispondente al tuo ID progetto.

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

Nella console Google Cloud , utilizza il selettore di progetti per selezionare il progetto di gestione.
Vai alla pagina IAM:

Vai a IAM
Fai clic su Concedi l'accesso. Viene visualizzato il riquadro Concedi l'accesso.
Nel campo Nuove entità, inserisci l'indirizzo email dell'entità a cui vuoi concedere l'accesso ad App Hub.
Fai clic su Seleziona un ruolo e inserisci App Hub nel campo Filtro.
Seleziona il ruolo IAM di App Hub che intendi assegnare all'entità e fai clic su Salva.

gcloud

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 preside 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 limite di 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:

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.
Assicurati che sia installata la versione più recente di Google Cloud CLI:
```
gcloud components update
```
Trova l'ID progetto.
Imposta il progetto come progetto predefinito per i comandi:
```
gcloud config set project PROJECT_ID
```
Sostituisci PROJECT_ID con l'ID del progetto.
Scollega il progetto dal relativo confine per disattivare la gestione delle applicazioni:
```
gcloud alpha apphub boundary update \
    --project=PROJECT_ID \
    --location=global \
    --clear-crm-node
```
Questo comando aggiorna la risorsa di confine e rimuove l'allegato, disabilitando la gestione delle applicazioni per il progetto.
Conferma il distacco descrivendo il confine:
```
gcloud alpha 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.
(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
```