Sdílet prostřednictvím

Správa a používání snímků

V tomto článku se dozvíte, jak vytvářet, používat a spravovat snímky v Azure App Configuration. Snímek je sada nastavení konfigurace aplikace uložená v neměnném stavu.

Požadavky

Přidání klíčových hodnot do úložiště konfigurace aplikace

V App Configuration Storu přejděte doPrůzkumníka konfigurace> a přidejte následující hodnoty klíčů. Ponechte typ obsahu s výchozí hodnotou. Další informace o tom, jak přidat hodnoty klíčů do úložiště pomocí webu Azure Portal nebo rozhraní příkazového řádku, najdete v tématu Vytvoření hodnoty klíče.

Klíč Hodnota Označení
app2/bgcolor Světle šedá label2
app1/color černá Žádný popisek
app1/color Modrý label1
app1/color Zelený label2
app1/color žlutá popisek 3
app1/message Hello (Nazdar) label1
app1/message Ahoj! label2
app2/message Dobré ráno! label1

Vytvoření snímku

V části Operace>Snímky vyberte Vytvořit nový snímek.

  1. Zadejte název snímku a volitelně také přidejte značky.

  2. V části Zvolte typ složení ponechte výchozí hodnotu Klíč (výchozí).

    • Pokud má vaše úložiště identické klíče s různými štítky, s typem složení Key je ve snímku zahrnuta pouze hodnota klíče, která je zadána v posledním použitelném filtru. Identické hodnoty klíčů s jinými popisky jsou mimo snímek.
    • S typem složení Key-Label, pokud má vaše úložiště stejné klíče s různými štítky, všechny hodnoty klíčů se stejnými klíči, ale různými štítky, jsou zahrnuty do snímku v závislosti na zadaných filtrech.

  3. Vyberte Přidat filtry a vyberte hodnoty klíče pro snímek. Filtrování se provádí výběrem filtrů: Rovná se, Začíná, Některý z a Všechny pro klíče a popisky. Můžete zadat mezi jedním a třemi filtry.

    1. Přidejte první filtr:
      • V části Klíč vyberte Začíná na a zadejte app1.
      • V části Label vyberte Rovná se a v rozevírací nabídce vyberte label2.
    2. Přidejte druhý filtr:
      • V části Klíč vyberte Začíná na a zadejte app1.
      • V části Popisek vyberte Rovná se a v rozevírací nabídce vyberte popisek1 .

  4. Pokud ve výchozím nastavení archivujete snímek, zůstane po dobu 30 dnů od archivace zachován. Volitelně můžete v části Možnosti obnovení snížit počet dnů uchovávání, po které bude snímek k dispozici po archivaci.

    Poznámka:

    Po vytvoření snímku nelze dobu uchovávání aktualizovat.

  5. Vyberte Vytvořit a vygenerujte snímek. V tomto příkladu má vytvořený snímek typ složení klíče a následující filtry:

    • Klíče, které začínají app1, s label2 popiskem
    • Klíče, které začínají aplikací 1, s popiskem label1

    Snímek obrazovky s formulářem Vytvořit s daty vyplněnými výše uvedenými kroky a zvýrazněným tlačítkem Vytvořit

  6. V tabulce zjistíte, které hodnoty klíčů z úložiště konfigurace skončí ve snímku na základě zadaných parametrů.

    Klíč Hodnota Označení Zahrnutý ve snímku
    app2/bgcolor Světle šedá label2 Ne: nezačíná s app1.
    app1/color černá Žádný popisek Ne: nemá popisek2 ani popisek1.
    app1/color Modrý label1 Ano: Má správný label1 z posledního z použitelných filtrů.
    app1/color Zelený label2 Ne: Stejný klíč s popiskem label1 vybraným druhým filtrem má přednost před tímto, i když má popisek label2.
    app1/color žlutá popisek 3 Ne: nemá popisek2 ani popisek1.
    app1/message Hello (Nazdar) label1 Ano: Má správný label1 z posledního z použitelných filtrů.
    app1/message Ahoj! label2 Ne: Stejný klíč s popiskem label1 vybraným druhým filtrem má přednost před tímto, i když má popisek label2.
    app2/message Dobré ráno! label1 Ne: nezačíná s app1.

Vytvoření ukázkových snímků

Pokud chcete vytvořit ukázkové snímky a zkontrolovat, jak funkce snímků funguje, použijte sandbox snímků. Tento sandbox obsahuje ukázková data, se kterými si můžete pohrát, abyste lépe pochopili, jak funguje typ složení snímku a filtry.

  1. V Operace>Snímky>Aktivní snímky vyberte Test v sandboxu.
  2. Prohlédněte si ukázková data a procvičte si vytváření snímků vyplněním formuláře s typem složení a jedním nebo více filtry.
  3. Výběrem možnosti Vytvořit vygenerujete ukázkový snímek.
  4. Prohlédněte si výsledek snímku vygenerovaný v části Vygenerovaný ukázkový snímek. Ukázkový snímek zobrazí všechny klíče, které jsou součástí ukázkového snímku, podle vašeho výběru.

Použití snímků

Pro konfiguraci aplikace můžete vybrat libovolný počet snímků. Výběrem snímku se přidají všechny jeho klíčové hodnoty. Po přidání do konfigurace se hodnoty klíče ze snímků považují za stejné jako všechny ostatní hodnoty klíče.

Pokud máte aplikaci využívající Azure App Configuration, můžete ji aktualizovat následujícím ukázkovým kódem, aby používala snímky. Stačí zadat jenom název snímku, při zadávání se rozlišují malá a velká písmena.

Upravte volání AddAzureAppConfiguration metody, která se často nachází v Program.cs souboru vaší aplikace. Pokud nemáte aplikaci, můžete na některou z příruček pro rychlý start pro .NET odkazovat, jako je vytvoření základní aplikace ASP.NET pomocí azure App Configuration.

Přidání snímků do konfigurace

configurationBuilder.AddAzureAppConfiguration(options =>
{
    string endpoint = Environment.GetEnvironmentVariable("Endpoint"); 
    options.Connect(new Uri(endpoint), new DefaultAzureCredential());
    // Select an existing snapshot by name. This will add all of the key-values from the snapshot to this application's configuration.
    options.SelectSnapshot("SnapshotName");
    
    // Other changes to options
});

Poznámka:

Podpora snímků je dostupná, pokud používáte verzi 7.0.0 nebo novější z následujících balíčků.

  • Microsoft.Extensions.Configuration.AzureAppConfiguration
  • Microsoft.Azure.AppConfiguration.AspNetCore
  • Microsoft.Azure.AppConfiguration.Functions.Worker

Poznámka:

Pouze snímky vytvořené složením typu Key lze načíst pomocí uvedených ukázek kódu výše.

Správa aktivních snímků

Na stránce pod Operace>Snímky se zobrazují dvě karty: Aktivní snímky a Archivované snímky. Výběrem možnosti Aktivní snímky zobrazíte seznam všech aktivních snímků v obchodě App Configuration Store.

Snímek obrazovky se seznamem aktivních snímků

Zobrazení existujícího snímku

Na kartě Aktivní snímky vyberte tři tečky ... napravo od existujícího snímku a zvolte Zobrazit, abyste zobrazili snímek. Tato akce otevře stránku s podrobnostmi snímku, která zobrazuje nastavení snímku a hodnoty klíče zahrnuté ve snímku.

Snímek obrazovky s podrobným zobrazením aktivního snímku

Archivace snímku

Na kartě Aktivní snímky vyberte tlačítko se třemi tečkami ... na pravé straně existujícího snímku a vyberte Archiv k archivaci snímku. Potvrďte archivaci tak, že vyberete Ano nebo zrušíte možnost Ne. Po archivaci snímku se zobrazí oznámení s potvrzením operace a aktualizace seznamu aktivních snímků.

Snímek obrazovky s možností archivu v aktivních snímcích

Správa archivovaných snímků

Přejděte na Operace>Snímky>Archivované snímky a zobrazte seznam všech archivovaných snímků v úložišti konfigurace aplikace. Archivované snímky zůstanou přístupné pro dobu uchovávání informací, která byla vybrána během jejich vytváření.

Snímek obrazovky se seznamem archivovaných snímků

Zobrazení archivovaného snímku

Podrobné zobrazení snímku je k dispozici i ve stavu archivu. Na kartě Archivované snímky vyberte ikonu ... napravo od existujícího snímku a vyberte Zobrazit pro zobrazení snímku. Tato akce otevře stránku s podrobnostmi snímku, která zobrazuje nastavení snímku a hodnoty klíče zahrnuté ve snímku.

Snímek obrazovky s podrobným zobrazením archivovaného snímku

Obnovení archivovaného snímku

Na kartě Archivované snímky vyberte ikonu ... napravo od archivovaného snímku a zvolte Obnovit pro obnovení snímku. Po obnovení snímku se zobrazí oznámení s potvrzením operace a aktualizace seznamu archivovaných snímků.

Snímek obrazovky s možností obnovení v archivovaných snímcích

Další kroky

Snímky v Azure App Configuration

  • Last updated on