Crea un'app Python nell'ambiente flessibile di App Engine

Crea un'app Python nell'ambiente flessibile di App Engine

ID regione

REGION_ID è un codice abbreviato assegnato da Google in base alla regione selezionata al momento della creazione dell'app. Non corrisponde a un paese o a una provincia, anche se alcuni ID regione possono apparire 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 regione è facoltativo nell'URL.

Scopri di più sugli ID regione.

Ok

Questa guida rapida illustra come creare ed eseguire il deployment di un'app che visualizza un breve messaggio. L'applicazione di esempio utilizza la versione più recente di Python 3. Puoi utilizzare lo stesso esempio di codice per il runtime Python 3.8 e versioni successive, specificando la versione nel file app.yaml.

Gli esempi di codice per Python 3.7 e versioni precedenti sono disponibili in GitHub.

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 la regione in cui vuoi trovare l'applicazione App Engine.

   Attenzione: non puoi modificare la regione di un'app dopo che è stata impostata.

2. Installa i seguenti prerequisiti:

   • Scarica e installa Git.

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

  gcloud components install app-engine-python
  

3. Preparare l'ambiente per lo sviluppo in 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 di sviluppo in Python.

Località App Engine

App Engine è regionale, il che significa che l'infrastruttura che esegue le 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à sono fattori principali per selezionare la regione in cui vengono eseguite le app. In genere, puoi selezionare la regione più vicina agli utenti della tua app, ma devi considerare le località in cui è disponibile App Engine e le località degli altri prodotti e servizi Google Cloud utilizzati dalla tua app. L'utilizzo di servizi in più località può influire sulla latenza della tua app e sui relativi pricing.

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 rispettivamente europe-west1 e us-central1, altrove nella documentazione di Google.

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

• Esegui il comando gcloud app describe.

• Apri la dashboard di App Engine nella console Google Cloud. L'area geografica viene visualizzata nella parte superiore della pagina.

Ok

Questa guida rapida illustra l'ultima app Python 3 scritta con il framework web Flask di cui è possibile eseguire il deployment in App Engine. Anche se questo esempio utilizza Flask, puoi utilizzare qualsiasi framework web che soddisfi i requisiti sopra indicati. I framework alternativi includono Django, Pyramid, Bottle e web.py.

scarica l'app Hello World

Abbiamo creato una semplice app Hello World per App Engine in modo che tu possa capire rapidamente come eseguire il deployment di un'app in Google Cloud.

1. Clona il repository dell'app di esempio Hello World sulla tua macchina 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 campione.

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

Esegui Hello World sulla tua macchina locale

Per eseguire l'applicazione Hello World nel computer locale:

Mac OS / Linux

Nota: queste istruzioni descrivono come configurare un ambiente virtuale in Python 3. Per le app Python 2, utilizza virtualenv per configurare un ambiente virtuale.

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 campione, vai alla directory che contiene il codice campione 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 il seguente indirizzo:

   http://localhost:8080

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

Windows

Nota: queste istruzioni descrivono come configurare un ambiente virtuale in Python 3. Per le app Python 2, utilizza virtualenv per configurare un ambiente virtuale.

Utilizza PowerShell per eseguire i tuoi pacchetti Python.

1. Individua l'installazione di PowerShell.
2. Fai clic con il tasto destro del mouse sul collegamento a PowerShell e avvialo 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 che contiene il codice campione, vai a quella che contiene il codice campione 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 il seguente indirizzo:

   http://localhost:8080

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

Deployment ed esecuzione di Hello World su App Engine

Per eseguire il deployment della tua app nell'ambiente flessibile di App Engine:

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

   gcloud app deploy

   Scopri di più sui flag facoltativi.

   Flag comuni del comando gcloud

   • Includi il flag --version per specificare un ID che identifichi in modo univoco quella versione della tua app, altrimenti ne viene generato uno per te. Esempio: --version [YOUR_VERSION_ID]
   • Includi il flag --project per specificare un ID progetto Google 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 scoprire di più sul deployment dell'app dalla riga di comando, consulta Test e deployment dell'app . Per un elenco di tutti i flag dei comandi, consulta la documentazione di 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 progetto Google Cloud.

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

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

Se si sono verificati errori durante il deployment dell'applicazione, consulta i suggerimenti per la risoluzione dei problemi.

Consulta le sezioni seguenti per informazioni sulla pulizia e i link per eventuali passaggi successivi che puoi intraprendere.

Esegui la pulizia

Per evitare addebiti, puoi eliminare il tuo progetto Google Cloud per interrompere la fatturazione per tutte le risorse utilizzate all'interno di quel progetto.

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

Impara a conoscere l'intera piattaforma

Ora che sai com'è sviluppare app di App Engine ed eseguirne il deployment, puoi esplorare il resto di Google Cloud. Hai già installato Google Cloud CLI, che offre gli strumenti per interagire con prodotti come Cloud SQL, Cloud Storage, Firestore e altri ancora.

Scopri di più sull'ambiente flessibile di App Engine

Ecco alcuni argomenti che ti aiuteranno a conoscere meglio App Engine:

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

Revisione del codice Hello World

Hello World è l'app App Engine più semplice possibile, in quanto contiene un solo servizio, ha una sola versione e tutto il codice si trova all'interno della directory root dell'app. Questa sezione descrive in dettaglio ogni file dell'app.

main.py

L'app Hello World è un'app Flask di base composta da un file.

from flask import Flask

app = Flask(__name__)

@app.route("/")
def hello() -> str:
    """Return a friendly HTTP greeting.

    Returns:
        A string with the words 'Hello World!'.
    """
    return "Hello World!"

if __name__ == "__main__":
    # This is used when running locally only. When deploying to Google App
    # Engine, a webserver process such as Gunicorn will serve the app.
    app.run(host="127.0.0.1", port=8080, debug=True)

app.yaml

Il file app.yaml descrive la seguente configurazione per la tua app:

• Imposta env: flex, a indicare che l'app utilizza l'ambiente flessibile di App Engine.

• Consente di specificare il runtime utilizzato dall'app. Se escludi l'impostazione runtime_version, App Engine utilizza l'ultima versione di Python come versione predefinita per l'app.

• entrypoint indica ad App Engine come avviare l'app. Questa app utilizza gunicorn per pubblicare l'app Python come alternativa al server di sviluppo di Flask (utilizzato durante l'esecuzione in locale). La variabile $PORT viene impostata da App Engine all'avvio dell'app. Per ulteriori informazioni su entrypoint, consulta Avvio app.

Nota: questo è il modo più semplice per eseguire gunicorn. Tuttavia, questo approccio esegue l'applicazione con un singolo worker di blocco, il che significa che tutte le richieste HTTP vengono gestite in serie, inclusi i controlli di integrità. In pratica, questo fa sì che l'applicazione non risponda in caso di richieste lente. Per maggiori dettagli su come configurare gunicorn per la produzione, consulta Configurazione di gunicorn consigliata

# Copyright 2021 Google LLC
#
# Licensed under the Apache License, Version 2.0 (the "License");
# you may not use this file except in compliance with the License.
# You may obtain a copy of the License at
#
#      http://www.apache.org/licenses/LICENSE-2.0
#
# Unless required by applicable law or agreed to in writing, software
# distributed under the License is distributed on an "AS IS" BASIS,
# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
# See the License for the specific language governing permissions and
# limitations under the License.

runtime: python
env: flex
entrypoint: gunicorn -b :$PORT main:app

runtime_config:
  operating_system: ubuntu22

# This sample incurs costs to run on the App Engine flexible environment.
# The settings below are to reduce costs during testing and are not appropriate
# for production use. For more information, see:
# https://cloud.google.com/appengine/docs/flexible/python/configuring-your-app-with-app-yaml
manual_scaling:
  instances: 1
resources:
  cpu: 1
  memory_gb: 0.5
  disk_size_gb: 10

• Per saperne di più sul funzionamento del runtime Python, consulta Il runtime Python.

• Per maggiori dettagli su come progettare la tua app per sfruttare versioni e servizi, consulta Panoramica di App Engine.

• Per ulteriori dettagli sulle impostazioni di configurazione per App Engine, consulta Configurazione dell'app con app.yaml.

requirements.txt

requirements.txt e il gestore di pacchetti Python pip dichiarano e installano le dipendenze dell'applicazione. Hello World richiede Flask, un framework web e Gunicorn, un server WSGI.

Flask==3.0.0; python_version > '3.6'
Flask==2.3.3; python_version < '3.7'
Werkzeug==3.0.1; python_version > '3.6'
Werkzeug==2.3.7; python_version < '3.7'
gunicorn==22.0.0

requirements.txt definisce le librerie che verranno installate sia in locale sia durante il deployment in App Engine.