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 della tua app, come il runtime e i gestori delle app.

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

Aggiornamento di app.yaml in corso…

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

Campo	Tipo di modifica	Descrizione
app_engine_apis	Applicabile solo a Python 3	Deve essere impostato su true se vuoi accedere ai servizi in bundle legacy per Python 3.
api_version application_read integrate	Non più supportato	Non applicabile per il runtime Python 3.
sicura per thread	Non più supportata	Tutte le applicazioni sono considerate threadsafe. Se la tua applicazione non è threadsafe, specifica un entrypoint configurando 1 thread per worker. Ad esempio, se utilizzi la classe di istanza F4: entrypoint: gunicorn -b :$PORT -w 8 --threads 1 main:app Consulta le best practice per entrypoint per il numero di worker consigliato per ogni classe di istanza.
librerie	Non più supportata	Utilizza il file requirements.txt per dichiarare le dipendenze e installare le librerie client.
gestori: accesso	Supportato se il valore di 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.
gestori: script	Modificato	Nel runtime Python 2, utilizzi il campo script per instradare le richieste in entrata allo script dell'app. Nel runtime Python 3, devi utilizzare un framework web con il routing in-app (come Flask o Django) anziché 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 instradate allo script dell'app: Rimuovi tutti i campi (script). Dopodiché aggiungi un campo entrypoint per avviare un server web che esegue la tua app. Le richieste che non corrispondono a nessuno dei tuoi fornitori statici verranno indirizzate al server web specificato nel campo entrypoint. Il server web e il framework web della tua app sono responsabili del routing della richiesta allo script corretto. Sostituisci il valore di tutti i campi script con auto. App Engine eseguirà automaticamente la tua app su un server web (supponendo che l'app soddisfi alcuni requisiti) e tutte le richieste che corrispondono a un gestore di script verranno indirizzate al server web. Il server web e il framework web della tua app sono responsabili del routing 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 instrada la richiesta allo script corretto. Facoltativamente, puoi aggiungere un campo entrypoint per personalizzare il comportamento predefinito all'avvio. Se app.yaml ha entrambi i tipi di gestori, puoi comunque rimuovere tutti i gestori di script che verrebbero contrassegnati come auto, lasciando indietro i gestori statici e i gestori auto che richiedono altre istruzioni, ad esempio il gestore solo amministratore 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: python312
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 server web preferito compatibile con WSGI è gunicorn. Quando utilizzi il campo facoltativo entrypoint nel file di configurazione di app.yaml, il timeout per gunicorn per impostazione predefinita è di 30 secondi. 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 in corso...

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 dipendenze, tra cui quelle che utilizzano codice nativo.