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 fungsi Cloud Run.

Untuk mulai menggunakan .NET di fungsi Cloud Run, lihat Panduan memulai.

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 dalam file project Anda (MyFunction.csproj atau yang serupa). Untuk menentukan runtime .NET:

gcloud

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 --entry-point FQN --runtime dotnet8 --trigger-http FLAGS...

FLAGS... merujuk pada argumen yang diteruskan selama deployment pertama fungsi Anda. Untuk mengetahui informasi selengkapnya mengenai argumen yang diperlukan dan opsional, lihat Men-deploy menggunakan Google Cloud CLI.

Konsol

Jika Anda menggunakan Google Cloud Console, lihat panduan memulai Google Cloud Console untuk mengetahui petunjuk mendetail.

Persiapan fungsi

Anda dapat menyiapkan fungsi langsung dari Konsol Google Cloud atau menulisnya di komputer lokal, lalu menguploadnya. Guna menyiapkan komputer lokal untuk pengembangan .NET, lihat Menyiapkan lingkungan pengembangan .NET.

Library yang memanggil fungsi Anda adalah .NET Functions Framework.

Untuk mulai menggunakan .NET dengan cepat di fungsi Cloud Run, lihat Panduan Memulai.

Struktur kode sumber

Agar fungsi Cloud Run 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 selanjutnya