.NET ランタイム

Cloud Run 関数は、オペレーティング システムのバージョンに加えて、アドオン パッケージ、言語サポート、お使いの関数をサポートして呼び出す .NET Functions Framework ライブラリで構成される環境で実行されます。この環境は言語バージョンで識別され、ランタイム ID として知られています。

関数の準備

関数は、 Google Cloud コンソールから直接準備することも、ローカルマシンで作成してアップロードすることもできます。.NET 開発用にローカルマシンを準備するには、.NET 開発環境を設定するをご覧ください。

テンプレート パッケージ

テンプレート パッケージを使用すると、新しい関数を簡単に作成できます。使用方法は次のとおりです。

  1. .NET SDK をインストールします。

  2. テンプレート パッケージをインストールします。

    dotnet new install Google.Cloud.Functions.Templates
    

C#(デフォルト)、F#、Visual Basic の 3 種類の関数用のテンプレートが用意されています。テンプレートから新しいプロジェクトを作成するときは、-lang f# を指定して F# プロジェクトを作成するか、-lang vb を指定して Visual Basic プロジェクトを作成します。

.NET Functions Framework のバージョンの選択

.NET Functions Framework のバージョンによって、サポートされるランタイムが異なります。バージョン 1 は .NET Core 3.1 以降をサポートし、デフォルトのテンプレートは .NET Core 3.1 です。バージョン 2 は .NET 6 以降をサポートし、デフォルトのテンプレートは .NET 6 です。

.NET Functions Framework バージョン 1 を使用して既存のプロジェクトをアップグレードするには、プロジェクト ファイルを編集するか Visual Studio を使用して、Google.Cloud.Functions で始まるすべての依存関係を最新バージョンに更新し、ターゲット フレームワークを .NET 6 に設定します。

ランタイムの選択

Cloud Run functions は、サポートされている言語ランタイムとベースイメージのページに記載されている複数のバージョンの .NET をサポートしています。関数をデプロイするときに、ターゲット フレームワークに対応する .NET ランタイムをプロジェクト ファイル(MyFunction.csproj など)に指定する必要があります。関数の優先ランタイムは、デプロイ時に選択できます。

gcloud

Cloud Run functions を使用して gcloud CLI で HTTP 関数をデプロイするには、Google Cloud CLI を使用してデプロイするをご覧ください。

Console

Google Cloud コンソールを使用している場合は、関数を作成してデプロイするときにランタイムを選択します。詳しい手順については、Google Cloud コンソール クイックスタートをご覧ください。

ソースコードの構造

Cloud Run functions が関数の定義を見つけるには、ソースコードが特定の構造に従っている必要があります。詳細については、Cloud Run 関数を作成するをご覧ください。

依存関係の指定

.NET Cloud Run functions は、ビルドとデプロイのプロセスの中核となる Microsoft Build Engine(MSBuild)プロジェクト ファイルを使用します。関数の依存関係は、プロジェクト ファイルで指定できます。C# の場合、ファイル拡張子は .csproj、F# の場合は .fsproj、Visual Basic の場合は .vbproj になります。

依存関係やその他の種類のカスタマイズの詳細については、Functions スタートアップ クラスを使用したカスタマイズをご覧ください。