Importowanie lub eksportowanie danych konfiguracji

Azure App Configuration obsługuje operacje importowania i eksportowania danych. Te operacje umożliwiają pracę z danymi konfiguracji zbiorczo i wymianą danych między App Configuration magazynem i projektem kodu. Można na przykład skonfigurować jeden App Configuration magazynu na potrzeby testowania, a drugi na potrzeby środowiska produkcyjnego. Ustawienia aplikacji można kopiować 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 App Configuration. Jeśli chcesz skonfigurować ciągłą synchronizację z repozytorium GitHub, zapoznaj się z zadaniami GitHub Actions i Azure Pipelines.

Dane można importować lub eksportować przy użyciu Azure Portal lub interfejsu wiersza polecenia platformy Azure.

Importowanie danych

Importowanie powoduje przeniesienie danych konfiguracji do magazynu App Configuration z istniejącego źródła. Funkcja importu służy do migrowania danych do magazynu App Configuration lub agregowania danych z wielu źródeł.

W tym przewodniku przedstawiono sposób importowania App Configuration danych:

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

Importowanie danych z pliku konfiguracji

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

Uwaga

Importowanie flag funkcji z pliku nie jest obsługiwane. Jeśli plik konfiguracji zawiera flagi funkcji, zostaną one automatycznie zaimportowane jako zwykłe wartości kluczy.

Portal

W Azure Portal wykonaj następujące kroki:

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

   

2. Na karcie Importowanie wybierz pozycję Plik konfiguracji w obszarze Usługa źródłowa.

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

   Parametr	Opis	Przykład
   Język	Wybierz język pliku importowanych między platformami .NET, Java (Spring) i Inne.	.NET
   Typ pliku	Wybierz typ pliku, który importujesz między plikami Yaml, Properties i Json.	Json

4. Wybierz ikonę Folder i przejdź do pliku do zaimportowania.

   Uwaga

   Na ekranie jest wyświetlany komunikat wskazujący, że plik został pomyślnie pobrany.

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

   Parametr	Opis	Przykład
   Separator	Separator jest znakiem analizowanym w zaimportowanym pliku konfiguracji w celu oddzielenia wartości klucz-wartości, które zostaną dodane do magazynu konfiguracji. Wybierz jedną z następujących opcji: ., ,, :, ;, /, , -_, —.	;
   Prefiks	Opcjonalny. Prefiks klucza jest początkową częścią właściwości "key-value". Prefiksy mogą służyć do zarządzania grupami klucz-wartości w magazynie konfiguracji. Wprowadzony prefiks zostanie dołączony do przodu właściwości "key" każdej wartości klucza importowanej z tego pliku.	TestApp:
   Etykieta	Opcjonalny. Wybierz istniejącą etykietę lub wprowadź nową etykietę, która zostanie przypisana do zaimportowanych wartości kluczy.	Prod
   Typ zawartości	Opcjonalny. Określ, czy importujesz plik JSON lub Key Vault odwołania. Aby uzyskać więcej informacji na temat odwołań Key Vault, zobacz Używanie odwołań Key Vault w aplikacji ASP.NET Core.	JSON (application/json)

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

Zaimportowano wartości kluczy z pliku JSON, przypisano im etykietę "prod" i prefiks "TestApp". Separator ":" jest używany, a wszystkie zaimportowane wartości klucza mają typ zawartości ustawiony jako "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ź wartość , 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 klucz-wartości 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 kluczy.	prod
   --content-type	Opcjonalny. Wprowadź appconfig/kvset lub application/json określ, że zaimportowana zawartość składa się z odwołania Key Vault lub pliku JSON.	application/json

   Przykład: zaimportuj wszystkie flagi klucz-wartości i funkcje 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. Wiersz polecenia wyświetla listę nadchodzących zmian. Potwierdź importowanie, wybierając ypozycję .

   

Zaimportowano wartości kluczy z pliku JSON, przypisano im etykietę "prod" i prefiks "TestApp:". Separator ";" jest używany, a 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 App Configuration

Możesz zaimportować wartości z jednego magazynu App Configuration do innego magazynu App Configuration lub zaimportować wartości z jednego magazynu App Configuration do tego samego magazynu 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 Azure App Configuration.

Portal

W Azure Portal wykonaj następujące kroki:

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

   

2. Na karcie Import (Importowanie) wybierz pozycję App Configuration w obszarze Usługa źródłowa.

3. Wybierz pozycję Wybierz zasób, wypełnij formularz następującymi parametrami i wybierz pozycję Zastosuj:

   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

   Uwaga

   Komunikat "Pomyślnie pobrano klucze dostępu" wskazuje, że połączenie z magazynem App Configuration zakończyło się pomyślnie".

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

   Parametr	Opis	Przykład
   Z etykiety	Wybierz co najmniej jedną etykietę, aby zaimportować wartości z odpowiednimi etykietami. Wybranie wszystkich wartości klucza spowoduje zaimportowanie wartości klucza z dowolną etykietą, a opcja (Bez etykiety) ograniczy importowanie do par klucz-wartości bez etykiety.	Prod
   W określonym czasie	Opcjonalny. Wypełnij polecenie , aby zaimportować wartości klucza z określonego punktu w czasie. Jest to punkt w czasie wartości kluczy w wybranym magazynie konfiguracji. Format: "RRRR-MM-DDThh:mm:ssZ". To pole domyślnie określa bieżący punkt w czasie wartości klucza, gdy pole pozostanie puste.	28.07.2022 12:00:00
   Zastępowanie domyślnych etykiet klucz-wartość	Opcjonalny. Domyślnie importowane elementy używają bieżącej etykiety. Zaznacz to pole i wprowadź etykietę, aby zastąpić te wartości domyślne etykietą niestandardową.	Nowy
   Zastępowanie domyślnego typu zawartości klucz-wartość	Opcjonalny. Domyślnie importowane elementy używają bieżącego typu zawartości. Zaznacz pole wyboru i wybierz pozycję Key Vault Odwołanie lub JSON (application/json) w obszarze Typ zawartości, aby stwierdzić, że zaimportowana zawartość składa się z odwołania Key Vault lub pliku JSON. Typ zawartości można zastąpić tylko dla zaimportowanych wartości klucza. Domyślny typ zawartości flag funkcji to "application/vnd.microsoft.appconfig.ff+json;charset=utf-8" i nie jest aktualizowany przez ten parametr.	JSON (application/json)

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

Zaimportowano flagi key-values i feature z etykietą "prod" z magazynu App Configuration w dniu 28 stycznia 2021 r. o godzinie 12:00 i przypisano im etykietę "new". Wszystkie zaimportowane wartości klucza mają typ zawartości ustawiony jako "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 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 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 par klucz-wartości przy użyciu określonej etykiety. Jeśli nie używasz tego parametru, zostaną zaimportowane tylko pary klucz-wartości z etykietą o wartości null. Obsługuje znak star 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 klucz-wartości.	new
   --content-type	Opcjonalny. Wprowadź appconfig/kvset lubapplication/json, aby stwierdzić, że zaimportowana zawartość składa się z odwołania Key Vault lub pliku JSON. Typ zawartości można zastąpić tylko dla zaimportowanych wartości klucza. 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 innego 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, wybierając pozycję y.

   

Zaimportowano wartości kluczy z etykietą "prod" z magazynu 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 Azure App Service

Wykonaj poniższe kroki, aby zaimportować pary klucz-wartości z Azure App Service.

Uwaga

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

Portal

Z witryny Azure Portal:

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

   

2. Na karcie Importowanie wybierz pozycję App Services w obszarze Usługa źródłowa.

3. Wybierz pozycję Wybierz zasób, wypełnij formularz następującymi parametrami i wybierz pozycję Zastosuj:

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

   Uwaga

   Zostanie wyświetlony komunikat wskazujący liczbę wartości kluczy, które zostały pomyślnie pobrane z zasobu źródłowego App Service.

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

   Parametr	Opis	Przykład
   Prefiks	Opcjonalny. Prefiks klucza jest początkową częścią właściwości "klucz" wartoś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:
   Etykieta	Opcjonalny. Wybierz istniejącą etykietę lub wprowadź nową etykietę, która zostanie przypisana do zaimportowanych wartości kluczy.	Prod
   Typ zawartości	Opcjonalny. Określ, czy importowane pliki są odwołaniem Key Vault lub plikiem JSON. Aby uzyskać więcej informacji na temat odwołań Key Vault, zobacz Używanie odwołań Key Vault w aplikacji ASP.NET Core.	JSON (application/json)

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

Wszystkie ustawienia aplikacji zostały zaimportowane z App Service jako wartości kluczy i przypisano im etykietę "prod" i prefiks "TestApp". Wszystkie zaimportowane wartości klucza mają typ zawartości ustawiony jako "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ź wartość , appservice aby wskazać, że importujesz dane konfiguracji aplikacji z Azure App Service.	appservice
   --appservice-account	Wprowadź identyfikator arm App Service lub użyj nazwy App Service, jeśli znajduje się ona w tej samej subskrypcji i grupie zasobów co 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 "key-value". 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 kluczy. Jeśli nie określisz etykiety, etykieta o wartości null zostanie przypisana do wartości klucz-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 Key Vault lub pliku JSON.	application/json

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

   Przykład: zaimportuj wszystkie ustawienia aplikacji z App Service jako wartości klucza z etykietą "prod", do magazynu 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. Wiersz polecenia wyświetla listę nadchodzących zmian. Potwierdź importowanie, wybierając ypozycję .

   

Wszystkie ustawienia aplikacji zostały zaimportowane z App Service jako klucz-wartości, przypisał 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

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

W tym przewodniku przedstawiono sposób eksportowania App Configuration danych:

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

Eksportowanie danych do pliku konfiguracji

Wykonaj poniższe kroki, aby wyeksportować dane konfiguracji z magazynu konfiguracji aplikacji do pliku Json, Yaml lub Properties.

Uwaga

Eksportowanie flag funkcji z magazynu App Configuration do pliku konfiguracji jest obecnie obsługiwane tylko w interfejsie wiersza polecenia.

Portal

W Azure Portal wykonaj następujące kroki:

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

   

2. Na karcie Eksportuj wybierz pozycję Plik konfiguracji w obszarze Usługa docelowa.

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

   Parametr	Opis	Przykład
   Prefiks	Opcjonalny. Ten prefiks zostanie przycięty z właściwości "klucz" każdej wartości klucza. Prefiks klucza jest początkową częścią klucza. Prefiksy mogą służyć do zarządzania grupami klucz-wartości w magazynie konfiguracji.	TestApp:
   Z etykiety	Wybierz istniejącą etykietę, aby ograniczyć eksport do wartości kluczy z określoną etykietą. Jeśli nie wybierzesz etykiety, domyślnie zostaną wyeksportowane tylko wartości klucz-wartości z etykietą "Brak etykiety". Zobacz notatkę poniżej.	Prod
   W określonym czasie	Opcjonalny. Wypełnij polecenie , aby zaimportować wartości klucza z określonego punktu w czasie. Jest to punkt w czasie wartości kluczy w wybranym magazynie konfiguracji. Format: "RRRR-MM-DDThh:mm:ssZ". To pole domyślnie określa bieżący punkt w czasie wartości klucza, gdy pole pozostanie puste.	28.07.2022 12:00:00
   Typ pliku	Wybierz typ pliku eksportowanego między plikami Yaml, Properties lub Json.	JSON
   Separator	Separator jest ogranicznikiem spłaszczania par klucz-wartości do pliku Json/Yaml. Obsługuje on strukturę hierarchiczną konfiguracji i nie ma zastosowania do plików właściwości i flag funkcji. Wybierz jedną z następujących opcji: ., ,, :, ;, /, , -_, — lub (Bez separatora).	;

   Ważne

   Jeśli nie wybierzesz etykiety Od, zostaną wyeksportowane tylko wartości klucz-wartości bez etykiet. Aby wyeksportować klucz-wartość z etykietą, musisz wybrać jej etykietę. Pamiętaj, że możesz wybrać tylko jedną etykietę na eksport w portalu, jeśli chcesz wyeksportować klucz-wartości ze wszystkimi określonymi etykietami, użyj interfejsu wiersza polecenia.

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

Wyeksportowano wartości kluczy, które mają etykietę "prod" z pliku konfiguracji, w ich stanie od 28.07.2021 12:00:00 i przycięte prefiks "TestApp". Wartości są rozdzielane znakami ";" w pliku.

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 zawierającego klucz-wartości, 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 jsonproperties , 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 pobrać wszystkie etykiety na koncie.	prod

   Ważne

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

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

   Parametr	Opis	Przykład
   --separator	Opcjonalny. Separator jest ogranicznikiem spłaszczania par klucz-wartości 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 klucz-wartości i funkcji, które mają etykietę "prod" do pliku konfiguracji i przycięły prefiks "TestApp". Wartości są rozdzielane znakami ";" w pliku.

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

Eksportowanie danych do magazynu App Configuration

Wykonaj poniższe kroki, aby wyeksportować flagi key-values i feature do magazynu Azure App Configuration.

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

Portal

W Azure Portal wykonaj następujące kroki:

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

   

2. Na karcie Eksportuj wybierz pozycję App Configuration w obszarze Usługa docelowa.

3. Wybierz pozycję Wybierz zasób, wypełnij formularz następującymi parametrami i wybierz pozycję Zastosuj:

   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.	my-resource-group
   Zasób	Wybierz magazyn App Configuration zawierający konfigurację, którą chcesz zaimportować.	my-app-config-store

4. Na stronie zostanie wyświetlona wybrana usługa docelowa i identyfikator zasobu. Akcja Wybierz zasób umożliwia przełączenie się do innego magazynu App Configuration źródłowego.

   Uwaga

   Na ekranie zostanie wyświetlony komunikat wskazujący, że klucz-wartości zostały pomyślnie pobrane.

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

   Parametr	Opis	Przykład
   Z etykiety	Wybierz co najmniej jedną etykietę, aby wyeksportować wartości z odpowiednimi etykietami. Wybranie wszystkich spowoduje wyeksportowanie wartości kluczy z dowolną etykietą, a (bez etykiety) spowoduje ograniczenie eksportu do wartości kluczy bez etykiety.	Prod
   W określonym czasie	Opcjonalny. Wypełnij polecenie , aby zaimportować wartości klucza z określonego punktu w czasie. Jest to punkt w czasie wartości kluczy w wybranym magazynie konfiguracji. Format: "RRRR-MM-DDThh:mm:ssZ". To pole domyślnie określa bieżący punkt w czasie wartości klucza, gdy pole pozostanie puste.	28.07.2022 12:00:00
   Zastępowanie domyślnych etykiet klucz-wartość	Opcjonalny. Domyślnie importowane elementy używają bieżącej etykiety. Zaznacz to pole i wprowadź etykietę, aby zastąpić te wartości domyślne etykietą niestandardową.	Nowy

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

Wyeksportowano flagi klucz-wartości i funkcji, które mają etykietę "prod" z magazynu App Configuration, w ich stanie od 28.07.2022 12:00:00 i przypisali im etykietę "new".

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 zawierającego klucz-wartości, które chcesz wyeksportować.	my-app-config-store
   --destination	Wprowadź , appconfig aby wskazać, że eksportujesz dane do magazynu 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 ciągiem ,, lub użyć * polecenia , aby pobrać wszystkie etykiety na koncie.	prod

   Ważne

   Jeśli klucz-wartości, które chcesz wyeksportować, mają etykiety, należy użyć polecenia --label i wprowadzić odpowiednie etykiety. Jeśli nie wybierzesz etykiety, zostaną wyeksportowane tylko wartości klucz-wartość bez etykiet. Użyj znaku przecinka (,), aby wybrać kilka etykiet lub użyć ich * 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 kluczy-wartości.	new

   Przykład: wyeksportuj flagi key-values i feature z etykietą "prod" do innego magazynu 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" z magazynu 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 Azure App Service

Wykonaj poniższe kroki, aby wyeksportować wartości kluczy do Azure App Service.

Uwaga

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

Portal

W Azure Portal wykonaj następujące kroki:

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

   

2. Na karcie Eksport wybierz pozycję App Services w obszarze Usługa docelowa.

3. Wybierz pozycję Wybierz zasób, wypełnij formularz następującymi parametrami i wybierz pozycję Zastosuj:

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

4. Na stronie zostanie wyświetlona wybrana usługa docelowa i identyfikator zasobu. Akcja Wybierz zasób umożliwia przełączenie się na inny zasób docelowy App Service.

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

   Parametr	Opis	Przykład
   Prefiks	Opcjonalny. Ten prefiks zostanie przycięty z każdej wyeksportowanej 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:
   Eksportuj jako odwołanie	Opcjonalny. Sprawdź, czy wyeksportować wartości kluczy do App Service jako odwołania App Configuration. Dowiedz się więcej
   W określonym czasie	Opcjonalny. Wypełnij polecenie , aby wyeksportować wartości klucza z określonego punktu w czasie. Jest to punkt w czasie wartości kluczy w wybranym magazynie konfiguracji. Format: "RRRR-MM-DDThh:mm:ssZ". To pole domyślnie określa bieżący punkt w czasie wartości klucza, gdy pole pozostanie puste.	28.07.2022 12:00:00
   Z etykiety	Opcjonalny. Wybierz istniejącą etykietę, aby ograniczyć eksport do par klucz-wartości z określoną etykietą. Jeśli nie wybierzesz etykiety, zostaną wyeksportowane tylko wartości klucza z etykietą "Brak etykiety".	Prod

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

Wyeksportowano wartości kluczy, które mają etykietę "prod" z zasobu App Service, w stanie od 28.07.2021 12:00:00 i przycięte prefiks "TestApp". Wartości klucza zostały wyeksportowane z typem zawartości w formacie JSON.

Jeśli zaznaczono pole eksportowania wartości kluczy jako odwołań, wyeksportowane wartości kluczy będą wskazywane jako App Configuration odwołania w kolumnie "Źródło" ustawień konfiguracji zasobów 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 zawierającego klucz-wartości, które chcesz wyeksportować.	my-app-config-store
   --destination	Wprowadź , appservice aby wskazać, że eksportujesz dane do App Service.	appservice
   --appservice-account	Wprowadź identyfikator arm App Service lub użyj nazwy App Service, jeśli znajduje się ona w tej samej subskrypcji i grupie zasobów co 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ść elementu --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 "key-value". 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 App Service i przycina 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:
   

   Wiersz polecenia wyświetla listę wartości kluczy eksportowanych do zasobu App Service. Potwierdź eksport, wybierając ypozycję .

   

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

3. Opcjonalnie określ flagę do wyeksportowania jako odwołanie App Configuration.

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

   Przykład: wyeksportuj wszystkie wartości klucza z etykietą "prod" jako odwołania do konfiguracji aplikacji 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
   

   Wiersz polecenia wyświetla listę wartości kluczy eksportowanych jako odwołania do konfiguracji aplikacji do zasobu App Service. Potwierdź eksport, wybierając ypozycję .

   

   Wszystkie wartości klucza zostały wyeksportowane z etykietą "prod" jako odwołania do konfiguracji aplikacji do zasobu Azure App Service. W zasobie App Service zaimportowane wartości kluczy będą wskazywane jako odwołania 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 App Configuration wartości klucza mogą wystąpić następujące komunikaty o błędach:

• Wybrany plik musi należeć do przedziału od 1 do 2097152 bajtów. Plik jest za duży. Wybierz mniejszy plik.
• Dostęp publiczny jest wyłączony dla twojego sklepu lub uzyskujesz dostęp z prywatnego punktu końcowego, który nie znajduje się w konfiguracjach prywatnego punktu końcowego magazynu. Aby zaimportować wartości kluczy z magazynu App Configuration, musisz mieć dostęp do tego magazynu. W razie potrzeby włącz publiczny dostęp do magazynu źródłowego lub uzyskaj do niego dostęp z zatwierdzonego prywatnego punktu końcowego. Jeśli po prostu włączono dostęp publiczny, poczekaj do 5 minut na odświeżenie pamięci podręcznej.

Następne kroki

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