Creare un'app Python 3 nell'ambiente standard di App Engine

Guida rapida: creare un'app Python 3 nell'ambiente standard di App Engine

Creare un'app Python 3 nell'ambiente standard di App Engine

ID regione

REGION_ID è un codice abbreviato assegnato da Google in base all'area geografica selezionata al momento della creazione dell'app. Il codice non corrisponde a un paese o a una provincia, anche se alcuni ID di area geografica potrebbero essere simili ai codici di paese e provincia di uso comune. Per le app create dopo febbraio 2020, REGION_ID.r è incluso negli URL di App Engine. Per le app esistenti create prima di questa data, l'ID area geografica è facoltativo nell'URL.

Scopri di più sugli ID dell'area geografica.

OK

Python 2.7/3 |Java 8/11/17 |PHP 5/7 |Ruby |Go 1.11 / 1.12+ |Node.js

Questa guida rapida mostra come eseguire il deployment di un'app di esempio su App Engine. Se vuoi saperne di più sulla codifica di un'app per App Engine, consulta la pagina relativa alla creazione di un'app.

App Engine è l'opzione di computing più adatta a te? Scopri altre opzioni per ospitare l'applicazione su Google Cloud.

Costi

Non ci sono costi associati all'esecuzione di questa guida. L'esecuzione della sola app di esempio non supera la quota gratuita.

Prima di iniziare

1. Accedi al tuo account Google Cloud. Se non conosci Google Cloud, crea un account per valutare le prestazioni dei nostri prodotti in scenari reali. I nuovi clienti ricevono anche 300 $di crediti gratuiti per l'esecuzione, il test e il deployment dei carichi di lavoro.

2. Nella pagina del selettore di progetti della console Google Cloud, seleziona o crea un progetto Google Cloud.

   Nota: se non prevedi di conservare le risorse create in questa procedura, crea un progetto anziché selezionarne uno esistente. Dopo aver completato questi passaggi, puoi eliminare il progetto, rimuovendo tutte le risorse associate.

   Vai al selettore progetti

3. Assicurati che la fatturazione sia attivata per il tuo progetto Google Cloud.

4. Attiva Cloud Build API.

   Abilita l'API

5. Installa Google Cloud CLI.

6. Per initialize gcloud CLI, esegui questo comando:

   gcloud init

7. Nella pagina del selettore di progetti della console Google Cloud, seleziona o crea un progetto Google Cloud.

   Nota: se non prevedi di conservare le risorse create in questa procedura, crea un progetto anziché selezionarne uno esistente. Dopo aver completato questi passaggi, puoi eliminare il progetto, rimuovendo tutte le risorse associate.

   Vai al selettore progetti

8. Assicurati che la fatturazione sia attivata per il tuo progetto Google Cloud.

9. Attiva Cloud Build API.

   Abilita l'API

10. Installa Google Cloud CLI.

11. Per initialize gcloud CLI, esegui questo comando:

    gcloud init

Prerequisiti aggiuntivi

1. Inizializza la tua app App Engine con il tuo progetto e scegli la relativa area geografica:

   gcloud app create --project=[YOUR_PROJECT_ID]
   

   Quando richiesto, seleziona l'area geografica in cui vuoi individuare l'applicazione App Engine.

   Attenzione: una volta impostata, non puoi modificare l'area geografica di un'app.

2. Installa i seguenti prerequisiti:

   • Scarica e installa Git.

• Esegui il comando seguente per installare il componente gcloud che include l'estensione App Engine per Python 3:

  gcloud components install app-engine-python
  

3. Prepara l'ambiente per lo sviluppo Python. Ti consigliamo di installare sul sistema la versione più recente di Python, pip e di altri strumenti correlati. Per istruzioni, consulta la guida alla configurazione dell'ambiente Python per lo sviluppo.

Località App Engine

App Engine è a livello di area geografica, il che significa che l'infrastruttura che esegue le tue app si trova in un'area geografica specifica e Google la gestisce in modo che sia disponibile in modo ridondante in tutte le zone all'interno di tale area.

I requisiti di latenza, disponibilità o durabilità sono fattori principali per selezionare l'area geografica in cui vengono eseguite le tue app. In genere, puoi selezionare l'area geografica più vicina agli utenti della tua app, ma dovresti considerare le località in cui è disponibile App Engine e le località degli altri prodotti e servizi Google Cloud che la tua app utilizza. L'utilizzo di servizi in più località può influire sulla latenza e sui prezzi dell'app.

Non puoi modificare l'area geografica di un'app dopo averla impostata.

Nota: due località, chiamate europe-west e us-central nei comandi di App Engine e in Google Cloud Console, vengono chiamate rispettivamente europe-west1 e us-central1, altrimenti nella documentazione di Google.

Se hai già creato un'applicazione App Engine, puoi visualizzarne l'area geografica procedendo in uno dei seguenti modi:

• Esegui il comando gcloud app describe.

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

OK

Questa guida rapida illustra una semplice app Python scritta con il framework web Flask di cui può essere eseguito il deployment in App Engine. Anche se questo esempio utilizza Flask, puoi utilizzare qualsiasi framework web che soddisfi i requisiti di cui sopra. I framework alternativi includono Django, Pyramid, Bottle e web.py.

Scarica l'app Hello World

Abbiamo creato una semplice app Hello World per Python 3 che ti consente di capire rapidamente come eseguire il deployment di un'app in Google Cloud.

1. Clonare il repository dell'app di esempio Hello World nel tuo computer locale.

   git clone https://github.com/GoogleCloudPlatform/python-docs-samples
   

   In alternativa puoi scaricare l'esempio come file ZIP ed estrarlo.

2. Passa alla directory che contiene il codice di esempio.

   cd python-docs-samples/appengine/standard_python3/hello_world
   

Esegui Hello World sul tuo computer locale

Per eseguire l'applicazione Hello World nel computer locale:

Mac OS / Linux

1. Crea un ambiente Python isolato:

   python3 -m venv env
   source env/bin/activate

2. Se non ti trovi nella directory che contiene il codice di esempio, vai alla directory che contiene il codice di esempio hello_world. Quindi installa le dipendenze:

   cd YOUR_SAMPLE_CODE_DIR
   pip install -r requirements.txt

3. Esegui l'applicazione:

   python main.py

4. Nel browser web, inserisci l'indirizzo seguente:

   http://localhost:8080

   Nota: se utilizzi Cloud Shell, fai clic su Anteprima web nella barra degli strumenti e seleziona Anteprima sulla porta 8080.

Windows

Utilizza PowerShell per eseguire i pacchetti Python.

1. Individua l'installazione di PowerShell.
2. Fai clic con il pulsante destro del mouse sulla scorciatoia di PowerShell e avviala come amministratore.
3. Crea un ambiente Python isolato.

   python -m venv env
   .\env\Scripts\activate

4. Naviga alla directory del progetto e installa le dipendenze. Se non ti trovi nella directory contenente il codice di esempio, vai alla directory che contiene il codice di esempio hello_world. Quindi, installa le dipendenze:

   cd YOUR_SAMPLE_CODE_DIR
   pip install -r requirements.txt

5. Esegui l'applicazione:

   python main.py

6. Nel browser web, inserisci l'indirizzo seguente:

   http://localhost:8080

Nella pagina viene visualizzato il messaggio Hello World dall'esempio di app. Nella finestra del terminale, premi Ctrl+C per uscire dal server web.

Eseguire il deployment ed eseguire Hello World su App Engine

Per eseguire il deployment dell'app nell'ambiente standard di App Engine:

1. Esegui il deployment dell'app Hello World eseguendo il seguente comando dalla directory standard_python3/hello_world:

   gcloud app deploy

   Scopri di più sui flag facoltativi.

   gcloud flag di comando comuni

   • Includi il flag --version per specificare un ID che identifica in modo univoco quella versione dell'app, altrimenti ne verrà generata una per te. Esempio: --version [YOUR_VERSION_ID]
   • Includi il flag --project per specificare un ID progetto Cloud alternativo a quello che hai inizializzato come predefinito nello strumento gcloud. Esempio: --project [YOUR_PROJECT_ID]

   Esempio:

   gcloud app deploy --version pre-prod-5 --project my-sample-app

   Per ulteriori informazioni sul deployment dell'app dalla riga di comando, consulta Test e deployment dell'app. Per un elenco di tutti i flag dei comandi, consulta il riferimento gcloud app deploy.

   OK

2. Avvia il browser per visualizzare l'app all'indirizzo https://PROJECT_ID.REGION_ID.r.appspot.com

   gcloud app browse

   dove PROJECT_ID rappresenta l'ID del tuo progetto Google Cloud.

Questa volta, la pagina che mostra il messaggio Hello World viene recapitata da un server web in esecuzione su un'istanza di App Engine.

Complimenti! Hai eseguito il deployment della tua prima app Python 3 nell'ambiente standard di App Engine.

Consulta le sezioni seguenti per informazioni sulla pulizia e link a possibili misure da intraprendere.

Esegui la pulizia

Per evitare addebiti, puoi eliminare il progetto Cloud per interrompere la fatturazione per tutte le risorse utilizzate al suo interno.

Attenzione: l'eliminazione di un progetto ha i seguenti effetti:
• L'intero contenuto del progetto viene eliminato. Se hai utilizzato un progetto esistente per le attività in questo documento, quando lo elimini elimini anche qualsiasi altro lavoro svolto nel progetto.
• Gli ID progetto personalizzati non sono più disponibili. Quando hai creato questo progetto, potresti aver creato un ID progetto personalizzato che vuoi utilizzare in futuro. Per conservare gli URL che utilizzano l'ID progetto, ad esempio un URL appspot.com, elimina le risorse selezionate all'interno del progetto anziché eliminare l'intero progetto.
1. Nella console Google Cloud, vai alla pagina Gestisci risorse.

   Vai a Gestisci risorse

2. Nell'elenco dei progetti, seleziona il progetto che vuoi eliminare, quindi fai clic su Elimina.
3. Nella finestra di dialogo, digita l'ID del progetto e fai clic su Chiudi per eliminare il progetto.

Passaggi successivi

Scopri tutta la piattaforma

Ora che conosci le caratteristiche dello sviluppo e del deployment delle app di App Engine, puoi scoprire il resto di Google Cloud. Hai già installato l'interfaccia a riga di comando di Google Cloud che ti offre gli strumenti per interagire con prodotti come Cloud SQL, Cloud Storage, Firestore e altri ancora.

Informazioni sull'ambiente standard di App Engine

Di seguito sono riportati alcuni argomenti che possono aiutarti a continuare la tua conoscenza di App Engine:

• Panoramica di App Engine
• Routing delle richieste
• Gestione delle richieste
• Gestione delle istanze