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 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 .NET, consultez la page Environnement d'exécution Cloud Run Functions.

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

Package de modèles

Le package de modèles vous aide à créer des fonctions. Pour l'utiliser :

  1. Installez le SDK .NET.

  2. 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 les pages suivantes :

Sélectionner une version du framework des fonctions .NET

Les différentes versions du framework des fonctions .NET prennent en charge différents environnements d'exécution. La version 1 est compatible avec .NET Core version 3.1 et ultérieure, 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 à jour un projet existant à l'aide du framework des fonctions .NET version 1, il vous suffit de modifier le fichier de projet (ou d'utiliser Visual Studio) pour mettre à jour toutes les dépendances commençant par Google.Cloud.Functions à la dernière version et définir le framework cible sur .NET 6.

Sélectionner votre environnement d'exécution

Cloud Run Functions est compatible avec plusieurs versions de .NET, répertoriées sur la page Compatibilité 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, procédez comme suit :

gcloud

Si vous utilisez Google Cloud CLI, spécifiez l'environnement d'exécution à l'aide du paramètre --runtime. L'option --entry-point spécifie le nom de classe complet (FQN). Exemple :

gcloud functions deploy NAME --entry-point FQN --runtime dotnet6 --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 .NET, consultez la page Configurer un environnement de développement .NET.

La bibliothèque qui appelle votre fonction est le framework des fonctions .NET.

Pour commencer à utiliser .NET 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, chaque environnement d'exécution a certaines exigences en matière de structuration pour 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 la page Spécifier des dépendances dans .NET.

Étapes suivantes