Votre fonction Cloud Run s'exécute dans un environnement composé d'une version de système d'exploitation avec des packages de modules complémentaires, de langages acceptés ainsi que de la bibliothèque du framework Functions.NET qui prend en charge et appelle votre fonction. Cet environnement est identifié par la version de langage et est appelé l'ID d'exécution.
Préparation de la fonction
Vous pouvez préparer une fonction directement depuis la Google Cloud console, 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.
Environnements d'exécution .NET et images de base compatibles
| Environnement d'exécution | ID d'exécution | Piles | Image de base de l'environnement d'exécution | Obsolescence | Mise hors service |
|---|---|---|---|---|---|
| .NET 10 | dotnet10 |
|
|
2028-11-14 | 2029-05-14 |
| .NET 8 | dotnet8 |
|
|
2026-11-10 | 2027-05-10 |
| .NET 6 | dotnet6 |
|
|
2024-11-12 | 2025-11-12 |
| .NET Core 3 | dotnet3 | google-18-full | google-18-full/dotnet3 | 2024-01-30 | 2025-01-30 |
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.
Sélectionner votre environnement 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). Vous pouvez sélectionner l'un des
environnements d'exécution .NET compatibles pour votre fonction lors du déploiement.
Vous pouvez sélectionner une version d'environnement d'exécution à l'aide de la Google Cloud console ou de la gcloud CLI. Cliquez sur l'onglet correspondant pour obtenir des instructions sur l'utilisation de l'outil de votre choix :
gcloud
Spécifiez l'image de base.NET pour votre fonction à l'aide de l'option --base-image lors du déploiement de votre fonction. Exemple :
gcloud run deploy FUNCTION \
--source . \
--function FUNCTION_ENTRYPOINT \
--base-image dotnet10
Remplacez :
FUNCTION par le nom de la fonction que vous déployez. Vous pouvez omettre ce paramètre, mais dans ce cas le nom vous sera demandé.
FUNCTION_ENTRYPOINT par le point d'entrée de votre fonction dans votre code source. Il s'agit du code que Cloud Run exécute lors de l'exécution de votre fonction. La valeur de cette option doit être un nom de fonction ou un nom de classe complet qui existe dans votre code source.
Pour obtenir des instructions détaillées sur le déploiement d'une fonction à l'aide de la gcloud CLI, consultez Déployer des fonctions dans Cloud Run.
Console
Vous pouvez sélectionner une version d'environnement d'exécution lorsque vous créez ou mettez à jour une fonction Cloud Run dans la Google Cloud console. Pour obtenir des instructions détaillées sur le déploiement d'une fonction, consultez Déployer des fonctions dans Cloud Run.
Pour sélectionner un environnement d'exécution dans la Google Cloud console lorsque vous créez une fonction, procédez comme suit :
Dans la Google Cloud console, accédez à la page Cloud Run :
Cliquez sur Écrire une fonction.
Dans la liste Environnement d'exécution, sélectionnez une version d'environnement d'exécution .NET.
Cliquez sur Créer, puis attendez que Cloud Run crée le service à l'aide d'une révision d'espace réservé.
La console vous redirige vers l'onglet Source , où vous pouvez voir le code source de votre fonction. Cliquez sur Enregistrer et redéployer.
Pour obtenir des instructions détaillées sur la mise à jour de la version de l'environnement d'exécution une fois votre fonction est déployée, consultez Redéployer un nouveau code source.
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 Écrire des fonctions Cloud Run.
Spécifier des dépendances
Les fonctions Cloud Run .NET utilisent
des fichiers de projet Microsoft Build Engine (MSBuild)
qui sont essentiels au processus de compilation et de déploiement. Vous pouvez spécifier des dépendances pour votre fonction dans un fichier de projet. Pour C#, l'extension de fichier est .csproj. Pour F#, il s'agit de .fsproj, et pour Visual Basic, de .vbproj.
Pour en savoir plus sur les dépendances et les autres types de personnalisation, consultez Customization through Functions Startup classes.