Hızlı Başlangıç: Redis için Azure Cache hizmetini ASP.NET Core web uygulamasıyla kullanma

Makale
04/29/2024

Bu hızlı başlangıçta, önbellekteki verileri depolamak ve almak için Redis için Azure Cache bağlanan bir ASP.NET Core web uygulamasına Redis için Azure Cache ekleyeceksiniz.

.NET core'da önbelleğe alma sağlayıcıları da vardır. Redis'i mevcut kodunuzda en az değişiklikle hızlı bir şekilde kullanmaya başlamak için bkz:

GitHub'da depoyu https://github.com/Azure-Samples/azure-cache-redis-samples/tree/main/quickstart/aspnet-core kopyalayın.

Bir sonraki adım olarak, ASP.NET çekirdek önbelleğe alma sağlayıcılarını gösteren bir gerçek dünya senaryosu eShop uygulaması görebilirsiniz: Redis önbelleğe alma sağlayıcılarını kullanan ASP.NET çekirdek eShop.

Dahil edilen özellikler:

Redis Dağıtılmış Önbelleğe Alma
Redis oturum durumu sağlayıcısı

Dağıtım yönergeleri README.md.

Önkoşullar

Azure aboneliği - ücretsiz bir abonelik oluşturun
.NET Core SDK

Önbellek oluşturma

Önbellek oluşturmak için Azure portalında oturum açın ve Kaynak oluştur'u seçin.
Yeni sayfasında Veritabanları'nı ve ardından Redis için Azure Cache'ı seçin.

Yeni Redis Önbelleği sayfasında, yeni önbelleğinizin ayarlarını yapılandırın.

Ayar	Bir değer seçin	Açıklama
Abonelik	Açılan menüye gidin ve aboneliğinizi seçin.	Bu yeni Redis için Azure Cache örneğinin oluşturulacağı abonelik.
Kaynak grubu	Açılan menüden bir kaynak grubu seçin veya Yeni oluştur'u seçip yeni bir kaynak grubu adı girin.	Önbelleğinizi ve diğer kaynakları oluşturacağınız kaynak grubunun adı. Tüm uygulama kaynaklarınızı tek bir kaynak grubuna yerleştirerek bunları kolayca yönetebilir veya silebilirsiniz.
DNS adı	Benzersiz bir ad girin.	Önbellek adı yalnızca sayı, harf veya kısa çizgi içeren 1 ile 63 karakter arasında bir dize olmalıdır. Adın bir sayı veya harfle başlayıp bitmesi gerekir ve ardışık kısa çizgi içeremez. Önbellek örneğinizin ana bilgisayar adı< DNS adı.redis.cache.windows.net.>
Konum	Açılan menüye gidin ve bir konum seçin.	Önbelleğinizi kullanan diğer hizmetlerin yakınında bir bölge seçin.
Önbellek türü	Açılan menüye gidin ve bir katman seçin.	Katman, önbellek için kullanılabilen boyutu, performansı ve özellikleri belirler. Daha fazla bilgi için bkz. Redis için Azure Cache Genel Bakış.

Ağ sekmesini seçin veya sayfanın en altındaki Ağ düğmesini seçin.
Ağ sekmesinde bağlantı yönteminizi seçin.
İleri: Gelişmiş sekmesini seçin veya Gelişmiş sekmesini görmek için sayfanın alt kısmındaki İleri: Gelişmiş düğmesini seçin.
- Temel veya Standart önbellekler için TLS olmayan bir bağlantı noktası için seçimi değiştirin. Microsoft Entra Authentication'ı etkinleştirmek isteyip istemediğinizi de seçebilirsiniz.
- Premium önbellek için TLS olmayan bağlantı noktası, kümeleme, yönetilen kimlik ve veri kalıcılığı ayarlarını yapılandırın. Microsoft Entra Authentication'ı etkinleştirmek isteyip istemediğinizi de seçebilirsiniz.
Sonraki: Etiketler sekmesini seçin veya sayfanın en altındaki İleri: Etiketler düğmesini seçin.
İsteğe bağlı olarak, kaynağı kategorilere ayırmak istiyorsanız Etiketler sekmesinde adı ve değeri girin.
Gözden geçir ve oluştur’u seçin. Azure'ın yapılandırmanızı doğruladığı Gözden Geçir ve oluştur sekmesine yönlendirilirsiniz.
Yeşil Doğrulama başarılı iletisi görüntülendiğinde Oluştur'u seçin.

Önbelleğin oluşturulması biraz zaman alır. İlerleme durumunu Redis için Azure Cache Genel Bakış sayfasından izleyebilirsiniz. Durum Çalışıyor olarak gösterildiğinde önbellek kullanıma hazırdır.

Azure portalından konak adını, bağlantı noktalarını ve erişim anahtarlarını alma

Redis için Azure Cache sunucunuzu bağlamak için önbellek istemcisinin ana bilgisayar adına, bağlantı noktalarına ve önbellek anahtarına ihtiyacı vardır. Bazı istemciler bu öğelere biraz daha farklı adlarla başvurabilir. Konak adını, bağlantı noktalarını ve anahtarları Azure portalından alabilirsiniz.

Erişim anahtarlarını almak için Kaynak menüsünden Kimlik Doğrulaması'nı seçin. Ardından Erişim tuşları sekmesini seçin.
Önbelleğinizin ana bilgisayar adını ve bağlantı noktalarını almak için Kaynak menüsünden Genel Bakış'ı seçin. Ana bilgisayar adı DNS name.redis.cache.windows.net biçimindedir<.>

ANA BİLGİSAYAR ADI ve Birincil erişim anahtarı bilgilerini not edin. Bu değerleri daha sonra Cache Bağlan ion gizli dizisini oluşturmak için kullanırsınız.

bağlantı dizesi için yerel gizli dizi ekleme

Önbellek adınız ve birincil erişim anahtarınız için köşeli ayraçlar da dahil olmak üzere yer tutucuları değiştirdikten sonra, komut pencerenizde Cache Bağlan ion adlı yeni bir gizli diziyi depolamak için aşağıdaki komutu yürütebilirsiniz:

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

Redis Bağlan ion ile önbelleğe Bağlan

RedisConnection sınıfı önbelleğinize bağlantıyı yönetir. Bağlantı, Controllers klasöründeki şu deyimde HomeController.cs yapılır:

_redisConnection = await _redisConnectionFactory;

içinde RedisConnection.csad alanının StackExchange.Redis koda eklendiğini görürsünüz. Bu, sınıf için RedisConnection gereklidir.

using StackExchange.Redis;

Kod, RedisConnection örneğini uygulamasından StackExchange.Redisyöneterek ConnectionMultiplexer önbellekle her zaman iyi durumda bir bağlantı olmasını sağlar. Sınıfı, RedisConnection bağlantı kesildiğinde ve otomatik olarak yeniden bağlanamadığında bağlantıyı yeniden oluşturur.

Daha fazla bilgi için bkz . StackExchange.Redis ve GitHub deposundaki kod.

Örnekteki düzen görünümleri

Bu örneğin giriş sayfası düzeni _Layout.cshtml dosyasında depolanır. Bu sayfadan, bu sayfadan Redis için Azure Cache Test'e tıklayarak gerçek önbellek testini başlatırsınız.

Views\Shared\_Layout.cshtml dosyasını açın.

içinde <div class="navbar-header">görmeniz gerekir:

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

karşılama sayfasının ekran görüntüsü

Önbellekteki verileri gösterme

Örnek çıktıyı görmek için giriş sayfasında test Redis için Azure Cache seçeneğini belirleyin.

Çözüm Gezgini’nde Görünümler klasörünü genişletin ve Giriş klasörüne sağ tıklayın.

Bu kodu RedisCache.cshtml dosyasında görmeniz gerekir.

@{
    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>

Uygulamayı yerel olarak çalıştırma

Uygulamayı derlemek için komut pencerenizde aşağıdaki komutu yürütün:
```
dotnet build
```
Ardından aşağıdaki komutla uygulamayı çalıştırın:
```
dotnet run
```
https://localhost:5001 Web tarayıcınızda adresine gidin.
Önbellek erişimini test etmek için web sayfasının gezinti çubuğunda Redis için Azure Cache Test et'i seçin.

Yerel olarak tamamlanan basit testin ekran görüntüsü

Kaynakları temizleme

Bu makalede oluşturduğunuz kaynakları kullanmaya devam etmek istiyorsanız kaynak grubunu koruyun.

Aksi takdirde, kaynaklarla işiniz bittiyse ücretlerden kaçınmak için oluşturduğunuz Azure kaynak grubunu silebilirsiniz.

Önemli

Silinen kaynak grupları geri alınamaz. Kaynak grubunu sildiğinizde, içindeki tüm kaynaklar kalıcı olarak silinir. Yanlış kaynak grubunu veya kaynakları yanlışlıkla silmediğinizden emin olun. Tutmak istediğiniz kaynakları içeren mevcut bir kaynak grubunun içinde kaynakları oluşturduysanız, kaynak grubunu silmek yerine her kaynağı tek tek silebilirsiniz.

Kaynak grubunu silmek için

Azure portalında oturum açın ve Kaynak grupları’nı seçin.
Silmek istediğiniz kaynak grubunu seçin.

Çok sayıda kaynak grubu varsa Herhangi bir alan için filtre uygula... kutusunu kullanın, bu makale için oluşturduğunuz kaynak grubunuzun adını yazın. Sonuçlar listesinden kaynak grubunu seçin.
Kaynak grubunu sil'i seçin.
Kaynak grubunun silinmesini onaylamanız istenir. Onaylamak için kaynak grubunuzun adını yazın ve ardından Sil’i seçin.

Birkaç dakika sonra kaynak grubu ve bu gruptaki kaynakların tümü silinir.