Snabbstart: Skapa en .NET Core-app med App Configuration

I den här snabbstarten införlivar du Azure App Configuration i en .NET Core-konsolapp för att centralisera lagring och hantering av programinställningar separat från din kod.

Förutsättningar

• Azure-prenumeration – skapa en kostnadsfritt
• .NET Core SDK – finns även i Azure Cloud Shell.

Skapa en App Configuration butik

1. Om du vill skapa ett nytt konfigurations Arkiv för appen loggar du in på Azure Portal. I det övre vänstra hörnet på Start sidan väljer du skapa en resurs. I rutan Sök på Marketplace anger du app-konfiguration och väljer RETUR.

   

2. Välj app-konfiguration från Sök resultaten och välj sedan skapa.

   

3. I fönstret skapa app-konfiguration anger du följande inställningar:

   Inställning	Föreslaget värde	Beskrivning
   Prenumeration	Din prenumeration	Välj den Azure-prenumeration du vill använda för att testa App Configuration. Om ditt konto bara har en prenumeration väljs den automatiskt och ingen prenumerations lista visas.
   Resursgrupp	AppConfigTestResources	Välj eller skapa en resurs grupp för din app Configuration Store-resurs. Den här gruppen är användbar för att organisera flera resurser som du kanske vill ta bort samtidigt genom att ta bort resurs gruppen. Mer information finns i använda resurs grupper för att hantera dina Azure-resurser.
   Resurs namn	Globalt unikt namn	Ange ett unikt resurs namn som ska användas för appens konfigurations Arkiv resurs. Namnet måste vara en sträng mellan 5 och 50 tecken och får bara innehålla siffror, bokstäver och - tecknet. Namnet får inte börja eller sluta med - specialtecknet.
   Plats	USA, centrala	Använd Plats till att ange den geografiska plats där appkonfigurationsarkivets resurs finns. För bästa prestanda skapar du resursen i samma region som andra komponenter i ditt program.
   Prisnivå	Kostnadsfri	Välj önskad pris nivå. Mer information finns på sidan med prissättning för app-konfiguration.

4. Välj Granska + skapa för att validera inställningarna.

5. Välj Skapa. Distributionen kan ta några minuter.

6. När distributionen är klar går du till appen konfigurations resurs. Välj Inställningar > Åtkomstnycklar. Anteckna den primära skrivskyddade nyckel anslutnings strängen. Du kommer att använda den här anslutnings strängen senare för att konfigurera programmet för att kommunicera med det app-konfigurations lager som du har skapat.

7. Välj Configuration Explorer > Create > Key-value (Skapa nyckelvärde) för att lägga till följande nyckel/värde-par:

   Tangent	Värde
   TestApp:Settings:Message	Data från Azure App Configuration

   Lämna Etikett och Innehållstyp tomma för tillfället.

8. Välj Använd.

Skapa en .NET Core-konsolapp

Du använder .NET Core-kommandoradsgränssnittet (CLI) för att skapa ett nytt .NET Core-konsolappsprojekt. Fördelen med att använda .NET Core CLI jämfört Visual Studio är att den är tillgänglig på Windows-, macOS- och Linux-plattformarna. Du kan också använda de förinstallerade verktygen som finns i Azure Cloud Shell.

1. Skapa en ny mapp för ditt projekt.

2. Kör följande kommando i den nya mappen för att skapa ett nytt .NET Core-konsolappsprojekt:

   dotnet new console
   

Anslut till en App Configuration butik

1. Lägg till en referens till Microsoft.Extensions.Configuration.AzureAppConfiguration NuGet-paketet genom att köra följande kommando:

   dotnet add package Microsoft.Extensions.Configuration.AzureAppConfiguration
   

2. Kör följande kommando för att återställa paket för projektet:

   dotnet restore
   

3. Öppna Program.cs och lägg till en referens till .NET Core-App Configuration providern.

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

4. Uppdatera metoden Main så att den App Configuration genom att anropa metoden builder.AddAzureAppConfiguration() .

   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!");
   }
   

Skapa och köra appen lokalt

1. Ange en miljövariabel med namnet ConnectionString och ställ in den på åtkomstnyckeln till App Configuration store. Kör följande kommando på kommandoraden:

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

   Om du använder Windows PowerShell kör du följande kommando:

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

   Om du använder macOS eller Linux kör du följande kommando:

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

   Starta om kommandotolken så att ändringen börjar gälla. Skriv ut värdet för miljövariabeln för att verifiera att den har angetts korrekt.

2. Kör följande kommando för att skapa konsolappen:

   dotnet build
   

3. När bygget har slutförts kör du följande kommando för att köra appen lokalt:

   dotnet run
   

Rensa resurser

Om du inte vill fortsätta använda resurserna som skapats i den här artikeln tar du bort resurs gruppen som du skapade här för att undvika avgifter.

1. Logga in på Azure Portaloch välj resurs grupper.
2. I rutan Filtrera efter namn anger du namnet på din resurs grupp.
3. I listan resultat väljer du resurs gruppens namn för att se en översikt.
4. Välj Ta bort resursgrupp.
5. Du blir ombedd att bekräfta borttagningen av resursgruppen. Ange namnet på resurs gruppen som ska bekräftas och välj ta bort.

Efter en liten stund tas resurs gruppen och alla dess resurser bort.

Nästa steg

I den här snabbstarten skapade du ett nytt App Configuration store och använde det med en .NET Core-konsolapp via App Configuration providern. Om du vill lära dig hur du konfigurerar .NET Core-appen för att dynamiskt uppdatera konfigurationsinställningarna fortsätter du till nästa självstudie.