Runtime .NET

Ringkasan

Fungsi Cloud Run Anda berjalan di lingkungan yang terdiri dari versi sistem operasi plus paket add-on, dukungan bahasa, dan library Functions Framework yang mendukung dan memanggil fungsi Anda. Lingkungan ini diidentifikasi berdasarkan versi bahasa, dan dikenal sebagai runtime.

Untuk informasi tentang runtime secara umum, dan untuk mempelajari versi Ubuntu yang digunakan oleh setiap runtime .NET, lihat Lingkungan eksekusi Cloud Run Functions.

Paket template

Paket template membantu Anda membuat fungsi baru. Untuk menggunakannya:

  1. Instal .NET SDK.

  2. Instal paket template:

    dotnet new install Google.Cloud.Functions.Templates

Template disediakan untuk tiga jenis fungsi di C# (default), F#, dan Visual Basic. Saat membuat project baru dari template, tentukan -lang f# untuk membuat project F#, atau -lang vb untuk membuat project Visual Basic. Untuk informasi selengkapnya, lihat:

Pilih versi .NET Functions Framework

Versi Framework .NET Functions yang berbeda mendukung runtime yang berbeda. Versi 1 mendukung .NET Core 3.1 dan yang lebih baru, dengan template yang ditetapkan secara default ke .NET Core 3.1. Versi 2 mendukung .NET 6 dan yang lebih baru, dengan template yang ditetapkan secara default ke .NET 6.

Untuk mengupgrade project yang ada menggunakan .NET Functions Framework versi 1, edit file project (atau gunakan Visual Studio) untuk mengupdate semua dependensi yang dimulai dengan Google.Cloud.Functions ke versi terbaru, lalu tetapkan framework target ke .NET 6.

Memilih runtime Anda

Fungsi Cloud Run mendukung beberapa versi .NET, yang tercantum di halaman Dukungan runtime. Saat men-deploy fungsi, Anda harus menentukan runtime .NET yang sesuai dengan framework target di file project (MyFunction.csproj atau yang serupa). Untuk menentukan runtime .NET:

Jika Anda menggunakan Google Cloud CLI, tentukan runtime menggunakan parameter --runtime. Flag --entry-point menentukan nama class yang sepenuhnya memenuhi syarat (fully qualified class name/FQN). Contoh:

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

Untuk parameter deployment lainnya, lihat Men-deploy fungsi Cloud Run.

Persiapan fungsi

Anda dapat menulis fungsi di komputer lokal dan menguploadnya. Guna menyiapkan komputer lokal untuk pengembangan .NET, lihat Menyiapkan lingkungan pengembangan .NET.

Library yang memanggil fungsi Anda adalah .NET Functions Framework.

Struktur kode sumber

Agar Cloud Run Functions dapat menemukan definisi fungsi Anda, setiap runtime memiliki persyaratan penyusunan struktur tertentu untuk kode sumber Anda. Lihat Menulis fungsi Cloud Run untuk mengetahui informasi selengkapnya.

Menentukan dependensi

Anda dapat menentukan dependensi untuk fungsi Anda dengan menambahkannya ke file project. Untuk informasi selengkapnya, lihat Menentukan dependensi di .NET.

Langkah berikutnya