Environnement d'exécution .NET
Présentation
Votre fonction Cloud Run s'exécute dans un environnement composé d'une version de système d'exploitation, de packages de modules complémentaires, de langages acceptés ainsi que de la bibliothèque du framework Functions qui prend en charge et appelle votre fonction. Cet environnement est identifié par la version de langage et appelé "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 .NET, consultez Environnement d'exécution Cloud Run Functions.
Package de modèles
Le package de modèles vous aide à créer des fonctions. Pour l'utiliser :
Installez le SDK .NET.
Installez le package de modèles :
dotnet new install Google.Cloud.Functions.Templates
Des modèles sont fournis pour les trois types de fonctions en C# (par défaut), F# et Visual Basic. Lorsque vous créez un projet à partir d'un modèle, spécifiez -lang f#
pour créer un projet F# ou -lang vb
pour créer un projet Visual Basic. Pour en savoir plus, consultez :
- Langages .NET (pour F# et Visual Basic)
Sélectionner une version du framework Functions .NET
Les différentes versions du framework Functions .NET prennent en charge différents environnements d'exécution. La version 1 est compatible avec .NET Core 3.1 et versions ultérieures, les modèles étant définis par défaut sur .NET Core version 3.1. La version 2 est compatible avec .NET 6 et versions ultérieures, les modèles étant définis par défaut sur .NET 6.
Pour mettre à niveau un projet existant à l'aide du framework Functions .NET version 1, modifiez le fichier de projet (ou utilisez Visual Studio) pour mettre à jour toutes les dépendances commençant par Google.Cloud.Functions
vers la dernière version et définir le framework cible sur .NET 6.
Sélectionner votre environnement d'exécution
Cloud Run Functions accepte plusieurs versions de .NET, lesquelles sont répertoriées sur la page Prise en charge des environnements d'exécution. Lorsque vous déployez votre fonction, vous devez spécifier un environnement d'exécution .NET correspondant au framework cible de votre fichier de projet (MyFunction.csproj
ou similaire). Pour spécifier votre environnement d'exécution .NET :
gcloud
Si vous utilisez la Google Cloud CLI, spécifiez l'environnement d'exécution à l'aide du paramètre --runtime
. Le flag --entry-point
spécifie le nom de classe complet (FQN). Exemple :
gcloud functions deploy NAME --no-gen2 --entry-point FQN --no-gen2 --runtime dotnet6 --trigger-http
Pour en savoir plus sur les paramètres de déploiement, consultez Déployer une fonction Cloud Run.
Console
Si vous utilisez la console Google Cloud , consultez le guide de démarrage rapide de la consoleGoogle 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 .NET, consultez Configurer un environnement de développement .NET.
La bibliothèque qui appelle votre fonction est le framework des fonctions .NET.
Structure du code source
Pour que Cloud Run Functions trouve la définition de votre fonction, chaque environnement d'exécution a certaines exigences concernant la structure de votre code source. Pour en savoir plus, consultez Écrire des fonctions Cloud Run.
Spécifier des dépendances
Vous pouvez spécifier des dépendances pour votre fonction en les ajoutant à un fichier de projet. Pour en savoir plus, consultez Spécifier des dépendances en .NET.
Étapes suivantes
- Découvrez les autres langages .NET que vous pouvez utiliser pour écrire des fonctions Cloud Run Functions : F# et Visual Basic.