Entorno de ejecución de .NET

Información general

Tu función de Cloud Run se ejecuta en un entorno que consta de una versión del sistema operativo, además de paquetes complementarios, compatibilidad con idiomas y la biblioteca Functions Framework, que admite e invoca tu función. Este entorno se identifica por la versión de idioma y se conoce como el tiempo 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 Run Functions.

Paquete de plantilla

El paquete de plantillas te ayuda a crear funciones nuevas. Para utilizarlo:

  1. Instala el SDK de.NET.

  2. Instala el paquete de plantilla:

    dotnet new install Google.Cloud.Functions.Templates

Se proporcionan plantillas para los tres tipos de funciones en C# (el valor predeterminado), F# y Visual Basic. Al crear un proyecto a partir de una plantilla, especifica -lang f# para crear un proyecto de F# o -lang vb para crear un proyecto de Visual Basic. Para obtener más información, consulta estos artículos:

Selecciona una versión de .NET Functions Framework

Las diferentes versiones del framework de funciones .NET admiten diferentes tiempos de ejecución. La versión 1 es compatible con .NET Core 3.1 y versiones posteriores, y las plantillas se definen de forma predeterminada en .NET Core 3.1. La versión 2 es compatible con .NET 6 y versiones posteriores, y las plantillas se definen de forma predeterminada en .NET 6.

Para actualizar un proyecto que utilice la versión 1 de .NET Functions Framework, edite el archivo del proyecto (o use Visual Studio) para actualizar todas las dependencias que empiecen por Google.Cloud.Functions a la versión más reciente y defina el framework de destino como .NET 6.

Selecciona tu tiempo de ejecución

Cloud Run Functions admite varias versiones de .NET, que se indican en la página Compatibilidad con el entorno de ejecución. Cuando implementes tu función, debes especificar un tiempo de ejecución de .NET que corresponda al framework de destino en el archivo de tu proyecto (MyFunction.csproj o similar). Para especificar tu entorno de ejecución de .NET, sigue estos pasos:

gcloud

Si usas Google Cloud CLI, especifica el tiempo de ejecución con el parámetro --runtime. La marca --entry-point especifica el nombre de clase completo (FQN). Por ejemplo:

gcloud functions deploy NAME --no-gen2 --entry-point FQN --no-gen2 --runtime dotnet6 --trigger-http

Para obtener más información sobre los parámetros de despliegue, consulta Desplegar una función de Cloud Run.

Consola

Si usas la Google Cloud consola, consulta la Google Cloud guía de inicio rápido de la consola para obtener instrucciones detalladas.

Preparación de la función

Puedes preparar una función directamente desde la Google Cloud consola o escribirla en tu máquina local y subirla. Para preparar tu máquina local para el desarrollo de .NET, consulta el artículo Configurar un entorno de desarrollo de .NET.

La biblioteca que invoca tu función es el framework de funciones de.NET.

Estructura del código fuente

Para que las funciones de Cloud Run puedan encontrar la definición de tu función, cada entorno de ejecución tiene ciertos requisitos de estructura para tu código fuente. Para obtener más información, consulta el artículo sobre cómo escribir funciones de Cloud Run.

Especificar dependencias

Puedes especificar las dependencias de tu función añadiéndolas a un archivo de proyecto. Para obtener más información, consulta Especificar dependencias en .NET.

Siguientes pasos