Spécifier des dépendances

Les dépendances pour les applications Python sont déclarées dans un fichier requirements.txt standard. Exemple :

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

Remplacez MAJOR, MINOR et PATCH par les numéros de version Flask souhaités.

Dans l'environnement flexible App Engine, vous pouvez utiliser n'importe quel package Python compatible avec Linux, y compris ceux qui requièrent des extensions (C) natives.

L'environnement d'exécution Python installe automatiquement toutes les dépendances déclarées dans le fichier requirements.txt lors du déploiement.

Installer les dépendances en local

Lorsque vous développez et testez votre application en local, nous vous recommandons d'utiliser venv pour isoler les dépendances de votre application des packages système. Ainsi, vous avez la garantie que les mêmes versions de ces dépendances seront utilisées sur votre ordinateur local et sur l'application déployée.

Pour utiliser venv afin d'installer des dépendances, procédez comme suit :

macOS/Linux

Remarque : Ces instructions décrivent comment configurer un environnement virtuel dans Python 3. Pour les applications Python 2, configurez un environnement virtuel à l'aide de virtualenv.

1. Créez un environnement Python isolé :

   python3 -m venv env
   source env/bin/activate

2. Si vous n'êtes pas dans le répertoire qui contient l'exemple de code, accédez au répertoire qui contient l'exemple de code hello_world. Ensuite, installez les dépendances :

   cd YOUR_SAMPLE_CODE_DIR
   pip install -r requirements.txt

Windows

Remarque : Ces instructions décrivent comment configurer un environnement virtuel dans Python 3. Pour les applications Python 2, configurez un environnement virtuel à l'aide de virtualenv.

Exécutez les packages Python à l'aide de PowerShell.

1. Localisez votre installation de PowerShell.
2. Cliquez avec le bouton droit sur le raccourci PowerShell et démarrez une session en tant qu'administrateur.
3. Créez un environnement Python isolé.

   python -m venv env
   .\env\Scripts\activate

4. Accédez au répertoire de votre projet et installez les dépendances : Si vous n'êtes pas dans le répertoire qui contient l'exemple de code, accédez au répertoire qui contient l'exemple de code hello_world. Ensuite, installez les dépendances :

   cd YOUR_SAMPLE_CODE_DIR
   pip install -r requirements.txt

Cette démarche vous assure que lorsque vous exécutez votre application en local, seules les dépendances déclarées dans le fichier requirements.txt sont disponibles. Les dépendances installées par App Engine lors du déploiement sont basées sur le contenu du fichier requirements.txt, et non sur le contenu du répertoire env/.

Conseil : Souvent, vous ne saurez pas précisément les dépendances dont vous disposez. Après avoir installé les dépendances, vous pouvez utiliser pip freeze pour écrire les noms et versions de tous les packages installés dans le fichier requirements.txt.

Installer un framework Web

Vous devez utiliser un framework Web pour permettre à votre application de répondre aux requêtes Web. Vous pouvez utiliser n'importe quel framework Web Python, par exemple :

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

Pour utiliser un framework Web particulier, il vous suffit de l'ajouter à votre fichier requirements.txt :

Flask==MAJOR.MINOR.PATCH

Installer un serveur WSGI

Certains frameworks Web offrent des serveurs WSGI intégrés. Cependant, peu d'entre eux sont adaptés à la diffusion du trafic de production. La plupart des applications Web utilisent un serveur WSGI autonome tel que Gunicorn, uWSGI ou Waitress. Pour en savoir plus sur l'installation, la configuration et l'utilisation d'un serveur WSGI, consultez la section Démarrage de l'application.

Installer les bibliothèques clientes Cloud

La bibliothèque cliente Cloud pour Python permet d'accéder facilement aux services Google Cloud. De ce fait, la quantité de code récurrent que vous devez développer est fortement réduite. La bibliothèque fournit des abstractions d'API de haut niveau, ce qui implique que les API sont plus faciles à comprendre et à utiliser. Cette bibliothèque accepte les idiomes de Python, fonctionne bien avec la bibliothèque standard et s'intègre mieux à votre base de code.

Par exemple, vous pouvez installer la bibliothèque cliente Python associée à Datastore ou Cloud Storage afin d'intégrer ces services à votre application.

Pour installer la bibliothèque cliente Python pour Cloud Datastore :

1. Installez la bibliothèque cliente localement à l'aide de pip :

   pip install google-cloud-datastore

2. Configurez l'authentification. Vous pouvez configurer les bibliothèques clientes Cloud pour Python afin de gérer l'authentification automatiquement. La bibliothèque cliente peut également gérer automatiquement l'authentification en local par le biais de Google Cloud CLI.

   gcloud auth login
   

3. Utilisez la documentation de référence sur les bibliothèques clientes pour Datastore pour rendre le service Cloud Datastore compatible avec votre application.

Pour obtenir la liste complète des bibliothèques clientes Cloud pour Python compatibles avec les services Google Cloud, consultez la page API et bibliothèques Python.