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

Dalam mulai cepat ini, Anda memasukkan Azure Cache for Redis ke aplikasi web ASP.NET Core yang terhubung ke Azure Cache for Redis untuk menyimpan dan mengambil data dari tembolokan.

Langsung ke kode pada GitHub

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

Prasyarat

• Langganan Azure - buat akun secara gratis
• .NET Core SDK

Membuat cache

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

   

2. Di halaman Baru, pilih Database, lalu pilih 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 Cache for 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.	Nama cache harus merupakan untai (karakter) antara 1 dan 63 karakter yang hanya berisi angka, huruf, atau 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	Buka drop down dan pilih lokasi.	Pilih wilayah di dekat layanan lain yang menggunakan cache Anda.
   Jenis cache	Buka menu drop down dan pilih tingkat.	Tingkat menentukan ukuran, performa, dan fitur yang tersedia untuk cache tersebut. Untuk informasi selengkapnya, lihat Gambaran Umum Azure Cache for Redis.

4. Pilih tab Jaringan atau pilih tombol Jaringan di bagian bawah halaman.

5. Di tab Jaringan, pilih metode konektivitas Anda.

6. Pilih tab Berikutnya: Tingkat Lanjut atau pilih tombol Berikutnya: Tingkat Lanjut di bagian bawah halaman untuk melihat tab Tingkat Lanjut .

   

   • Untuk cache Dasar atau Standar, alihkan pilihan untuk port non-TLS. Anda juga dapat memilih apakah Anda ingin mengaktifkan Autentikasi Microsoft Entra.
   • Untuk cache Premium, konfigurasikan pengaturan untuk port non-TLS, pengklusteran, identitas terkelola, dan persistensi data. Anda juga dapat memilih apakah Anda ingin mengaktifkan Autentikasi Microsoft Entra.

7. Pilih tab Berikutnya: Tag atau pilih tombol Berikutnya: Tag di bagian bawah halaman.

8. Secara opsional, di tab Tag, masukkan nama dan nilai jika Anda ingin mengategorikan sumber daya.

9. Pilih Tinjau + buat. Anda dibawa ke tab Tinjau + buat tempat Azure memvalidasi konfigurasi Anda.

10. Setelah pesan lulus Validasi warna hijau muncul, pilih Buat.

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

Mengambil nama host, port, dan kunci akses dari portal Azure

Untuk menyambungkan ke server Azure Cache for Redis Anda, klien cache memerlukan nama host, port, dan kunci untuk cache. Beberapa klien mungkin merujuk ke item ini dengan nama yang sedikit berbeda. Anda bisa mendapatkan nama host, port, dan kunci dari portal Azure.

• Untuk mendapatkan kunci akses, dari navigasi kiri cache, pilih Kunci akses.

  

• Untuk mendapatkan nama host dan port, dari navigasi kiri cache, pilih Properti. Nama host dalam bentuk <nama DNS>.redis.cache.windows.net.

  

Catat NAMA HOST dan kunci akses Utama. Anda akan menggunakan nilai ini nanti untuk membangun rahasia CacheConnection.

Menambahkan rahasia lokal untuk string koneksi

Di jendela perintah Anda, jalankan perintah berikut untuk menyimpan rahasia baru bernama CacheConnection, setelah mengganti tempat penampung, termasuk tanda kurung sudut, untuk nama cache dan kunci akses utama Anda:

dotnet user-secrets set CacheConnection "<cache name>.redis.cache.windows.net,abortConnect=false,ssl=true,allowAdmin=true,password=<primary-access-key>"

Koneksi ke cache dengan RedisConnection

Koneksi ke cache Anda dikelola oleh kelas RedisConnection. Koneksi dibuat dalam pernyataan ini dalam HomeController.cs folder Pengontrol:

_redisConnection = await _redisConnectionFactory;

Di RedisConnection.cs, Anda melihat namespace StackExchange.Redis telah ditambahkan ke kode. Ini diperlukan untuk kelas RedisConnection.

using StackExchange.Redis;

Kode RedisConnection memastikan bahwa selalu ada koneksi yang sehat ke cache dengan mengelola instans ConnectionMultiplexer dari StackExchange.Redis. Kelas RedisConnection membuat ulang koneksi ketika koneksi hilang dan tidak dapat tersambung kembali secara otomatis.

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

Tampilan tata letak dalam sampel

Tata letak halaman beranda untuk sampel ini disimpan dalam file _Layout.cshtml. Dari halaman ini, Anda memulai pengujian cache aktual dengan mengklik Azure Cache for Redis Uji dari halaman ini.

1. Buka Views\Shared\_Layout.cshtml.

2. Anda akan melihat di <div class="navbar-header">:

   <a class="navbar-brand" asp-area="" asp-controller="Home" asp-action="RedisCache">Azure Cache for Redis Test</a>
   

Menampilkan data dari cache

Dari beranda, Anda memilih Uji Azure Cache for Redis untuk melihat output sampel.

1. Di Solution Explorer, perluas folder Views, lalu klik kanan folder Home.

2. Anda akan melihat kode ini di file RedisCache.cshtml.

   @{
       ViewBag.Title = "Azure Cache for Redis Test";
   }
   
   <h2>@ViewBag.Title.</h2>
   <h3>@ViewBag.Message</h3>
   <br /><br />
   <table border="1" cellpadding="10">
       <tr>
           <th>Command</th>
           <th>Result</th>
       </tr>
       <tr>
           <td>@ViewBag.command1</td>
           <td><pre>@ViewBag.command1Result</pre></td>
       </tr>
       <tr>
           <td>@ViewBag.command2</td>
           <td><pre>@ViewBag.command2Result</pre></td>
       </tr>
       <tr>
           <td>@ViewBag.command3</td>
           <td><pre>@ViewBag.command3Result</pre></td>
       </tr>
       <tr>
           <td>@ViewBag.command4</td>
           <td><pre>@ViewBag.command4Result</pre></td>
       </tr>
       <tr>
           <td>@ViewBag.command5</td>
           <td><pre>@ViewBag.command5Result</pre></td>
       </tr>
   </table>
   

Menjalankan aplikasi secara lokal

1. Jalankan perintah berikut di jendela perintah untuk membangun aplikasi:

   dotnet build
   

2. Kemudian jalankan aplikasi dengan perintah berikut:

   dotnet run
   

3. Telusuri https://localhost:5001 di browser web Anda.

4. Pilih Uji Azure Cache for Redis di bilah navigasi halaman web untuk menguji akses tembolokan.

Membersihkan sumber daya

Jika Anda terus menggunakan mulai cepat ini, Anda dapat menyimpan sumber daya yang Anda buat dan menggunakannya kembali.

Atau, jika Anda sudah selesai dengan aplikasi sampel mulai cepat, Anda dapat menghapus sumber daya Azure yang Anda buat dalam mulai cepat ini 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 untuk menghosting sampel ini dalam grup sumber daya yang ada yang berisi sumber daya yang ingin disimpan, Anda dapat menghapus setiap sumber daya satu per satu dari bilahnya, bukan menghapus grup sumber daya.

Untuk menghapus grup sumber daya

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

2. Dalam kotak Filter menurut nama..., ketik nama grup sumber daya Anda. Petunjuk untuk artikel ini menggunakan grup sumber daya bernama TestResources. Pada grup sumber daya Anda, di daftar hasil, pilih ..., lalu pilih Hapus grup sumber daya.

   

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

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

Langkah berikutnya

• Ketahanan koneksi
• Praktik terbaik: Pengembangan