Hızlı Başlangıç: Uygulama Yapılandırması ile .NET Core uygulaması oluşturma

Bu hızlı başlangıçta, koddan ayrı Azure Uygulama Yapılandırması uygulama ayarlarının depolanması ve yönetimini merkezileştirmek için bir .NET Core konsol uygulamasına bir .NET Core konsol uygulaması ekleniyor.

Önkoşullar

• Azure aboneliği - ücretsiz bir abonelik oluşturun
• .NET Core SDK - içinde de Azure Cloud Shell.

Uygulama Yapılandırma deposu oluşturma

1. Yeni bir uygulama yapılandırma deposu oluşturmak için Azure Portaloturum açın. Giriş sayfasının sol üst köşesinde kaynak oluştur' u seçin. Market 'te Ara kutusuna uygulama yapılandırması ' nı girin ve ENTER' u seçin.

   

2. Arama sonuçlarından uygulama yapılandırması ' nı seçin ve ardından Oluştur' u seçin.

   

3. Uygulama yapılandırması oluştur bölmesinde, aşağıdaki ayarları girin:

   Ayar	Önerilen değer	Açıklama
   Abonelik	Aboneliğiniz	Uygulama yapılandırmasını test etmek için kullanmak istediğiniz Azure aboneliğini seçin. Hesabınızda yalnızca bir abonelik varsa, bu otomatik olarak seçilir ve abonelik listesi gösterilmez.
   Kaynak grubu	AppConfigTestResources	Uygulama yapılandırma deposu kaynağınız için bir kaynak grubu seçin veya oluşturun. Bu grup, kaynak grubunu silerek aynı anda silmek isteyebileceğiniz birden çok kaynağı düzenlemek için yararlıdır. Daha fazla bilgi için Azure kaynaklarınızı yönetmek için kaynak gruplarını kullanma konusunu inceleyin.
   Kaynak adı	Genel olarak benzersiz bir ad	Uygulama yapılandırma deposu kaynağı için kullanılacak benzersiz bir kaynak adı girin. Ad, 5 ila 50 karakter arasında bir dize olmalı ve yalnızca rakam, harf ve - karakter içermelidir. Ad, karakteriyle başlayamaz veya bitemez - .
   Konum	Central US	Uygulama yapılandırma deponuzın barındırıldığı coğrafi konumu belirtmek için konum ' i kullanın. En iyi performansı elde etmek için, kaynağı uygulamanızın diğer bileşenleriyle aynı bölgede oluşturun.
   Fiyatlandırma katmanı	Ücretsiz	İstediğiniz fiyatlandırma katmanını seçin. Daha fazla bilgi için bkz. uygulama yapılandırma fiyatlandırma sayfası.

4. Ayarlarınızı doğrulamak için gözden geçir + oluştur ' u seçin.

5. Oluştur’u seçin. Dağıtım birkaç dakika sürebilir.

6. Dağıtım bittikten sonra uygulama yapılandırma kaynağına gidin. Ayarlar > Erişim anahtarları öğesini seçin. Birincil salt okunurdur anahtar bağlantı dizesini bir yere unutmayın. Uygulamanızı oluşturduğunuz uygulama yapılandırma deposuyla iletişim kuracak şekilde yapılandırmak için bu bağlantı dizesini daha sonra kullanacaksınız.

7. Aşağıdaki > > anahtar-değer çiftlerini eklemek için Yapılandırma Gezgini Anahtar-değer Oluştur'a tıklayın:

   Anahtar	Değer
   TestApp:Ayarlar:Message	Azure Uygulama Yapılandırması'den veriler

   Etiket ve İçerik Türü'leri şimdilik boş bırakın.

8. Uygula’yı seçin.

.NET Core konsol uygulaması oluşturma

Yeni bir .NET Core konsol uygulaması projesi oluşturmak için .NET Core komut satırı arabirimini (CLI) kullanırsınız. .NET Core CLI' Visual Studio kullanmanın avantajı, Windows, macOS ve Linux platformlarında kullanılabilir durumdadır. Alternatif olarak, içinde bulunan önceden yüklenmiş araçları Azure Cloud Shell.

1. Projeniz için yeni bir klasör oluşturun.

2. Yeni klasörde aşağıdaki komutu çalıştırarak yeni bir .NET Core konsol uygulaması projesi oluşturun:

   dotnet new console
   

Bağlan Yapılandırma deposuna yapılandırma

1. Aşağıdaki komutu çalıştırarak Microsoft.Extensions.Configuration.AzureAppConfiguration NuGet paketine başvuru ekleyin:

   dotnet add package Microsoft.Extensions.Configuration.AzureAppConfiguration
   

2. Projenizin paketlerini geri yüklemek için aşağıdaki komutu çalıştırın:

   dotnet restore
   

3. Program.cs'yi açın ve .NET Core Uygulama Yapılandırma sağlayıcısına bir başvuru ekleyin.

   using Microsoft.Extensions.Configuration;
   using Microsoft.Extensions.Configuration.AzureAppConfiguration;
   

4. yöntemini Main çağırarak Uygulama Yapılandırmasını kullanmak için yöntemini builder.AddAzureAppConfiguration() güncelleştirin.

   static void Main(string[] args)
   {
       var builder = new ConfigurationBuilder();
       builder.AddAzureAppConfiguration(Environment.GetEnvironmentVariable("ConnectionString"));
   
       var config = builder.Build();
       Console.WriteLine(config["TestApp:Settings:Message"] ?? "Hello world!");
   }
   

Uygulamayı yerel olarak derleme ve çalıştırma

1. ConnectionString adlı bir ortam değişkeni ayarlayın ve bunu Uygulama Yapılandırma mağazanıza erişim anahtarı olarak ayarlayın. Komut satırına aşağıdaki komutu çalıştırın:

   setx ConnectionString "connection-string-of-your-app-configuration-store"
   

   Aşağıdaki komutu Windows PowerShell çalıştırın:

   $Env:ConnectionString = "connection-string-of-your-app-configuration-store"
   

   macOS veya Linux kullanıyorsanız aşağıdaki komutu çalıştırın:

   export ConnectionString='connection-string-of-your-app-configuration-store'
   

   Değişikliğin etkili olmasına izin vermek için komut istemini yeniden başlatın. Ortam değişkeninin değerini yazdırarak düzgün ayarlandıktan emin olun.

2. Konsol uygulamasını derlemek için aşağıdaki komutu çalıştırın:

   dotnet build
   

3. Derleme başarıyla tamamlandıktan sonra uygulamayı yerel olarak çalıştırmak için aşağıdaki komutu çalıştırın:

   dotnet run
   

Kaynakları temizleme

Bu makalede oluşturulan kaynakları kullanmaya devam etmek istemiyorsanız, ücretlendirmemek için burada oluşturduğunuz kaynak grubunu silin.

1. Azure Portaloturum açın ve kaynak grupları' nı seçin.
2. Ada göre filtrele kutusuna kaynak grubunuzun adını girin.
3. Sonuç listesinde, bir genel bakışı görmek için kaynak grubu adını seçin.
4. Kaynak grubunu sil'i seçin.
5. Kaynak grubunun silinmesini onaylamanız istenir. Onaylamak için kaynak grubunuzun adını girin ve Sil' i seçin.

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

Sonraki adımlar

Bu hızlı başlangıçta, yeni bir Uygulama Yapılandırma deposu oluşturdunız ve bunu Uygulama Yapılandırma sağlayıcısı aracılığıyla bir .NET Core konsol uygulamasıyla kullandınız. .NET Core uygulamanızı yapılandırma ayarlarını dinamik olarak yenilenecek şekilde yapılandırmayı öğrenmek için sonraki öğreticiye devam edin.