Creare progetti

I progetti sono l'unità operativa fondamentale nella gerarchia delle risorse Google Cloude ti consentono di organizzare, isolare e controllare le tue risorse cloud. Situati tra le cartelle (o la risorsa dell'organizzazione) e le risorse di servizio, come le macchine virtuali e lo spazio di archiviazione, i progetti ti aiutano a gestire le API, la fatturazione e le autorizzazioni in tutti gli ambienti. Per creare e gestire i progetti, puoi utilizzare la console Google Cloud , Google Cloud CLI o l'API Cloud Resource Manager.

Caratteristiche principali dei progetti

Le caratteristiche principali dei progetti includono:

  • Il container di servizi principale: un progetto è il livello di base in cui abiliti i servizi (API) Google Cloud e crei risorse come istanze Compute Engine o set di dati BigQuery.

  • Confine di attendibilità: i progetti fungono da livello di isolamento. Per impostazione predefinita, le risorse di un progetto non hanno accesso alle risorse di un altro progetto, il che contribuisce a stabilire un perimetro sicuro per applicazioni o ambienti diversi.

  • L'unità di fatturazione: i progetti sono il modo principale per monitorare, organizzare e separare i costi all'interno dell'organizzazione.

  • Il punto di collegamento delle policy: sebbene i progetti ereditino le policy dalle cartelle e dalla risorsa organizzazione, il livello di progetto è il punto più comune in cui concedi autorizzazioni Identity and Access Management (IAM) specifiche a sviluppatori e service account per le attività quotidiane.

Prima di iniziare

Scopri di più sulla risorsa di progetto nella panoramica della gerarchia delle risorse. Per indicazioni sulla configurazione della gerarchia delle risorse, consulta Decidi una gerarchia delle risorse per la tua zona di destinazione Google Cloud .

Per il tuo progetto vengono utilizzati i seguenti identificatori:

  • Nome progetto: un nome leggibile per il progetto.

    Il nome del progetto deve soddisfare i seguenti requisiti:

    • Deve avere una lunghezza compresa tra 4 e 30 caratteri.
    • Può contenere lettere, numeri, virgolette singole, trattini, spazi o punti esclamativi.
    • Deve terminare con una lettera o una cifra.

    Il nome del progetto non è utilizzato da nessuna API di Google. Puoi modificare il nome del progetto in qualsiasi momento durante o dopo la creazione del progetto. I nomi dei progetti non devono essere univoci.

  • ID progetto: un identificatore univoco globale per il tuo progetto.

    Un ID progetto è una stringa univoca che distingue il tuo progetto da tutti gli altri in Google Cloud. Dopo aver inserito un nome per il progetto, la consoleGoogle Cloud genera un ID progetto univoco che può essere una combinazione di lettere, numeri e trattini. Utilizza l'ID progetto generato, ma puoi modificarlo durante la creazione del progetto. Dopo la creazione del progetto, l'ID progetto è permanente.

    Un ID progetto deve soddisfare i seguenti requisiti:

    • Deve avere una lunghezza compresa tra 6 e 30 caratteri.
    • Può contenere solo lettere minuscole, numeri e trattini.
    • Deve iniziare con una lettera.
    • Non può terminare con un trattino.
    • Non può essere in uso o essere stato utilizzato in precedenza, inclusi i progetti eliminati.
    • Non può contenere stringhe con limitazioni come google e ssl. Evita di utilizzare stringhe come undefined e null in un ID progetto.

  • Numero di progetto: un numero di progetto è un identificatore univoco generato automaticamente per il tuo progetto. Per trovare il numero di progetto, consulta Identificazione dei progetti.

Non includere informazioni sensibili, ad esempio informazioni che consentono l'identificazione personale o dati di sicurezza, nel nome del progetto, nell'ID progetto o in altri nomi delle risorse. L'ID progetto viene visualizzato nel nome di molte altre risorse Google Cloud. Se fai riferimento al progetto o alle sue risorse, l'ID progetto e il nome della risorsa vengono esposti.

Crea un progetto

Per creare un progetto, devi disporre dell'autorizzazione resourcemanager.projects.create. Questa autorizzazione è inclusa in ruoli come Project Creator (roles/resourcemanager.projectCreator).

Per informazioni su come concedere il ruolo alle persone e limitare l'accesso a livello di risorsa dell'organizzazione, consulta la pagina Gestione dei ruoli predefiniti dell'organizzazione.

Se non specifichi la risorsa principale, ne viene selezionata una automaticamente, se applicabile, in base al dominio dell'account utente.

Puoi creare un nuovo progetto utilizzando la console Google Cloud , Google Cloud CLI o il metodo projects.create().

Console

Per creare un nuovo progetto, segui questi passaggi:

  1. Vai alla pagina Gestisci risorse nella console Google Cloud .

    Vai a Gestisci risorse

    I passaggi rimanenti vengono visualizzati nella console Google Cloud .

  2. Fai clic su Create project (Crea progetto).
  3. Nella finestra Nuovo progetto visualizzata, inserisci un nome per il progetto e seleziona un account di fatturazione appropriato. Il nome del progetto può contenere solo lettere, numeri, virgolette singole, trattini, spazi o punti esclamativi e deve avere una lunghezza compresa tra 4 e 30 caratteri.
  4. Inserisci la cartella o l'organizzazione padre nella casella Risorsa padre. Questa risorsa sarà l'entità padre gerarchica di un nuovo progetto. Se Nessuna organizzazione è un'opzione, puoi selezionarla per creare il nuovo progetto come livello superiore della sua gerarchia di risorse.
  5. Una volta specificati i dettagli del nuovo progetto, fai clic su Crea.

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 e viene visualizzato un prompt della riga di comando. Cloud Shell è un ambiente shell con Google Cloud CLI già installata e con valori già impostati per il progetto corrente. L'inizializzazione della sessione può richiedere alcuni secondi.

  2. Per creare un nuovo progetto, utilizza il comando gcloud projects create:

    gcloud projects create PROJECT_ID

    Dove PROJECT_ID è l'ID del progetto che vuoi creare. Un ID progetto deve iniziare con una lettera minuscola e può contenere solo lettere ASCII, cifre e trattini e deve avere una lunghezza compresa tra 6 e 30 caratteri.

    Per creare un progetto con una risorsa organizzazione o una cartella come risorsa padre, utilizza i flag --organization o --folder. Poiché una risorsa può avere un solo elemento principale, è possibile utilizzare solo uno di questi flag:

    gcloud projects create PROJECT_ID --organization=ORGANIZATION_ID

    gcloud projects create PROJECT_ID --folder=FOLDER_ID

REST

Non puoi utilizzare determinate parole nell'ID progetto quando crei un nuovo progetto con il metodo projects.create(). Alcuni esempi includono google, null, undefined e ssl. Se utilizzi una parola limitata, la richiesta restituisce un errore INVALID_ARGUMENT.

La seguente richiesta crea solo un progetto e non lo associa automaticamente a un account di fatturazione. Utilizza il metodo projects.updateBillingInfo per impostare o aggiornare l'account di fatturazione associato a un progetto.

Crea una richiesta di progetto:

POST https://cloudresourcemanager.googleapis.com/v3/projects/
Authorization: *************
Content-Type: application/json

{
    "projectId": "our-project-123",
    "name": "my project",
    "labels": {
      "mylabel": "prod"
    }
}

Risposta alla creazione del progetto:

{
    "name": "operations/pc.123456789",
}

Richiesta di operazione Get:

GET https://cloudresourcemanager.googleapis.com/v3/operations/pc.123456789
Authorization: *************
Content-Type: application/json

Ottieni la risposta dell'operazione:

{
    "name": "operations/pc.123456789",
    "done": true,
    "response": {
        "@type": "type.googleapis.com/google.cloudresourcemanager.v3.Project",
        "projectNumber": "464036093014",
        "projectId": "our-project-123",
        "lifecycleState": "ACTIVE",
        "name": "my project",
        "labels": {
        "mylabel": "prod"
        },
    "createTime": "2016-01-07T21:59:43.314Z"
    }
}

Aggiungi tag durante la creazione del progetto

I tag forniscono un modo per creare annotazioni per le risorse. Puoi aggiungere tag al momento della creazione dei progetti. Devi assegnare il ruolo Tag User durante l'aggiunta dei tag. Per saperne di più sulle autorizzazioni assegnate a questo ruolo, consulta Gestisci i tag sulle risorse. Puoi aggiungere lo spazio dei nomi per le coppie chiave-valore dei tag solo in uno dei seguenti modi:

gcloud

Per aggiungere tag durante la creazione del progetto, esegui questo comando:

gcloud projects create PROJECT_ID --organization=ORGANIZATION_ID --tags=KEY_VALUE_PAIRS

Sostituisci quanto segue:

  • PROJECT_ID è l'identificatore univoco del progetto.
  • ORGANIZATION_ID è l'identificatore univoco dell'organizzazione.
  • KEY_VALUE_PAIRS è un elenco separato da virgole di coppie chiave-valore che puoi assegnare alla tua risorsa. Un esempio di coppie chiave-valore separate da virgole è 123/environment=production, 456/create=testresource. In questo esempio, 123 e 456 sono gli identificatori univoci (ID) delle risorse organizzazione o cartella in cui sono definite le chiavi dei tag.

REST

Il seguente snippet è una richiesta JSON in cui crei un progetto e aggiungi tag annuncio.

  POST https://cloudresourcemanager.googleapis.com/v3/projects/
  Authorization: *************
  Content-Type: application/json

  {
    "projectId": "our-project-456",
    "name": "my project",
    "parent": "organizations/123",
    "tags": {
      "key": "123/environment"
      "value": "production"
    },
"tags": {
      "key": "123/costCenter"
      "value": "marketing"
  }
}

Designa gli ambienti di progetto con i tag

Puoi utilizzare i tag per distinguere visivamente i progetti in base al loro ambiente, ad esempio produzione, gestione temporanea o sviluppo. In questo modo, puoi evitare errori e migliorare la consapevolezza quando lavori in ambienti sensibili. Google aggiunge un indicatore visivo al progetto nel selettore di progetti della console Google Cloud quando viene selezionato un progetto con una coppia chiave-valore di tag specifica. Questo indicatore ti ricorda che le modifiche potrebbero influire sulle applicazioni di produzione o non di produzione associate. I tag possono essere ereditati dal progetto o impostati direttamente sul progetto.

Per utilizzare questa funzionalità, procedi nel seguente modo:

  1. Crea una chiave tag denominata environment.
  2. Crea valori dei tag per le categorie di ambiente che utilizzi. Sono supportati i seguenti valori, che vengono mappati a un badge corrispondente nel selettore di progetti della console:
    • Prod: Prod, prod, Production, production
    • Dev: Dev, dev, Development, development
    • Test: Test, test, Testing, testing, QA, qa, Quality assurance, quality assurance
    • Staging: Staging, staging, Stage, stage
  3. Associa il tag appropriato al tuo progetto creando un'associazione di tag.

Se un progetto ha più tag di ambiente (ad esempio, uno ereditato da una cartella e uno direttamente sul progetto), viene utilizzato il tag più specifico per determinare il badge.

Creazione di un progetto utilizzando un account di servizio

Puoi utilizzare un account di servizio per automatizzare la creazione dei progetti. Come agli account utente, ai service account può essere concessa l'autorizzazione per creare progetti all'interno di una risorsa organizzazione. I service account non possono creare progetti al di fuori di una risorsa organizzazione e devono specificare la risorsa padre durante la creazione di un progetto. I service account possono creare un nuovo progetto utilizzando gcloud CLI o il metodo projects.create().

Gestione delle quote di progetto

Il numero di progetti che un utente o un account di servizio può creare è limitato. Se crei un progetto al di fuori di una risorsa di organizzazione, viene utilizzata la quota del tuo account utente. Se stai creando un progetto all'interno di una risorsa organizzazione, viene controllata la quota sia del tuo account utente sia della risorsa organizzazione. Se uno dei due ha una quota rimanente, il progetto può essere creato.

Se nella tua quota rimangono meno di 30 progetti, nella pagina Nuovo progetto viene visualizzata una notifica con il numero di progetti rimanenti nella quota. Una volta raggiunto il limite di progetti, per crearne altri devi richiedere un aumento del limite. In alternativa, puoi pianificare l'eliminazione di alcuni progetti dopo 30 giorni nella pagina Gestisci risorse. I progetti che gli utenti hanno eliminato temporaneamente vengono conteggiati ai fini della quota. Questi progetti vengono eliminati completamente dopo 30 giorni.

Per richiedere capacità aggiuntiva per i progetti nella quota della tua organizzazione, segui questi passaggi:

  1. Vai alla pagina Quote e limiti di sistema.

    Vai a Quote e Limiti di sistema

  2. Nel selettore di risorse, seleziona l'organizzazione per cui vuoi aumentare la quota di progetti.

  3. Nell'opzione Filtro, seleziona Metrica e inserisci cloudresourcemanager.googleapis.com/projects_count.

  4. Seleziona API Cloud Resource Manager, fai clic su Altre azioni, quindi seleziona Modifica quota.

  5. Nella finestra di dialogo Modifiche alla quota, inserisci un nuovo valore della quota e una descrizione, quindi fai clic su Avanti.

  6. Inserisci i tuoi dati di contatto e fai clic su Invia richiesta.

Riceverai un'email di conferma della ricezione della richiesta. Se hai bisogno di ulteriore assistenza, rispondi all'email. Dopo la revisione, riceverai una notifica via email indicante se la richiesta è stata approvata.

Se non hai un'organizzazione e vuoi richiedere capacità aggiuntiva per i progetti nella tua quota, utilizza il modulo Richiedi un aumento della quota di progetti.

Passaggi successivi