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

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 cache

Selanjutnya, Anda membuat cache untuk aplikasi.

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

    Create a resource is highlighted in the left navigation pane.

  2. Di halaman Baru, pilih Database, lalu pilih Azure Cache for Redis.

    On New, Databases is highlighted, and Azure Cache for Redis is highlighted.

  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 .

    Screenshot showing the Advanced tab in the working pane and the available option to select.

    • 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.

    Azure Cache for Redis keys

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

    Azure Cache for Redis properties

Untuk mengedit file CacheSecrets.config

  1. Buat file di komputer Anda bernama CacheSecrets.config dan letakkan di lokasi tempat file tersebut tidak akan diperiksa dengan kode sumber aplikasi sampel Anda. Untuk mulai cepat ini, file CacheSecrets.config terletak di C:\AppSecrets\CacheSecrets.config.

  2. Untuk mengedit fileCacheSecrets.config. Kemudian tambahkan konten berikut:

    <appSettings>
        <add key="CacheConnection" value="<cache-name>.redis.cache.windows.net,abortConnect=false,ssl=true,allowAdmin=true,password=<access-key>"/>
    </appSettings>
    
  3. Ganti <cache-name> dengan nama host cache Anda.

  4. Ganti <access-key> dengan kunci primer untuk cache Anda.

    Tip

    Anda dapat menggunakan kunci akses sekunder selama rotasi kunci sebagai kunci alternatif saat Anda meregenerasi kunci akses utama.

  5. Simpan file.

Memperbarui aplikasi MVC

Di bagian ini, Anda dapat melihat aplikasi MVC yang menghadirkan tampilan yang menampilkan pengujian sederhana terhadap Azure Cache for Redis.

Cara file web.config tersambung ke cache

Saat Anda menjalankan aplikasi secara lokal, informasi di CacheSecrets.config digunakan untuk menyambungkan ke instans Azure Cache for Redis Anda. Nantinya, Anda dapat menyebarkan aplikasi ini ke Azure. Pada saat itu, Anda mengonfigurasi pengaturan aplikasi di Azure yang digunakan aplikasi untuk mengambil informasi koneksi cache alih-alih file ini.

Karena file CacheSecrets.config tidak digunakan ke Azure dengan aplikasi Anda, Anda hanya menggunakannya saat menguji aplikasi secara lokal. Jaga informasi ini seaman mungkin untuk mencegah akses berbahaya ke data cache Anda.

Untuk memperbarui file web.config

  1. Di Penjelajah Solusi, buka file web.config.

    Web.config

  2. Dalam file web.config, Anda dapat mengatur <appSettings> elemen untuk menjalankan aplikasi secara lokal.

    <appSettings file="C:\AppSecrets\CacheSecrets.config">

ASP.NET waktu proses menggabungkan konten file eksternal dengan markup dalam elemen <appSettings>. Runtime mengabaikan atribut file jika file yang ditentukan tidak dapat ditemukan. Rahasia Anda (string koneksi ke cache Anda) tidak disertakan sebagai bagian dari kode sumber untuk aplikasi. Saat Anda menggunakan aplikasi web ke Azure, file CacheSecrets.config tidak digunakan.

Menginstal StackExchange.Redis

Solusi Anda memerlukan StackExchange.Redis paket untuk dijalankan. Instal, dengan prosedur ini:

  1. Untuk mengonfigurasi aplikasi agar menggunakan paket NuGet StackExchange.Redis untuk Visual Studio, pilih Tools > NuGet Package Manager > Package Manager Console.

  2. Jalankan perintah berikut dari Package Manager Console jendela:

    Install-Package StackExchange.Redis
    
  3. Paket NuGet mengunduh dan menambahkan referensi perakitan yang diperlukan untuk aplikasi klien Anda untuk mengakses Azure Cache for Redis dengan klien StackExchange.Redis.

Koneksi ke cache dengan RedisConnection

Koneksi ke cache Anda dikelola oleh kelas RedisConnection. Koneksi pertama kali dibuat dalam pernyataan ini dari ContosoTeamStats/Controllers/HomeController.cs:

   private static Task<RedisConnection> _redisConnectionFactory = RedisConnection.InitializeAsync(connectionString: ConfigurationManager.AppSettings["CacheConnection"].ToString()););

Nilai rahasia CacheConnection diakses menggunakan penyedia konfigurasi Pengelola Rahasia dan digunakan sebagai parameter kata sandi.

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. Di Solution Explorer, perluas folder Views>Shared. Lalu buka file _Layout.cshtml.

  2. Anda melihat garis berikut di <div class="navbar-header">.

    @Html.ActionLink("Azure Cache for Redis Test", "RedisCache", "Home", new { area = "" }, new { @class = "navbar-brand" })
    

    screenshot of welcome page

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

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.

    Screenshot of simple test completed local

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.

    Publish

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

    Publish to 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 diterapkan 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.

    App Service dialog box

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

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

    Publishing output

Menambahkan pengaturan aplikasi untuk cache

Setelah aplikasi baru dipublikasikan, tambahkan setelan aplikasi baru. Setelan ini digunakan untuk menyimpan informasi sambungan khazanah.

Untuk menambahkan pengaturan aplikasi

  1. Ketik nama aplikasi di bilah pencarian di bagian atas portal Azure untuk menemukan aplikasi baru yang Anda buat.

    Find app

  2. Tambahkan pengaturan aplikasi baru bernama CacheConnection untuk aplikasi yang digunakan untuk menyambungkan ke cache. Gunakan nilai yang sama dengan yang Anda konfigurasi CacheConnection dalam fileCacheSecrets.config Anda. Nilai berisi nama host cache dan kunci akses.

    Add app setting

Menjalankan aplikasi di Azure

  1. Di browser Anda, buka URL untuk aplikasi. URL muncul di hasil operasi penerbitan di jendela output Visual Studio. Ini juga disediakan di portal Azure pada halaman ikhtisar 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 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.

    Delete

  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