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 örneği oluştur

1. Azure Yönetilen Redis örneği oluşturmak için Azure portalında oturum açın ve Kaynak oluştur'u seçin.

2. Yeni sayfasında, arama kutusuna Redis için Azure Cache yazın.

3. Yeni Redis Önbelleği sekmesinde, Temel Bilgiler'de yeni önbelleğinizin ayarlarını yapılandırın.

   Ayarlar	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.
   İsim	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ı, \<DNS name\>.\<Azure region\>.redis.azure.net.
   Bölge	Açılan menüden bir konum seçin.	Azure Yönetilen Redis, seçili Azure bölgelerinde kullanılabilir.
   Veri katmanı	Yüksek performans için Bellek içi'yi veya daha düşük performanslı önbellekler için Flash'ı seçin	Bellek içi katmanlar Dengeli, Bellek için İyileştirilmiş ve İşlem için İyileştirilmiş'i içerir. Bellek içi (RAM) ve disk içi (SSD) veri depolamayı kullanmak için Flash katmanını kullanın.
   Önbellek Boyutu	Açılan menüye gidin ve bir boyut seçin.	Önbellek boyutu katmana bağlıdır. En küçük boyut Dengeli katmandır. Bellek içi katmanların en büyüğü, Bellek İyileştirilmiş bir katmandır.
   Performans	Açılan menüye gidin ve bir performans tercihi seçin.	Performans, vCPU sayısına bağlıdır. vCPU sayısı katmana göre değişir. Compute Optimized, en fazla sayıda vCPU'ya sahiptir.

   Doğru performans katmanını seçme hakkında yönergeler için bkz. Doğru katmanı seçme.

   Önemli

   Bellek için İyileştirilmiş M150 ve üzeri dahil olmak üzere 120 GB'ın üzerinde depolama alanı kullanan tüm bellek içi katmanlar Genel Önizleme aşamasındadır; Dengeli B150 ve üzeri; ve İşlem için İyileştirilmiş X150 ve üzeri. Tüm bu katmanlar ve üzeri Genel Önizleme aşamasındadır.

   Flash için İyileştirilmiş tüm katmanlar herkese açık önizleme aşamasındadır.

4. İleri: Ağ'ı seçin ve bir Genel Uç Nokta veya Özel Uç Nokta seçin.

5. İleri: Etkin coğrafi çoğaltma'ya tıklayın. Coğrafi çoğaltmayı etkin kullanmak için, hizmet sağlama sırasında etkinleştirilmesi gerekir. Etkin coğrafi çoğaltma olmayan önbellekler daha sonra etkin coğrafi çoğaltma gruplarına eklenemez veya bu gruplara katılamaz. Daha fazla bilgi için bkz . Azure Yönetilen Redis örnekleri için etkin coğrafi çoğaltmayı yapılandırma.

6. İleri: Gelişmiş sekmesini 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 Önbellek kimlik doğrulaması için Microsoft Entra ID kullanma kısmına bakın.

   Kümeleme ilkesini ayarlayın:

   • RedisSearch veya diğer modülleri kullanmak için Kurumsal'ı kullanma
   • Kümelenmiş önbellek için OSS kullanın.
   • Non-clustered (Önizleme) için kümelenmemiş bir önbellek kullanın.

   Kümeleme ilkesi seçme hakkında daha fazla bilgi için bkz. Küme ilkesi.

   Önemli

   Bir Azure Yönetilen Redis örneğinin kümeleme ilkesini oluşturduktan sonra değiştiremezsiniz. RediSearch kullanıyorsanız Kurumsal küme ilkesi gereklidir ve NoEviction desteklenen 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.

7. İleri: Etiketler'i seçin ve atlayın.

8. Sonraki: Gözden geçirme ve oluşturma’yı seçin.

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

1. Azure portalındaRedis için Azure Cache'i arayın ve seçin.

2. Redis için Azure Cache sayfasındaRedis için Azure Cache> seçin.

3. Yeni Redis Cache sayfasının Temel Bilgiler sekmesinde aşağıdaki ayarları yapılandırın:

   • Abonelik: Kullanmak istediğiniz aboneliği seçin.
   • Kaynak grubu: Bir kaynak grubu seçin veya Yeni oluştur'u seçip yeni bir kaynak grubu adı girin. Tüm uygulama kaynaklarınızı aynı kaynak grubuna yerleştirmek, bunları kolayca yönetmenize veya silmenize olanak tanır.
   • Ad: Bölgede benzersiz bir önbellek adı girin. Adın şu şekilde olması gerekir:
     • 1 ile 63 karakter arası bir dize olmalıdır.
     • Yalnızca sayı, harf ve kısa çizgi içerir.
     • Bir sayı veya harfle başlayıp bitirin.
     • Ardışık kısa çizgi içermez.
   • Bölge: Önbelleğinizi kullanan diğer hizmetlerin yakınında bir Azure bölgesi seçin.
   • Önbellek SKU'su: Önbelleğiniz için kullanılabilir boyutları, performansı ve özellikleri belirlemek için bir SKU seçin.
   • Önbellek boyutu: Önbellek boyutu seçin. Daha fazla bilgi için bkz. Redis için Azure Cache genel bakış.

   

4. Ağ sekmesini seçin veya İleri: Ağ'ı seçin.

5. Ağ Ayarları sekmesinde önbellek için kullanılacak bir bağlantı yöntemi seçin. Güvenlik için Özel Uç Nokta önerilir. Özel Uç Nokta'yı seçerseniz Özel uç nokta ekle'yi seçin ve özel uç noktayı oluşturun.

6. Gelişmiş sekmesini seçin veya İleri: Gelişmiş'i seçin.

7. Gelişmiş bölmesinde aşağıdaki seçenekleri yapılandırın:

   • Microsoft Entra Kimlik Doğrulaması veya Erişim Anahtarları Kimlik Doğrulaması'nı seçin. Microsoft Entra Kimlik Doğrulaması varsayılan olarak etkindir.
   • TLS olmayan bağlantı noktasının etkinleştirilip etkinleştirilmeyeceğini seçin.
   • Premium önbellek için Kullanılabilirlik alanlarını yapılandırabilir veya devre dışı bırakabilirsiniz. Önbellek oluşturulduktan sonra kullanılabilirlik alanlarını devre dışı bırakamazsınız. Standart önbellek için kullanılabilirlik alanları otomatik olarak ayrılır. Kullanılabilirlik bölgeleri, Temel SKU için kullanılamaz.
   • Premium önbellek için Çoğaltma sayısı, Kümeleme ve Parça sayısı, Sistem tarafından atanan yönetilen kimlik ve Veri kalıcılığı ayarlarını yapılandırın.

   Aşağıdaki resimde Standart SKU için Gelişmiş sekmesi gösterilmektedir.

   

   Önemli

   Mümkünse istekleri önbelleğinizde yetkilendirmek için yönetilen kimliklerle Microsoft Entra Id kullanın. Microsoft Entra Kimliğini ve yönetilen kimliği kullanarak yetkilendirme, daha iyi güvenlik sağlar ve paylaşılan erişim anahtarı yetkilendirmesinden daha kolay kullanılır. Önbelleğinizle yönetilen kimlikleri kullanma hakkında daha fazla bilgi için Önbellek kimlik doğrulaması için Microsoft Entra ID kullanma kısmına bakın.

8. İsteğe bağlı olarak , Etiketler sekmesini seçin veya İleri: Etiketler'i seçin ve önbellek kaynaklarınızı kategorilere ayırmak için etiket adlarını ve değerlerini girin.

9. Gözden geçir + oluştur'u seçin ve doğrulama başarılı olduktan sonra Oluştur'u seçin.

Yeni önbellek dağıtımı birkaç dakika sürer. Dağıtım ilerleme durumunu Portal Azure Cache for Redis sayfasından izleyebilirsiniz. Önbellek DurumuÇ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

Azure Yönetilen Redis önbelleklerinde varsayılan olarak Microsoft Entra Kimlik Doğrulaması etkindir.

1. Azure portalında Microsoft Entra belirteci tabanlı kimlik doğrulamasını kullanmak istediğiniz önbelleği seçin.

2. Kaynak menüsünden Kimlik Doğrulaması'nı seçin.

3. Ü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 ilkesi de kullanabilirsiniz.

   

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 Azure Cache for Redis, Azure Cache for Redis Enterprise ve Azure Yönetilen Redis için geçerlidir.

1. Projenizi Visual Studio'da açma

2. Projeye sağ tıklayın, NuGet Paketlerini Yönet... seçeneğini belirleyin .

3. Microsoft.Azure.StackExchangeRedis arayın.

4. Yüklemek için Yükle düğmesine tıklayın

5. Yüklemeyi tamamlamak için tüm istemli içeriği kabul et

Microsoft Entra Id kullanarak önbelleğe bağlanma

1. Kitaplıkları kodunuza ekleme

   using Azure.Identity;
   using StackExchange.Redis
   

2. İ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

1. Aşağıdaki içeriği ekleyerek Web.config dosyasını düzenleyin:

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

2. 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 Managed Redis veya Kurumsal seviyelerle: *my-redis.eastus.azure.net:10000_

3. Dosyayı kaydedin.

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

Web.config dosyasını düzenlemek için

1. Aşağıdaki içeriği ekleyerek Web.config dosyasını düzenleyin:

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

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

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

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

2. Tarayıcıda gezinti çubuğunda test Redis için Azure Cache seçin.

3. Aşağıdaki örnekte, anahtarın önceden portaldaki Message Redis 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, PING ve CLIENT LIST komutları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

1. Visual Studio’da, Çözüm Gezgini’ndeki proje düğümüne sağ tıklayın. Ardından Yayımla’yı seçin.

   

2. Microsoft Azure App Service’i, sonra Yeni Oluştur'u ve Yayımla’yı seçin.

   

3. Uygulama Hizmetini Oluştur iletişim kutusunda aşağıdaki değişiklikleri yapın:

   Ayarlar	Ö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.

   

4. App Service barındırma ayarlarını yapılandırdıktan sonra Oluştur'u seçin.

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

1. Oluşturduğunuz yeni uygulamayı bulmak için Azure portalının üst kısmındaki arama çubuğuna uygulama adını yazın.

   

2. Önbelleğe bağlanmak için kullanılacak uygulama için CacheConnection adlı yeni bir uygulama ayarı ekleyin. Web.configRedisHostNameyapılandırdığınız değeri kullanın.

Azure’da uygulamayı çalıştırma

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

2. Ö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ı temizle

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

Bir kaynak grubunu silmek 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

1. Azure portalında oturum açın ve Kaynak grupları’nı seçin.

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

   

3. Kaynak grubunu sil seçeneğini seçin.

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

İlgili içerik

• Bağlantı dayanıklılığı
• En İyi Yöntemler Geliştirme