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 :

  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 :

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