Zarządzanie migawkami i korzystanie z nich

Z tego artykułu dowiesz się, jak tworzyć migawki i zarządzać nimi w usłudze Azure App Configuration. Migawka to zestaw ustawień konfiguracji aplikacji przechowywanych w stanie niezmiennym.

Wymagania wstępne

• Magazyn usługi App Configuration, jak pokazano w samouczku dotyczącym tworzenia magazynu konfiguracji aplikacji.
• Rola "Właściciel danych" w App Configuration. Szczegółowe informacje na temat wymaganej roli i uprawnień dla migawek

Dodawanie wartości klucz-wartość do magazynu konfiguracji aplikacji

W magazynie App Configuration przejdź doEksploratora konfiguracji> i dodaj następujące wartości klucza. Pozostaw wartość domyślną typu zawartości . Aby uzyskać więcej informacji na temat dodawania par klucz-wartość do magazynu przy użyciu portalu Azure lub interfejsu wiersza polecenia, przejdź do Utwórz parę klucz-wartość.

Klawisz	Wartość	Etykieta
app2/bgcolor	Jasnoszary	label2
app1/color	Czarny	Brak etykiety
app1/color	Niebieski	label1
app1/color	Zielony	label2
app1/color	Żółty	label3
app1/message	Hello (Cześć)	label1
app1/message	Cześć!	label2
app2/message	Dzień dobry!	label1

Utwórz migawkę

W obszarze Operacje>Migawki wybierz pozycję Utwórz nową migawkę.

1. Wprowadź nazwę migawki i opcjonalnie dodaj również tagi.

2. W obszarze Wybierz typ kompozycji zachowaj wartość domyślną Klucz (wartość domyślna).

   • Jeśli przy użyciu typu kompozycji Klucz w magazynie mogę istnieć identyczne klucze z różnymi etykietami, w migawce znajduje się tylko wartość odpowiadająca kluczowi określona w ostatnim odpowiednim filtrze. Wspólne wartości kluczowe z innymi etykietami nie są uwzględniane w migawce.
   • W przypadku typu kompozycji Key-Label, jeśli magazyn ma identyczne klucze z różnymi etykietami, wszystkie wartości kluczy z identycznymi kluczami, ale różnymi etykietami są uwzględniane w migawce, w zależności od określonych filtrów.

3. Wybierz pozycję Dodaj filtry, aby wybrać wartości kluczowe dla migawki. Filtrowanie odbywa się przez wybranie filtrów: Równe, Zaczyna się od, Jeden z i Wszystkie dla kluczy i etykiet. Można wprowadzić od jednego do trzech filtrów.

   1. Dodaj pierwszy filtr:
      • W obszarze Klucz wybierz pozycję Rozpoczyna się od i wprowadź app1
      • Pod Etykieta, wybierz Równa się i wybierz label2 z menu rozwijanego.
   2. Dodaj drugi filtr:
      • W obszarze Klucz wybierz pozycję Rozpoczyna się od i wprowadź app1
      • W obszarze Etykieta wybierz Równa się i wybierz label1 z menu rozwijanego.

4. Jeśli zarchiwizujesz migawkę, domyślnie będzie ona przechowywana przez 30 dni po archiwizacji. Opcjonalnie, w obszarze Opcje odzyskiwania, zmniejsz liczbę dni przechowywania, przez które migawka będzie dostępna po archiwizacji.

   Uwaga / Notatka

   Okres przechowywania nie może zostać zaktualizowany, gdy migawka zostanie utworzona.

5. Wybierz pozycję Utwórz , aby wygenerować migawkę. W tym przykładzie utworzona migawka ma typ kompozycji klucza i poniższe filtry:

   • Klucze rozpoczynające się od app1 z etykietą label2
   • Klucze rozpoczynające się od app1 z etykietą label1 .

   

6. Sprawdź tabelę, aby zrozumieć, które wartości klucza z magazynu konfiguracji trafiają do migawki na podstawie podanych parametrów.

   Klawisz	Wartość	Etykieta	Dołączone do zrzutu
   app2/bgcolor	Jasnoszary	label2	Nie: nie zaczyna się od app1.
   app1/color	Czarny	Brak etykiety	Nie: nie ma etykiety label2 ani label1.
   app1/color	Niebieski	label1	Tak: ma odpowiednią etykietę label1 z ostatnich odpowiednich filtrów.
   app1/color	Zielony	label2	Nie: ten sam klucz z etykietą label1 wybrany przez drugi filtr zastępuje ten, mimo że ma wybraną etykietę label2.
   app1/color	Żółty	label3	Nie: nie ma etykiety label2 ani label1.
   app1/message	Hello (Cześć)	label1	Tak: ma odpowiednią etykietę label1 z ostatnich odpowiednich filtrów.
   app1/message	Cześć!	label2	Nie: ten sam klucz z etykietą label1 wybrany przez drugi filtr zastępuje ten, mimo że ma wybraną etykietę label2.
   app2/message	Dzień dobry!	label1	Nie: nie zaczyna się od app1.

Tworzenie przykładowych migawek

Aby utworzyć przykładowe migawki i sprawdzić, jak działa funkcja migawek, użyj piaskownicy. Ta piaskownica zawiera przykładowe dane, które pozwalają lepiej zrozumieć działanie typu kompozycji i filtrów migawki.

1. W Migawkach operacji>> wybierz Przetestuj w piaskownicy.
2. Przejrzyj przykładowe dane i przećwicz tworzenie migawek, wypełniając formularz typem kompozycji i co najmniej jednym filtrem.
3. Wybierz pozycję Utwórz , aby wygenerować przykładową migawkę.
4. Sprawdź wynik migawki, który jest dostępny pod Wygenerowana migawka przykładu. Przykładowa migawka wyświetla wszystkie klucze uwzględnione w przykładowej migawki zgodnie z wyborem.

Używanie migawek

Możesz wybrać dowolną liczbę migawek dla konfiguracji aplikacji. Wybranie migawki dodaje wszystkie jej klucz-wartości. Po dodaniu do konfiguracji wartości klucza z migawek są traktowane tak samo jak każda inna wartość klucza.

Jeśli masz aplikację korzystającą z usługi Azure App Configuration, możesz ją zaktualizować przy użyciu następującego przykładowego kodu, aby używać migawek. Musisz tylko podać nazwę migawki, która jest rozróżniana pod względem wielkości liter.

.NET

Zmodyfikuj wywołanie AddAzureAppConfiguration metody , która jest często znajdowana w Program.cs pliku aplikacji. pl-PL: Jeśli nie masz aplikacji .NET, możesz odwołać się do dowolnego z przewodników szybkiego startu platformy .NET, takich jak tworzenie aplikacji ASP.NET Core za pomocą usługi Azure App Configuration.

Dodawanie migawek do konfiguracji

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

Uwaga / Notatka

Obsługa migawek jest dostępna, jeśli używasz wersji 7.0.0 lub nowszej dowolnego z następujących pakietów.

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

Python

Zmodyfikuj wywołanie metody load w swojej aplikacji. Jeśli nie masz aplikacji, możesz skorzystać z przewodnika Szybki start dotyczącego języka Python dla usługi Azure App Configuration.

Dodawanie migawek do konfiguracji

from azure.appconfiguration.provider import load, SettingSelector
from azure.identity import DefaultAzureCredential
import os

endpoint = os.environ["APPCONFIGURATION_ENDPOINT_STRING"]

# Load configuration settings from a snapshot
config = load(
    endpoint=endpoint,
    credential=DefaultAzureCredential(),
    selects=[SettingSelector(snapshot_name="SnapshotName")]
)

Uwaga / Notatka

Obsługa migawek jest dostępna, jeśli używasz wersji 2.3.0 lub nowszej azure-appconfiguration-provider pakietu.

Wiosna

application.yml Zaktualizuj plik aplikacji przy użyciu następujących konfiguracji.

spring:
  config:
    import: azureAppConfiguration
  cloud:
    azure:
      appconfiguration:
        stores:
         -
           endpoint: <your-endpoint>
           selects:
             -
              snapshot-name: <name-of-your-snapshot>
           trim-key-prefix: 
             - <prefix-to-trim>

Uwaga / Notatka

Każdy prefiks, taki jak /application/, który jest automatycznie przycinany podczas korzystania z filtru kluczowego, musi być określony dla zrzutów ekranu, inaczej nie będzie prawidłowo mapowany na poprawne klasy @ConfigurationProperties. Obsługa migawek jest dostępna, jeśli używasz wersji 4.12.0-beta.1/5.6.0-beta.1 lub nowszej z następujących pakietów.

• spring-cloud-azure-appconfiguration-config
• spring-cloud-azure-appconfiguration-config-web
• spring-cloud-azure-starter-appconfiguration-config

Uwaga / Notatka

Tylko migawki utworzone z typem kompozycji Key mogą być ładowane przy użyciu przedstawionych powyżej przykładów kodu.

Zarządzanie aktywnymi migawkami

Na stronie Operacje>Migawki są wyświetlane dwie karty: Aktywne migawki i Zarchiwizowane migawki. Wybierz Aktywne migawki, aby zobaczyć listę wszystkich aktywnych migawek w magazynie App Configuration.

Wyświetl istniejącą migawkę

Na karcie Aktywne migawki wybierz wielokropek ... po prawej stronie istniejącej migawki i wybierz pozycję Wyświetl , aby wyświetlić migawkę. Ta akcja powoduje otwarcie strony Szczegółów migawki, gdzie wyświetlane są ustawienia migawki i klucz-wartość zawarte w migawce.

Archiwizacja migawki

Na karcie Aktywne migawki wybierz wielokropek ... po prawej stronie istniejącej migawki i wybierz pozycję Archiwum , aby zarchiwizować migawkę. Potwierdź archiwizację, wybierając pozycję Tak lub anuluj z pozycją Nie. Po zarchiwizowaniu migawki pojawi się powiadomienie potwierdzające operację, a lista aktywnych migawek zostanie zaktualizowana.

Zarządzanie zarchiwizowanymi migawkami

Przejdź do Operacje>Migawki>Zarchiwizowane migawki, aby wyświetlić listę wszystkich zarchiwizowanych migawek w magazynie App Configuration. Zarchiwizowane migawki danych pozostają dostępne dla okresu przechowywania wybranego podczas ich tworzenia.

Wyświetlanie zarchiwizowanej migawki

Szczegółowy widok migawki jest również dostępny w stanie archiwum. Na karcie Zarchiwizowane migawki wybierz wielokropek ... po prawej stronie istniejącej migawki i wybierz pozycję Wyświetl , aby wyświetlić migawkę. Ta akcja powoduje otwarcie strony Szczegółów migawki, gdzie wyświetlane są ustawienia migawki i klucz-wartość zawarte w migawce.

Odzyskaj zarchiwizowaną migawkę

Na karcie Zarchiwizowane migawki wybierz wielokropek ... po prawej stronie zarchiwizowanej migawki i wybierz pozycję Odzyskaj , aby odzyskać migawkę. Po odzyskaniu migawki zostanie wyświetlone powiadomienie o potwierdzeniu operacji i zaktualizowaniu listy zarchiwizowanych migawek.

Dalsze kroki

Migawki w usłudze Azure App Configuration