El entorno de ejecución de .NET

Tu función de Cloud Run se ejecuta en un entorno que consta de una versión del sistema operativo con paquetes de complementos, compatibilidad con lenguajes y la biblioteca de .NET Functions Framework que admite e invoca la función. Este entorno se identifica mediante la versión del lenguaje y se conoce como el ID del entorno de ejecución.

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.

Paquete de plantillas

El paquete de plantillas te ayuda a crear funciones nuevas. Para usarlo, realiza los pasos siguientes:

  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.

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 Entornos de ejecución y las imágenes base de lenguajes compatibles. Cuando implementes tu función, debes especificar un entorno de ejecución de .NET corresponding to the target framework in your project file (MyFunction.csproj o similar). Puedes seleccionar el entorno de ejecución que prefieras para tu función durante la implementación.

gcloud

Para usar funciones de Cloud Run para implementar una función HTTP con gcloud CLI, consulta Implementa con Google Cloud CLI.

Console

Si usas la consola de Google Cloud, selecciona el entorno de ejecución cuando creas y cuando implementas tu función. Consulta la guía de inicio rápido de la consola de Google Cloud para obtener instrucciones detalladas.

Estructura del código fuente

Para que Cloud Run Functions encuentre la definición de tu función, tu código fuente debe seguir una estructura específica. Consulta Escribe funciones de Cloud Run para obtener más información.

Especifica dependencias

Las funciones de .NET Cloud Run usan archivos de proyecto de Microsoft Build Engine (MSBuild), que son fundamentales para el proceso de compilación y de implementación. Puedes especificar dependencias para tu función en un archivo de proyecto. La extensión de archivo es .csproj en C#, .fsproj para F# y .vbproj para Visual Basic.

Para obtener más información sobre las dependencias y otros tipos de personalización, consulta Customization through Functions Startup classes (Personalización mediante clases de Functions Startup).