El entorno de ejecución de .NET

Descripció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 de complementos, compatibilidad con lenguajes y la biblioteca de Functions Framework que admite y, luego, invoca la función. Este entorno se identifica con 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 Run Functions.

Paquete de plantillas

El paquete de plantillas te ayuda a crear funciones nuevas. Para usarlo, sigue estos pasos:

  1. Instala el SDK de .NET.

  2. 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 F#, o -lang vb si deseas crear un proyecto de Visual Basic. Para obtener más información, consulta lo siguiente:

Selecciona una versión de Functions Framework para .NET

Las diferentes versiones de Functions Framework para .NET 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 Functions Framework para .NET, 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 Run Functions admite varias versiones de .NET, que se enumeran en la página Compatibilidad del 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 con el parámetro --runtime. La marca --entry-point especifica el nombre de clase completamente calificado (FQN). Por ejemplo:

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

Para obtener más parámetros de implementación, consulta Implementa una función de Cloud Run.

Consola

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

Prepara funciones

Puedes preparar una función directamente desde la consola de Google Cloud o escribirla en tu máquina local y subirla. Si deseas 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.

Estructura del código fuente

Para que Cloud Run 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 Run para obtener más información.

Especifica dependencias

Puedes especificar dependencias para tu función agregándolas a un archivo de proyecto. Para obtener más información, consulta Especifica dependencias en .NET.

¿Qué sigue?