Specifica delle dipendenze

Le dipendenze per le applicazioni Python sono dichiarate in un file requirements.txt standard. Ad esempio:

Flask==MAJOR.MINOR.PATCH
google-cloud-storage

Sostituisci MAJOR, MINOR e PATCH con i numeri di versione di Flask che preferisci.

Puoi utilizzare qualsiasi pacchetto Python compatibile con Linux nell'ambiente flessibile di App Engine, inclusi i pacchetti che richiedono estensioni native (C).

Il runtime Python installa automaticamente tutte le dipendenze dichiarato in requirements.txt durante il deployment.

Installazione delle dipendenze a livello locale

Quando sviluppi e testi l'applicazione localmente, ti consigliamo di utilizzare venv per isolare le dipendenze dell'applicazione dai pacchetti di sistema. Ciò garantisce anche che le dipendenze abbiano la stessa versione della macchina locale e dell'applicazione di cui è stato eseguito il deployment.

Per utilizzare venv per installare le dipendenze, completa i seguenti passaggi:

Mac OS / Linux

Nota: queste istruzioni descrivono come configurare un ambiente virtuale in Python 3. Per Python 2 usa 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. Poi installa le dipendenze:

   cd YOUR_SAMPLE_CODE_DIR
   pip install -r requirements.txt

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 le funzionalità di PowerShell per eseguire i pacchetti Python.

1. Individua l'installazione di PowerShell.
2. Fai clic con il tasto destro del mouse sulla scorciatoia a 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 sei nella directory che contiene il codice campione, passa alla directory che contiene Codice campione hello_world. Poi installa le dipendenze:

   cd YOUR_SAMPLE_CODE_DIR
   pip install -r requirements.txt

In questo modo ti assicuri che, quando esegui l'app in locale, solo sono disponibili le dipendenze dichiarate nel file requirements.txt. Le dipendenze installate da App Engine durante il deployment si basano i contenuti del file requirements.txt, non i contenuti dei file env/ .

Suggerimento: spesso non conosci le tue dipendenze esatte. Dopo aver installato le dipendenze, puoi utilizzare pip freeze per scrivere il nome e la versione di tutti i pacchetti installati in requirements.txt.

Installazione di un framework web

Dovrai usare un framework web per consentire alla tua app di gestire le richieste web. Puoi utilizzare qualsiasi framework web Python, tra cui:

• Flask
• Django
• Pyramid
• Bottiglia
• web.py
• Tornado

Per utilizzare un determinato framework web, è sufficiente aggiungerlo a requirements.txt:

Flask==MAJOR.MINOR.PATCH

Installazione di un server WSGI

Alcuni framework web hanno server WSGI integrati; tuttavia, alcuni sono adatte a gestire traffico di produzione. La maggior parte delle applicazioni web utilizza un server WSGI autonomo come Gunicorn, uWSGI o Waitress. Per ulteriori informazioni sull'installazione, la configurazione e l'utilizzo di un server WSGI, vedi l'avvio dell'applicazione.

Installazione delle librerie client di Cloud

Le librerie client di Cloud per Python sono una libreria client accesso ai servizi Google Cloud che riducono notevolmente il boilerplate il codice che devi scrivere. La libreria fornisce astrazioni API di alto livello in modo che siano più facili da comprendere. Adotta le espressioni idiomatiche di Python, funziona bene con la libreria Python standard e si integra meglio con il tuo codice di base.

Ad esempio, puoi installare la libreria client Python corrispondente per Datastore o Cloud Storage per integrare questi servizi con la tua app.

Per installare la libreria client Python per Cloud Datastore:

1. Installa la libreria client localmente utilizzando pip:

   pip install google-cloud-datastore

2. Configurare l'autenticazione. Puoi configurare le librerie client di Cloud per Python per gestire automaticamente l'autenticazione. La libreria client può gestire automaticamente l'autenticazione anche localmente utilizzando Google Cloud CLI.

   gcloud auth login
   

3. Utilizza il riferimento sulle librerie client di Datastore per implementare il supporto per il servizio Cloud Datastore nella tua app.

Per un elenco completo di tutte le librerie client di Cloud per Python per i servizi Google Cloud supportati, consulta API e librerie Python.