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 di Python installerà automaticamente tutte le dipendenze dichiarate 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. In questo modo, avrai anche la certezza che le dipendenze siano della stessa versione sulla tua macchina locale e nell'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 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 sei 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 PowerShell per eseguire i pacchetti Python.

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

   cd YOUR_SAMPLE_CODE_DIR
   pip install -r requirements.txt

In questo modo, quando esegui l'app localmente, sono disponibili solo le dipendenze dichiarate nel file requirements.txt. Le dipendenze installate da App Engine durante il deployment si basano sui contenuti del file requirements.txt, non sui contenuti della directory env/.

Suggerimento: spesso non conosci le 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 utilizzare 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, aggiungilo a requirements.txt:

Flask==MAJOR.MINOR.PATCH

Installazione di un server WSGI

Alcuni framework web hanno server WSGI integrati, ma pochi sono adatti per la pubblicazione del traffico di produzione. La maggior parte delle applicazioni web utilizza un server WSGI autonomo come Gunicorn, uWSGI o Waitress. Per ulteriori informazioni sull'installazione, sulla configurazione e sull'utilizzo di un server WSGI, consulta la sezione relativa all'avvio dell'applicazione.

Installazione delle librerie client Cloud

Le librerie client di Cloud per Python sono una libreria client per accedere ai servizi Google Cloud che riduce notevolmente il codice boilerplate da 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 a livello locale utilizzando Google Cloud CLI.

   gcloud auth login
   

3. Utilizza la documentazione di riferimento delle librerie client Datastore per implementare il supporto del 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.