Runtime .NET

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

Persiapan fungsi

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

Runtime dan image dasar .NET yang didukung

Runtime ID Runtime Stack Image dasar runtime Penghentian penggunaan Penghapusan
.NET 10 dotnet10
  • google-24 (default)
  • google-24-full
  • google-24/dotnet10
  • google-24-full/dotnet10
  • 2028-11-14 2029-05-14
    .NET 8 dotnet8
  • google-22 (default)
  • google-22-full
  • google-22/dotnet8
  • google-22-full/dotnet8
  • 2026-11-10 2027-05-10
    .NET 6 dotnet6
  • google-22 (default)
  • google-22-full
  • google-22/dotnet6
  • google-22-full/dotnet6
  • 2024-11-12 12-11-2025
    .NET Core 3 dotnet3 google-18-full google-18-full/dotnet3 30-01-2024 30-01-2025

    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.

    Memilih runtime Anda

    Saat men-deploy fungsi, Anda harus menentukan runtime .NET yang sesuai dengan framework target di file project (MyFunction.csproj atau yang serupa). Anda dapat memilih salah satu runtime .NET yang didukung untuk fungsi Anda selama deployment.

    Anda dapat memilih versi runtime menggunakan Google Cloud konsol, atau gcloud CLI. Klik tab untuk mengetahui petunjuk tentang cara menggunakan alat pilihan Anda:

    gcloud

    Tentukan image dasar.NET untuk fungsi Anda menggunakan flag --base-image, saat men-deploy fungsi. Contoh:

    gcloud run deploy FUNCTION \
        --source . \
        --function FUNCTION_ENTRYPOINT \
        --base-image dotnet10
    

    Ganti:

    • FUNCTION dengan nama fungsi yang Anda deploy. Anda dapat menghapus parameter ini sepenuhnya, tetapi Anda akan diminta untuk memasukkan nama jika menghapusnya.

    • FUNCTION_ENTRYPOINT dengan titik entri ke fungsi Anda dalam kode sumber. Ini adalah kode yang dijalankan Cloud Run saat fungsi Anda berjalan. Nilai flag ini harus berupa nama fungsi atau nama class yang sepenuhnya memenuhi syarat yang ada dalam kode sumber Anda.

    Untuk mengetahui petunjuk mendetail tentang cara men-deploy fungsi menggunakan gcloud CLI, lihat Men-deploy fungsi di Cloud Run.

    Konsol

    Anda dapat memilih versi runtime saat membuat atau memperbarui fungsi Cloud Run di Google Cloud konsol. Untuk mengetahui petunjuk mendetail tentang cara men-deploy fungsi, lihat Men-deploy fungsi di Cloud Run.

    Untuk memilih runtime di Google Cloud konsol saat membuat fungsi, ikuti langkah-langkah berikut:

    1. Di Google Cloud konsol, buka halaman Cloud Run:

      Buka Cloud Run

    2. Klik Write a function.

    3. Dalam daftar Runtime, pilih versi runtime .NET.

    4. Klik Create, lalu tunggu Cloud Run membuat layanan menggunakan revisi placeholder.

    5. Konsol akan mengalihkan Anda ke tab Source tempat Anda dapat melihat kode sumber fungsi Anda. Klik Save and redeploy.

    Untuk mengetahui petunjuk mendetail tentang cara memperbarui versi runtime setelah fungsi Anda di deploy, lihat Men-deploy ulang kode sumber baru.

    Struktur kode sumber

    Agar Cloud Run Functions dapat menemukan definisi fungsi Anda, kode sumber harus mengikuti struktur tertentu. Lihat Menulis fungsi Cloud Run untuk mengetahui informasi selengkapnya.

    Menentukan dependensi

    Fungsi Cloud Run .NET menggunakan file project Microsoft Build Engine (MSBuild) yang merupakan pusat dari proses build dan deployment. Anda dapat menentukan dependensi untuk fungsi Anda dalam file project. Untuk C#, ekstensi filenya adalah .csproj, untuk F#-nya adalah .fsproj, dan untuk Visual Basic adalah .vbproj.

    Untuk pembahasan selengkapnya tentang dependensi dan jenis penyesuaian lainnya, lihat Penyesuaian melalui class Functions Startup.