O ambiente de execução do .NET

Visão geral

A função do Cloud Run é executada em um ambiente que consiste em uma versão do sistema operacional, além de pacotes complementares, suporte a linguagens e a biblioteca do Functions Framework que dá suporte e invoca a função. Esse ambiente é identificado pela versão da linguagem e conhecido como ambiente de execução.

Para mais informações sobre tempos de execução em geral e para saber qual versão do Ubuntu cada ambiente de execução .NET usa, consulte o ambiente de execução do Cloud Run functions.

Para começar a usar o .NET nas funções do Cloud Run, consulte o Guia de início rápido.

Pacote de modelos

O pacote de modelos ajuda a criar novas funções. Para usá-lo, faça o seguinte:

  1. Instale o SDK .NET.

  2. Instale o pacote de modelos:

    dotnet new install Google.Cloud.Functions.Templates

Os modelos são fornecidos para os três tipos de funções em C# (padrão), F# e Visual Basic. Ao criar um novo projeto usando um modelo, especifique -lang f# para criar um projeto F# ou -lang vb para criar um projeto Visual Basic. Confira mais informações em:

Selecionar uma versão do .NET Functions Framework

Versões diferentes do .NET Functions Framework aceitam diferentes ambientes de execução. A versão 1 dá suporte ao .NET Core 3.1 e a versões mais recentes, com modelos padronizados para o .NET Core 3.1. A versão 2 dá suporte ao .NET 6 e a versões mais recentes, com modelos padronizados para o .NET 6.

Para fazer upgrade de um projeto atual usando o .NET Functions Framework 1, basta editar o arquivo do projeto (ou usar o Visual Studio) a fim de atualizar todas as dependências que começam com Google.Cloud.Functions para a versão mais recente e definir o framework de destino como .NET 6.

Selecionar o ambiente de execução

As funções do Cloud Run dão suporte a várias versões do .NET, que estão listadas na página Suporte ao ambiente de execução. Ao implantar a função, você precisa especificar um ambiente de execução .NET correspondente ao framework de destino que está no arquivo de projeto (MyFunction.csproj ou semelhante). Para especificar o ambiente de execução .NET:

gcloud

Se você estiver usando a Google Cloud CLI, especifique o ambiente de execução usando o parâmetro --runtime. A sinalização --entry-point especifica o nome de classe totalmente qualificado (FQN, na sigla em inglês). Exemplo:

gcloud functions deploy NAME --entry-point FQN --runtime dotnet6 --trigger-http FLAGS...

FLAGS... refere-se a argumentos transmitidos durante a primeira implantação da função. Para mais informações sobre argumentos obrigatórios e opcionais, consulte Implantação com a CLI do Google Cloud.

Console

Se você estiver usando o console do Google Cloud, consulte o Guia de início rápido do console do Google Cloud para conferir instruções detalhadas.

Preparação de funções

É possível preparar uma função diretamente do console do Google Cloud ou gravá-la na máquina local e fazer upload dela. Para preparar a máquina local para desenvolvimento do .NET, consulte Como configurar um ambiente de desenvolvimento do .NET.

A biblioteca que invoca a função é o Functions Framework para .NET.

Para começar rapidamente a usar o .NET no Cloud Run functions, consulte o Guia de início rápido.

Estrutura do código-fonte

Para que as funções do Cloud Run encontrem a definição da sua função, cada ambiente de execução possui determinados requisitos de estruturação para o código-fonte. Consulte Escrever funções do Cloud Run para mais informações.

Como especificar dependências

É possível especificar dependências para a função adicionando-as a um arquivo de projeto. Para mais informações, consulte Como especificar dependências em .NET.

A seguir