O tempo de execução do .NET

Vista geral

A sua função do Cloud Run é executada num ambiente que consiste numa versão do sistema operativo, além de pacotes de suplementos, suporte de idiomas e a biblioteca Functions Framework que suporta e invoca a sua função. Este ambiente é identificado pela versão do idioma e é conhecido como o tempo de execução.

Para obter informações sobre os tempos de execução em geral e saber que versão do Ubuntu cada tempo de execução do .NET usa, consulte o ambiente de execução das funções do Cloud Run.

Pacote de modelos

O pacote de modelos ajuda a criar novas funções. Para utilizar a aplicação:

  1. Instale o SDK.NET.

  2. Instale o pacote de modelos:

    dotnet new install Google.Cloud.Functions.Templates

São fornecidos modelos para os três tipos de funções em C# (a predefinição), F# e Visual Basic. Quando criar um novo projeto a partir de um modelo, especifique -lang f# para criar um projeto F# ou -lang vb para criar um projeto do Visual Basic. Para mais informações, consulte:

Selecione uma versão do .NET Functions Framework

As diferentes versões do .NET Functions Framework são compatíveis com diferentes tempos de execução. A versão 1 suporta o .NET Core 3.1 e posteriores, com os modelos definidos por predefinição para o .NET Core 3.1. A versão 2 suporta o .NET 6 e posterior, com os modelos predefinidos para o .NET 6.

Para atualizar um projeto existente com a versão 1 do .NET Functions Framework, edite o ficheiro do projeto (ou use o Visual Studio) para atualizar todas as dependências que começam com Google.Cloud.Functions para a versão mais recente e defina o framework de destino para .NET 6.

Selecione o tempo de execução

As funções do Cloud Run suportam várias versões do .NET, listadas na página de suporte de tempo de execução. Quando implementa a função, tem de especificar um runtime .NET correspondente à framework de destino no ficheiro do projeto (MyFunction.csproj ou semelhante). Para especificar o runtime .NET:

gcloud

Se estiver a usar a Google Cloud CLI, especifique o tempo de execução com o parâmetro --runtime. A flag --entry-point especifica o nome da classe totalmente qualificado (FQN). Por exemplo:

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

Para mais parâmetros de implementação, consulte o artigo Implemente uma função do Cloud Run.

Consola

Se estiver a usar a Google Cloud consola, consulte o Google Cloud início rápido da consola para ver instruções detalhadas.

Preparação da função

Pode preparar uma função diretamente a partir da Google Cloud consola ou escrevê-la no seu computador local e carregá-la. Para preparar o seu computador local para o desenvolvimento .NET, consulte o artigo Configurar um ambiente de desenvolvimento .NET.

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

Estrutura do código-fonte

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

Especificar dependências

Pode especificar dependências para a sua função adicionando-as a um ficheiro de projeto. Para mais informações, consulte o artigo Especificar dependências no .NET.

O que se segue?