Environnement d'exécution Python

Présentation

Votre fonction Cloud Run s'exécute dans un environnement composé d'une version de système d'exploitation, de packages complémentaires, d'une compatibilité avec les langages et de la bibliothèque du framework des fonctions compatible avec votre fonction. Cet environnement est identifié par la version de langage et est appelé l'environnement d'exécution.

Pour en savoir plus sur les environnements d'exécution en général et découvrir la version d'Ubuntu utilisée par chaque environnement d'exécution Python, consultez la page Environnement d'exécution Cloud Run Functions.

Pour commencer à utiliser Python sur Cloud Run Functions, consultez le guide de démarrage rapide.

Sélectionner votre environnement d'exécution

Cloud Run Functions est compatible avec plusieurs versions de Python, répertoriées sur la page Compatibilité des environnements d'exécution. Vous pouvez sélectionner l'environnement d'exécution Python pour votre fonction lors du déploiement.

gcloud

Si vous utilisez Google Cloud CLI, spécifiez l'environnement d'exécution à l'aide du paramètre --runtime. Exemple :

gcloud functions deploy NAME --runtime python312 --trigger-http FLAGS...

FLAGS... fait référence aux arguments transmis lors du premier déploiement de votre fonction. Pour en savoir plus sur les arguments obligatoires et facultatifs, consultez la page Déployer à l'aide de Google Cloud CLI.

Console

Si vous utilisez la console Google Cloud, consultez le guide de démarrage rapide de la console Google Cloud pour obtenir des instructions détaillées.

Préparation de la fonction

Vous pouvez préparer une fonction directement depuis la console Google Cloud, ou l'écrire sur votre ordinateur local et l'importer. Pour préparer votre ordinateur local pour le développement Python, consultez la page Configurer un environnement de développement Python.

Pour commencer à utiliser Python sur Cloud Run Functions rapidement, consultez le guide de démarrage rapide.

Structure du code source

Pour que Cloud Run Functions trouve la définition de votre fonction, votre code source doit respecter une structure spécifique. Pour en savoir plus, consultez la page Écrire des fonctions Cloud Run.

Spécifier des dépendances

Il existe deux manières de spécifier des dépendances pour les fonctions Cloud Run 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. Pour en savoir plus, consultez la page Spécifier des dépendances en Python.

Cloud Run Functions ne permet pas de spécifier des dépendances avec Pipfile/Pipfile.lock. Votre projet ne doit pas contenir ces fichiers.

Variables d'environnement

Votre environnement d'exécution Python définit automatiquement certaines variables d'environnement pour que votre fonction puisse les utiliser si nécessaire. Pour en savoir plus, consultez la page Utiliser des variables d'environnement.

Journalisation

Vous pouvez écrire des journaux dans Cloud Logging à partir de fonctions Python à l'aide du gestionnaire de journalisation Python standard ou directement à l'aide de la bibliothèque cliente de l'API Cloud Logging pour Python. Lorsque vous utilisez le gestionnaire de journalisation Python standard, vous devez associer un gestionnaire Cloud Logging au gestionnaire racine Python. Pour en savoir plus, consultez la page Configurer Cloud Logging pour Python.