Specifica delle dipendenze

Le dipendenze per le applicazioni Python vengono 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.

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

Il runtime Python installerà automaticamente tutte le dipendenze dichiarate in requirements.txt durante il deployment.

Installazione delle dipendenze in locale

Per lo sviluppo e il test della tua applicazione in locale, ti consigliamo di utilizzare venv per isolare le dipendenze dell'applicazione dai pacchetti di sistema. In questo modo, inoltre, le dipendenze saranno la stessa versione sulla macchina locale e sull'applicazione di cui è stato eseguito il deployment.

Per utilizzare venv per installare le dipendenze, segui questi 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 ti trovi nella directory che contiene il codice di esempio, vai alla directory che contiene il codice campione hello_world. Quindi 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 pulsante 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 ti trovi nella directory che contiene il codice campione, vai a quella contenente il codice campione hello_world. Quindi, installa le dipendenze:

   cd YOUR_SAMPLE_CODE_DIR
   pip install -r requirements.txt

In questo modo, quando esegui la tua app in locale, 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 sai con esattezza quali sono le tue dipendenze. Dopo aver installato le dipendenze, puoi utilizzare pip freeze per scrivere il nome e la versione di tutti i pacchetti installati sul tuo 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
• Piramide
• Bottiglia
• web.py
• Tromba d'aria

Per utilizzare un particolare framework web, basta aggiungerlo a requirements.txt:

Flask==MAJOR.MINOR.PATCH

Installazione di un server WSGI

Alcuni framework web dispongono di server WSGI integrati, ma pochi sono adatti per gestire il 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, consulta la sezione relativa all'avvio dell'applicazione.

Installazione delle librerie client di Cloud

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

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 in locale utilizzando pip:

   pip install google-cloud-datastore

2. Configurare l'autenticazione. Puoi configurare le librerie client di Cloud per Python in modo da 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 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.