hızlı başlangıç: Azure uygulama yapılandırmasıyla ASP.NET Core uygulaması oluşturma

bu hızlı başlangıçta, bir ASP.NET Core uygulamasının uygulama ayarlarının depolanmasını ve yönetimini merkezileştirmek için Azure uygulama yapılandırması 'nı kullanacaksınız. ASP.NET Core, bir uygulama tarafından belirtilen bir veya daha fazla veri kaynağından ayarları kullanarak tek, anahtar-değer tabanlı bir yapılandırma nesnesi oluşturur. Bu veri kaynakları yapılandırma sağlayıcıları olarak bilinir. Uygulama yapılandırmasının .NET Core istemcisi bir yapılandırma sağlayıcısı olarak uygulandığından, hizmet başka bir veri kaynağı gibi görünür.

Önkoşullar

• Azure aboneliği- ücretsiz olarak bir tane oluşturun
• .NET Core SDK

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 Operations Configuration Explorer anahtar değeri oluştur ' u seçin:

| Anahtar                                | Değer                               |
|------------------------------------|-------------------------------------|
| `TestApp:Settings:BackgroundColor` | *#FFF*                              |
| `TestApp:Settings:FontColor`       | *#000*                              |
| `TestApp:Settings:FontSize`        | *24*                                |
| `TestApp:Settings:Message`         | *Azure Uygulama yapılandırmasından veriler* |

**Etiket** ve **içerik türü** şimdilik boş bırakın. **Uygula**’yı seçin.

ASP.NET Core web uygulaması oluşturma

yeni bir ASP.NET Core MVC projesi oluşturmak için .net Core komut satırı arabirimi 'ni (clı) kullanın. Azure Cloud Shell , sizin için bu araçları sağlar. Windows, macos ve Linux platformları arasında da kullanılabilir.

yeni bir testappconfig klasöründe ASP.NET Core MVC projesi oluşturmak için aşağıdaki komutu çalıştırın:

dotnet new mvc --no-https --output TestAppConfig

Gizli dizi Yöneticisi ekleme

Gizli dizi Yöneticisi olarak adlandırılan bir araç, geliştirme çalışması için hassas verileri proje ağacınızdaki dışında depolar. Bu yaklaşım, uygulama gizli dizilerini kaynak kodunun içinde yanlışlıkla paylaşmayı önlemeye yardımcı olur. ASP.NET Core projesinde gizli yöneticinin kullanımını etkinleştirmek için aşağıdaki adımları izleyin:

dotnet user-secrets init

<Project Sdk="Microsoft.NET.Sdk.Web">
    
    <PropertyGroup>
        <TargetFramework>net5.0</TargetFramework>
        <UserSecretsId>79a3edd0-2092-40a2-a04d-dcb46d5ca9ed</UserSecretsId>
    </PropertyGroup>

</Project>

dotnet user-secrets init

<Project Sdk="Microsoft.NET.Sdk.Web">
    
    <PropertyGroup>
        <TargetFramework>netcoreapp3.1</TargetFramework>
        <UserSecretsId>79a3edd0-2092-40a2-a04d-dcb46d5ca9ed</UserSecretsId>
    </PropertyGroup>

</Project>

uygulama yapılandırma deposuna Bağlan

1. Microsoft. Azure. appconfiguration. aspnetcore NuGet paket başvurusu eklemek için aşağıdaki komutu çalıştırın:

   dotnet add package Microsoft.Azure.AppConfiguration.AspNetCore
   

2. Aşağıdaki komutu . csproj dosyasıyla aynı dizinde çalıştırın. Komutu ConnectionStrings:AppConfig , uygulama yapılandırma deponuzu için bağlantı dizesini depolayan adlı bir gizli dizi depolamak Için gizli bir yönetici kullanır. <your_connection_string>Yer tutucusunu uygulama yapılandırma deponuzdaki bağlantı dizesiyle değiştirin. Bağlantı dizesini Azure portal erişim tuşları altında bulabilirsiniz.

   dotnet user-secrets set ConnectionStrings:AppConfig "<your_connection_string>"
   

   Önemli

   Bazı kabuklar tırnak içine alınmadığı takdirde bağlantı dizesini keser. dotnet user-secrets listKomutun çıktısının tüm bağlantı dizesini belirttiğinden emin olun. Aksi takdirde, bağlantı dizesini tırnak içine alarak komutu yeniden çalıştırın.

   Gizli dizi Yöneticisi yalnızca Web uygulamasını yerel olarak test etmek için kullanılır. Uygulama Azure App Servicedağıtıldığında, bağlantı dizesini depolamak Için gizli yönetici yerine App Service bağlantı dizeleri uygulama ayarını kullanın.

   .NET Core Yapılandırma API 'sini kullanarak bu gizli dizi ile erişin. İki nokta üst üste ( : ) yapılandırma adında desteklenen tüm platformlarda Yapılandırma API 'si ile birlikte kullanılır. Daha fazla bilgi için bkz. yapılandırma anahtarları ve değerleri.

3. Program. cs' de .NET Core yapılandırması API 'si ad alanına bir başvuru ekleyin:

   using Microsoft.Extensions.Configuration;
   

4. Yöntemini CreateWebHostBuilder çağırarak uygulama yapılandırmasını kullanmak için yöntemi güncelleştirin AddAzureAppConfiguration .

   Önemli

   CreateHostBuilder``CreateWebHostBuilder.NET Core 3. x içindeki yerini alır. Ortamınıza göre doğru söz dizimini seçin.

   • .NET 5. x
   • .NET Core 3. x
   • .NET Core 2. x

   public static IHostBuilder CreateHostBuilder(string[] args) =>
       Host.CreateDefaultBuilder(args)
           .ConfigureWebHostDefaults(webBuilder =>
               webBuilder.ConfigureAppConfiguration(config =>
               {
                   var settings = config.Build();
                   var connection = settings.GetConnectionString("AppConfig");
                   config.AddAzureAppConfiguration(connection);
               }).UseStartup<Startup>());
   

   Önceki değişiklikten sonra, uygulama yapılandırması için yapılandırma sağlayıcısı .NET Core Yapılandırma API 'sine kaydedilir.

Uygulama yapılandırma deposundan okuma

Uygulama yapılandırma deposunda depolanan değerleri okumak ve göstermek için aşağıdaki adımları izleyin. .NET Core Configuration API 'SI mağazaya erişmek için kullanılacaktır. Razor söz dizimi, anahtarların değerlerini göstermek için kullanılacaktır.

<app root> /Views/Home/Index.cshtml dosyasını açın ve içeriğini şu kodla değiştirin:

@using Microsoft.Extensions.Configuration
@inject IConfiguration Configuration

<style>
    body {
        background-color: @Configuration["TestApp:Settings:BackgroundColor"]
    }
    h1 {
        color: @Configuration["TestApp:Settings:FontColor"];
        font-size: @Configuration["TestApp:Settings:FontSize"]px;
    }
</style>

<h1>@Configuration["TestApp:Settings:Message"]</h1>

Yukarıdaki kodda, uygulama yapılandırma deposunun anahtarları aşağıdaki gibi kullanılır:

• TestApp:Settings:BackgroundColorAnahtarın değeri, CSS background-color özelliğine atanır.
• TestApp:Settings:FontColorAnahtarın değeri, CSS color özelliğine atanır.
• TestApp:Settings:FontSizeAnahtarın değeri, CSS font-size özelliğine atanır.
• TestApp:Settings:MessageAnahtarın değeri bir başlık olarak görüntülenir.

Uygulamayı yerel olarak derleyin ve çalıştırın

1. .NET Core CLI kullanarak uygulamayı derlemek için, projenizin kök dizinine gidin. Komut kabuğunda aşağıdaki komutu çalıştırın:

   dotnet build
   

2. Oluşturma işlemi başarıyla tamamlandıktan sonra, Web uygulamasını yerel olarak çalıştırmak için aşağıdaki komutu çalıştırın:

   dotnet run
   

3. Yerel makinenizde çalışıyorsanız, ' ye gitmek için bir tarayıcı kullanın http://localhost:5000 . Bu adres, yerel olarak barındırılan Web uygulamasının varsayılan URL 'sidir. Azure Cloud Shell çalışıyorsanız, Web önizleme düğmesini ve ardından Yapılandır' ı seçin.

   

   Önizleme için bağlantı noktasını yapılandırmak isteyip istemediğiniz sorulduğunda 5000 girin ve Aç ve araştır' ı seçin. Web sayfası "Azure Uygulama yapılandırmasından verileri" okuyacaktır.

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 sağlandı.
• Uygulama yapılandırma deposunun .NET Core yapılandırma sağlayıcısı kaydedildi.
• Yapılandırma sağlayıcısıyla uygulama yapılandırma deposunun anahtarlarını okuyun.
• Razor söz dizimi kullanılarak uygulama yapılandırma deposunun anahtar değerleri görüntülendi.

yapılandırma ayarlarını dinamik olarak yenilemek üzere ASP.NET Core uygulamanızı nasıl yapılandıracağınızı öğrenmek için bir sonraki öğreticiye geçin.