Spécifier les dépendances en Python
Il existe deux manières de spécifier des dépendances Cloud Functions rédigées en Python : en utilisant le fichier requirements.txt
du gestionnaire de packages pip ou en empaquetant les dépendances locales avec votre fonction.
La spécification des dépendances avec le fichier standard Pipfile/Pipfile.lock n'est actuellement pas prise en charge. Votre projet ne doit pas contenir ces fichiers.
Spécifier des dépendances avec pip
Dans Python, les dépendances sont gérées avec piprequirements.txt
et exprimées dans un fichier de métadonnées appelé .
Ce fichier doit se trouver dans le même répertoire que le fichier main.py
qui contient le code de votre fonction.
Lorsque vous déployez ou redéployez votre fonction, Cloud Functions utilise pip pour télécharger et installer la dernière version de vos dépendances, comme déclaré dans le fichier requirements.txt
.
Le fichier requirements.txt
contient une ligne par package. Chaque ligne contient le nom du package et, éventuellement, la version demandée. Pour en savoir plus, consultez la documentation de référence sur requirements.txt
.
Pour éviter que votre compilation ne soit affectée par les modifications de version de dépendance, envisagez d'épingler vos packages de dépendance sur une version spécifique.
Voici un exemple de fichier requirements.txt
:
functions-framework requests==2.20.0 numpy
Le Functions Framework est une dépendance requise pour toutes les fonctions. Bien que Cloud Functions l'installe en votre nom lors de la création de la fonction, nous vous recommandons de l'inclure en tant que dépendance explicite pour plus de clarté.
Si votre fonction repose sur des dépendances privées, nous vous recommandons de mettre en miroir functions-framework
sur votre registre privé. Incluez la valeur en miroir functions-framework
en tant que dépendance à votre fonction pour éviter d'installer le package à partir de l'Internet public.
Emballer les dépendances locales
Vous pouvez également empaqueter et déployer les dépendances avec votre fonction. Cette approche est utile si votre dépendance n'est pas disponible via le gestionnaire de packages pip ou si l'accès Internet de votre environnement Cloud Functions est limité.
Par exemple, vous pouvez utiliser une structure de répertoires comme suit :
myfunction/ ├── main.py └── localpackage/ ├── __init__.py └── script.py
Vous pouvez ensuite importer le code comme d'habitude à partir de localpackage
en utilisant l'instruction import
suivante.
# Code in main.py from localpackage import script
Notez qu'avec cette approche, aucun fichier setup.py
n'est exécuté. Les packages avec ces fichiers peuvent toujours être regroupés, mais peuvent ne pas s'exécuter correctement sur Cloud Functions.
Dépendances fournies par le fournisseur
Les dépendances fournies par le fournisseur sont des dépendances dont la source est incluse directement dans votre package de code source et reconstruite avec votre propre code. Utilisez la variable d'environnement de compilation GOOGLE_VENDOR_PIP_DEPENDENCIES pour créer des dépendances PIP fournies par le fournisseur et éviter de les installer lors du déploiement.
Créer des dépendances fournies par le fournisseur
Assurez-vous que python3 est installé sur votre système de développement.
Déclarez vos dépendances d'application dans un fichier
requirements.txt
dans le répertoire racine de l'arborescence de développement.Vous pouvez déclarer le framework des fonctions en incluant
functions-framework
sur une ligne distincte de votre fichierrequirements.txt
.Téléchargez les dépendances de votre fonction dans votre répertoire local. La procédure à suivre varie selon que la dépendance est un fichier wheel Python (*.whl) ou un fichier tar (*.tar.gz).
Si la dépendance est de type wheel Python (*.whl), téléchargez-la dans le répertoire racine de l'arborescence de développement à l'aide de la commande pip:
python3 -m pip download -r requirements.txt --only-binary=:all: \ -d DIRECTORY \ --python-version PYTHON_RUNTIME_NAME \ --platform manylinux2014_x86_64 \ --implementation cp
Remplacez :
- DIRECTORY: nom du répertoire local dans lequel effectuer le téléchargement
- PYTHON_RUNTIME_NAME: version de Python à utiliser pour les vérifications de compatibilité
La structure de répertoire obtenue doit se présenter comme suit:
myfunction/ ├── main.py └── requirements.txt └── DIRECTORY ├── dependency1.whl └── dependency2.whl
Si la dépendance est un fichier tar (*.tar.gz):
Si la dépendance est écrite en Python, utilisez pip pour la télécharger:
python3 -m pip download -r requirements.txt \ -d DIRECTORY
Si une dépendance consiste en du code écrit en C ou C++, vous devez la télécharger et la compiler séparément.
Déployez votre fonction et ses dépendances fournies par des fournisseurs:
gcloud functions deploy FUNCTION_NAME \ --runtime PYTHON_RUNTIME_NAME \ --set-build-env-vars GOOGLE_VENDOR_PIP_DEPENDENCIES=DIRECTORY
Remplacez :
- FUNCTION_NAME: nom de la fonction Cloud Functions que vous déployez.
- PYTHON_RUNTIME_NAME: nom de l'environnement d'exécution Python sous lequel exécuter votre fonction déployée, par exemple python311. Il doit s'agir de la même version d'exécution Python que celle utilisée dans votre environnement de développement local.
- DIRECTORY: nom du répertoire contenant vos dépendances fournies par le fournisseur
Pour en savoir plus sur l'utilisation des buildpacks, consultez la section Créer une fonction avec des packs de création.
Utiliser des dépendances privées
Dépendances privées d'Artifact Registry
Un dépôt Python Artifact Registry peut héberger des dépendances privées pour votre fonction Python. Lors du déploiement sur Cloud Functions, le processus de compilation génère automatiquement des identifiants Artifact Registry pour le compte de service Cloud Build. Il vous suffit d'inclure l'URL Artifact Registry dans votre fichier requirements.txt
sans générer d'identifiants supplémentaires. Exemple :
--index-url REPOSITORY_URL
sampleapp
Flask==0.10.1
google-cloud-storage
Si votre build nécessite plusieurs dépôts, utilisez un dépôt virtuel Artifact Registry pour contrôler en toute sécurité l'ordre dans lequel pip recherche vos dépôts.
Dépendances privées d'autres dépôts
Les dépendances sont installées dans un environnement Cloud Build qui ne fournit pas d'accès aux clés SSH. Les packages hébergés dans des dépôts nécessitant une authentification SSH doivent être fournis et importés avec le code de votre projet, comme décrit dans la section précédente.
Pour copier des dépendances privées dans un répertoire local avant de déployer votre application, vous pouvez utiliser la commande pip install
avec l'indicateur -t DIRECTORY
. Pour ce faire, procédez comme suit :
Copiez votre dépendance dans un répertoire local :
pip install -t DIRECTORY DEPENDENCY
Ajoutez un fichier
__init__.py
vide au répertoireDIRECTORY
pour le transformer en module.Importez depuis ce module pour utiliser votre dépendance :
import DIRECTORY.DEPENDENCY
Packages pré-installés
Les packages Python suivants sont automatiquement installés avec votre fonction lors du déploiement. Si vous utilisez l'un de ces packages dans le code de votre fonction, nous vous recommandons d'inclure les versions suivantes dans votre fichier requirements.txt
:
Python 3.7
Python 3.8 et versions ultérieures
* `pip` (latest version)
* `setuptools` (latest version)
* `wheel` (determined by product requirements)
L'environnement d'exécution Python inclut également un certain nombre de packages système. Si votre fonction utilise une dépendance nécessitant un package système non répertorié, vous pouvez demander un package.