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 wypychania 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.

Uwaga

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

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. 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 importowanych plików między platformami .NET, Java (Spring) i Innymi.	.NET
   Typ pliku	Wybierz typ pliku importowanych między plikami Yaml, Properties i Json.	Json

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

   Uwaga

   Na ekranie zostanie wyświetlony 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, aby oddzielić 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 "klucz-wartość". 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 "klucz" 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. Wskaż, czy importujesz plik JSON lub odwołania do usługi Key Vault. Aby uzyskać więcej informacji na temat odwołań do usługi Key Vault, zobacz Używanie odwołań usługi 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ź , 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, aand 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. Na karcie Importowanie wybierz pozycję Konfiguracja aplikacji 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 "Klucze dostępu został pomyślnie pobrany" wskazuje, że połączenie ze sklepem 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. Zaznacz wszystkie importy klucz-wartości z dowolną etykietą, a (Bez etykiety) ogranicza importowanie do wartości klucz-wartości bez etykiety.	Prod
   W określonym czasie	Opcjonalny. Wypełnij pole , aby zaimportować wartości kluczy z określonego punktu w czasie. Jest to punkt w czasie wartości klucz-w wybranym magazynie konfiguracji. Format: "RRRR-MM-DDThh:mm:ssZ". To pole domyślnie do bieżącego punktu w czasie wartości klucz-wartości, gdy pozostanie puste.	28.07.2022 12:00:00
   Zastępowanie domyślnych etykiet klucz-wartość	Opcjonalny. Domyślnie zaimportowane elementy używają bieżącej etykiety. Zaznacz to pole i wprowadź etykietę, aby zastąpić te wartości domyślne etykietą niestandardową.	new
   Zastępowanie domyślnego typu zawartości klucz-wartość	Opcjonalny. Domyślnie importowane elementy używają bieżącego typu zawartości. Zaznacz to pole i wybierz pozycję Odwołanie do usługi Key Vault lub JSON (application/json) w obszarze Typ zawartości, 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' 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" ze sklepu 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 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. 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ą 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

   Uwaga

   Zostanie wyświetlony komunikat wskazujący liczbę klucz-wartości, które zostały pomyślnie pobrane z źródłowego zasobu usługi 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 "key-values". Prefiksy mogą służyć do zarządzania grupami klucz-wartości w magazynie konfiguracji. Ten prefiks jest dołączany 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 do usługi Key Vault lub plikiem JSON. Aby uzyskać więcej informacji na temat odwołań do usługi Key Vault, zobacz Używanie odwołań usługi Key Vault w aplikacji ASP.NET Core.	JSON (application/json)

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

Zaimportowano wszystkie ustawienia aplikacji z usługi App Service jako wartości klucza 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ź , 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 poniższe kroki, aby wyeksportować dane konfiguracji z magazynu konfiguracji aplikacji do pliku Json, Yaml lub Właściwości.

Uwaga

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

Portal

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

1. Przejdź do sklepu 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 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.	TestApp:
   Z etykiety	Wybierz istniejącą etykietę, aby ograniczyć eksport do wartości kluczy przy użyciu określonej etykiety. Jeśli nie wybierzesz etykiety, domyślnie zostaną wyeksportowane tylko wartości klucza z etykietą "Brak etykiety". Patrz uwaga poniżej.	Prod
   W określonym czasie	Opcjonalny. Wypełnij pole , aby zaimportować wartości kluczy z określonego punktu w czasie. Jest to punkt w czasie wartości klucz-w wybranym magazynie konfiguracji. Format: "RRRR-MM-DDThh:mm:ssZ". To pole domyślnie do bieżącego punktu w czasie wartości klucz-wartości, gdy 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 wartości kluczy do pliku Json/Yaml. Obsługuje on hierarchiczną strukturę 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ć jego etykietę. Należy pamiętać, że można 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 07/28/2021 12:00:00 AM i przycięty prefiks "TestApp". Wartości są oddzielone ciągami ";" 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, 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 App Configuration zawierającego dane, które chcesz wyeksportować, a następnie wybierz pozycję Importuj/eksportu z menu Operacje .

   

2. Na karcie Eksportowanie wybierz pozycję Konfiguracja aplikacji 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 źródłowego magazynu usługi App Configuration.

   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. Zaznacz wszystkie wartości klucza zostaną wyeksportowane z dowolną etykietą, a (Bez etykiety) spowoduje ograniczenie eksportu do wartości klucz-wartości bez etykiety.	Prod
   W określonym czasie	Opcjonalny. Wypełnij pole , aby zaimportować wartości kluczy z określonego punktu w czasie. Jest to punkt w czasie wartości klucz-w wybranym magazynie konfiguracji. Format: "RRRR-MM-DDThh:mm:ssZ". To pole domyślnie do bieżącego punktu w czasie wartości klucz-wartości, gdy pozostanie puste.	28.07.2022 12:00:00
   Zastępowanie domyślnych etykiet klucz-wartość	Opcjonalny. Domyślnie zaimportowane elementy używają bieżącej etykiety. Zaznacz to pole i wprowadź etykietę, aby zastąpić te wartości domyślne etykietą niestandardową.	new

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

Wyeksportowano wartości klucza i flagi funkcji, które mają etykietę "prod" ze sklepu App Configuration, w ich stanie od 07/28/2022 12:00:00 AM i przypisać 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, 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 obecnie 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. Na karcie Eksportowanie 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ą usługę App Service z konfiguracją do wyeksportowania.	my-resource-group
   Zasób	Wybierz usługę 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 do innego docelowego zasobu usługi 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 usługi App Service jako odwołania do usługi App Configuration. Dowiedz się więcej
   W określonym czasie	Opcjonalny. Wypełnij pole , aby wyeksportować wartości kluczy z określonego punktu w czasie. Jest to punkt w czasie wartości klucz-w wybranym magazynie konfiguracji. Format: "RRRR-MM-DDThh:mm:ssZ". To pole domyślnie do bieżącego punktu w czasie wartości klucz-wartości, gdy pozostanie puste.	28.07.2022 12:00:00
   Z etykiety	Opcjonalny. Wybierz istniejącą etykietę, aby ograniczyć eksport do wartości kluczy przy użyciu określonej etykiety. 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 usługi App Service, w ich stanie od 07/28/2021 12:00:00 am i przycięte prefiks "TestApp". Wartości klucza zostały wyeksportowane z typem zawartości w formacie JSON.

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:

• Wybrany plik musi zawierać się z zakresu od 1 do 2097152 bajtów. Plik jest za duży. Wybierz mniejszy plik.
• 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. Aby zaimportować wartości kluczy ze sklepu 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