Hızlı Başlangıç: Azure Redis'i ASP.NET web uygulamasıyla kullanma
Bu hızlı başlangıçta, önbelleğe veri depolamak ve önbellekten veri almak için Redis için Azure Cache bağlanan ASP.NET bir web uygulaması oluşturmak için Visual Studio 2019'u kullanacaksınız. Ardından uygulamayı Azure Uygulaması Hizmeti'ne dağıtırsınız.
GitHub'da koda atlayın
GitHub'da depoyu https://github.com/Azure-Samples/azure-cache-redis-samples/tree/main/quickstart/aspnet kopyalayın.
Önkoşullar
- Azure aboneliği - ücretsiz bir abonelik oluşturun
- ASP.NET, web geliştirme ve Azure geliştirme iş yükleriyle Visual Studio 2019.
- StackExchange.Redis istemcisi için .NET Framework 4 veya üzeri gereklidir.
Azure Yönetilen Redis (önizleme) örneği oluşturma
Azure Yönetilen Redis (önizleme) örneği oluşturmak için Azure portalında oturum açın ve Kaynak oluştur'u seçin.
Yeni sayfasında, arama kutusuna Redis için Azure Cache yazın.
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 Azure Yönetilen Redis ö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ı Bölgede benzersiz bir ad girin. Önbellek adı yalnızca sayı, harf veya kısa çizgi içeren önbelleğin bölge adıyla birleştirildiğinde 1 ile 63 karakter arasında bir dize olmalıdır. (Önbellek adı 45 karakterden azsa, kullanılabilir durumdaki tüm bölgelerde çalışmalı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ıdır \<DNS name\>.\<Azure region\>.redis.azure.net.Konum Açılan menüye gidin ve bir konum seçin. Azure Yönetilen Redis, seçili Azure bölgelerinde kullanılabilir. Önbellek türü Açılan menüden performans katmanını ve önbellek boyutunu seçin. Katman Redis örneğinin performansını belirlerken önbellek boyutu verileri depolamak için kullanılabilir belleği belirler. Doğru performans katmanını seçme yönergeleri için bkz . Doğru katmanı seçme 
İleri: Ağ'ı seçin ve genel veya özel bir uç nokta seçin.
İleri: Gelişmiş'i seçin.
Örneğe eklemek istediğiniz tüm Redis modüllerini yapılandırın.
Yeni yönetilen önbellek için varsayılan olarak:
- Microsoft Entra Id etkinleştirildi.
- Erişim Anahtarları Kimlik Doğrulaması güvenlik nedeniyle devre dışı bırakıldı.
Önemli
En iyi güvenlik için, mümkünse istekleri önbelleğinize karşı yetkilendirmek için yönetilen kimliklerle Microsoft Entra Id kullanmanızı öneririz. Microsoft Entra Id ve yönetilen kimlikleri kullanarak yetkilendirme, paylaşılan erişim anahtarı yetkilendirmesi üzerinden üstün güvenlik ve kullanım kolaylığı sağlar. Önbelleğinizle yönetilen kimlikleri kullanma hakkında daha fazla bilgi için bkz . Önbellek kimlik doğrulaması için Microsoft Entra Id kullanma.
Kümeleme ilkesini, kümelenmemiş önbellek için Kurumsal veya kümelenmiş önbellek için OSS olarak ayarlayın. Kümeleme ilkesi seçme hakkında daha fazla bilgi için bkz. Küme ilkesi.
Etkin coğrafi çoğaltma kullanıyorsanız, oluşturma sırasında yapılandırılması gerekir. Daha fazla bilgi için bkz . Azure Yönetilen Redis örnekleri için etkin coğrafi çoğaltmayı yapılandırma.
Önemli
Azure Managed Redis (önizleme) örneğini oluşturduktan sonra kümeleme ilkesini değiştiremezsiniz. RediSearch kullanıyorsanız Kurumsal küme ilkesi gereklidir ve
NoEvictiondesteklenen tek çıkarma ilkesidir.Önemli
Bu önbellek örneğini bir coğrafi çoğaltma grubunda kullanıyorsanız, çıkarma ilkeleri örnek oluşturulduktan sonra değiştirilemez. Önbelleği oluşturmadan önce birincil düğümlerinizin çıkarma ilkelerini bildiğinizden emin olun. Etkin coğrafi çoğaltma hakkında daha fazla bilgi için bkz . Etkin coğrafi çoğaltma önkoşulları.
Önemli
Önbellek örneği oluşturduktan sonra modülleri değiştiremezsiniz. Modüllerin bir Redis için Azure Cache örneği oluşturduğunuzda etkinleştirilmesi gerekir. Önbellek oluşturduktan sonra modülün yapılandırmasını etkinleştirme seçeneği yoktur.
İleri: Etiketler'i seçin ve atlayın.
Sonraki: Gözden geçirme ve oluşturma’yı seçin.
Ayarları gözden geçirin ve Oluştur'u seçin.
Redis örneğinin oluşturulması birkaç dakika sürer. Azure Yönetilen Redis'e Genel Bakış sayfasında ilerleme durumunu izleyebilirsiniz. Durum Çalışıyor olarak gösterildiğinde önbellek kullanıma hazırdır.
Redis için Azure Cache örneği oluşturma
Önbellek oluşturmak için Azure portalında oturum açın. Portal menüsünde Kaynak oluştur'u seçin.
Başlarken bölmesinde, arama çubuğuna Redis için Azure Cache girin. Arama sonuçlarında Redis için Azure Cache bulun ve Oluştur'u seçin.
Yeni Redis Önbelleği bölmesindeki Temel Bilgiler sekmesinde önbelleğiniz için aşağıdaki ayarları yapılandırın:
Ayar Eylem Açıklama Abonelik Azure aboneliği seçin. yeni Redis için Azure Cache örneğini oluşturmak için kullanılacak abonelik. Kaynak grubu Bir kaynak grubu seçin veya Yeni oluştur'u seçip yeni bir kaynak grubu adı girin. Önbelleğinizin ve diğer kaynakların oluşturulacağı 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 ve 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ıdır \<DNS name>.redis.cache.windows.net.Konum Bir konum seçin. Önbelleğinizi kullanan diğer hizmetlere yakın bir Azure bölgesi. Önbellek SKU'su Bir SKU seçin. SKU, önbellek için kullanılabilen boyut, performans ve özellik parametrelerini belirler. Daha fazla bilgi için bkz. Redis için Azure Cache genel bakış. Önbellek boyutu Önbellek boyutu seçin. Daha fazla bilgi için bkz. Redis için Azure Cache genel bakış. Ağ sekmesini seçin veya İleri: Ağ'ı seçin.
Ağ sekmesinde önbellek için kullanılacak bir bağlantı yöntemi seçin.
Gelişmiş sekmesini seçin veya İleri: Gelişmiş'i seçin.
Gelişmiş bölmesinde, aşağıdaki bilgilere göre bir kimlik doğrulama yöntemi doğrulayın veya seçin:
- Varsayılan olarak, yeni bir Temel, Standart veya Premium önbellek için Microsoft Entra Kimlik Doğrulaması etkinleştirilir ve Erişim Anahtarları Kimlik Doğrulaması devre dışı bırakılır.
- Temel veya Standart önbellekler için TLS olmayan bir bağlantı noktası için seçim yapabilirsiniz.
- Standart ve Premium önbellekler için kullanılabilirlik alanlarını etkinleştirmeyi seçebilirsiniz. Önbellek oluşturulduktan sonra kullanılabilirlik alanlarını devre dışı bırakamazsınız.
- 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.
Önemli
En iyi güvenlik için, mümkünse istekleri önbelleğinize karşı yetkilendirmek için yönetilen kimliklerle Microsoft Entra Id kullanmanızı öneririz. Microsoft Entra Id ve yönetilen kimlikleri kullanarak yetkilendirme, paylaşılan erişim anahtarı yetkilendirmesi üzerinden üstün güvenlik ve kullanım kolaylığı sağlar. Önbelleğinizle yönetilen kimlikleri kullanma hakkında daha fazla bilgi için bkz . Önbellek kimlik doğrulaması için Microsoft Entra Id kullanma.
(İsteğe bağlı) Etiketler sekmesini seçin veya İleri: Etiketler'i seçin.
(İsteğe bağlı) Önbellek kaynağınızı kategorilere ayırmak istiyorsanız Etiketler sekmesinde bir etiket adı ve değeri girin.
Gözden geçir + oluştur düğmesini seçin.
Gözden Geçir ve oluştur sekmesinde Azure yapılandırmanızı otomatik olarak doğrular.
Yeşil Doğrulama başarılı iletisi görüntülendiğinde Oluştur'u seçin.
Birkaç dakika içinde yeni bir önbellek dağıtımı gerçekleşir. Dağıtımın ilerleme durumunu Redis için Azure Cache Genel Bakış bölmesinden izleyebilirsiniz. Durum Çalışıyor olarak görüntülendiğinde önbellek kullanıma hazırdır.
Microsoft Entra ID Kimlik Doğrulaması (önerilir)
Önbelleğinizde Microsoft Entra Id kimlik doğrulamayı kullanma
Kurumsal ve Kurumsal Flash katmanları dışında Azure Redis önbelleklerinde Microsoft Entra Authentication varsayılan olarak etkindir. Erişim anahtarları varsayılan olarak devre dışı bırakılır.
Önemli
Microsoft, parolaları veya erişim anahtarlarını kullanmak yerine en güvenli kimlik doğrulama deneyimi için Microsoft Entra Id kimlik doğrulamasının kullanılmasını önerir. Makalenin bu bölümünde açıklanan kimlik doğrulaması, uygulamada çok yüksek düzeyde güven gerektiren ve Microsoft Entra Id kullanılırken mevcut olmayan riskleri taşıyan erişim anahtarlarını kullanır. Bu belgedeki yaklaşımı yalnızca Microsoft Entra Id kimlik doğrulaması uygun olmadığında kullanın.
Azure portalında Microsoft Entra belirteci tabanlı kimlik doğrulamasını kullanmak istediğiniz önbelleği seçin.
Kaynak menüsünden Kimlik Doğrulaması'nı seçin.
Üye seç'i seçin ve geçerli bir kullanıcının adını girin. Kaydet'i seçtiğinizde, girdiğiniz kullanıcıya varsayılan olarak otomatik olarak Veri Sahibi Erişim İlkesi atanır. Önbellek örneğinize bağlanmak için yönetilen kimlik veya hizmet sorumlusu da girebilirsiniz.
Microsoft Entra Id'yi Azure CLI ile kullanma hakkında bilgi için kimlik başvuru sayfalarına bakın.
Microsoft Entra ID Kimlik Doğrulaması'nı kullanmak için kitaplığı yükleme
Azure.StackExchange.Redis kitaplığı, Microsoft Entra ID kullanarak Azure Redis hizmetlerine bağlanmak için Microsoft Entra Id kimlik doğrulama yöntemini kullanan Microsoft'u içerir. Tüm Redis için Azure Cache, Redis için Azure Cache Enterprise ve Azure Yönetilen Redis (Önizleme) için geçerlidir.
Projenizi Visual Studio'da açma
Projeye sağ tıklayın, NuGet Paketlerini Yönet... seçeneğini belirleyin .
Microsoft.Azure.StackExchangeRedisarayın.Yüklemek için Yükle düğmesine tıklayın
Yüklemeyi tamamlamak için tüm istemli içeriği kabul et
Microsoft Entra Id kullanarak önbelleğe bağlanma
Kitaplıkları kodunuza ekleme
using Azure.Identity; using StackExchange.Redisİstemci bağlantısının kimliğini doğrulamak için varsayılan Azure kimlik bilgilerini kullanma. Bu, kodunuzun yerel olarak çalışırken oturum açmış kullanıcı kimlik bilgilerini ve Azure'da kod değişikliği olmadan çalışırken Azure yönetilen kimliğini kullanmasını sağlar.
var configurationOptions = await ConfigurationOptions.Parse($"{_redisHostName}").ConfigureForAzureWithTokenCredentialAsync(new DefaultAzureCredential());
ConnectionMultiplexer _newConnection = await ConnectionMultiplexer.ConnectAsync(configurationOptions);
IDatabase Database = _newConnection.GetDatabase();
Web.config dosyasını düzenlemek için
Aşağıdaki içeriği ekleyerek Web.config dosyasını düzenleyin:
<appSettings> <add key="RedisHostName" value="<cache-hostname-with-portnumber>"/> </appSettings>değerini, Azure portalındaki Kaynak menüsündeki Genel Bakış'ta görünen önbellek ana bilgisayar adınızla değiştirin
<cache-hostname>.Örneğin, Azure Yönetilen Redis veya Kurumsal katmanlarıyla: my-redis.eastus.azure.net:10000
Dosyayı kaydedin.
Daha fazla bilgi için bkz . StackExchange.Redis ve GitHub deposundaki kod.
Web.config dosyasını düzenlemek için
Aşağıdaki içeriği ekleyerek Web.config dosyasını düzenleyin:
<appSettings> <add key="RedisHostName" value="<cache-hostname-with-portnumber>"/> </appSettings>değerini, Azure portalındaki Kaynak menüsündeki Genel Bakış'ta görünen önbellek ana bilgisayar adınızla değiştirin
<cache-hostname>.Örneğin Redis için Azure Cache my-redis.eastus.azure.net:6380
Dosyayı kaydedin.
Daha fazla bilgi için bkz . StackExchange.Redis ve GitHub deposundaki kod.
Uygulamayı yerel olarak çalıştırma
Varsayılan olarak proje, test ve hata ayıklama için uygulamayı IIS Express’te yerel olarak barındırmak üzere yapılandırılır.
Uygulamayı yerel olarak çalıştırmak için
Visual Studio’da Hata Ayıklama>Hata Ayıklamayı Başlat'ı seçerek test ve hata ayıklama için uygulamayı yerel olarak derleyip başlatın.
Tarayıcıda gezinti çubuğunda test Redis için Azure Cache seçin.
Aşağıdaki örnekte, anahtarın önceden portaldaki
MessageRedis için Azure Cache konsolu kullanılarak ayarlanan önbelleğe alınmış bir değeri vardı. Uygulama, önbelleğe alınan bu değeri güncelleştirdi. Ayrıca uygulama,PINGveCLIENT LISTkomutlarını da yürüttü.
Azure’da yayımlama ve çalıştırma
Uygulamayı yerel olarak başarıyla test ettikten sonra Azure’a dağıtabilir ve bulutta çalıştırabilirsiniz.
Uygulamayı Azure’da yayımlamak için
Visual Studio’da, Çözüm Gezgini’ndeki proje düğümüne sağ tıklayın. Ardından Yayımla’yı seçin.
Microsoft Azure App Service’i, sonra Yeni Oluştur'u ve Yayımla’yı seçin.
Uygulama Hizmetini Oluştur iletişim kutusunda aşağıdaki değişiklikleri yapın:
Ayar Önerilen değer Açıklama Uygulama adı Varsayılan değeri kullanın. Uygulama adı, Azure'a dağıtıldığında uygulamanın ana bilgisayar adıdır. Gerekirse adı benzersiz hale getirmek için ada bir zaman damgası soneki eklenebilir. Abonelik Azure aboneliğinizi seçin. Tüm ilgili barındırma maliyetleri bu aboneliğe yansıtılır. Birden çok Azure aboneliğiniz varsa, istediğiniz aboneliğin seçildiğini doğrulayın. Kaynak grubu Önbelleği oluşturduğunuz aynı kaynak grubunu kullanın (örneğin, TestResourceGroup). Kaynak grubu, tüm kaynakları bir grup olarak yönetmenize yardımcı olur. Daha sonra uygulamayı silmek istediğinizde, grubu silmeniz yeterli olacaktır. App Service planı Yeni’yi seçin ve TestingPlan adlı yeni bir App Service planı oluşturun.
Önbelleğinizi oluştururken kullandığınız aynı Konumu kullanın.
Boyut için Serbest’i seçin.App Service planı, bir web uygulamasının birlikte çalıştırılacağı işlem kaynakları kümesini tanımlar. 
App Service barındırma ayarlarını yapılandırdıktan sonra Oluştur'u seçin.
Yayımlama durumunu görmek için Visual Studio’da Çıkış penceresini izleyin. Uygulama yayımlandıktan sonra uygulamanın URL'si günlüğe kaydedilir:
Önbellek için uygulama ayarını ekleme
Yeni uygulama yayımlandıktan sonra yeni bir uygulama ayarı ekleyin. Bu ayar, önbellek bağlantı bilgilerini depolamak için kullanılır.
Uygulama ayarını eklemek için
Oluşturduğunuz yeni uygulamayı bulmak için Azure portalının üst kısmındaki arama çubuğuna uygulama adını yazın.
Önbelleğe bağlanmak için kullanılacak uygulama için CacheConnection adlı yeni bir uygulama ayarı ekleyin. Web.config dosyanızda yapılandırdığınız
RedisHostNamedeğeri kullanın.
Azure’da uygulamayı çalıştırma
Tarayıcınızda, uygulamanın URL'sine gidin. URL, Visual Studio çıkış penceresindeki yayımlama işleminin sonuçlarında gösterilir. URL, oluşturduğunuz uygulamanın genel bakış sayfasında Azure portalında da sağlanır.
Önbellek erişimini yerel sürümde yaptığınız gibi test etmek için gezinti çubuğunda test Redis için Azure Cache seçin.
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.