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 tu función. Este entorno se identifica por la versión del lenguaje y se conoce como ID de entorno de ejecución.
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.
Imágenes base y entornos de ejecución de .NET compatibles
| Entorno de ejecución | ID de entorno de ejecución | Pilas | Imagen base del entorno de ejecución |
|---|---|---|---|
| .NET 10 (vista previa) |
dotnet10 |
|
|
| .NET 8 | dotnet8 |
|
|
| .NET 6 | dotnet6 |
|
|
| .NET Core 3 | dotnet3 | google-18-full | google-18-full/dotnet3 |
Paquete de plantillas
El paquete de plantillas te ayuda a crear funciones nuevas. Para usarlo, sigue estos 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 F#, o -lang vb si deseas crear un proyecto de
Visual Basic.
Selecciona tu entorno de ejecución
Cuando implementes 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). Puedes seleccionar uno de los entornos de ejecución de .NET compatibles para tu función durante la implementación.
Puedes seleccionar una versión del entorno de ejecución con la consola de Google Cloud o gcloud CLI. Haz clic en la pestaña para obtener instrucciones sobre cómo usar la herramienta que elijas:
gcloud
Especifica la imagen base de.NET para tu función con la marca --base-image cuando implementes tu función. Por ejemplo:
gcloud run deploy FUNCTION \
--source . \
--function FUNCTION_ENTRYPOINT \
--base-image dotnet8
Reemplaza lo siguiente:
Reemplaza FUNCTION por el nombre de la función que implementas. Puedes omitir este parámetro por completo, pero se te solicitará el nombre si lo haces.
FUNCTION_ENTRYPOINT por el punto de entrada a tu función en tu código fuente. Este es el código que ejecuta Cloud Run cuando se ejecuta tu función. El valor de esta marca debe ser un nombre de función o un nombre de clase completamente calificado que exista en tu código fuente.
Para obtener instrucciones detalladas sobre cómo implementar una función con gcloud CLI, consulta Implementa funciones en Cloud Run.
Console
Puedes seleccionar una versión del entorno de ejecución cuando creas o actualizas una función de Cloud Run en la consola de Google Cloud . Para obtener instrucciones detalladas sobre cómo implementar una función, consulta Implementa funciones en Cloud Run.
Para seleccionar un entorno de ejecución en la consola de Google Cloud cuando crees una función, sigue estos pasos:
En la consola Google Cloud , ve a la página de Cloud Run:
Haz clic en Escribe una función.
En la lista Entorno de ejecución, selecciona una versión del entorno de ejecución de .NET.
Haz clic en Crear y espera a que Cloud Run cree el servicio con una revisión de marcador de posición.
La consola te redireccionará a la pestaña Fuente, en la que puedes ver el código fuente de tu función. Haz clic en Guardar y volver a implementar.
Para obtener instrucciones detalladas sobre cómo actualizar la versión del entorno de ejecución después de implementar tu función, consulta Cómo volver a implementar código fuente nuevo.
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 Cloud Run en .NET 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 Personalización a través de clases de Functions Startup.