Entorno de ejecución de .NET
Descripción general
Tu Cloud Function se ejecuta en un entorno que consta de una versión del sistema operativo, además de paquetes de complementos, compatibilidad con lenguajes y la biblioteca de Functions Framework que admite e invoca la función. Este entorno se identifica mediante la versión del lenguaje y se conoce como el entorno de ejecución.
Para obtener información sobre los entornos de ejecución en general y saber qué versión de Ubuntu usa cada entorno de ejecución de .NET, consulta el entorno de ejecución de Cloud Functions.
Para comenzar a usar .NET en Cloud Functions, consulta la guía de inicio rápido.
Paquete de plantillas
El paquete de plantillas te ayuda a crear funciones nuevas. Para usarlo, realiza los siguientes pasos:
Instala el SDK de .NET.
Instala el paquete de plantillas:
dotnet new install Google.Cloud.Functions.Templates
Las plantillas se proporcionan para los tres tipos de funciones en C# (predeterminado), F# y Visual Basic. Cuando crees un proyecto nuevo a partir de una plantilla, especifica -lang f# para crear un proyecto de F# o -lang vb si deseas crear un proyecto de Visual Basic. Para obtener más información, consulte:
- Tu primera función: C#
- Lenguajes de .NET (para F# y Visual Basic)
Selecciona una versión de .NET Functions Framework
Las diferentes versiones de .NET Functions Framework admiten diferentes entornos de ejecución. La versión 1 es compatible con .NET Core 3.1 y versiones posteriores, con plantillas predeterminadas para .NET Core 3.1. La versión 2 es compatible con .NET 6 y versiones posteriores, con plantillas predeterminadas para .NET 6.
Para actualizar un proyecto existente con la versión 1 de .NET Functions Framework,
edita el archivo del proyecto (o usa Visual Studio) para actualizar todas las dependencias que
comienzan con Google.Cloud.Functions a la versión más reciente y establece el
framework de destino para .NET 6.
Selecciona tu entorno de ejecución
Cloud Functions admite varias versiones de .NET, que se enumeran en
la página Compatibilidad con el entorno de ejecución. Cuando implementas
tu función, debes especificar
un entorno de ejecución de .NET correspondiente al framework de destino en el archivo de proyecto
(MyFunction.csproj o similar). Para especificar el entorno de ejecución de .NET, haz lo siguiente:
gcloud
Si usas Google Cloud CLI, especifica el entorno de ejecución mediante el parámetro --runtime. La marca --entry-point especifica el nombre de clase completamente calificado (FQN). Por ejemplo:
gcloud functions deploy NAME --entry-point FQN --runtime dotnet6 --trigger-http
Para obtener más parámetros de implementación, consulta Implementa con Google Cloud CLI.
Console
Si usas la consola de Google Cloud, consulta la guía de inicio rápido de la consola de Google Cloud para obtener instrucciones detalladas.
Preparación de funciones
Puedes preparar una función directamente desde la consola de Google Cloud o escribirla en tu máquina local y subirla. A fin de preparar tu máquina local para el desarrollo de .NET, consulta Configura un entorno de desarrollo de .NET.
La biblioteca que invoca tu función es Functions Framework para .NET.
Para comenzar rápidamente con .NET en Cloud Functions, consulta la guía de inicio rápido.
Estructura del código fuente
A fin de que Cloud Functions encuentre la definición de tu función, cada entorno de ejecución tiene ciertos requisitos de estructura para el código fuente. Consulta Escribe funciones de Cloud Functions para obtener más información.
Especifica dependencias
Puedes especificar dependencias para tu función si las agregas a un archivo de proyecto. Para obtener más información, consulta Especifica dependencias en .NET.
¿Qué sigue?
- Crea tu primera función de C# desde cero.
- Obtén más información sobre otros lenguajes de .NET que puedes usar para escribir funciones de Cloud Functions: F# y Visual Basic.