Preparazione dei file di configurazione per il runtime Python 3

Prima di poter eseguire l'app nel runtime Python 3 dell'ambiente standard di App Engine, potresti dover modificare alcuni dei file di configurazione utilizzati da App Engine:

• app.yaml. Questo file contiene informazioni sul codice dell'app, ad esempio il runtime e i gestori dell'app.

• appengine_config.py. Il runtime Python 2 utilizza questo file per accedere a librerie di terze parti e fornire valori per costanti e "funzioni hook". Il runtime Python 3 non utilizza questo file.

Aggiornamento di app.yaml in corso…

Il comportamento di alcuni campi nel tuo file di configurazione app.yaml è stato modificato. Rimuovi i campi non più supportati e aggiorna gli altri campi come descritto nella tabella seguente.

Campo	Tipo di modifica	Descrizione
app_engine_apis	Valido solo per Python 3	Obbligatorio se vuoi accedere ai servizi in bundle legacy per Python 3.true
api_version application_readable builtins	Non più supportato	Non applicabile nel runtime Python 3.
threadsafe	Non più supportata	Si presume che tutte le applicazioni siano thread-safe. Se la tua applicazione non è thread-safe, specifica un entrypoint configurando 1 thread per worker. Ad esempio, quando utilizzi la classe di istanze F4: entrypoint: gunicorn -b :$PORT -w 8 --threads 1 main:app Consulta le best practice per i punti di ingresso per il numero consigliato di worker per ogni classe di istanze.
librerie	Non più supportata	Utilizza il file requirements.txt per dichiarare le dipendenze e installare le librerie client.
gestori: login	Supportato se app_engine_apis è true	Se non utilizzi i servizi in bundle legacy per Python 3, utilizza Identity and Access Management (IAM) per la gestione degli utenti.
handlers: script	Modificato	Nel runtime Python 2, utilizzi il campo script per indirizzare le richieste in entrata allo script della tua app. Nel runtime Python 3, devi utilizzare un framework web con routing in-app (come Flask o Django) anziché utilizzare il campo script. Per eseguire la migrazione del file app.yaml al runtime Python 3, esegui una delle seguenti operazioni, a seconda che il file contenga gestori statici e gestori di script: Se il file app.yaml contiene gestori statici, esegui una delle seguenti operazioni per assicurarti che le richieste di contenuti dinamici vengano indirizzate allo script della tua app: Rimuovi tutti i campi script. Poi aggiungi un campo entrypoint per avviare un server web che esegue la tua app. Le richieste che non corrispondono a nessuno dei tuoi gestori statici verranno indirizzate al server web specificato nel campo entrypoint. Il server web e il framework web della tua app sono responsabili dell'instradamento della richiesta allo script corretto. Sostituisci il valore di tutti i campi script con auto. App Engine eseguirà automaticamente la tua app in un web server (supponendo che la tua app soddisfi alcuni requisiti) e tutte le richieste che corrispondono a un gestore di script verranno indirizzate al web server. Il server web e il framework web della tua app sono responsabili dell'instradamento della richiesta allo script corretto. Se il file app.yaml non contiene gestori statici, rimuovi tutti i campi script. Tutte le richieste alla tua app verranno indirizzate al server web dell'app e il framework dell'app indirizzerà la richiesta allo script corretto. Puoi aggiungere facoltativamente un campo entrypoint per personalizzare il comportamento di avvio predefinito. Se il tuo app.yaml ha entrambi i tipi di gestori, puoi comunque rimuovere tutti i gestori di script che verrebbero contrassegnati come auto, lasciando i gestori statici e i gestori auto che richiedono altre direttive, come il gestore solo per amministratori nell'esempio seguente. La gestione dei file statici rimane invariata.

Se utilizzi uno dei campi deprecati, App Engine restituisce un errore quando esegui il deployment dell'app.

Puoi utilizzare i seguenti esempi per confrontare le differenze tra i file app.yaml:

Python 2

runtime: python27
api_version: 1
threadsafe: true

handlers:
- url: /
  script: home.app

- url: /index\.html
  script: home.app

- url: /stylesheets
  static_dir: stylesheets

- url: /(.*\.(gif|png|jpg))$
  static_files: static/\1
  upload: static/.*\.(gif|png|jpg)$

- url: /admin/.*
  script: admin.app
  login: admin

- url: /.*
  script: not_found.app

Python 3

runtime: python314
app_engine_apis: true

handlers:
- url: /stylesheets
  static_dir: stylesheets

- url: /(.*\.(gif|png|jpg))$
  static_files: static/\1
  upload: static/.*\.(gif|png|jpg)$

- url: /admin/.*
  script: auto
  login: admin

Nota: per Python 3, il web server compatibile con WSGI preferito è gunicorn. Quando utilizzi il campo facoltativo entrypoint nel file di configurazione app.yaml, il timeout per gunicorn è impostato su 30 secondi per impostazione predefinita. Per impostare un timeout personalizzato, aggiorna il campo entrypoint: ad esempio, entrypoint: gunicorn -b :$PORT --timeout=600. In questo caso, assicurati di aver incluso gunicorn nel file requirements.txt.

Rimozione di appengine_config.py

Il runtime Python 2 nell'ambiente standard di App Engine utilizza il file appengine_config.py.

Questo file viene ignorato nel runtime Python 3. Il runtime Python 3 utilizza invece il file requirements.txt standard per installare le dipendenze, incluse quelle che utilizzano codice nativo.