Import nebo export konfiguračních dat

Aplikace Azure Configuration podporuje operace importu a exportu dat. Pomocí těchto operací můžete pracovat s konfiguračními daty hromadně a vyměňovat data mezi úložištěm app Configuration Store a projektem kódu. Můžete například nastavit jeden obchod App Configuration pro testování a druhý pro produkční prostředí. Mezi nimi můžete zkopírovat nastavení aplikace, abyste nemuseli zadávat data dvakrát.

Tento článek obsahuje průvodce importem a exportem dat pomocí webu Azure Portal nebo Azure CLI. Pokud jste konfiguraci přijali jako kód a spravovali konfigurace v GitHubu nebo Azure DevOps, můžete nastavit průběžný import konfiguračních souborů pomocí GitHub Actions nebo použít úlohu importu kanálu Azure.

Importovat data

Import přináší konfigurační data do úložiště App Configuration z existujícího zdroje. Pomocí funkce importu můžete migrovat data do úložiště App Configuration nebo agregovat data z více zdrojů.

Tento průvodce ukazuje, jak importovat data konfigurace aplikace:

• z konfiguračního souboru ve formátu Json, Yaml nebo Properties
• z App Configuration Storu
• ze služby Aplikace Azure Service

Import dat z konfiguračního souboru

Pokud chcete importovat hodnoty klíčů ze souboru, postupujte podle následujících kroků.

Azure Portal

Na webu Azure Portal postupujte takto:

1. Přejděte do obchodu App Configuration a v nabídce Operations (Operace) vyberte Import/export.

   

2. Ve výchozím nastavení je vybrané přepínač Importovat . V části Typ zdroje vyberte Konfigurační soubor.

3. Vyplňte formulář následujícími parametry:

   Parametr	Popis	Příklad
   Typ souboru	Vyberte typ souboru pro import: YAML, Vlastnosti nebo JSON.	Json

4. Klikněte na tlačítko Procházet a vyberte soubor, který chcete importovat.

5. Vyplňte další část formuláře:

   Parametr	Popis	Příklad
   Profil obsahu souboru	Vyberte profil obsahu: Výchozí nebo KVSet. Výchozí profil obsahu souboru odkazuje na konvenční schéma konfiguračních souborů široce přijímané existujícími programovacími architekturami nebo systémy, podporuje formáty souborů JSON, Yaml nebo Properties. Profil obsahu souboru KVSet odkazuje na schéma souboru, které obsahuje všechny vlastnosti hodnoty klíče konfigurace aplikace, včetně klíče, hodnoty, popisku, typu obsahu a značek.	Výchozí
   Režim Import	Režim importu slouží k určení, jestli se mají ignorovat stejné hodnoty klíče. Při použití možnosti Ignorovat shodu se ignorují všechny hodnoty klíčů v úložišti, které jsou stejné jako hodnoty v konfiguračním souboru. U možnosti Vše se aktualizují všechny hodnoty klíčů v konfiguračním souboru.	Ignorovat shodu
   Vyloučit příznak funkce	Pokud je tato možnost zaškrtnutá, příznaky funkcí se nenaimportují.	Nezaškrtnuto
   Striktní	Pokud je toto políčko zaškrtnuté, odstraní se všechny hodnoty klíče v úložišti se zadanou předponou a popiskem, které nejsou součástí konfiguračního souboru, když je profil obsahu Soubor nastavený na Výchozí. Pokud je profil obsahu souboru nastavený na KVSet, odstraní se všechny hodnoty klíče v úložišti, které nejsou zahrnuty do konfiguračního souboru. Pokud políčko není zaškrtnuté, nebudou odstraněny žádné hodnoty klíčů v úložišti.	Nezaškrtnuto
   Oddělovač	Oddělovač je oddělovač používaný pro zploštění souborů JSON nebo YAML do hodnoty klíče. U souborů vlastností a příznaků funkcí se bude ignorovat. Mezi podporované hodnoty patří bez oddělovač, tečka (.), čárka (,), středník (;), spojovník (-), podtržítko (_), dvojité podtržítko (__), lomítko (/) a dvojtečka (:)).	:
   Hloubka	Nepovinné. Hloubka pro zploštění souborů JSON nebo YAML do párů klíč-hodnota. Ve výchozím nastavení se soubory zploštějí na nejnižší úroveň, pokud je vybrán oddělovač. Toto nastavení se nevztahuje na soubory vlastností nebo příznaky funkcí.
   Přidání předpony	Nepovinné. Pokud je zadána, přidá se předpona do názvů klíčů všech importovaných hodnot klíčů.	TestApp:
   Přidat popisek	Nepovinné. Pokud je zadaný, zadaný popisek se přiřadí všem importovaným hodnotám klíče.	píchnutí
   Přidat typ obsahu	Nepovinné. Pokud je zadaný, zadaný typ obsahu se přidá do všech importovaných hodnot klíče.	JSON (application/json)
   Přidání značek	Nepovinné. Pokud zadáte, zadané značky se přidají ke všem importovaným hodnotám klíče.	{tag: tag1}

6. Chcete-li pokračovat v importu, vyberte Použít .

Úspěšně jste naimportovali hodnoty klíčů ze souboru JSON. Názvy klíčů byly zploštěny pomocí : oddělovače a předpony TestApp:. Všechny importované hodnoty klíč-hodnoty jsou označeny jako prod, s typem application/jsonobsahu , a označeny tag: tag1.

Azure CLI

V Azure CLI postupujte podle následujících kroků. Pokud nemáte azure CLI nainstalované místně, můžete volitelně použít Azure Cloud Shell.

1. Zadejte příkaz az appconfig kv import importu a přidejte následující parametry:

   Parametr	Popis	Příklad
   --name	Zadejte název obchodu App Configuration, do kterého chcete importovat data.	my-app-config-store
   --source	Zadáním file označíte, že importujete konfigurační data aplikace ze souboru.	file
   --path	Zadejte místní cestu k souboru obsahujícímu data, která chcete importovat.	C:/Users/john/Downloads/data.json
   --format	Zadejte yaml, vlastnosti nebo json, abyste označili formát importovaných souborů.	json

2. Volitelně přidejte také následující parametry:

   Parametr	Popis	Příklad
   --separator	Nepovinné. Oddělovač je oddělovač pro zploštění hodnot klíče na Json/Yaml. Vyžaduje se pro export hierarchické struktury a bude ignorován pro soubory vlastností a příznaky funkcí. Vyberte jednu z následujících možností: ., ,, :, ;, /, -, _. —	;
   --prefix	Nepovinné. Předpona klíče je počáteční částí klíče. Předpony lze použít ke správě skupin hodnot klíčů v úložišti konfigurace. Tato předpona bude připojena před vlastnost "klíč" každé importované hodnoty klíče.	TestApp:
   --label	Nepovinné. Zadejte popisek, který se přiřadí importovaným hodnotám klíče.	prod
   --content-type	Nepovinné. Zadejte nebo application/json uveďteappconfig/kvset, že importovaný obsah se skládá z odkazu služby Key Vault nebo souboru JSON.	application/json

   Příklad: Import všech příznaků klíč-hodnoty a funkce ze souboru JSON, použití popisku "prod" a připojení předpony "TestApp". Přidejte typ obsahu 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. Na příkazovém řádku se zobrazí seznam nadcházejících změn. Potvrďte import výběrem možnosti y.

   

Naimportovali jste hodnoty klíčů ze souboru JSON a přiřadili jste jim popisek "prod" a předponu "TestApp:". Použije se oddělovač ";" a všechny hodnoty klíč-hodnoty, které jste naimportovali, mají nastavený typ obsahu jako JSON.

Další volitelné parametry a příklady najdete v tématu az appconfig kv import.

Import dat z App Configuration Storu

Hodnoty z jednoho app Configuration Storu můžete importovat do jiného obchodu App Configuration Store nebo můžete importovat hodnoty z jednoho app Configuration Storu do stejného úložiště App Configuration Store, aby bylo možné duplikovat jeho hodnoty a použít různé parametry, například nový popisek nebo typ obsahu.

Pokud chcete importovat příznaky klíč-hodnoty a funkce z úložiště konfigurace Aplikace Azure, postupujte podle následujících kroků.

Azure Portal

Na webu Azure Portal postupujte takto:

1. Přejděte do obchodu App Configuration a v nabídce Operations (Operace) vyberte Import/export.

   

2. Ve výchozím nastavení je vybrané přepínač Importovat . V části Typ zdroje vyberte Konfigurace aplikace.

3. Vyberte úložiště App Configuration, ze které chcete importovat data, a vyplňte formulář následujícími parametry:

   Parametr	Popis	Příklad
   Předplatné	Ve výchozím nastavení je vybrané vaše aktuální předplatné.	moje předplatné
   Skupina prostředků	Vyberte skupinu prostředků, která obsahuje úložiště App Configuration s konfigurací, kterou chcete importovat. Ve výchozím nastavení je vybraná aktuální skupina prostředků.	my-resource-group
   Prostředek	Vyberte obchod App Configuration, který obsahuje konfiguraci, kterou chcete importovat.	my-other-app-config-store

4. Vyplňte další část formuláře:

   Parametr	Popis	Příklad
   Režim výběru	Vyberte, jestli se mají importovat z běžných hodnot klíčů, což je výchozí možnost, nebo ze snímku.	Výchozí
   Filtr klíčů	Slouží k filtrování hodnot klíčů na základě názvu klíče pro import. Pokud nejsou zadány žádné klíče, jsou všechny klíče způsobilé.	Začíná testem
   V určitém čase	Nepovinné. Vyplňte toto pole pro import hodnot klíčů z konkrétního bodu v čase ve vybraném úložišti konfigurace. Pokud je tato hodnota prázdná, výchozí hodnota je aktuální bod v čase hodnot klíčů.	07/28/2022 12:00:00 AM
   Z popisku	Vyberte jeden nebo více popisků pro import hodnot klíčů přidružených k těmto popiskům. Pokud není vybraný žádný popisek, jsou všechny popisky způsobilé.	píchnutí
   Vyloučit příznak funkce	Pokud je tato možnost zaškrtnutá, příznaky funkcí se nenaimportují.	Nezaškrtnuto
   Přidání předpony	Nepovinné. Pokud je zadána, přidá se předpona do názvů klíčů všech importovaných hodnot klíčů.	TestApp:
   Přepsání popisků	Nepovinné. Ve výchozím nastavení se zachovají původní popisky zdrojových hodnot klíčů. Pokud je chcete přepsat, zaškrtněte políčko a zadejte nový popisek pro importované hodnoty klíče.	new
   Přepsání typů obsahu	Nepovinné. Ve výchozím nastavení se zachovají původní typy obsahu zdrojových hodnot klíčů. Pokud je chcete přepsat, zaškrtněte políčko a zadejte nový typ obsahu pro importované hodnoty klíče. Všimněte si, že typ obsahu příznaků funkce nelze přepsat.	JSON (application/json)

5. Chcete-li pokračovat v importu, vyberte Použít .

Od 28. ledna 2021 jste od 28. ledna 2021 naimportovali hodnoty klíčů z úložiště App Configuration s názvy klíčů začínajícími test a popiskem prod. Názvy klíčů byly předponou TestApp:. Všem importovaným hodnotám klíče byl přiřazen popisek new a typ application/jsonobsahu .

Azure CLI

V Azure CLI postupujte podle následujících kroků. Pokud nemáte azure CLI nainstalované místně, můžete volitelně použít Azure Cloud Shell.

1. Zadejte příkaz az appconfig kv import importu a zadejte následující parametry:

   Parametr	Popis	Příklad
   --name	Zadejte název obchodu App Configuration, do kterého chcete importovat data.	my-app-config-store
   --source	Zadáním appconfig označíte, že importujete data z obchodu App Configuration Store.	appconfig
   --src-name	Zadejte název obchodu App Configuration, ze kterého chcete importovat data.	my-source-app-config
   --src-label	Omezte import na hodnoty klíčů s konkrétním popiskem. Pokud tento parametr nepoužíváte, importují se pouze hodnoty klíče s popiskem null. Podporuje hvězdičku jako filtr: zadejte * pro všechny popisky; abc* pro všechny popisky s předponou abc.	prod

2. Volitelně přidejte následující parametry:

   Parametr	Popis	Příklad
   --label	Nepovinné. Zadejte popisek, který se přiřadí importovaným hodnotám klíče.	new
   --content-type	Nepovinné. Zadejte nebo application/json uveďteappconfig/kvset, že importovaný obsah se skládá z odkazu služby Key Vault nebo souboru JSON. Typ obsahu lze přepsat pouze pro importované hodnoty klíče. Výchozí typ obsahu pro příznaky funkce je application/vnd.microsoft.appconfig.ff+json; charset=utf-8' ve výchozím nastavení a tento parametr ho neaktualizuje.	application/json

   Příklad: importujte příznaky klíč-hodnoty a funkce s popiskem "prod" z jiné konfigurace aplikace a přiřaďte je popisek "nový". Přidejte typ obsahu 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. Na příkazovém řádku se zobrazí seznam nadcházejících změn. Potvrďte import výběrem možnosti y.

   

Importovali jste hodnoty klíčů s popiskem "prod" z obchodu App Configuration Store a přiřadili jste jim popisek "nový". Všechny hodnoty klíče, které jste naimportovali, mají nastavený typ obsahu jako JSON.

Další volitelné parametry a příklady najdete v tématu az appconfig kv import.

Import dat ze služby Aplikace Azure Service

Pokud chcete importovat hodnoty klíčů ze služby Aplikace Azure Service, postupujte podle následujících kroků.

Poznámka:

App Service v současné době nepodporuje příznaky funkcí. Všechny příznaky funkcí importované do služby App Service se automaticky převedou na hodnoty klíče. Vaše prostředky služby App Service můžou obsahovat pouze hodnoty klíče.

Azure Portal

Na webu Azure Portal:

1. Přejděte do obchodu App Configuration a v nabídce Operations (Operace) vyberte Import/export.

   

2. Ve výchozím nastavení je vybrané přepínač Importovat . V části Typ zdroje vyberte App Services.

3. Vyberte úložiště App Configuration, ze které chcete importovat data, a vyplňte formulář následujícími parametry:

   Parametr	Popis	Příklad
   Předplatné	Ve výchozím nastavení je vybrané vaše aktuální předplatné.	moje předplatné
   Skupina prostředků	Vyberte skupinu prostředků, která obsahuje službu App Service s konfigurací, kterou chcete importovat.	my-resource-group
   Prostředek	Vyberte službu App Service, která obsahuje konfiguraci, kterou chcete importovat.	my-app-service

4. Vyplňte další část formuláře:

   Parametr	Popis	Příklad
   Aktualizovat nastavení tak, aby odkazovat	Pokud je tato možnost zaškrtnutá, nastavení aplikace ve službě App Service se aktualizuje na odkazy na konfiguraci aplikace pro importované hodnoty klíčů. To vám umožní spravovat nastavení aplikace v konfiguraci aplikací v budoucnu. Vaše služba App Service automaticky načte aktuální hodnotu z App Configuration. Další informace najdete v tématu Použití odkazů na App Configuration pro App Service a Azure Functions.	Kontroloval
   Přidání předpony	Nepovinné. Pokud je zadána, přidá se předpona do názvů klíčů všech importovaných hodnot klíčů.	TestApp:
   Přidat popisek	Nepovinné. Pokud je zadaný, zadaný popisek se přiřadí všem importovaným hodnotám klíče.	píchnutí
   Přidat typ obsahu	Nepovinné. Pokud je zadaný, zadaný typ obsahu se přidá do všech importovaných hodnot klíče.	JSON (application/json)

5. Chcete-li pokračovat v importu, vyberte Použít .

Importovali jste všechna nastavení aplikace ze služby App Service jako hodnoty klíče a přiřadili jste jim popisek prod a předponu TestApp:. Všechny hodnoty klíče, které jste naimportovali, mají nastavený typ obsahu jako application/json.

Azure CLI

V Azure CLI postupujte podle následujících kroků. Pokud nemáte azure CLI nainstalované místně, můžete volitelně použít Azure Cloud Shell.

1. Zadejte příkaz az appconfig kv import importu a přidejte následující parametry:

   Parametr	Popis	Příklad
   --name	Zadejte název obchodu App Configuration, do kterého chcete importovat data.	my-app-config-store
   --source	Zadáním appservice označíte, že importujete konfigurační data aplikace ze služby Aplikace Azure Service.	appservice
   --appservice-account	Zadejte ID ARM služby App Service nebo použijte název služby App Service, pokud je ve stejném předplatném a skupině prostředků jako Konfigurace aplikace.	/subscriptions/123/resourceGroups/my-resource-group/providers/Microsoft.Web/sites/my-app-service nebo my-app-service

2. Volitelně přidejte také následující parametry:

   Parametr	Popis	Příklad
   --prefix	Nepovinné. Předpona klíče je počáteční částí vlastnosti klíč-hodnota klíč. Předpony lze použít ke správě skupin hodnot klíčů v úložišti konfigurace. Tato předpona bude připojena před vlastnost "klíč" každé importované hodnoty klíče.	TestApp:
   --label	Nepovinné. Zadejte popisek, který se přiřadí importovaným hodnotám klíče. Pokud popisek nezadáte, přiřadí se popisek null hodnotě key-values.	prod
   --content-type	Nepovinné. Zadejte appconfig/kvset nebo application/json a uveďte, že importovaný obsah se skládá z odkazu služby Key Vault nebo souboru JSON.	application/json

   Pokud chcete získat hodnotu pro --appservice-account, použijte příkaz az webapp show --resource-group <resource-group> --name <resource-name>.

   Příklad: Importujte všechna nastavení aplikace z vaší služby App Service jako hodnoty klíče s popiskem "prod", do obchodu App Configuration a přidejte předponu 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. Na příkazovém řádku se zobrazí seznam nadcházejících změn. Potvrďte import výběrem možnosti y.

   

Importovali jste všechna nastavení aplikace ze služby App Service jako hodnoty klíče, přiřadili jste jim popisek "prod" a přidali předponu TestApp:. Všechny hodnoty klíče, které jste naimportovali, mají nastavený typ obsahu jako JSON.

Další volitelné parametry a příklady najdete v tématu az appconfig kv import.

Export dat

Exportuje konfigurační data uložená ve službě App Configuration do jiného cíle. Pomocí funkce exportu můžete například uložit data z obchodu App Configuration do souboru, který lze vložit do kódu aplikace během nasazování.

Tento průvodce ukazuje, jak exportovat data konfigurace aplikace:

• do konfiguračního souboru ve formátu Json, Yaml nebo Properties
• do App Configuration Storu
• do prostředku služby Aplikace Azure Service

Export dat do konfiguračního souboru

Při exportu konfiguračních dat z app Configuration Storu do souboru JSON, YAML nebo Properties postupujte podle těchto kroků.

Azure Portal

Na webu Azure Portal postupujte takto:

1. Přejděte do obchodu App Configuration a vyberte Import/export.

   

2. Vyberte přepínač Exportovat a v části Typ cíle vyberte Konfigurační soubor.

3. Vyplňte formulář následujícími parametry:

   Parametr	Popis	Příklad
   Typ souboru	Vyberte typ souboru pro export: YAML, Vlastnosti nebo JSON.	JSON
   Profil obsahu souboru	Vyberte profil obsahu: Výchozí nebo KVSet. Výchozí profil obsahu souboru odkazuje na konvenční schéma konfiguračních souborů široce přijímané existujícími programovacími architekturami nebo systémy, podporuje formáty souborů JSON, Yaml nebo Properties. Profil obsahu souboru KVSet odkazuje na schéma souboru, které obsahuje všechny vlastnosti hodnoty klíče konfigurace aplikace, včetně klíče, hodnoty, popisku, typu obsahu a značek.	Výchozí
   Režim výběru	Vyberte, jestli se má exportovat z běžných hodnot klíčů, což je výchozí možnost, nebo ze snímku.	Výchozí
   Filtr klíčů	Slouží k filtrování hodnot klíčů na základě názvu klíče pro export. Pokud nejsou zadány žádné klíče, jsou všechny klíče způsobilé.	Začíná aplikací TestApp:
   V určitém čase	Nepovinné. Vyplňte toto pole pro export hodnot klíčů z konkrétního bodu v čase ve vybraném úložišti konfigurace. Pokud je tato hodnota prázdná, výchozí hodnota je aktuální bod v čase hodnot klíčů.	07/28/2022 12:00:00 AM
   Z popisku	Vyberte popisek pro export hodnot klíčů přidružených k těmto popiskům. Pokud není vybraný žádný popisek, jsou všechny popisky způsobilé. Všimněte si, že při exportu Default s profilem obsahu souboru můžete vybrat pouze jeden popisek. Pokud chcete exportovat hodnoty klíčů s více popisky, použijte KVSet profil obsahu souboru.	píchnutí
   Odebrat předponu	Nepovinné. Pokud je zadána, předpona bude odebrána z názvů klíčů všech exportovaných hodnot klíčů, které ho obsahují.	TestApp:
   Oddělovač	Oddělovač je oddělovač používaný k segmentování názvů klíčů a rekonstrukci hierarchických konfigurací pro soubory JSON nebo YAML z hodnot klíčů. U souborů vlastností a příznaků funkcí se bude ignorovat. Mezi podporované hodnoty patří žádný oddělovač, tečka (.), čárka (,), středník (;), spojovník (-), podtržítko (_), dvojité podtržítko (__), lomítko (/) a dvojtečka (:)).	:

4. Výběrem možnosti Exportovat dokončíte export.

Od 28. července 2021 jste vyexportovali hodnoty klíčů z úložiště App Configuration na 12:00, přičemž názvy klíčů začínají TestApp: na soubor JSON a popisek prod. Předpona TestApp: byla oříznuta z názvů klíčů a oddělovač : se použil k segmentaci názvů klíčů a rekonstrukci hierarchického formátu JSON.

Azure CLI

V Azure CLI postupujte podle následujících kroků. Pokud nemáte azure CLI nainstalované místně, můžete volitelně použít Azure Cloud Shell.

1. Zadejte příkaz az appconfig kv export pro export a přidejte následující parametry:

   Parametr	Popis	Příklad
   --name	Zadejte název obchodu App Configuration, který obsahuje hodnoty klíče, které chcete exportovat.	my-app-config-store
   --destination	Zadáním file označíte, že exportujete data do souboru.	file
   --path	Zadejte cestu, kam chcete soubor uložit.	C:/Users/john/Downloads/data.json
   --format	Zadejte yamlnebo json zadejte formát souboru, properties který chcete exportovat.	json
   --label	Zadejte popisek pro export hodnot klíčů a příznaků funkcí s tímto popiskem. Pokud popisek nezadáte, ve výchozím nastavení exportujete pouze hodnoty klíče a příznaky funkcí bez popisku. Můžete zadat jeden popisek, zadat několik štítků jejich oddělením ,nebo použít * k zohlednění všech popisků.	prod

   Důležité

   Pokud popisek nevyberete, exportují se pouze hodnoty klíče bez popisků. Pokud chcete exportovat hodnotu klíče s popiskem, musíte vybrat jeho popisek.

2. Volitelně přidejte také následující parametry:

   Parametr	Popis	Příklad
   --separator	Nepovinné. Oddělovač je oddělovač pro zploštění hodnot klíče na Json/Yaml. Vyžaduje se pro export hierarchické struktury a bude ignorován pro soubory vlastností a příznaky funkcí. Vyberte jednu z následujících možností: ., ,, :, ;, /, -, _. —	;
   --prefix	Nepovinné. Předpona, která se má oříznout z vlastnosti "klíč" každé hodnoty klíče. Předpona klíče je počáteční částí klíče. Předpony lze použít ke správě skupin hodnot klíčů v úložišti konfigurace. Předpona bude u příznaků funkcí ignorována.	TestApp:

   Příklad: Export všech příznaků klíč-hodnoty a funkce s popiskem "prod" do souboru JSON.

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

3. Na příkazovém řádku se zobrazí seznam hodnot klíčů, které se exportují do souboru. Potvrďte export výběrem možnosti y.

   

Exportovali jste příznaky klíč-hodnoty a funkce, které mají popisek "prod" do konfiguračního souboru a ořízli jste předponu TestApp. Hodnoty jsou v souboru oddělené hodnotou ";".

Další volitelné parametry a příklady najdete v tématu az appconfig kv export.

Export dat do app Configuration Storu

Pokud chcete exportovat příznaky klíč-hodnoty a funkce do úložiště konfigurace Aplikace Azure, postupujte podle následujících kroků.

Hodnoty z jednoho obchodu App Configuration store můžete exportovat do jiného úložiště App Configuration Store nebo můžete exportovat hodnoty z jednoho obchodu App Configuration store do stejného úložiště App Configuration Store, aby se duplikovala jeho hodnoty a použily různé parametry, jako je nový popisek nebo typ obsahu.

Azure Portal

Na webu Azure Portal postupujte takto:

1. Přejděte do obchodu App Configuration, který obsahuje data, která chcete exportovat, a v nabídce Operace vyberte Import/export.

   

2. Vyberte přepínač Exportovat a v části Typ cíle vyberte Konfigurace aplikace.

3. Vyplňte formulář následujícími parametry:

   Parametr	Popis	Příklad
   Režim výběru	Vyberte, jestli se má exportovat z běžných hodnot klíčů, což je výchozí možnost, nebo ze snímku.	Výchozí
   Filtr klíčů	Slouží k filtrování hodnot klíčů na základě názvu klíče pro export. Pokud nejsou zadány žádné klíče, jsou všechny klíče způsobilé.	Začíná aplikací TestApp:
   V určitém čase	Nepovinné. Vyplňte toto pole pro export hodnot klíčů z konkrétního bodu v čase ve vybraném úložišti konfigurace. Pokud je tato hodnota prázdná, výchozí hodnota je aktuální bod v čase hodnot klíčů.	07/28/2022 12:00:00 AM
   Z popisku	Vyberte jeden nebo více popisků pro export hodnot klíčů přidružených k těmto popiskům. Pokud není vybraný žádný popisek, jsou všechny popisky způsobilé.	píchnutí
   Vyloučit příznak funkce	Pokud je tato možnost zaškrtnutá, příznaky funkcí se neexportují.	Nezaškrtnuto

4. Vyberte cílové úložiště a vyplňte formulář následujícími parametry:

   Parametr	Popis	Příklad
   Předplatné	Ve výchozím nastavení je vybrané vaše aktuální předplatné.	moje předplatné
   Skupina prostředků	Vyberte skupinu prostředků, která obsahuje obchod App Configuration, do kterého chcete konfiguraci exportovat. Ve výchozím nastavení je vybraná aktuální skupina prostředků.	my-resource-group
   Prostředek	Vyberte obchod App Configuration, do kterého chcete konfiguraci exportovat.	my-other-app-config-store

5. Vyplňte další část formuláře:

   Parametr	Popis	Příklad
   Odebrat předponu	Nepovinné. Pokud je zadána, předpona bude odebrána z názvů klíčů všech exportovaných hodnot klíčů, které ho obsahují.	TestApp:
   Přepsání popisků	Nepovinné. Ve výchozím nastavení se zachovají původní popisky zdrojových hodnot klíčů. Pokud je chcete přepsat, zaškrtněte políčko a zadejte nový popisek pro exportované hodnoty klíče.	new
   Přepsání typů obsahu	Nepovinné. Ve výchozím nastavení se zachovají původní typy obsahu zdrojových hodnot klíčů. Pokud je chcete přepsat, zaškrtněte políčko a zadejte nový typ obsahu pro exportované hodnoty klíče. Všimněte si, že typ obsahu příznaků funkce nelze přepsat.	JSON (application/json)

6. Chcete-li pokračovat v exportu, vyberte Použít .

Hodnoty klíčů jste exportovali z úložiště App Configuration od 28. července 2022 do 12:00 s názvy klíčů začínajícími TestApp: a popiskem proddo jiného obchodu App Configuration Store. Všechny exportované hodnoty klíče byly oříznuty předponu TestApp:klíče a přiřadili popisek new a typ application/jsonobsahu .

Azure CLI

V Azure CLI postupujte podle následujících kroků. Pokud nemáte azure CLI nainstalované místně, můžete volitelně použít Azure Cloud Shell.

1. Zadejte příkaz az appconfig kv export pro export a zadejte následující parametry:

   Parametr	Popis	Příklad
   --name	Zadejte název obchodu App Configuration, který obsahuje hodnoty klíče, které chcete exportovat.	my-app-config-store
   --destination	Zadáním appconfig označíte, že exportujete data do obchodu App Configuration Store.	appconfig
   --dest-name	Zadejte název obchodu App Configuration, do kterého chcete exportovat data.	my-other-app-config-store
   --label	Zadejte popisek pro export hodnot klíčů a příznaků funkcí s tímto popiskem. Pokud popisek nezadáte, ve výchozím nastavení exportujete jenom hodnoty klíče a příznaky funkcí bez popisku. Můžete zadat jeden popisek, zadat několik štítků tak, že je ,oddělíte nebo použijete * k převzetí všech popisků v účtu.	prod

   Důležité

   Pokud hodnoty klíčů, které chcete exportovat, mají popisky, musíte použít příkaz --label a zadat odpovídající popisky. Pokud popisek nevyberete, exportují se pouze hodnoty klíče bez popisků. Pomocí znaménka čárky (,) vyberte několik popisků nebo použijte * k zahrnutí všech popisků, včetně popisku null (bez popisku).

2. Volitelně přidejte také následující parametr:

   Parametr	Popis	Příklad
   --dest-label	Nepovinné. Zadejte cílový popisek pro přiřazení tohoto popisku k exportovaným hodnotám klíče.	new

   Příklad: Export hodnot klíčů a příznaků funkcí s popiskem "prod" do jiného obchodu App Configuration a přidání cílového popisku "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. Na příkazovém řádku se zobrazí seznam hodnot klíčů, které se exportují do souborů. Potvrďte export výběrem možnosti y.

   

Exportovali jste příznaky klíč-hodnoty a funkce, které mají popisek "prod" z app Configuration Storu a přiřadili je popisek "nový".

Další volitelné parametry a příklady najdete v tématu az appconfig kv import.

Export dat do služby Aplikace Azure Service

Pokud chcete exportovat hodnoty klíčů do služby Aplikace Azure Service, postupujte podle následujících kroků.

Poznámka:

Export příznaků funkcí do služby App Service se nepodporuje.

Azure Portal

Na webu Azure Portal postupujte takto:

1. Přejděte do obchodu App Configuration a v nabídce Operations (Operace) vyberte Import/export.

   

2. Vyberte přepínač Exportovat a v části Typ cíle vyberte App Services.

3. Ve výchozím nastavení je zaškrtnutá možnost Exportovat jako odkaz . Po zaškrtnutí tohoto políčka se nastavení aplikace ve službě App Service přidá jako odkazy na konfiguraci aplikace pro exportované hodnoty klíčů. To vám umožní spravovat nastavení v App Configuration a služba App Service automaticky načítá aktuální hodnoty z App Configuration. Další informace najdete v tématu Použití odkazů na App Configuration pro App Service a Azure Functions. Pokud políčko není zaškrtnuté, klíč a hodnota se přímo exportují do služby App Service. Nezapomeňte data znovu exportovat pokaždé, když v Konfiguraci aplikace provedete změny, abyste zajistili, že vaše aplikace bude aktualizace vracet.

4. Vyplňte formulář následujícími parametry:

   Parametr	Popis	Příklad
   Režim výběru	Vyberte, jestli se má exportovat z běžných hodnot klíčů, což je výchozí možnost, nebo ze snímku.	Výchozí
   Filtr klíčů	Slouží k filtrování hodnot klíčů na základě názvu klíče pro export. Pokud nejsou zadány žádné klíče, jsou všechny klíče způsobilé.	Začíná aplikací TestApp:
   V určitém čase	Nepovinné. Vyplňte toto pole pro export hodnot klíčů z konkrétního bodu v čase ve vybraném úložišti konfigurace. Pokud je tato hodnota prázdná, výchozí hodnota je aktuální bod v čase hodnot klíčů.	07/28/2022 12:00:00 AM
   Z popisku	Vyberte jeden popisek pro export hodnot klíčů přidružených k tomuto popisku.	píchnutí

5. Vyberte cílové úložiště a vyplňte formulář následujícími parametry:

   Parametr	Popis	Příklad
   Předplatné	Ve výchozím nastavení je vybrané vaše aktuální předplatné.	moje předplatné
   Skupina prostředků	Vyberte skupinu prostředků, která obsahuje službu App Service, do které chcete konfiguraci exportovat.	my-resource-group
   Prostředek	Vyberte službu App Service, do které chcete konfiguraci exportovat.	my-app-service

6. Volitelně vyplňte další část formuláře:

   Parametr	Popis	Příklad
   Odebrat předponu	Nepovinné. Pokud je zadána, předpona bude odebrána z názvů klíčů všech exportovaných hodnot klíčů, které ho obsahují.	TestApp:

7. Chcete-li pokračovat v exportu, vyberte Použít .

Od 28. července 2022 jste vyexportovali hodnoty klíčů z obchodu App Configuration na 12:00 s názvy klíčů začínajícími TestApp: a popiskem proddo nastavení aplikace prostředku služby App Service. Předpona TestApp: byla oříznuta z exportovaných názvů klíčů.

Pokud jste zaškrtli políčko pro export hodnot klíčů jako odkazů, jsou exportované hodnoty klíčů označené jako odkazy na Konfiguraci aplikace ve sloupci Zdroj v nastavení konfigurace prostředku služby App Service.

Azure CLI

V Azure CLI postupujte podle následujících kroků. Pokud nemáte azure CLI nainstalované místně, můžete volitelně použít Azure Cloud Shell.

1. Zadejte příkaz az appconfig kv export pro export a zadejte následující parametry:

   Parametr	Popis	Příklad
   --name	Zadejte název obchodu App Configuration, který obsahuje hodnoty klíče, které chcete exportovat.	my-app-config-store
   --destination	Zadáním appservice označíte, že exportujete data do služby App Service.	appservice
   --appservice-account	Zadejte ID ARM služby App Service nebo použijte název služby App Service, pokud je ve stejném předplatném a skupině prostředků jako Konfigurace aplikace.	/subscriptions/123/resourceGroups/my-as-resource-group/providers/Microsoft.Web/sites/my-app-service nebo my-app-service
   --label	Nepovinné. Zadejte popisek pro export hodnot klíčů a příznaků funkcí s tímto popiskem. Pokud popisek nezadáte, ve výchozím nastavení exportujete jenom hodnoty klíče a příznaky funkcí bez popisku.	prod

   Pokud chcete získat hodnotu pro --appservice-account, použijte příkaz az webapp show --resource-group <resource-group> --name <resource-name>.

2. Volitelně také přidejte předponu:

   Parametr	Popis	Příklad
   --prefix	Nepovinné. Předpona, která se má oříznout z exportované vlastnosti klíč-hodnota Předpona klíče je počáteční částí klíče. Předpony lze použít ke správě skupin hodnot klíčů v úložišti konfigurace.	TestApp:

   Příklad: Export všech hodnot klíčů s popiskem "prod" do aplikace App Service a oříznutí předpony "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:
   

   Na příkazovém řádku se zobrazí seznam hodnot klíčů, které se exportují do prostředku služby App Service. Potvrďte export výběrem možnosti y.

   

   Exportovali jste všechny hodnoty klíčů s popiskem "prod" do prostředku služby Aplikace Azure Service a ořízli jste předponu TestApp:.

3. Volitelně můžete zadat příznak, který se má exportovat jako odkaz na konfiguraci aplikace.

   Parametr	Popis
   --export-as-reference -r	Nepovinné. Určete, jestli se hodnoty klíčů exportují do služby App Service jako odkazy na konfiguraci aplikace. Další informace.

   Příklad: Export všech hodnot klíčů s popiskem "prod" jako odkazy na konfiguraci aplikace do aplikace 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
   

   Na příkazovém řádku se zobrazí seznam hodnot klíčů, které se exportují jako odkazy na konfiguraci aplikace na prostředek služby App Service. Potvrďte export výběrem možnosti y.

   

   Exportovali jste všechny hodnoty klíčů s popiskem "prod" jako odkazy na konfiguraci aplikace do prostředku služby Aplikace Azure Service. V prostředku služby App Service se importované hodnoty klíčů označí jako odkazy na konfiguraci aplikace ve sloupci Zdroj.

   

Další volitelné parametry a příklady najdete v tématu az appconfig kv export.

Chybové zprávy

Při importu nebo exportu hodnot klíče konfigurace aplikace se můžou zobrazit následující chybové zprávy:

• Veřejný přístup je pro vaše úložiště zakázaný nebo k němu přistupujete z privátního koncového bodu, který není v konfiguracích privátních koncových bodů úložiště. Pokud má váš App Configuration Store povolené privátní koncové body, můžete k němu ve výchozím nastavení přistupovat jenom z nakonfigurované virtuální sítě. Ujistěte se, že je počítač s webem Azure Portal nebo rozhraním příkazového řádku připojený ke stejné virtuální síti jako privátní koncový bod. Pokud jste právě povolili přístup k veřejné síti do úložiště App Configuration Store, počkejte aspoň 5 minut, než zkusíte mezipaměť aktualizovat.

Další kroky

Integrace s kanálem CI/CD