.NET-Laufzeit

Überblick

Die Cloud Run Functions-Funktion wird in einer Umgebung ausgeführt, die aus einer Betriebssystemversion, Add-on-Paketen, Sprachunterstützung und der Functions Framework-Bibliothek besteht, die Ihre Funktion unterstützt und aufruft. Diese Umgebung wird durch die Sprachversion identifiziert und als Laufzeit bezeichnet.

Informationen zu Laufzeiten im Allgemeinen und dazu, welche Ubuntu-Version jede .NET-Laufzeit verwendet, finden Sie in der Ausführungsumgebung von Cloud Run Functions.

Vorlagenpaket

Mit dem Vorlagenpaket können Sie neue Funktionen ganz einfach erstellen. Dabei gilt:

  1. Installieren Sie das .NET SDK.

  2. Installieren Sie das Vorlagenpaket:

    dotnet new install Google.Cloud.Functions.Templates

Für die drei Arten von Funktionen in C# (Standardeinstellung), F# und Visual Basic werden Vorlagen bereitgestellt. Geben Sie beim Erstellen eines neuen Projekts aus einer Vorlage -lang f# an, um ein F#-Projekt zu erstellen, oder -lang vb, um ein Visual Basic-Projekt zu erstellen. Weitere Informationen finden Sie unter:

.NET Functions Framework-Version auswählen

Verschiedene Versionen des .NET Functions Frameworks unterstützen unterschiedliche Laufzeiten. Version 1 unterstützt .NET Core 3.1 und höher, wobei Vorlagen standardmäßig auf .NET Core 3.1 eingestellt sind. Version 2 unterstützt .NET 6 und höher, wobei Vorlagen standardmäßig auf .NET 6 eingestellt sind.

Um ein bestehendes Projekt mit .NET Functions Framework Version 1 zu aktualisieren, bearbeiten Sie die Projektdatei (oder verwenden Sie Visual Studio), um alle Abhängigkeiten, die mit Google.Cloud.Functions beginnen, auf die neueste Version zu aktualisieren, und setzen Sie das Ziel-Framework auf .NET 6.

Laufzeit auswählen

Cloud Run Functions unterstützt mehrere .NET-Versionen, die auf der Seite Laufzeitsupport aufgeführt sind. Beim Bereitstellen der Funktion müssen Sie eine .NET-Laufzeit angeben, die dem Ziel-Framework in Ihrer Projektdatei (MyFunction.csproj oder ähnlich) entspricht. So legen Sie Ihre .NET-Laufzeit fest:

gcloud

Wenn Sie die Google Cloud CLI verwenden, geben Sie die Laufzeit mit dem Parameter --runtime an. Das Flag --entry-point gibt den vollständig qualifizierten Klassennamen (FQN) an. Beispiel:

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

Weitere Bereitstellungsparameter finden Sie unter Cloud Run Functions-Funktion bereitstellen.

Console

Wenn Sie die Google Cloud -Konsole verwenden, finden Sie eine ausführliche Anleitung in der Google Cloud -Konsolen-Kurzanleitung.

Funktionsvorbereitung

Sie können eine Funktion direkt über die Google Cloud Console vorbereiten oder auf Ihrem lokalen Computer schreiben und hochladen. Informationen zum Vorbereiten Ihres lokalen Computers für die .NET-Entwicklung finden Sie unter .NET-Entwicklungsumgebung einrichten.

Die Bibliothek, die Ihre Funktion aufruft, ist .NET Functions Framework.

Struktur des Quellcodes

Damit Cloud Run-Funktionen die Definition Ihrer Funktion findet, hat jede Laufzeit bestimmte Strukturanforderungen für Ihren Quellcode. Weitere Informationen finden Sie unter Cloud Run Functions-Funktionen schreiben.

Abhängigkeiten angeben

Sie können Abhängigkeiten für die Funktion angeben, wenn Sie diese in eine Projektdatei einfügen. Weitere Informationen finden Sie unter Abhängigkeiten in .NET angeben.

Nächste Schritte