El entorno de ejecución de .NET

Descripción general

Tu función de Cloud Run Functions 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 Run Functions.

Para comenzar a usar .NET en Cloud Run 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:

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

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 Run 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 dotnet8 --trigger-http FLAGS...

FLAGS... hace referencia a los argumentos que se pasaron durante la primera implementación de tu función. Para obtener más información sobre los argumentos obligatorios y los opcionales, 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. 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.

Para comenzar rápidamente con .NET en Cloud Run Functions consulta la guía de inicio rápido.

Estructura del código fuente

A fin de que las funciones de Cloud Run encuentren la definición de tu función, cada entorno de ejecución tiene ciertos requisitos de estructura para el código fuente. Consulta Escribe Cloud Run 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?