Mulai Cepat: Buat aplikasi Azure Functions dengan Azure App Configuration

Dalam panduan mulai cepat ini, Anda memasukkan layanan Azure App Configuration ke dalam aplikasi Azure Functions untuk memusatkan penyimpanan dan pengelolaan semua pengaturan aplikasi yang terpisah Anda dari kode Anda.

Prasyarat

• Akun Azure dengan langganan aktif. Buat akun gratis.
• Penyimpanan App Configuration. Buat toko.
• Visual Studio dengan beban kerja pengembangan Azure.
• Alat Azure Functions, jika Anda belum menginstalnya dengan Visual Studio.

Menambahkan nilai kunci

Tambahkan nilai kunci berikut ke penyimpanan App Configuration dan biarkan Label dan Tipe Konten dengan nilai defaultnya. Untuk informasi selengkapnya tentang cara menambahkan nilai kunci ke penyimpanan menggunakan portal Azure atau CLI, buka Membuat nilai kunci.

Tombol	Nilai
TestApp:Settings:Message	Data dari Azure App Configuration

Buat aplikasi fungsi

Templat proyek Azure Functions di Visual Studio membuat proyek pustaka kelas C# yang bisa Anda terbitkan ke aplikasi fungsi di Azure. Aplikasi fungsi memungkinkan Anda mengelompokkan fungsi sebagai unit logis untuk pengelolaan, penyebaran, penskalaan, dan berbagi sumber daya dengan lebih mudah.

1. Dari menu Visual Studio, pilih File>Proyek>Baru.

2. Di Buat proyek baru, masukkan fungsi di kotak pencarian, pilih templat Azure Functions, lalu pilih Berikutnya.

3. Di Konfigurasikan proyek baru, masukkan Nama proyek untuk proyek Anda, lalu pilih Buat. Nama aplikasi fungsi harus valid sebagai namespace layanan C#, jadi jangan gunakan garis bawah, tanda hubung, atau karakter non-alfanumerik lainnya.

4. Untuk pengaturan Buat aplikasi Azure Functions baru, gunakan nilai dalam tabel berikut:

   Proses terisolasi

   Pengaturan	Nilai	Deskripsi
   Versi .NET	.NET 6 Terisolasi	Nilai ini membuat proyek fungsi yang berjalan dalam proses pekerja yang terisolasi. Proses pekerja terisolasi mendukung versi .NET non-LTS lainnya dan juga .NET Framework. Untuk informasi selengkapnya, lihat Ringkasan versi runtime Azure Functions.
   Templat fungsi	Pemicu HTTP	Nilai ini membuat fungsi yang dipicu oleh permintaan HTTP.
   Akun penyimpanan (AzureWebJobsStorage)	Emulator Storage	Karena aplikasi fungsi di Azure memerlukan akun penyimpanan, aplikasi ditetapkan atau dibuat saat Anda memublikasikan proyek Anda ke Azure. Pemicu HTTP tidak menggunakan string koneksi akun Azure Storage; semua jenis pemicu lainnya memerlukan string koneksi akun Azure Storage yang valid.
   Tingkat otorisasi	Anonim	Fungsi yang dibuat dapat dipicu oleh klien mana pun tanpa menyediakan kunci. Pengaturan otorisasi ini memudahkan Anda menguji fungsi baru Anda. Untuk informasi selengkapnya tentang kunci dan otorisasi, lihat Kunci otorisasi dan pengikatan HTTP dan webhook.

   

   Sedang dalam proses

   Penting

   Dukungan akan berakhir untuk model dalam proses pada 10 November 2026. Kami sangat menyarankan Agar Anda memigrasikan aplikasi Anda ke model pekerja yang terisolasi untuk dukungan penuh.

   Pengaturan	Nilai	Deskripsi
   Versi .NET	.NET 6	Nilai ini membuat proyek fungsi yang berjalan dalam proses dengan versi 4.x runtime Azure Functions. Untuk informasi selengkapnya, lihat Ringkasan versi runtime Azure Functions.
   Templat fungsi	Pemicu HTTP	Nilai ini membuat fungsi yang dipicu oleh permintaan HTTP.
   Akun penyimpanan (AzureWebJobsStorage)	Emulator Storage	Karena aplikasi fungsi di Azure memerlukan akun penyimpanan, aplikasi ditetapkan atau dibuat saat Anda memublikasikan proyek Anda ke Azure. Pemicu HTTP tidak menggunakan string koneksi akun Azure Storage; semua jenis pemicu lainnya memerlukan string koneksi akun Azure Storage yang valid.
   Tingkat otorisasi	Anonim	Fungsi yang dibuat dapat dipicu oleh klien mana pun tanpa menyediakan kunci. Pengaturan otorisasi ini memudahkan Anda menguji fungsi baru Anda. Untuk informasi selengkapnya tentang kunci dan otorisasi, lihat Kunci otorisasi dan pengikatan HTTP dan webhook.

   

   Pastikan Anda mengatur Tingkat otorisasi ke Anonim. Ketika Anda memilih tingkat default Fungsi, Anda diharuskan untuk memberikan kunci fungsi dalam permintaan untuk mengakses titik akhir fungsi Anda.

5. Pilih Buat untuk membuat proyek fungsi dan fungsi pemicu HTTP.

Tersambung ke Penyimpanan App Configuration

Proyek ini akan menggunakan injeksi dependensi di .NET Azure Functions dan menambahkan Azure App Configuration sebagai sumber data konfigurasi tambahan. Azure Functions mendukung operasi dalam-proses atau proses-terisolasi. Pilih salah satu yang sesuai dengan persyaratan Anda.

1. Klik kanan proyek Anda dan pilih Kelola Paket NuGet. Pada tab Telusuri, cari dan tambahkan paket NuGet berikut ke proyek Anda.

   Sedang dalam proses

   • Microsoft.Extensions.Configuration. AzureAppConfiguration versi 4.1.0 atau yang lebih baru
   • Microsoft.Azure.Functions.Extensions versi 1.1.0 atau yang lebih baru

   Proses terisolasi

   • Microsoft.Azure.AppConfiguration.Functions.Worker

2. Tambahkan kode untuk membuat sambungan ke Azure App Configuration.

   Sedang dalam proses

   Tambahkan file baru, Startup.cs, dengan kode berikut. Ini mendefinisikan kelas bernama Startup yang mengimplementasikan FunctionsStartup kelas abstrak. Atribut rakitan digunakan untuk menentukan nama jenis yang digunakan selama startup Azure Functions.

   Metode ConfigureAppConfiguration ini diganti dan penyedia Azure App Configuration ditambahkan sebagai sumber data konfigurasi tambahan dengan panggilanAddAzureAppConfiguration(). Metode Configure ini dibiarkan kosong karena Anda tidak perlu mendaftarkan layanan apa pun pada saat ini.

   using System;
   using Microsoft.Azure.Functions.Extensions.DependencyInjection;
   using Microsoft.Extensions.Configuration;
   
   [assembly: FunctionsStartup(typeof(FunctionApp.Startup))]
   
   namespace FunctionApp
   {
       class Startup : FunctionsStartup
       {
           public override void ConfigureAppConfiguration(IFunctionsConfigurationBuilder builder)
           {
               string cs = Environment.GetEnvironmentVariable("ConnectionString");
               builder.ConfigurationBuilder.AddAzureAppConfiguration(cs);
           }
   
           public override void Configure(IFunctionsHostBuilder builder)
           {
           }
       }
   }
   

   Proses terisolasi

   Buka Program.cs dan perbarui metode Main() sebagai berikut. Anda menambahkan penyedia Azure App Configuration sebagai sumber konfigurasi tambahan dengan memanggil AddAzureAppConfiguration().

   public static void Main()
   {
       var host = new HostBuilder()
           .ConfigureAppConfiguration(builder =>
           {
               string cs = Environment.GetEnvironmentVariable("ConnectionString");
               builder.AddAzureAppConfiguration(cs);
           })
           .ConfigureFunctionsWorkerDefaults()
           .Build();
   
       host.Run();
   }
   

3. Buka Function1.cs, dan tambahkan namespace layanan berikut jika belum ada.

   using Microsoft.Extensions.Configuration;
   

   Menambahkan atau memperbarui konstruktor yang digunakan untuk mendapatkan instans IConfiguration melalui injeksi dependensi.

   Sedang dalam proses

   private readonly IConfiguration _configuration;
   
   public Function1(IConfiguration configuration)
   {
       _configuration = configuration;
   }
   

   Proses terisolasi

   private readonly IConfiguration _configuration;
   
   public Function1(ILoggerFactory loggerFactory, IConfiguration configuration)
   {
       _logger = loggerFactory.CreateLogger<Function1>();
       _configuration = configuration;
   }
   

4. Perbarui Run metode untuk membaca nilai dari konfigurasi.

   Sedang dalam proses

   [FunctionName("Function1")]
   public async Task<IActionResult> Run(
       [HttpTrigger(AuthorizationLevel.Anonymous, "get", "post", Route = null)] HttpRequest req, ILogger log)
   {
       log.LogInformation("C# HTTP trigger function processed a request.");
   
       // Read configuration data
       string keyName = "TestApp:Settings:Message";
       string message = _configuration[keyName];
   
       return message != null
           ? (ActionResult)new OkObjectResult(message)
           : new BadRequestObjectResult($"Please create a key-value with the key '{keyName}' in App Configuration.");
   }
   

   Catatan

   Function1Kelas dan Run metode ini tidak harus statis. Hapusstatic pengubah jika ia diregenerasi secara otomatis.

   Proses terisolasi

   [Function("Function1")]
   public HttpResponseData Run([HttpTrigger(AuthorizationLevel.Anonymous, "get", "post")] HttpRequestData req)
   {
       _logger.LogInformation("C# HTTP trigger function processed a request.");
   
       var response = req.CreateResponse(HttpStatusCode.OK);
       response.Headers.Add("Content-Type", "text/plain; charset=utf-8");
   
       // Read configuration data
       string keyName = "TestApp:Settings:Message";
       string message = _configuration[keyName];
   
       response.WriteString(message ?? $"Please create a key-value with the key '{keyName}' in Azure App Configuration.");
   
       return response;
   }
   

Uji fungsi secara lokal

1. Set variabel lingkungan bernama ConnectionString, dan set ke kunci akses ke simpan Azure App Configuration Anda. Jika Anda menggunakan perintah Windows, jalankan perintah berikut dan hidupkan ulang perintah untuk memungkinkan perubahan berlaku:

       setx ConnectionString "connection-string-of-your-app-configuration-store"
   

   Jika Anda menggunakan PowerShell Windows, jalankan perintah berikut:

       $Env:ConnectionString = "connection-string-of-your-app-configuration-store"
   

   Jika Anda menggunakan macOS atau Linux, jalankan perintah berikut:

       export ConnectionString='connection-string-of-your-app-configuration-store'
   

2. Tekan F5 untuk menguji fungsi. Jika diminta, terima permintaan dari Visual Studio untuk mengunduh dan memasang alat Utama Azure Functions (CLI). Anda mungkin perlu mengaktifkan pengecualian firewall agar alat dapat menangani permintaan HTTP.

3. Salin URL fungsi Anda dari output runtime Azure Functions.

   

4. Tempelkan URL untuk permintaan HTTP ke bar alamat browser Anda. Gambar berikut menampilkan respons di browser ke permintaan GET lokal yang dikembalikan oleh fungsi.

   

Membersihkan sumber daya

Jika Anda tidak ingin terus menggunakan sumber daya yang dibuat dalam artikel ini, hapus grup sumber daya yang Anda buat di sini untuk menghindari biaya.

Penting

Penghapusan grup sumber daya tidak bisa dipulihkan. Grup sumber daya dan semua sumber daya yang ada di dalamnya akan dihapus secara permanen. Pastikan Anda tidak menghapus grup atau sumber daya yang salah secara tidak sengaja. Jika Anda membuat sumber daya untuk artikel ini dalam grup sumber daya yang ada yang berisi sumber daya lain yang ingin disimpan, hapus setiap sumber daya satu per satu dari panelnya masing-masing, bukan menghapus grup sumber daya.

1. Masuk ke portal Azure, lalu pilih Grup sumber daya.
2. Dalam kotak Filter menurut nama, masukkan nama grup sumber daya Anda.
3. Dalam daftar hasil, pilih nama grup sumber daya untuk melihat gambaran umum.
4. Pilih Hapus grup sumber daya.
5. Anda akan diminta untuk mengonfirmasi penghapusan grup sumber daya. Masukkan nama grup sumber daya Anda untuk mengonfirmasi, dan pilih Hapus.

Setelah beberapa saat, grup sumber daya dan semua sumber dayanya akan dihapus.

Langkah berikutnya

Dalam panduan mulai cepat ini, Anda membuat simpan Azure App Configuration baru dan menggunakannya dengan aplikasi Azure Functions melalui penyedia Azure App Configuration. Untuk mempelajari cara memperbarui aplikasi Azure Functions Anda untuk menyegarkan konfigurasi secara dinamis, lanjutkan ke tutorial berikutnya.

Aktifkan konfigurasi dinamis di Azure Functions

Untuk mempelajari cara menggunakan identitas terkelola Azure guna menyederhanakan akses ke App Configuration, lanjut ke tutorial berikutnya.

Mengakses App Configuration menggunakan identitas terkelola