Configurazione del progetto Google Cloud per App Engine

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

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

Prima di poter eseguire il deployment delle tue app nell'ambiente flessibile 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

Creare un progetto e 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.

Solo il ruolo Proprietario dispone dei privilegi per creare un'applicazione App Engine in un progetto Google Cloud e questa 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 modificare la posizione dell'applicazione App Engine.

gcloud

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

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

   gcloud projects create PROJECT_ID

   Sostituisci PROJECT_ID con l' Google Cloud ID progetto.

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

   gcloud app create

   Ulteriori informazioni sulle località di App Engine

3. Attiva la fatturazione nella pagina Fatturazione della console Google Cloud . Per maggiori dettagli, consulta la sezione Attivazione della fatturazione.

   Suggerimenti:

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

API

Per creare un progetto Google Cloud e un'applicazione App Engine a livello di programmazione, utilizza sia l'API Cloud Resource Manager sia l'API App Engine Admin:

1. Per creare un Google Cloud progetto, consulta Creazione di un nuovo progetto.

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

3. Attiva la fatturazione nella pagina Fatturazione della console Google Cloud . Per maggiori dettagli, consulta la sezione Attivazione della fatturazione.

Console

Per creare un progetto Google Cloud 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 attiva la fatturazione:

   1. Seleziona una regione per specificare dove vuoi che si trovi l'applicazione App Engine.
      Ulteriori informazioni sulle località di App Engine
   2. Seleziona un service account per la tua 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 e attivata la fatturazione nel tuo 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 e Google la gestisce in modo che sia disponibile in modo ridondante in tutte le zone all'interno di quella regione.

Soddisfare i requisiti di latenza, disponibilità o durabilità è il fattore principale per la selezione della regione in cui vengono eseguite le tue app. In genere puoi selezionare la regione più vicina agli utenti della tua app, ma devi considerare le posizioni in cui è disponibile App Engine e le posizioni degli altri Google Cloud prodotti e servizi utilizzati dalla tua app. L'utilizzo di servizi in più località può influire sulla latenza della tua app e sui relativi prezzi.

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

Nota: due posizioni, chiamate europe-west e us-central nei comandi App Engine e nella console Google Cloud , sono chiamate 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 eseguendo una delle seguenti operazioni:

• Esegui il comando gcloud app describe.

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

Ok

Abilitazione della fatturazione in corso

Per eseguire il deployment delle tue app, devi abilitare la fatturazione. Non verrà addebitato alcun costo sul tuo account se rimani entro la quota gratuita. Se la tua applicazione ha bisogno di risorse che superano la quota gratuita, ti verrà addebitato un costo per l'utilizzo aggiuntivo.

Se disponi di un account di fatturazione quando crei un progetto Google Cloud , la fatturazione viene abilitata automaticamente per il progetto.

Per abilitare la fatturazione in un progetto Google Cloud :

1. Nella console Google Cloud , 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 progettoGoogle Cloud selezionato sia associato a un account, la pagina Fatturazione mostra una delle seguenti opzioni:

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

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

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

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

Gestione della fatturazione

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

1. Vai alla pagina Fatturazione nella console Google Cloud :

   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 tuoi 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 ulteriori informazioni sulla fatturazione, consulta la pagina Prezzi.

Creazione di budget e impostazione di avvisi

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

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

1. Nella console Google Cloud , 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 progetto Google Cloud .

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 relativi al budget.

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

Impostazione dell'ID progetto per un progetto

In alcuni runtime dell'ambiente standard di App Engine, potresti aver specificato l'ID progetto (a volte chiamato "ID app") nel file app.yaml del progetto. Google Cloud

Puoi specificare l'ID progetto in diversi modi:

• Utilizzando gcloud init durante l'installazione di 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.

Disattivare un'applicazione

Disattiva un'applicazione App Engine per impedire all'app di eseguire istanze e gestire richieste. Quando disattivi l'app, non si verifica alcuna perdita di dati e non vengono modificate le impostazioni di configurazione. È sufficiente riattivare l'applicazione App Engine per avviare le istanze e continuare a gestire il traffico verso l'app.

Le risorse della tua app sia nell'ambiente standard che in quello flessibile sono disattivate e pertanto non comportano addebiti. Tuttavia, potrebbero comunque verificarsi addebiti per gli altri servizi nel tuo progetto Google Cloud , ad esempio potresti comunque incorrere in costi di archiviazione per i dati archiviati.

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

Per disattivare un'applicazione App Engine:

1. Vai alla pagina Impostazioni applicazione:

   Vai a Impostazioni applicazione

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

Quando vuoi che la tua app continui a gestire le richieste, attiva l'applicazione App Engine tornando alla stessa pagina Impostazioni applicazione e facendo clic su Attiva applicazione.

La disattivazione dell'applicazione interrompe 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 nel progetto, chiudilo.

Chiusura di un progetto

Puoi disattivare la fatturazione e rilasciare tutte le risorse Google Cloud che vengono utilizzate nel tuo progetto Google Cloud chiudendolo.

gcloud

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

gcloud projects delete PROJECT_ID

Sostituisci PROJECT_ID con l' Google Cloud ID progetto.

API

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

Console

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

1. Vai alla pagina Progetti:

   Vai a Progetti

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

Per saperne di più sulla gestione dei tuoi progetti Google Cloud , vedi Cloud Resource Manager: creare, chiudere e ripristinare progetti.