Bagikan melalui

Mulai cepat: Menggunakan Azure Redis dengan aplikasi web ASP.NET

  • Artikel

Dalam quickstart ini, Anda menggunakan Visual Studio 2019 untuk membuat aplikasi web ASP.NET yang terhubung ke Azure Cache for Redis untuk menyimpan dan mengambil data dari cache. Anda kemudian menerapkan aplikasi ke Azure App Service.

Langsung ke kode pada GitHub

Kloning repositori https://github.com/Azure-Samples/azure-cache-redis-samples/tree/main/quickstart/aspnet di GitHub.

Prasyarat

Membuat instans Azure Managed Redis (pratinjau)

  1. Untuk membuat instans Azure Managed Redis (pratinjau), masuk ke portal Azure dan pilih Buat sumber daya.

  2. Pada halaman Baru , di kotak pencarian ketik Azure Cache for Redis.

  3. Pada halaman Cache Redis Baru, konfigurasikan pengaturan untuk cache baru Anda.

    Pengaturan Pilih nilai Deskripsi
    Langganan Buka menu drop-down dan pilih langganan Anda. Langganan untuk membuat instans Azure Managed Redis baru ini.
    Grup sumber daya Buka drop down dan pilih grup sumber daya, atau pilih Buat baru dan masukkan nama grup sumber daya baru. Nama untuk grup sumber daya tempat membuat cache dan sumber daya lainnya. Dengan menyatukan semua sumber daya aplikasi dalam satu grup sumber daya, Anda dapat dengan mudah mengelola atau menghapusnya sekaligus.
    Nama DNS Masukkan nama yang unik di wilayah ini. Nama cache harus berupa string antara 1 dan 63 karakter jika dikombinasikan dengan nama wilayah cache yang hanya berisi angka, huruf, atau tanda hubung. (Jika nama cache kurang dari 45 karakter, panjangnya harus berfungsi di semua wilayah yang saat ini tersedia.) Nama harus dimulai dan diakhir dengan angka atau huruf, dan tidak boleh berisi tanda hubung berturut-turut. Nama host instans cache Anda adalah \<DNS name\>.\<Azure region\>.redis.azure.net.
    Location Buka drop down dan pilih lokasi. Azure Managed Redis tersedia di wilayah Azure yang dipilih.
    Jenis cache Turun bawah dan pilih tingkat performa dan ukuran cache. Tingkat menentukan performa instans Redis, sementara ukuran cache menentukan memori yang tersedia untuk menyimpan data. Untuk panduan tentang memilih tingkat performa yang tepat, lihat Memilih tingkat yang tepat

    Cuplikan layar memperlihatkan tab Dasar-Dasar Azure Managed Redis.

  4. Pilih Berikutnya: Jaringan dan pilih titik akhir publik atau privat.

  5. Pilih Berikutnya: Tingkat Lanjut.

    Konfigurasikan modul Redis apa pun yang Ingin Anda tambahkan ke instans.

    Secara default, untuk cache terkelola baru:

    • ID Microsoft Entra diaktifkan.
    • Autentikasi Kunci Akses dinonaktifkan karena alasan keamanan.

    Penting

    Untuk keamanan yang optimal, kami sarankan Anda menggunakan ID Microsoft Entra dengan identitas terkelola untuk mengotorisasi permintaan terhadap cache Anda jika memungkinkan. Otorisasi dengan menggunakan ID Microsoft Entra dan identitas terkelola memberikan keamanan yang unggul dan kemudahan penggunaan melalui otorisasi kunci akses bersama. Untuk informasi selengkapnya tentang menggunakan identitas terkelola dengan cache Anda, lihat Menggunakan ID Microsoft Entra untuk autentikasi cache.

    Atur kebijakan Pengklusteran ke Enterprise untuk cache non-kluster, atau ke OSS untuk cache berkluster. Untuk informasi selengkapnya tentang memilih kebijakan Pengklusteran, lihat Kebijakan kluster.

    Cuplikan layar yang memperlihatkan tab Tingkat Lanjut Azure Managed Redis.

    Jika Anda menggunakan Replikasi geografis aktif, replikasi tersebut harus dikonfigurasi selama pembuatan. Untuk informasi selengkapnya, lihat Mengonfigurasi replikasi geografis aktif untuk instans Azure Managed Redis.

    Penting

    Anda tidak dapat mengubah kebijakan pengklusteran instans Azure Managed Redis (pratinjau) setelah Anda membuatnya. Jika Anda menggunakan RediSearch, kebijakan kluster Enterprise diperlukan, dan NoEviction merupakan satu-satunya kebijakan pengeluaran yang didukung.

    Penting

    Jika Anda menggunakan instans cache ini dalam grup replikasi geografis, kebijakan pengeluaran tidak dapat diubah setelah instans dibuat. Pastikan untuk mengetahui kebijakan pengeluaran simpul utama Anda sebelum Membuat cache. Untuk informasi selengkapnya tentang replikasi geografis aktif, lihat Prasyarat replikasi geografis aktif.

    Penting

    Anda tidak dapat mengubah modul setelah membuat instans cache. Modul harus diaktifkan ketika Anda membuat instans Azure Cache for Redis. Tidak ada opsi untuk mengaktifkan konfigurasi modul setelah Anda membuat cache.

  6. Pilih Berikutnya: Tag dan lewati.

  7. Pilih Berikutnya: Tinjau + buat.

  8. Tinjau pengaturan akhir, dan pilih Buat.

    Dibutuhkan beberapa menit untuk membuat instans Redis. Anda dapat memantau kemajuan di halaman Gambaran Umum Azure Managed Redis. Ketika Status muncul sebagai Sedang Berjalan, cache siap digunakan.

Membuat instans Azure Cache for Redis

  1. Untuk membuat cache, masuk ke portal Azure. Pada menu portal, pilih Buat sumber daya.

    Sceenshot yang memperlihatkan opsi Buat sumber daya disorot di panel navigasi kiri di portal Azure.

  2. Pada panel Memulai , masukkan Azure Cache for Redis di bilah pencarian. Di hasil pencarian, temukan Azure Cache for Redis, lalu pilih Buat.

    Cuplikan layar yang memperlihatkan Marketplace Azure dengan Azure Cache for Redis di kotak pencarian, dan tombol Buat disorot.

  3. Pada panel Singgahan Redis Baru, pada tab Dasar , konfigurasikan pengaturan berikut untuk cache Anda:

    Pengaturan Tindakan Deskripsi
    Langganan Pilih langganan Azure Anda. Langganan yang digunakan untuk membuat instans baru Azure Cache for Redis.
    Grup sumber daya Pilih grup sumber daya, atau pilih Buat baru dan masukkan nama grup sumber daya baru. Nama untuk grup sumber daya untuk membuat cache dan sumber daya lainnya. Dengan menyatukan semua sumber daya aplikasi dalam satu grup sumber daya, Anda dapat dengan mudah mengelola atau menghapusnya sekaligus.
    Nama DNS Masukkan nama yang unik. Nama cache harus berupa string 1 hingga 63 karakter yang hanya berisi angka, huruf, dan tanda hubung. Nama harus dimulai dan diakhiri dengan angka atau huruf, dan tidak boleh berisi tanda hubung berturut-turut. Nama host instans cache Anda adalah \<DNS name>.redis.cache.windows.net.
    Location Pilih lokasi. Wilayah Azure yang berada di dekat layanan lain yang menggunakan cache Anda.
    Cache SKU Pilih SKU. SKU menentukan ukuran, performa, dan parameter fitur yang tersedia untuk cache. Untuk informasi selengkapnya, lihat Gambaran Umum Azure Cache for Redis.
    Ukuran cache Pilih ukuran cache. Untuk informasi selengkapnya, lihat Gambaran Umum Azure Cache for Redis.

  4. Pilih tab Jaringan atau pilih Berikutnya: Jaringan.

  5. Pada tab Jaringan , pilih metode konektivitas yang akan digunakan untuk cache.

  6. Pilih tab Tingkat Lanjut atau pilih Berikutnya: Tingkat Lanjut.

  7. Pada panel Tingkat Lanjut , verifikasi atau pilih metode autentikasi berdasarkan informasi berikut:

    Cuplikan layar memperlihatkan panel Tingkat Lanjut dan opsi yang tersedia untuk dipilih.

    • Secara default, untuk cache Dasar, Standar, atau Premium baru, Autentikasi Microsoft Entra diaktifkan dan Autentikasi Kunci Akses dinonaktifkan.
    • Untuk cache Dasar atau Standar, Anda dapat memilih pilihan untuk port non-TLS.
    • Untuk cache Standar dan Premium, Anda dapat memilih untuk mengaktifkan zona ketersediaan. Anda tidak dapat menonaktifkan zona ketersediaan setelah cache dibuat.
    • Untuk cache Premium, konfigurasikan pengaturan untuk port non-TLS, pengklusteran, identitas terkelola, dan persistensi data.

    Penting

    Untuk keamanan yang optimal, kami sarankan Anda menggunakan ID Microsoft Entra dengan identitas terkelola untuk mengotorisasi permintaan terhadap cache Anda jika memungkinkan. Otorisasi dengan menggunakan ID Microsoft Entra dan identitas terkelola memberikan keamanan yang unggul dan kemudahan penggunaan melalui otorisasi kunci akses bersama. Untuk informasi selengkapnya tentang menggunakan identitas terkelola dengan cache Anda, lihat Menggunakan ID Microsoft Entra untuk autentikasi cache.

  8. (Opsional) Pilih tab Tag atau pilih Berikutnya: Tag.

  9. (Opsional) Pada tab Tag , masukkan nama dan nilai tag jika Anda ingin mengategorikan sumber daya cache Anda.

  10. Pilih tombol Tinjau + buat.

    Pada tab Tinjau + buat , Azure secara otomatis memvalidasi konfigurasi Anda.

  11. Setelah pesan hijauLulus validasi muncul, pilih Buat.

Penyebaran cache baru terjadi selama beberapa menit. Anda dapat memantau kemajuan penyebaran di panel Gambaran Umum Azure Cache for Redis. Saat Status ditampilkan Berjalan, cache siap digunakan.

Menggunakan autentikasi ID Microsoft Entra di cache Anda

Cache Azure Redis, kecuali untuk tingkat Enterprise dan Enterprise Flash, mengaktifkan Autentikasi Microsoft Entra secara default. Kunci akses dinonaktifkan secara default.

Penting

Microsoft merekomendasikan penggunaan autentikasi ID Microsoft Entra untuk pengalaman autentikasi yang paling aman alih-alih menggunakan kata sandi atau kunci akses. Autentikasi yang dijelaskan di bagian artikel ini menggunakan kunci akses, yang memerlukan tingkat kepercayaan yang sangat tinggi pada aplikasi dan membawa risiko yang tidak ada saat menggunakan ID Microsoft Entra. Gunakan pendekatan dalam dokumen ini hanya ketika autentikasi ID Microsoft Entra tidak layak.

  1. Di portal Azure, pilih cache tempat Anda ingin menggunakan autentikasi berbasis token Microsoft Entra.

  2. Pilih Autentikasi dari menu Sumber Daya.

  3. Pilih Pilih anggota dan masukkan nama pengguna yang valid. Pengguna yang Anda masukkan secara otomatis diberi Kebijakan Akses Pemilik Data secara default saat Anda memilih Simpan. Anda juga dapat memasukkan identitas terkelola atau perwakilan layanan untuk terhubung ke instans cache Anda.

    Cuplikan layar memperlihatkan autentikasi dipilih di menu sumber daya dan mengaktifkan autentikasi Microsoft Entra diperiksa.

Untuk informasi tentang menggunakan ID Microsoft Entra dengan Azure CLI, lihat halaman referensi untuk identitas.

Menginstal pustaka untuk menggunakan Autentikasi ID Microsoft Entra

Pustaka Azure.StackExchange.Redis berisi Microsoft menggunakan metode autentikasi ID Microsoft Entra untuk menyambungkan ke layanan Azure Redis menggunakan ID Microsoft Entra. Ini berlaku untuk semua Azure Cache for Redis, Azure Cache for Redis Enterprise, dan Azure Managed Redis (Pratinjau).

  1. Membuka proyek Anda di Visual Studio

  2. Klik kanan pada proyek, pilih Kelola Paket NuGet...

  3. Cari Microsoft.Azure.StackExchangeRedis

  4. Klik tombol Instal untuk menginstal

  5. Terima semua konten yang diminta untuk menyelesaikan penginstalan

Menyambungkan ke cache menggunakan ID Microsoft Entra

  1. Sertakan pustaka dalam kode Anda

    using Azure.Identity;
using StackExchange.Redis

  2. Menggunakan kredensial Azure default untuk mengautentikasi koneksi klien. Ini memungkinkan kode Anda untuk menggunakan kredensial pengguna yang masuk saat berjalan secara lokal, dan identitas terkelola Azure saat berjalan di Azure tanpa perubahan kode.

var configurationOptions = await ConfigurationOptions.Parse($"{_redisHostName}").ConfigureForAzureWithTokenCredentialAsync(new DefaultAzureCredential());
ConnectionMultiplexer _newConnection = await ConnectionMultiplexer.ConnectAsync(configurationOptions);
IDatabase Database = _newConnection.GetDatabase();

Untuk mengedit file web.config

  1. Edit file Web.config dengan menambahkan konten berikut:

    <appSettings>
    <add key="RedisHostName" value="<cache-hostname-with-portnumber>"/>
</appSettings>

  2. Ganti <cache-hostname> dengan nama host cache Anda seperti yang muncul di Gambaran Umum pada menu Sumber Daya di portal Azure.

    Misalnya, dengan Azure Managed Redis atau tingkat Enterprise: my-redis.eastus.azure.net:10000

  3. Simpan file.

Untuk informasi selengkapnya, lihat StackExchange.Redis dan kode dalam repositori GitHub.

Untuk mengedit file web.config

  1. Edit file Web.config dengan menambahkan konten berikut:

    <appSettings>
    <add key="RedisHostName" value="<cache-hostname-with-portnumber>"/>
</appSettings>

  2. Ganti <cache-hostname> dengan nama host cache Anda seperti yang muncul di Gambaran Umum pada menu Sumber Daya di portal Azure.

    Misalnya dengan Azure Cache for Redis, my-redis.eastus.azure.net:6380

  3. Simpan file.

Untuk informasi selengkapnya, lihat StackExchange.Redis dan kode dalam repositori GitHub.

Menjalankan aplikasi secara lokal

Secara default, proyek dikonfigurasi untuk meng-host aplikasi secara lokal di IIS Express untuk pengujian dan debugging.

Untuk menjalankan aplikasi secara lokal

  1. Di Visual Studio, pilih Debug>Start Debugging untuk mem-build dan memulai aplikasi secara lokal untuk pengujian dan debugging.

  2. Di browser, pilih Uji Azure Cache for Redis pada bilah navigasi.

  3. Dalam contoh berikut, Message kunci sebelumnya memiliki nilai cache, yang ditetapkan dengan menggunakan konsol Azure Cache for Redis di portal. Aplikasi memperbarui nilai cache tersebut. Aplikasi ini juga menjalankan perintah PING dan CLIENT LIST.

    Cuplikan layar pengujian sederhana selesai secara lokal.

Menerbitkan dan menjalankan di Azure

Setelah berhasil menguji aplikasi secara lokal, Anda dapat menerapkan aplikasi ke Azure dan menjalankannya di cloud.

Untuk memublikasikan aplikasi ke Azure

  1. Di Visual Studio, klik kanan node proyek di Solution Explorer. Lalu, pilih Terbitkan.

    Cuplikan layar memperlihatkan tombol terbitkan.

  2. Pilih Microsoft Azure App Service, pilih Buat Baru,lalu pilih Terbitkan.

    Cuplikan layar memperlihatkan cara menerbitkan ke App Service.

  3. Dalam kotak dialog Buat Layanan Aplikasi, buat perubahan berikut ini:

    Pengaturan Nilai yang direkomendasikan Deskripsi
    Nama aplikasi Gunakan default. Nama aplikasi adalah nama host untuk aplikasi saat disebarkan ke Azure. Nama mungkin memiliki akhiran cap waktu yang ditambahkan ke dalamnya untuk membuatnya unik jika perlu.
    Langganan Pilih langganan Azure Anda. Langganan ini dikenakan biaya hosting terkait. Jika Anda memiliki beberapa langganan Azure, verifikasi bahwa langganan yang Anda inginkan dipilih.
    Grup sumber daya Gunakan grup sumber daya yang sama tempat Anda membuat cache (misalnya, TestResourceGroup). Grup sumber daya membantu Anda mengelola semua sumber daya sebagai grup. Nantinya, saat ingin menghapus aplikasi, Anda cukup menghapus grup.
    Paket App Service Pilih Baru, lalu buat paket Layanan Aplikasi baru bernama TestingPlan.
    Gunakan Lokasi yang sama dengan yang Anda gunakan saat membuat cache.
    Pilih Gratis untuk ukurannya.    		 Paket Layanan Aplikasi menentukan sekumpulan sumber daya komputasi untuk dijalankan oleh aplikasi web.

    Cuplikan layar memperlihatkan kotak dialog App Service.

  4. Setelah Anda mengonfigurasi pengaturan hosting Layanan Aplikasi, pilih Buat.

  5. Pantau jendela Output di Visual Studio untuk melihat status penerbitan. Setelah aplikasi diterbitkan, URL untuk aplikasi dicatat:

    Cuplikan layar informasi penerbitan di panel output.

Menambahkan pengaturan aplikasi untuk cache

Setelah aplikasi baru diterbitkan, tambahkan pengaturan aplikasi baru. Setelan ini digunakan untuk menyimpan informasi sambungan khazanah.

Untuk menambahkan pengaturan aplikasi

  1. Untuk menemukan aplikasi baru yang Anda buat, ketik nama aplikasi di bilah pencarian di bagian atas portal Azure.

    Cuplikan layar memperlihatkan cara menemukan aplikasi di portal Azure.

  2. Tambahkan pengaturan aplikasi baru bernama CacheConnection untuk aplikasi yang digunakan untuk menyambungkan ke cache. Gunakan nilai yang sama dengan yang Anda konfigurasi di RedisHostName file web.config Anda.

Menjalankan aplikasi di Azure

  1. Di browser Anda, buka URL untuk aplikasi. URL muncul di hasil operasi penerbitan di jendela output Visual Studio. URL juga disediakan di portal Azure pada halaman gambaran umum aplikasi yang Anda buat.

  2. Pilih Azure Cache for Redis Uji pada bilah navigasi untuk menguji akses cache seperti yang Anda lakukan dengan versi lokal.

Membersihkan sumber daya

Jika Anda ingin terus menggunakan sumber daya yang Anda buat di artikel ini, simpan grup sumber daya.

Jika tidak, jika Anda sudah selesai dengan sumber daya, Anda dapat menghapus grup sumber daya Azure yang Anda buat untuk menghindari biaya.

Penting

Penghapusan grup sumber daya tidak bisa dipulihkan. Ketika Anda menghapus grup sumber daya, semua sumber daya di dalamnya dihapus secara permanen. Pastikan Anda tidak salah menghapus grup sumber daya atau sumber daya secara tidak sengaja. Jika Anda membuat sumber daya di dalam grup sumber daya yang sudah ada yang berisi sumber daya yang ingin Anda simpan, Anda dapat menghapus setiap sumber daya satu per satu alih-alih menghapus grup sumber daya.

Untuk menghapus grup sumber daya

  1. Masuk ke portal Azure, lalu pilih Grup sumber daya.

  2. Pilih grup sumber daya yang ingin Anda hapus.

    Jika ada banyak grup sumber daya, gunakan kotak Filter untuk bidang apa pun... , ketik nama grup sumber daya yang Anda buat untuk artikel ini. Pilih grup sumber daya dalam daftar hasil.

    Cuplikan layar memperlihatkan daftar grup sumber daya yang akan dihapus di panel kerja.

  3. Pilih Hapus grup sumber daya.

  4. Anda akan diminta untuk mengonfirmasi penghapusan grup sumber daya. Ketik nama grup sumber daya Anda lagi untuk mengonfirmasi, lalu pilih Hapus.

    Cuplikan layar memperlihatkan formulir yang memerlukan nama sumber daya untuk mengonfirmasi penghapusan.

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

Konten terkait