.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.

Informationen zu den ersten Schritten mit .NET in Cloud Run Functions finden Sie in der Kurzanleitung.

Vorlagenpaket

Mit dem Vorlagenpaket können Sie neue Funktionen ganz einfach erstellen. So verwenden Sie sie:

  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 --runtime dotnet8 --trigger-http

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

Console

Wenn Sie die Google Cloud Console verwenden, finden Sie weitere Informationen in der Google Cloud Console-Kurzanleitung.

Funktionsvorbereitung

Sie können eine Funktion direkt über die Google Cloud Console vorbereiten oder auf Ihren 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.

Informationen zu den ersten Schritten mit .NET in Cloud Run Functions finden Sie in der Kurzanleitung.

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