Importowanie lub eksportowanie danych konfiguracji

aplikacja systemu Azure Configuration obsługuje operacje importowania i eksportowania danych. Te operacje umożliwiają pracę z danymi konfiguracji zbiorczo i wymianą danych między magazynem App Configuration i projektem kodu. Na przykład można skonfigurować jeden magazyn usługi App Configuration na potrzeby testowania, a drugi na potrzeby środowiska produkcyjnego. Ustawienia aplikacji można skopiować między nimi, aby nie trzeba było wprowadzać danych dwa razy.

Ten artykuł zawiera przewodnik dotyczący importowania i eksportowania danych przy użyciu witryny Azure Portal lub interfejsu wiersza polecenia platformy Azure. Jeśli konfiguracja została przyjęta jako kod i zarządzasz konfiguracjami w usłudze GitHub lub Azure DevOps, możesz skonfigurować ciągły import plików konfiguracji przy użyciu funkcji GitHub Actions lub użyć zadania importowania potoku platformy Azure.

Importuj dane

Importowanie powoduje przeniesienie danych konfiguracji do magazynu usługi App Configuration z istniejącego źródła. Użyj funkcji import, aby przeprowadzić migrację danych do magazynu usługi App Configuration lub agregować dane z wielu źródeł.

W tym przewodniku pokazano, jak zaimportować dane usługi App Configuration:

• z pliku konfiguracji w formacie Json, Yaml lub Właściwości
• z magazynu App Configuration
• z usługi aplikacja systemu Azure

Importowanie danych z pliku konfiguracji

Wykonaj poniższe kroki, aby zaimportować wartości kluczy z pliku.

Portal

W witrynie Azure Portal wykonaj następujące kroki:

1. Przejdź do sklepu App Configuration i wybierz pozycję Importuj/eksportuj z menu Operacje.

   

2. Przycisk radiowy Importuj jest domyślnie zaznaczony. W obszarze Typ źródła wybierz pozycję Plik konfiguracji.

3. Wypełnij formularz następującymi parametrami:

   Parametr	Opis	Przykład
   Typ pliku	Wybierz typ pliku do zaimportowania: YAML, Właściwości lub JSON.	Json

4. Kliknij przycisk Przeglądaj i wybierz plik do zaimportowania.

5. Wypełnij następną część formularza:

   Parametr	Opis	Przykład
   Profil zawartości pliku	Wybierz profil zawartości: Domyślny lub KVSet. Domyślny profil zawartości pliku odnosi się do konwencjonalnego schematu pliku konfiguracji powszechnie stosowanego przez istniejące struktury programowania lub systemy, obsługuje formaty plików JSON, Yaml lub Properties. Profil zawartości pliku KVSet odnosi się do schematu pliku zawierającego wszystkie właściwości klucza-wartości konfiguracji aplikacji, w tym klucz, wartość, etykietę, typ zawartości i tagi.	Wartość domyślna
   Tryb Import	Tryb importu służy do określania, czy ignorować identyczne wartości klucza. W przypadku opcji Ignoruj dopasowanie wszystkie wartości klucza w magazynie, które są takie same jak w pliku konfiguracji, są ignorowane. Po wybraniu opcji Wszystkie wszystkie wartości klucza w pliku konfiguracji są aktualizowane.	Ignoruj dopasowanie
   Wyklucz flagę funkcji	Jeśli to pole wyboru, flagi funkcji nie zostaną zaimportowane.	Niezaznaczone
   Dokładny	Jeśli pole jest zaznaczone, wszystkie wartości kluczy w magazynie z określonym prefiksem i etykietą, które nie są uwzględnione w pliku konfiguracji, zostaną usunięte, gdy profil zawartości pliku jest ustawiony na Wartość domyślna. Gdy profil zawartości pliku jest ustawiony na KVSet, wszystkie wartości kluczy w magazynie, które nie są uwzględnione w pliku konfiguracji, zostaną usunięte. Jeśli pole jest niezaznaczone, nie zostaną usunięte żadne wartości klucza w magazynie.	Niezaznaczone
   Separator	Separator jest ogranicznikiem używanym do spłaszczania plików JSON lub YAML do wartości klucza. Zostanie on zignorowany dla plików właściwości i flag funkcji. Obsługiwane wartości obejmują separator bez separatora, kropki (.), przecinek (,), średnik (;), łącznik (-), podkreślenie (_), podwójne podkreślenie (__), ukośnik (/) i dwukropek (:).	:
   Głębokość	Opcjonalny. Głębokość spłaszczania plików JSON lub YAML do par klucz-wartość. Domyślnie pliki są spłaszczone na najgłębszym poziomie, jeśli wybrano separator. To ustawienie nie ma zastosowania do plików właściwości ani flag funkcji.
   Dodaj prefiks	Opcjonalny. W przypadku określenia prefiks zostanie dodany do nazw kluczy wszystkich zaimportowanych wartości klucza.	TestApp:
   Dodaj etykietę	Opcjonalny. Jeśli zostanie określona, podana etykieta zostanie przypisana do wszystkich zaimportowanych wartości kluczy.	Prod
   Dodawanie typu zawartości	Opcjonalny. Jeśli zostanie określony, podany typ zawartości zostanie dodany do wszystkich zaimportowanych wartości klucza.	JSON (application/json)
   Dodawanie tagów	Opcjonalny. Jeśli zostanie określony, podane tagi zostaną dodane do wszystkich zaimportowanych wartości klucza.	{tag: tag1}

6. Wybierz pozycję Zastosuj , aby kontynuować importowanie.

Pomyślnie zaimportowaliśmy wartości kluczy z pliku JSON. Nazwy kluczy zostały spłaszczone przy użyciu separatora : i prefiksu z TestApp:. Wszystkie zaimportowane wartości klucza są oznaczone jako prod, z typem application/jsonzawartości i oznaczonym tagiem tag: tag1.

Interfejs wiersza polecenia platformy Azure

W interfejsie wiersza polecenia platformy Azure wykonaj poniższe kroki. Jeśli nie masz zainstalowanego lokalnie interfejsu wiersza polecenia platformy Azure, możesz opcjonalnie użyć usługi Azure Cloud Shell.

1. Wprowadź polecenie az appconfig kv import importu i dodaj następujące parametry:

   Parametr	Opis	Przykład
   --name	Wprowadź nazwę magazynu App Configuration, do którego chcesz zaimportować dane.	my-app-config-store
   --source	Wprowadź , file aby wskazać, że importujesz dane konfiguracji aplikacji z pliku.	file
   --path	Wprowadź ścieżkę lokalną do pliku zawierającego dane, które chcesz zaimportować.	C:/Users/john/Downloads/data.json
   --format	Wprowadź plik yaml, properties lub json, aby wskazać format importowanych plików.	json

2. Opcjonalnie dodaj również następujące parametry:

   Parametr	Opis	Przykład
   --separator	Opcjonalny. Separator jest ogranicznikiem spłaszczania wartości kluczy do pliku Json/Yaml. Jest to wymagane do eksportowania struktury hierarchicznej i będzie ignorowane dla plików właściwości i flag funkcji. Wybierz jedną z następujących opcji: ., , ,, :;, /, -, _. —	;
   --prefix	Opcjonalny. Prefiks klucza jest początkową częścią klucza. Prefiksy mogą służyć do zarządzania grupami klucz-wartości w magazynie konfiguracji. Ten prefiks zostanie dołączony do przodu właściwości "klucz" każdej zaimportowanej wartości klucza.	TestApp:
   --label	Opcjonalny. Wprowadź etykietę, która zostanie przypisana do zaimportowanych wartości klucza.	prod
   --content-type	Opcjonalny. Wprowadź appconfig/kvset lub application/json , aby stwierdzić, że zaimportowana zawartość składa się z odwołania do usługi Key Vault lub pliku JSON.	application/json

   Przykład: zaimportuj wszystkie flagi kluczy i funkcji z pliku JSON, zastosuj etykietę "prod" i dołącz prefiks "TestApp". Dodaj typ zawartości "application/json".

   az appconfig kv import --name my-app-config-store --source file --path D:/abc.json --format json --separator ; --prefix TestApp: --label prod --content-type application/json
   

3. W wierszu polecenia zostanie wyświetlona lista nadchodzących zmian. Potwierdź importowanie y, wybierając pozycję .

   

Zaimportowano wartości kluczy z pliku JSON i przypisano im etykietę "prod" i prefiks "TestApp:". Separator ";" jest używany i wszystkie zaimportowane wartości klucza mają typ zawartości ustawiony jako "JSON".

Aby uzyskać więcej opcjonalnych parametrów i przykładów, przejdź do polecenia az appconfig kv import.

Importowanie danych z magazynu usługi App Configuration

Możesz zaimportować wartości z jednego magazynu usługi App Configuration do innego magazynu usługi App Configuration lub zaimportować wartości z jednego magazynu usługi App Configuration do tego samego magazynu usługi App Configuration, aby zduplikować jego wartości i zastosować różne parametry, takie jak nowa etykieta lub typ zawartości.

Wykonaj poniższe kroki, aby zaimportować flagi key-values i feature z magazynu konfiguracji aplikacja systemu Azure.

Portal

W witrynie Azure Portal wykonaj następujące kroki:

1. Przejdź do sklepu App Configuration i wybierz pozycję Importuj/eksportuj z menu Operacje.

   

2. Przycisk radiowy Importuj jest domyślnie zaznaczony. W obszarze Typ źródła wybierz pozycję Konfiguracja aplikacji.

3. Wybierz magazyn usługi App Configuration, z której chcesz zaimportować dane, i wypełnij formularz następującymi parametrami:

   Parametr	Opis	Przykład
   Subskrypcja	Bieżąca subskrypcja jest domyślnie zaznaczona.	moja subskrypcja
   Grupa zasobów	Wybierz grupę zasobów zawierającą magazyn App Configuration z konfiguracją do zaimportowania. Bieżąca grupa zasobów jest domyślnie zaznaczona.	my-resource-group
   Zasób	Wybierz magazyn App Configuration zawierający konfigurację, którą chcesz zaimportować.	my-other-app-config-store

4. Wypełnij następną część formularza:

   Parametr	Opis	Przykład
   Tryb zaznaczenia	Wybierz, czy importować z zwykłych wartości klucz-wartość, która jest opcją domyślną, czy z migawki.	Wartość domyślna
   Filtr klucza	Służy do filtrowania wartości klucz-wartości na podstawie nazwy klucza do zaimportowania. Jeśli nie określono żadnych kluczy, wszystkie klucze kwalifikują się.	Rozpoczyna się od testu
   W określonym czasie	Opcjonalny. Wypełnij to pole, aby zaimportować wartości kluczy z określonego punktu w czasie w wybranym magazynie konfiguracji. Jeśli pole pozostanie puste, wartość domyślna to bieżący punkt w czasie wartości klucz-wartość.	28.07.2022 12:00:00
   Z etykiety	Wybierz co najmniej jedną etykietę, aby zaimportować wartości kluczy skojarzone z tymi etykietami. Jeśli żadna etykieta nie zostanie wybrana, wszystkie etykiety kwalifikują się.	Prod
   Wyklucz flagę funkcji	Jeśli to pole wyboru, flagi funkcji nie zostaną zaimportowane.	Niezaznaczone
   Dodaj prefiks	Opcjonalny. W przypadku określenia prefiks zostanie dodany do nazw kluczy wszystkich zaimportowanych wartości klucza.	TestApp:
   Zastępowanie etykiet	Opcjonalny. Domyślnie oryginalne etykiety wartości klucza źródłowego są zachowywane. Aby je zastąpić, zaznacz pole wyboru i wprowadź nową etykietę dla zaimportowanych wartości kluczy.	new
   Zastępowanie typów zawartości	Opcjonalny. Domyślnie oryginalne typy zawartości wartości klucza źródłowego są zachowywane. Aby je zastąpić, zaznacz pole i wprowadź nowy typ zawartości dla zaimportowanych wartości klucza. Należy pamiętać, że nie można zastąpić typu zawartości flag funkcji.	JSON (application/json)

5. Wybierz pozycję Zastosuj , aby kontynuować importowanie.

Zaimportowaliśmy wartości kluczy ze sklepu App Configuration od 28 stycznia 2021 r. o godzinie 12:00 z nazwami kluczy rozpoczynającymi się od test i etykietą prod. Nazwy kluczy zostały poprzedzone prefiksem TestApp:. Wszystkie zaimportowane wartości klucza zostały przypisane do etykiety new i typu application/jsonzawartości .

Interfejs wiersza polecenia platformy Azure

W interfejsie wiersza polecenia platformy Azure wykonaj poniższe kroki. Jeśli nie masz zainstalowanego lokalnie interfejsu wiersza polecenia platformy Azure, możesz opcjonalnie użyć usługi Azure Cloud Shell.

1. Wprowadź polecenie az appconfig kv import importu i wprowadź następujące parametry:

   Parametr	Opis	Przykład
   --name	Wprowadź nazwę magazynu App Configuration, do którego chcesz zaimportować dane	my-app-config-store
   --source	Wprowadź , appconfig aby wskazać, że importujesz dane z magazynu usługi App Configuration.	appconfig
   --src-name	Wprowadź nazwę magazynu App Configuration, z którego chcesz zaimportować dane.	my-source-app-config
   --src-label	Ogranicz importowanie do wartości klucz-wartości przy użyciu określonej etykiety. Jeśli nie używasz tego parametru, importowane będą tylko wartości klucz-wartości z etykietą null. Obsługuje znak gwiazdki jako filtr: wprowadź * dla wszystkich etykiet; abc* dla wszystkich etykiet z abc jako prefiksem.	prod

2. Opcjonalnie dodaj następujące parametry:

   Parametr	Opis	Przykład
   --label	Opcjonalny. Wprowadź etykietę, która zostanie przypisana do zaimportowanych wartości klucza.	new
   --content-type	Opcjonalny. Wprowadź appconfig/kvset lub application/json , aby stwierdzić, że zaimportowana zawartość składa się z odwołania do usługi Key Vault lub pliku JSON. Typ zawartości można zastąpić tylko dla zaimportowanych wartości klucz-wartość. Domyślny typ zawartości flag funkcji to "application/vnd.microsoft.appconfig.ff+json; charset=utf-8' domyślnie i nie jest aktualizowany przez ten parametr.	application/json

   Przykład: zaimportuj flagi key-values i feature z etykietą "prod" z innej usługi App Configuration i przypisz im etykietę "new". Dodaj typ zawartości "application/json".

   az appconfig kv import --name my-app-config-store --source appconfig --src-name my-source-app-config --src-label prod --label new --content-type application/json
   

3. W wierszu polecenia zostanie wyświetlona lista nadchodzących zmian. Potwierdź importowanie y, wybierając pozycję .

   

Zaimportowano wartości kluczy z etykietą "prod" ze sklepu App Configuration i przypisano im etykietę "new". Wszystkie zaimportowane wartości klucza mają typ zawartości ustawiony jako "JSON".

Aby uzyskać więcej opcjonalnych parametrów i przykładów, przejdź do polecenia az appconfig kv import.

Importowanie danych z usługi aplikacja systemu Azure

Wykonaj poniższe kroki, aby zaimportować wartości kluczy z usługi aplikacja systemu Azure Service.

Uwaga

Usługa App Service nie obsługuje obecnie flag funkcji. Wszystkie flagi funkcji zaimportowane do usługi App Service są automatycznie konwertowane na wartości klucza. Zasoby usługi App Service mogą zawierać tylko wartości klucz-wartość.

Portal

Z witryny Azure Portal:

1. Przejdź do sklepu App Configuration i wybierz pozycję Importuj/eksportuj z menu Operacje.

   

2. Przycisk radiowy Importuj jest domyślnie zaznaczony. W obszarze Typ źródła wybierz pozycję App Services.

3. Wybierz magazyn usługi App Configuration, z której chcesz zaimportować dane, i wypełnij formularz następującymi parametrami:

   Parametr	Opis	Przykład
   Subskrypcja	Bieżąca subskrypcja jest domyślnie zaznaczona.	moja subskrypcja
   Grupa zasobów	Wybierz grupę zasobów zawierającą usługę App Service z konfiguracją do zaimportowania.	my-resource-group
   Zasób	Wybierz usługę App Service zawierającą konfigurację, którą chcesz zaimportować.	my-app-service

4. Wypełnij następną część formularza:

   Parametr	Opis	Przykład
   Aktualizowanie ustawień do odwołania	Jeśli to pole wyboru, ustawienia aplikacji w usłudze App Service zostaną zaktualizowane do odwołań usługi App Configuration dla zaimportowanych klucz-wartości. Umożliwia to zarządzanie ustawieniami aplikacji w usłudze App Configuration w przyszłości. Usługa App Service automatycznie pobierze bieżącą wartość z usługi App Configuration. Aby dowiedzieć się więcej, zobacz Use App Configuration references for App Service and Azure Functions (Używanie odwołań do konfiguracji aplikacji dla usług App Service i Azure Functions).	Sprawdzane
   Dodaj prefiks	Opcjonalny. W przypadku określenia prefiks zostanie dodany do nazw kluczy wszystkich zaimportowanych wartości klucza.	TestApp:
   Dodaj etykietę	Opcjonalny. Jeśli zostanie określona, podana etykieta zostanie przypisana do wszystkich zaimportowanych wartości kluczy.	Prod
   Dodawanie typu zawartości	Opcjonalny. Jeśli zostanie określony, podany typ zawartości zostanie dodany do wszystkich zaimportowanych wartości klucza.	JSON (application/json)

5. Wybierz pozycję Zastosuj , aby kontynuować importowanie.

Zaimportowaliśmy wszystkie ustawienia aplikacji z usługi App Service jako wartości klucza i przypisano do nich etykietę prod i prefiks TestApp:. Wszystkie zaimportowane wartości klucza mają typ zawartości ustawiony jako application/json.

Interfejs wiersza polecenia platformy Azure

W interfejsie wiersza polecenia platformy Azure wykonaj poniższe kroki. Jeśli nie masz zainstalowanego lokalnie interfejsu wiersza polecenia platformy Azure, możesz opcjonalnie użyć usługi Azure Cloud Shell.

1. Wprowadź polecenie az appconfig kv import importu i dodaj następujące parametry:

   Parametr	Opis	Przykład
   --name	Wprowadź nazwę magazynu App Configuration, do którego chcesz zaimportować dane.	my-app-config-store
   --source	Wprowadź , appservice aby wskazać, że importujesz dane konfiguracji aplikacji z usługi aplikacja systemu Azure Service.	appservice
   --appservice-account	Wprowadź identyfikator arm usługi App Service lub użyj nazwy usługi App Service, jeśli znajduje się ona w tej samej subskrypcji i grupie zasobów co usługa App Configuration.	/subscriptions/123/resourceGroups/my-resource-group/providers/Microsoft.Web/sites/my-app-service lub my-app-service

2. Opcjonalnie dodaj również następujące parametry:

   Parametr	Opis	Przykład
   --prefix	Opcjonalny. Prefiks klucza jest początkową częścią właściwości "klucz-wartość". Prefiksy mogą służyć do zarządzania grupami klucz-wartości w magazynie konfiguracji. Ten prefiks zostanie dołączony do przodu właściwości "klucz" każdej zaimportowanej wartości klucza.	TestApp:
   --label	Opcjonalny. Wprowadź etykietę, która zostanie przypisana do zaimportowanych wartości klucza. Jeśli nie określisz etykiety, etykieta o wartości null zostanie przypisana do klucza-wartości.	prod
   --content-type	Opcjonalny. Wprowadź ciąg appconfig/kvset lub application/json, aby stwierdzić, że zaimportowana zawartość składa się z odwołania do usługi Key Vault lub pliku JSON.	application/json

   Aby uzyskać wartość parametru --appservice-account, użyj polecenia az webapp show --resource-group <resource-group> --name <resource-name>.

   Przykład: zaimportuj wszystkie ustawienia aplikacji z usługi App Service jako wartości klucza z etykietą "prod", do sklepu App Configuration i dodaj prefiks "TestApp:".

   az appconfig kv import --name my-app-config-store --source appservice --appservice-account /subscriptions/123/resourceGroups/my-resource-group/providers/Microsoft.Web/sites/my-app-service --label prod --prefix TestApp:
   

3. W wierszu polecenia zostanie wyświetlona lista nadchodzących zmian. Potwierdź importowanie y, wybierając pozycję .

   

Zaimportowano wszystkie ustawienia aplikacji z usługi App Service jako wartości klucza, przypisano im etykietę "prod" i dodano prefiks "TestApp:". Wszystkie zaimportowane wartości klucza mają typ zawartości ustawiony jako "JSON".

Aby uzyskać więcej opcjonalnych parametrów i przykładów, przejdź do polecenia az appconfig kv import.

Eksportowanie danych

Eksportuje dane konfiguracji przechowywane w usłudze App Configuration do innego miejsca docelowego. Użyj funkcji eksportu, na przykład, aby zapisać dane z magazynu usługi App Configuration do pliku, który można osadzić w kodzie aplikacji podczas wdrażania.

W tym przewodniku pokazano, jak wyeksportować dane usługi App Configuration:

• do pliku konfiguracji w formacie Json, Yaml lub Właściwości
• do magazynu usługi App Configuration
• do zasobu usługi aplikacja systemu Azure

Eksportowanie danych do pliku konfiguracji

Wykonaj następujące kroki, aby wyeksportować dane konfiguracji z magazynu usługi App Configuration do pliku JSON, YAML lub Właściwości.

Portal

W witrynie Azure Portal wykonaj następujące kroki:

1. Przejdź do sklepu App Configuration i wybierz pozycję Importuj/eksportuj.

   

2. Wybierz przycisk radiowy Eksportuj, a następnie w obszarze Typ docelowy wybierz pozycję Plik konfiguracji.

3. Wypełnij formularz następującymi parametrami:

   Parametr	Opis	Przykład
   Typ pliku	Wybierz typ pliku dla eksportu: YAML, Właściwości lub JSON.	JSON
   Profil zawartości pliku	Wybierz profil zawartości: Domyślny lub KVSet. Domyślny profil zawartości pliku odnosi się do konwencjonalnego schematu pliku konfiguracji powszechnie stosowanego przez istniejące struktury programowania lub systemy, obsługuje formaty plików JSON, Yaml lub Properties. Profil zawartości pliku KVSet odnosi się do schematu pliku zawierającego wszystkie właściwości klucza-wartości konfiguracji aplikacji, w tym klucz, wartość, etykietę, typ zawartości i tagi.	Wartość domyślna
   Tryb zaznaczenia	Wybierz, czy chcesz wyeksportować z zwykłych wartości klucz-wartość, która jest opcją domyślną, czy z migawki.	Wartość domyślna
   Filtr klucza	Służy do filtrowania wartości klucz-wartości na podstawie nazwy klucza do eksportu. Jeśli nie określono żadnych kluczy, wszystkie klucze kwalifikują się.	Rozpoczyna się od aplikacji TestApp:
   W określonym czasie	Opcjonalny. Wypełnij to pole, aby wyeksportować wartości kluczy z określonego punktu w czasie w wybranym magazynie konfiguracji. Jeśli pole pozostanie puste, wartość domyślna to bieżący punkt w czasie wartości klucz-wartość.	28.07.2022 12:00:00
   Z etykiety	Wybierz etykietę, aby wyeksportować wartości kluczy skojarzone z tymi etykietami. Jeśli żadna etykieta nie zostanie wybrana, wszystkie etykiety kwalifikują się. Pamiętaj, że podczas eksportowania z profilem zawartości pliku można wybrać tylko jedną etykietę Default . Aby wyeksportować wartości kluczy z więcej niż jedną etykietą, użyj KVSet profilu zawartości pliku.	Prod
   Usuń prefiks	Opcjonalny. Jeśli zostanie określony, prefiks zostanie usunięty z nazw kluczy wszystkich wyeksportowanych wartości klucza, które go zawierają.	TestApp:
   Separator	Separator jest ogranicznikiem używanym do segmentowania nazw kluczy i rekonstruowania konfiguracji hierarchicznych dla plików JSON lub YAML z wartości klucz-wartości. Zostanie on zignorowany dla plików właściwości i flag funkcji. Obsługiwane wartości nie obejmują separatora, kropki (.), przecinka (,), średnika (;), łącznika (-), podkreślenia (_), podwójnego podkreślenia (__), ukośnika (/) i dwukropka (:).	:

4. Wybierz pozycję Eksportuj , aby zakończyć eksport.

Wyeksportowano wartości kluczy ze sklepu App Configuration od 28 lipca 2021 r. o godzinie 12:00 z nazwami kluczy rozpoczynającymi się TestApp: od i etykietą proddo pliku JSON. Prefiks TestApp: został przycięty z nazw kluczy, a separator : został użyty do segmentowania nazw kluczy i odtworzenia hierarchicznego formatu JSON.

Interfejs wiersza polecenia platformy Azure

W interfejsie wiersza polecenia platformy Azure wykonaj poniższe kroki. Jeśli nie masz zainstalowanego lokalnie interfejsu wiersza polecenia platformy Azure, możesz opcjonalnie użyć usługi Azure Cloud Shell.

1. Wprowadź polecenie az appconfig kv export eksportu i dodaj następujące parametry:

   Parametr	Opis	Przykład
   --name	Wprowadź nazwę magazynu App Configuration, który zawiera wartości klucza, które chcesz wyeksportować.	my-app-config-store
   --destination	Wprowadź file , aby wskazać, że eksportujesz dane do pliku.	file
   --path	Wprowadź ścieżkę, w której chcesz zapisać plik.	C:/Users/john/Downloads/data.json
   --format	Wprowadź yamlwartość lub json properties , aby wskazać format pliku, który chcesz wyeksportować.	json
   --label	Wprowadź etykietę, aby wyeksportować wartości kluczy i flag funkcji z tą etykietą. Jeśli domyślnie nie określisz etykiety, eksportujesz tylko flagi key-values i feature bez etykiety. Możesz wprowadzić jedną etykietę, wprowadzić kilka etykiet, oddzielając je ciągiem ,, lub użyć * polecenia , aby uwzględnić wszystkie etykiety.	prod

   Ważne

   Jeśli nie wybierzesz etykiety, zostaną wyeksportowane tylko wartości klucz-wartości bez etykiet. Aby wyeksportować klucz-wartość z etykietą, musisz wybrać jego etykietę.

2. Opcjonalnie dodaj również następujące parametry:

   Parametr	Opis	Przykład
   --separator	Opcjonalny. Separator jest ogranicznikiem spłaszczania wartości kluczy do pliku Json/Yaml. Jest to wymagane do eksportowania struktury hierarchicznej i będzie ignorowane dla plików właściwości i flag funkcji. Wybierz jedną z następujących opcji: ., , ,, :;, /, -, _. —	;
   --prefix	Opcjonalny. Prefiks do przycinania z każdej właściwości "klucz-wartość". Prefiks klucza jest początkową częścią klucza. Prefiksy mogą służyć do zarządzania grupami klucz-wartości w magazynie konfiguracji. Prefiks zostanie zignorowany dla flag funkcji.	TestApp:

   Przykład: wyeksportuj wszystkie flagi key-values i feature z etykietą "prod" do pliku JSON.

   az appconfig kv export --name my-app-config-store --label prod --destination file --path D:/abc.json --format json --separator ; --prefix TestApp:
   

3. W wierszu polecenia zostanie wyświetlona lista klucz-wartości eksportowanych do pliku. Potwierdź eksport, wybierając pozycję y.

   

Wyeksportowano flagi key-values i feature z etykietą "prod" do pliku konfiguracji i przycięte prefiks "TestApp". Wartości są oddzielone ciągami ";" w pliku.

Aby uzyskać więcej opcjonalnych parametrów i przykładów, przejdź do polecenia az appconfig kv export.

Eksportowanie danych do magazynu usługi App Configuration

Wykonaj poniższe kroki, aby wyeksportować flagi key-values i feature do magazynu konfiguracji aplikacja systemu Azure.

Możesz wyeksportować wartości z jednego magazynu usługi App Configuration do innego magazynu usługi App Configuration lub wyeksportować wartości z jednego magazynu usługi App Configuration do tego samego magazynu usługi App Configuration, aby zduplikować jego wartości i zastosować różne parametry, takie jak nowa etykieta lub typ zawartości.

Portal

W witrynie Azure Portal wykonaj następujące kroki:

1. Przejdź do magazynu usługi App Configuration zawierającego dane, które chcesz wyeksportować, i wybierz pozycję Importuj/eksportu z menu Operacje .

   

2. Wybierz przycisk radiowy Eksportuj i w obszarze Typ docelowy wybierz pozycję Konfiguracja aplikacji.

3. Wypełnij formularz następującymi parametrami:

   Parametr	Opis	Przykład
   Tryb zaznaczenia	Wybierz, czy chcesz wyeksportować z zwykłych wartości klucz-wartość, która jest opcją domyślną, czy z migawki.	Wartość domyślna
   Filtr klucza	Służy do filtrowania wartości klucz-wartości na podstawie nazwy klucza do eksportu. Jeśli nie określono żadnych kluczy, wszystkie klucze kwalifikują się.	Rozpoczyna się od aplikacji TestApp:
   W określonym czasie	Opcjonalny. Wypełnij to pole, aby wyeksportować wartości kluczy z określonego punktu w czasie w wybranym magazynie konfiguracji. Jeśli pole pozostanie puste, wartość domyślna to bieżący punkt w czasie wartości klucz-wartość.	28.07.2022 12:00:00
   Z etykiety	Wybierz co najmniej jedną etykietę, aby wyeksportować wartości kluczy skojarzone z tymi etykietami. Jeśli żadna etykieta nie zostanie wybrana, wszystkie etykiety kwalifikują się.	Prod
   Wyklucz flagę funkcji	Jeśli to pole wyboru, flagi funkcji nie zostaną wyeksportowane.	Niezaznaczone

4. Wybierz magazyn docelowy, wypełnij formularz następującymi parametrami:

   Parametr	Opis	Przykład
   Subskrypcja	Bieżąca subskrypcja jest domyślnie zaznaczona.	moja subskrypcja
   Grupa zasobów	Wybierz grupę zasobów zawierającą magazyn App Configuration, w którym chcesz wyeksportować konfigurację. Bieżąca grupa zasobów jest domyślnie zaznaczona.	my-resource-group
   Zasób	Wybierz magazyn App Configuration, w którym chcesz wyeksportować konfigurację.	my-other-app-config-store

5. Wypełnij następną część formularza:

   Parametr	Opis	Przykład
   Usuń prefiks	Opcjonalny. Jeśli zostanie określony, prefiks zostanie usunięty z nazw kluczy wszystkich wyeksportowanych wartości klucza, które go zawierają.	TestApp:
   Zastępowanie etykiet	Opcjonalny. Domyślnie oryginalne etykiety wartości klucza źródłowego są zachowywane. Aby je zastąpić, zaznacz pole wyboru i wprowadź nową etykietę dla wyeksportowanych klucz-wartości.	new
   Zastępowanie typów zawartości	Opcjonalny. Domyślnie oryginalne typy zawartości wartości klucza źródłowego są zachowywane. Aby je zastąpić, zaznacz pole i wprowadź nowy typ zawartości dla wyeksportowanych klucz-wartości. Należy pamiętać, że nie można zastąpić typu zawartości flag funkcji.	JSON (application/json)

6. Wybierz pozycję Zastosuj , aby kontynuować eksportowanie.

Wyeksportowano wartości kluczy ze sklepu App Configuration od 28 lipca 2022 r. o godzinie 12:00 z nazwami kluczy rozpoczynającymi się od TestApp: i etykietą proddo innego magazynu usługi App Configuration. Wszystkie wyeksportowane wartości klucza zostały przycięte prefiksem TestApp:klucza i przypisano etykietę new i typ application/jsonzawartości .

Interfejs wiersza polecenia platformy Azure

W interfejsie wiersza polecenia platformy Azure wykonaj poniższe kroki. Jeśli nie masz zainstalowanego lokalnie interfejsu wiersza polecenia platformy Azure, możesz opcjonalnie użyć usługi Azure Cloud Shell.

1. Wprowadź polecenie az appconfig kv export eksportu i wprowadź następujące parametry:

   Parametr	Opis	Przykład
   --name	Wprowadź nazwę magazynu App Configuration, który zawiera wartości klucza, które chcesz wyeksportować.	my-app-config-store
   --destination	Wprowadź , appconfig aby wskazać, że eksportujesz dane do magazynu usługi App Configuration.	appconfig
   --dest-name	Wprowadź nazwę magazynu App Configuration, do którego chcesz wyeksportować dane.	my-other-app-config-store
   --label	Wprowadź etykietę, aby wyeksportować wartości kluczy i flag funkcji z tą etykietą. Jeśli domyślnie nie określisz etykiety, eksportujesz tylko flagi key-values i feature bez etykiety. Możesz wprowadzić jedną etykietę, wprowadzić kilka etykiet, oddzielając je od ,, lub użyć * polecenia , aby pobrać wszystkie etykiety na koncie.	prod

   Ważne

   Jeśli wartości klucz-wartości, które chcesz wyeksportować, mają etykiety, musisz użyć polecenia --label i wprowadzić odpowiednie etykiety. Jeśli nie wybierzesz etykiety, zostaną wyeksportowane tylko wartości klucz-wartości bez etykiet. Użyj znaku przecinka (,), aby wybrać kilka etykiet lub użyć * do uwzględnienia wszystkich etykiet, w tym etykiety o wartości null (bez etykiety).

2. Opcjonalnie dodaj również następujący parametr:

   Parametr	Opis	Przykład
   --dest-label	Opcjonalny. Wprowadź etykietę docelową, aby przypisać tę etykietę do wyeksportowanych wartości kluczy.	new

   Przykład: wyeksportuj flagi key-values i feature z etykietą "prod" do innego magazynu usługi App Configuration i dodaj etykietę docelową "new".

   az appconfig kv export --name my-app-config-store --destination appconfig --dest-name my-other-app-config-store --dest-label new --label prod
   

3. W wierszu polecenia zostanie wyświetlona lista klucz-wartości eksportowanych do plików. Potwierdź eksport, wybierając pozycję y.

   

Wyeksportowano flagi key-values i feature z etykietą "prod" ze sklepu App Configuration i przypisano do nich etykietę "new".

Aby uzyskać więcej opcjonalnych parametrów i przykładów, przejdź do polecenia az appconfig kv import.

Eksportowanie danych do usługi aplikacja systemu Azure

Wykonaj poniższe kroki, aby wyeksportować wartości kluczy do usługi aplikacja systemu Azure Service.

Uwaga

Eksportowanie flag funkcji do usługi App Service nie jest obsługiwane.

Portal

W witrynie Azure Portal wykonaj następujące kroki:

1. Przejdź do sklepu App Configuration i wybierz pozycję Importuj/eksportuj z menu Operacje.

   

2. Wybierz przycisk radiowy Eksportuj i w obszarze Typ docelowy wybierz pozycję App Services.

3. Opcja Eksportuj jako odwołanie jest domyślnie zaznaczona. Po zaznaczeniu pola ustawienia aplikacji w usłudze App Service zostaną dodane jako odwołania do usługi App Configuration dla wyeksportowanych klucz-wartości. Dzięki temu możesz zarządzać ustawieniami w usłudze App Configuration, a usługa App Service automatycznie ściąga bieżące wartości z usługi App Configuration. Aby dowiedzieć się więcej, zobacz Use App Configuration references for App Service and Azure Functions (Używanie odwołań do konfiguracji aplikacji dla usług App Service i Azure Functions). Jeśli pole jest niezaznaczone, klucz i wartość zostaną bezpośrednio wyeksportowane do usługi App Service. Pamiętaj, aby ponownie wyeksportować dane za każdym razem, gdy wprowadzisz zmiany w usłudze App Configuration, aby upewnić się, że aplikacja pobiera aktualizacje.

4. Wypełnij formularz następującymi parametrami:

   Parametr	Opis	Przykład
   Tryb zaznaczenia	Wybierz, czy chcesz wyeksportować z zwykłych wartości klucz-wartość, która jest opcją domyślną, czy z migawki.	Wartość domyślna
   Filtr klucza	Służy do filtrowania wartości klucz-wartości na podstawie nazwy klucza do eksportu. Jeśli nie określono żadnych kluczy, wszystkie klucze kwalifikują się.	Rozpoczyna się od aplikacji TestApp:
   W określonym czasie	Opcjonalny. Wypełnij to pole, aby wyeksportować wartości kluczy z określonego punktu w czasie w wybranym magazynie konfiguracji. Jeśli pole pozostanie puste, wartość domyślna to bieżący punkt w czasie wartości klucz-wartość.	28.07.2022 12:00:00
   Z etykiety	Wybierz jedną etykietę, aby wyeksportować wartości kluczy skojarzone z tą etykietą.	Prod

5. Wybierz magazyn docelowy i wypełnij formularz następującymi parametrami:

   Parametr	Opis	Przykład
   Subskrypcja	Bieżąca subskrypcja jest domyślnie zaznaczona.	moja subskrypcja
   Grupa zasobów	Wybierz grupę zasobów zawierającą usługę App Service, w której chcesz wyeksportować konfigurację.	my-resource-group
   Zasób	Wybierz usługę App Service, w której chcesz wyeksportować konfigurację.	my-app-service

6. Opcjonalnie wypełnij następną część formularza:

   Parametr	Opis	Przykład
   Usuń prefiks	Opcjonalny. Jeśli zostanie określony, prefiks zostanie usunięty z nazw kluczy wszystkich wyeksportowanych wartości klucza, które go zawierają.	TestApp:

7. Wybierz pozycję Zastosuj , aby kontynuować eksportowanie.

Wyeksportowano wartości kluczy ze sklepu App Configuration od 28 lipca 2022 r. o godzinie 12:00 z nazwami kluczy rozpoczynającymi się TestApp: od i etykietą proddo ustawień aplikacji zasobu usługi App Service. Prefiks TestApp: został przycięty z wyeksportowanych nazw kluczy.

Jeśli pole wyboru umożliwia wyeksportowanie wartości kluczy jako odwołań, wyeksportowane wartości klucza są wskazywane jako odwołania do usługi App Configuration w kolumnie "Źródło" ustawień konfiguracji zasobów usługi App Service.

Interfejs wiersza polecenia platformy Azure

W interfejsie wiersza polecenia platformy Azure wykonaj poniższe kroki. Jeśli nie masz zainstalowanego lokalnie interfejsu wiersza polecenia platformy Azure, możesz opcjonalnie użyć usługi Azure Cloud Shell.

1. Wprowadź polecenie az appconfig kv export eksportu i wprowadź następujące parametry:

   Parametr	Opis	Przykład
   --name	Wprowadź nazwę magazynu App Configuration, który zawiera wartości klucza, które chcesz wyeksportować.	my-app-config-store
   --destination	Wprowadź , appservice aby wskazać, że eksportujesz dane do usługi App Service.	appservice
   --appservice-account	Wprowadź identyfikator arm usługi App Service lub użyj nazwy usługi App Service, jeśli znajduje się ona w tej samej subskrypcji i grupie zasobów co usługa App Configuration.	/subscriptions/123/resourceGroups/my-as-resource-group/providers/Microsoft.Web/sites/my-app-service lub my-app-service
   --label	Opcjonalny. Wprowadź etykietę, aby wyeksportować wartości kluczy i flag funkcji z tą etykietą. Jeśli domyślnie nie określisz etykiety, wyeksportujesz tylko flagi key-values i feature bez etykiety.	prod

   Aby uzyskać wartość parametru --appservice-account, użyj polecenia az webapp show --resource-group <resource-group> --name <resource-name>.

2. Opcjonalnie dodaj również prefiks:

   Parametr	Opis	Przykład
   --prefix	Opcjonalny. Prefiks do przycinania z wyeksportowanej właściwości klucz-wartość "klucz". Prefiks klucza jest początkową częścią klucza. Prefiksy mogą służyć do zarządzania grupami klucz-wartości w magazynie konfiguracji.	TestApp:

   Przykład: wyeksportuj wszystkie wartości klucza z etykietą "prod" do aplikacji usługi App Service i przycinaj prefiks "TestApp".

   az appconfig kv export --name my-app-config-store --destination appservice --appservice-account /subscriptions/123/resourceGroups/my-resource-group/providers/Microsoft.Web/sites/my-app-service/config/web --label prod --prefix TestApp:
   

   W wierszu polecenia zostanie wyświetlona lista klucz-wartości eksportowanych do zasobu usługi App Service. Potwierdź eksport, wybierając pozycję y.

   

   Wszystkie wartości klucza zostały wyeksportowane z etykietą "prod" do zasobu usługi aplikacja systemu Azure i przycięte prefiks "TestApp:".

3. Opcjonalnie określ flagę do wyeksportowania jako odwołanie do konfiguracji aplikacji.

   Parametr	Opis
   --export-as-reference -r	Opcjonalny. Określ, czy klucz-wartości są eksportowane do usługi App Service jako odwołania do usługi App Configuration. Dowiedz się więcej.

   Przykład: wyeksportuj wszystkie wartości kluczy z etykietą "prod" jako odwołania do konfiguracji aplikacji usługi App Service.

   az appconfig kv export --name my-app-config-store --destination appservice --appservice-account "/subscriptions/123/resourceGroups/my-resource-group/providers/Microsoft.Web/sites/my-app-service" --label prod --export-as-reference
   

   W wierszu polecenia zostanie wyświetlona lista klucz-wartości eksportowanych jako odwołania do konfiguracji aplikacji do zasobu usługi App Service. Potwierdź eksport, wybierając pozycję y.

   

   Wszystkie wartości klucza zostały wyeksportowane z etykietą "prod" jako odwołania do konfiguracji aplikacji do zasobu usługi aplikacja systemu Azure. W zasobie usługi App Service zaimportowane wartości klucza będą wskazywane jako odwołania do usługi App Configuration w kolumnie "Źródło".

   

Aby uzyskać więcej opcjonalnych parametrów i przykładów, przejdź do polecenia az appconfig kv export.

Komunikaty o błędach

Podczas importowania lub eksportowania kluczy konfiguracji aplikacji mogą wystąpić następujące komunikaty o błędach:

• Dostęp publiczny jest wyłączony dla sklepu lub uzyskujesz dostęp z prywatnego punktu końcowego, który nie znajduje się w konfiguracjach prywatnego punktu końcowego magazynu. Jeśli magazyn usługi App Configuration ma włączone prywatne punkty końcowe, dostęp do niego można uzyskać tylko z poziomu skonfigurowanej sieci wirtualnej domyślnie. Upewnij się, że maszyna z uruchomioną witryną Azure Portal lub interfejsem wiersza polecenia jest przyłączona do tej samej sieci wirtualnej co prywatny punkt końcowy. Jeśli właśnie włączono dostęp do sieci publicznej do magazynu usługi App Configuration, poczekaj co najmniej 5 minut, zanim ponowisz próbę, aby umożliwić odświeżanie pamięci podręcznej.

Następne kroki

Integracja z potokiem ciągłej integracji/ciągłego wdrażania