Configurazione del progetto Google Cloud per App Engine

Un Google Cloud progetto contiene l'applicazione App Engine e altre Google Cloud risorse.

Puoi eseguire tutte le attività amministrative da Google Cloud CLI e dall'API App Engine Admin, incluse le attività comuni trattate in questo argomento.

Prima di poter eseguire il deployment delle app nell'ambiente standard di App Engine, in genere devi creare o configurare quanto segue:

1. Un Google Cloud progetto
2. Un'applicazione App Engine
3. Un account di fatturazione

Creazione di un progetto e di un'applicazione

Puoi selezionare o creare un nuovo Google Cloud progetto e un'applicazione App Engine per creare e gestire una raccolta di impostazioni, credenziali e metadati della tua app. App Engine richiede che la fatturazione sia abilitata per tutti i progetti, ma ti verranno addebitati costi solo se un progetto supera la sua quota senza costi.

Solo il ruolo Proprietario ha i privilegi per creare un'applicazione App Engine in un Google Cloud progetto e l'applicazione deve esistere prima che qualsiasi altro account possa eseguire attività su di essa. Ad esempio, l'applicazione App Engine deve essere creata prima che un account con il ruolo Deployer App Engine possa eseguire il deployment di un'app utilizzando un account di servizio.

Importante: ogni Google Cloud progetto può contenere una sola applicazione App Engine e, una volta creata, non puoi modificarne la località della tua applicazione App Engine.

gcloud

Dopo aver installato Google Cloud CLI, un account con il ruolo Proprietario del progetto può eseguire i seguenti gcloud comandi per creare un Google Cloud progetto e un'applicazione App Engine : Google Cloud

1. Esegui il comando seguente per creare un Google Cloud progetto:

   gcloud projects create PROJECT_ID

   Sostituisci PROJECT_ID con l' Google Cloud ID progetto.

2. Esegui il comando seguente per selezionare una regione e creare un'applicazione App Engine:

   gcloud app create

   Scopri di più sulle località di App Engine

3. Abilita la fatturazione nella pagina Fatturazione della Google Cloud console, per maggiori dettagli consulta Abilitare la fatturazione.

   Suggerimenti:

   • Se esegui il deployment delle app con il gcloud app deploy comando, gcloud CLI si assicurerà che il Google Cloud progetto includa un'applicazione App Engine e ti chiederà di selezionare una regione, se necessario.
   • Per verificare se esiste un'applicazione App Engine nel tuo Google Cloud progetto, puoi eseguire il gcloud app describe comando.

API

Per creare un Google Cloud progetto e un'applicazione App Engine a livello programmatico, devi utilizzare sia l'API Cloud Resource Manager sia l'API App Engine Admin:

1. Per creare un Google Cloud progetto, consulta Creare un nuovo progetto.

2. Per creare un'applicazione App Engine, consulta Creare applicazioni App Engine.

3. Abilita la fatturazione nella pagina Fatturazione della Google Cloud console, per maggiori dettagli consulta Abilitare la fatturazione.

Console

Nota: questa procedura non è applicabile a Python.

Per creare un Google Cloud progetto e un'applicazione App Engine con la fatturazione abilitata:

1. Vai alla pagina App Engine:

   Vai ad App Engine

2. Seleziona o crea un Google Cloud progetto.

3. Nella pagina Crea app , seleziona una regione, account di servizio e abilita la fatturazione:

   1. Seleziona una regione per specificare dove vuoi che si trovi l'applicazione App Engine.
      Scopri di più sulle località di App Engine
   2. Seleziona un service account per l'app da Identità e accesso API.
   3. Seleziona o crea un account di fatturazione per abilitare la fatturazione nel tuo progetto.

Una volta creata l'applicazione App Engine nel progetto, si apre la pagina Dashboard.

Località App Engine

App Engine è regionale, il che significa che l'infrastruttura che esegue le tue app si trova in una regione specifica ed è gestita da Google in modo che sia disponibile in modo ridondante in tutte le zone all'interno di quella regione.

Il rispetto dei requisiti di latenza, disponibilità o durabilità è un fattore primario per la selezione della regione in cui vengono eseguite le app. In genere puoi selezionare la regione più vicina agli utenti dell'app, ma devi anche considerare le località in cui App Engine è disponibile nonché le località degli altri Google Cloud prodotti e servizi utilizzati dall'app. L'utilizzo di servizi in più località può influire sulla latenza dell'app, nonché sui prezzi.

Non puoi modificare la regione di un'app dopo averla impostata.

Nota: due località, denominate europe-west e us-central nei comandi di App Engine e nella Google Cloud console, sono denominate rispettivamente europe-west1 e us-central1, in altre parti della documentazione di Google.

Se hai già creato un'applicazione App Engine, puoi visualizzarne la regione in uno dei seguenti modi:

• Esegui il comando gcloud app describe.

• Apri la dashboard di App Engine nella Google Cloud console. La regione viene visualizzata nella parte superiore della pagina.

OK

Abilitare la fatturazione

Per eseguire il deployment delle app, devi abilitare la fatturazione. Non ti verranno addebitati costi se rimani entro la tua quota senza costi. Se la tua applicazione ha bisogno di risorse che superano la quota senza costi, ti verranno addebitati costi per l'utilizzo aggiuntivo.

Se hai un account di fatturazione quando crei un Google Cloud progetto, allora la fatturazione viene abilitata automaticamente per quel progetto.

Per abilitare la fatturazione in un Google Cloud progetto:

1. Nella Google Cloud console, vai alla pagina Fatturazione:

   Vai a Fatturazione

2. Seleziona o crea un Google Cloud progetto.

3. A seconda che esista un account di fatturazione o che il progetto selezionato Google Cloud sia associato a un account, la pagina Fatturazione mostra una delle seguenti opzioni:

   • Se la fatturazione è già abilitata per il progetto selezionato Google Cloud , vengono elencati i dettagli dell'account di fatturazione.

   • Se non esiste un account di fatturazione, ti viene chiesto di crearne uno e di associarlo al progetto selezionato Google Cloud .

   • Se esiste un account di fatturazione, ti viene chiesto di abilitare la fatturazione se il progetto Google Cloud selezionato non è già associato a un account di fatturazione. Puoi anche fare clic su Annulla e poi su Crea account per creare e associare un nuovo account di fatturazione.

Dopo aver abilitato la fatturazione, non esiste un limite all'importo che potrebbe essere addebitato. Per avere un maggiore controllo sui costi dell'applicazione, puoi creare un budget e impostare avvisi.

Gestire la fatturazione

Utilizza la pagina Fatturazione per gestire i tuoi account di fatturazione:

1. Vai alla pagina Fatturazione nella Google Cloud console:

   Vai a Fatturazione

2. Seleziona l'account che vuoi gestire e poi vai alla pagina corrispondente per eseguire le seguenti attività di gestione:

   • Visualizza una panoramica del tuo account di fatturazione, effettua pagamenti e aggiungi amministratori dell'account di fatturazione dalla pagina Panoramica.
   • Crea budget e avvisi nella pagina Budget e avvisi.
   • Visualizza la cronologia delle transazioni e scarica le fatture dalla pagina Transazioni.
   • Esporta i dati di fatturazione in un set di dati BigQuery dalla pagina Esportazione fatturazione.
   • Configura l'account pagamenti e i contatti nella pagina Impostazioni di pagamento.
   • Imposta il metodo di pagamento nella pagina Metodo di pagamento.

Per maggiori informazioni sulla fatturazione, consulta la pagina Prezzi.

Creare budget e impostare avvisi

Puoi creare un budget per un Google Cloud progetto per evitare sorprese in fattura e monitorare tutti gli Google Cloud addebiti da un'unica posizione. Con un budget, puoi creare avvisi che inviano email agli amministratori della fatturazione quando gli addebiti superano un determinato importo.

Per creare un budget e impostare avvisi in un Google Cloud progetto:

1. Nella Google Cloud console, vai alla pagina Fatturazione:

   Vai a Fatturazione

2. Fai clic sull'account di fatturazione per il quale vuoi creare un budget.

3. Fai clic su Budget e avvisi e poi su Crea budget per iniziare a creare un budget per il tuo Google Cloud progetto.

4. Definisci il budget nella sezione Imposta budget e poi specifica le percentuali per le quali vuoi ricevere avvisi via email nella sezione Imposta avvisi budget.

5. Fai clic su Salva per impostare il budget e abilitare gli avvisi per il tuo Google Cloud progetto. Se hai più Google Cloud progetti, devi impostare budget e avvisi singolarmente in ogni progetto.

Impostare l'ID progetto per un progetto

Puoi specificare l'ID progetto in diversi modi:

• Utilizzando gcloud init quando installi Google Cloud CLI. Per visualizzare l'ID progetto predefinito di gcloud CLI, esegui gcloud config list.
• Utilizzando il comando gcloud config set project [YOUR_PROJECT_ID] per impostare l'ID progetto predefinito di gcloud CLI.
• Utilizzando il flag --project quando esegui il deployment dell'app, ad esempio: gcloud app deploy --project [YOUR_PROJECT_ID]

Se utilizzi il runtime Java, puoi specificare l'ID progetto durante il deployment utilizzando il plug-in Google Cloud per IntelliJ.

Disabilitare un'applicazione

Disabilita un'applicazione App Engine per impedire all'app di eseguire istanze e gestire le richieste. Quando disabiliti l'app, non si verifica alcuna perdita di dati né vengono modificate le impostazioni di configurazione. Ti basta riabilitare l'applicazione App Engine per avviare le istanze e continuare a gestire il traffico verso l'app.

Le risorse dell'app nell'ambiente standard e nell'ambiente flessibile sono disabilitate e, di conseguenza, non vengono addebitati costi. Tuttavia, potrebbero comunque essere addebitati costi per gli altri servizi nel tuo Google Cloud progetto, ad esempio potresti comunque sostenere costi di archiviazione per i dati archiviati.

Se l'app sta elaborando attivamente una richiesta, continuerà a completare l'attività e potrebbe essere necessaria fino a un'ora prima che l'app venga completamente disabilitata.

Per disabilitare un'applicazione App Engine:

1. Vai alla pagina Impostazioni applicazione:

   Vai a Impostazioni applicazione

2. Fai clic su Disattiva applicazione e segui le istruzioni.

Quando vuoi che l'app continui a gestire le richieste, abilita l'applicazione App Engine tornando alla stessa pagina Impostazioni applicazione e poi facendo clic su Abilita applicazione.

La disabilitazione dell'applicazione comporta l'arresto di tutte le richieste di servizio, ma i dati e lo stato vengono conservati. Ti verranno comunque addebitati i costi applicabili già sostenuti o i costi per altri servizi in esecuzione nel tuo progetto, come Cloud SQL. Per rilasciare tutte le risorse utilizzate all'interno del progetto, chiudi il progetto.

Chiudere un progetto

Puoi disabilitare la fatturazione e rilasciare tutte le Google Cloud risorse che vengono utilizzate nel tuo Google Cloud progetto chiudendo il progetto.

gcloud

Dopo aver installato Google Cloud CLI, esegui il seguente gcloud comando per chiudere un Google Cloud progetto:

gcloud projects delete PROJECT_ID

Sostituisci PROJECT_ID con l' Google Cloud ID progetto.

API

Per chiudere il tuo Google Cloud progetto a livello programmatico, consulta Chiusura di un progetto in nell'API Resource Manager.

Console

Per chiudere un Google Cloud progetto utilizzando la Google Cloud console:

1. Vai alla pagina Progetti:

   Vai a Progetti

2. Seleziona il Google Cloud progetto che vuoi chiudere, poi fai clic su .

Per maggiori informazioni sulla gestione dei Google Cloud progetti, consulta Cloud Resource Manager: creare, chiudere e ripristinare progetti.