Sdílet prostřednictvím


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í služby App Configuration. Pokud chcete nastavit průběžnou synchronizaci s úložištěm GitHubu, podívejte se na úlohy GitHub Actions a Azure Pipelines.

Data můžete importovat nebo exportovat pomocí webu Azure Portal nebo Azure CLI.

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:

Import dat z konfiguračního souboru

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

Poznámka:

Import příznaků funkcí ze souboru se nepodporuje. Pokud konfigurační soubor obsahuje příznaky funkcí, importují se automaticky jako běžné hodnoty klíče.

Na webu Azure Portal postupujte takto:

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

    Snímek obrazovky webu Azure Portal s importem souboru

  2. Na kartě Import vyberte v části Zdrojová služba konfigurační soubor.

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

    Parametr Popis Příklad
    Jazyk Zvolte jazyk souboru, který importujete mezi .NET, Javou (Spring) a jinými. .NET
    Typ souboru Vyberte typ souboru, který importujete mezi Yaml, Properties a Json. Json
  4. Vyberte ikonu Složka a přejděte k souboru, který chcete importovat.

    Poznámka:

    Na obrazovce se zobrazí zpráva s informací, že se soubor úspěšně načte.

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

    Parametr Popis Příklad
    Oddělovač Oddělovač je znak parsovaný v importovaném konfiguračním souboru na samostatné hodnoty klíče, které se přidají do úložiště konfigurace. Vyberte jednu z následujících možností: ., ,, :, ;, /, , -_, ;
    Předpona 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. Zadaná předpona se připojí před vlastnost "klíč" každé hodnoty klíče, kterou importujete z tohoto souboru. TestApp:
    Popisek Nepovinné. Vyberte existující popisek nebo zadejte nový popisek, který se přiřadí importovaným hodnotám klíče. píchnutí
    Typ obsahu Nepovinné. Uveďte, jestli importujete soubor JSON nebo odkazy na Key Vault. Další informace o referencích služby Key Vault najdete v tématu Použití odkazů služby Key Vault v aplikaci ASP.NET Core. JSON (application/json)
  6. Chcete-li pokračovat v importu, vyberte Použít .

Importovali jste hodnoty klíčů ze souboru JSON, 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.

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

Na webu Azure Portal postupujte takto:

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

    Snímek obrazovky webu Azure Portal, který se importuje z App Configuration Storu

  2. Na kartě Import vyberte v části Zdrojová služba možnost Konfigurace aplikace.

  3. Vyberte Vybrat prostředek, vyplňte formulář následujícími parametry a vyberte Použít:

    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

    Poznámka:

    Zpráva "Přístupové klíče byly úspěšně načteny" znamená, že připojení k app Configuration Storu bylo úspěšné.

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

    Parametr Popis Příklad
    Z popisku Vyberte alespoň jeden popisek pro import hodnot s odpovídajícími popisky. Vyberte všechny importované hodnoty klíčů s libovolným popiskem a (bez popisku) omezí import na hodnoty klíčů bez popisku. píchnutí
    V určitém čase Nepovinné. Vyplňte import hodnot klíčů z určitého bodu v čase. Toto je bod v čase hodnot klíčů ve vybraném úložišti konfigurace. Formát: "RRRR-MM-DDThh:mm:ssZ". Toto pole je výchozí hodnotou aktuálního bodu v čase hodnot klíče, když je pole prázdné. 07/28/2022 12:00:00 AM
    Přepsání výchozích popisků klíč-hodnota Nepovinné. Ve výchozím nastavení používají importované položky jejich aktuální popisek. Zaškrtněte políčko a zadejte popisek, který má tyto výchozí hodnoty přepsat vlastním popiskem. new
    Přepsání výchozího typu obsahu klíč-hodnota Nepovinné. Ve výchozím nastavení používají importované položky svůj aktuální typ obsahu. Zaškrtněte políčko a v části Typ obsahu zaškrtněte odkaz služby Key Vault nebo JSON (application/json) a uveďte, ž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' a tento parametr neaktualizuje. JSON (application/json)
  5. Chcete-li pokračovat v importu, vyberte Použít .

Naimportovali jste příznaky klíč-hodnoty a funkce s popiskem "prod" z obchodu App Configuration 28. ledna 2021 na 12:00 a přiřadili jste jim popisek "nový". Všechny hodnoty klíče, které jste naimportovali, mají nastavený typ obsahu jako JSON.

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.

Na webu Azure Portal:

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

    Snímek obrazovky webu Azure Portal, který se importuje ze služby App Service

  2. Na kartě Import vyberte v části Zdrojová služba službu App Services.

  3. Vyberte Vybrat prostředek, vyplňte formulář následujícími parametry a vyberte Použít:

    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

    Poznámka:

    Zobrazí se zpráva označující počet hodnot klíče, které byly úspěšně načteny ze zdrojového prostředku služby App Service.

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

    Parametr Popis Příklad
    Předpona Nepovinné. Předpona klíče je počáteční částí vlastnosti key-values "key". Předpony lze použít ke správě skupin hodnot klíčů v úložišti konfigurace. Tato předpona je připojena před vlastnost "klíč" každé importované hodnoty klíče. TestApp:
    Popisek Nepovinné. Vyberte existující popisek nebo zadejte nový popisek, který se přiřadí importovaným hodnotám klíče. píchnutí
    Typ obsahu Nepovinné. Uveďte, jestli importujete soubor jako odkaz služby Key Vault nebo soubor JSON. Další informace o referencích služby Key Vault najdete v tématu Použití odkazů služby Key Vault v aplikaci ASP.NET Core. 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 JSON.

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:

Export dat do konfiguračního souboru

Pomocí následujícího postupu exportujte konfigurační data z úložiště konfigurace aplikace do souboru Json, Yaml nebo Properties.

Poznámka:

Export příznaků funkcí z app Configuration Storu do konfiguračního souboru se v současné době podporuje jenom v rozhraní příkazového řádku.

Na webu Azure Portal postupujte takto:

  1. Přejděte do obchodu App Configuration a vyberte Importovat/exportovat.

    Snímek obrazovky webu Azure Portal s exportem souboru

  2. Na kartě Export vyberte v části Cílová služba konfigurační soubor.

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

    Parametr Popis Příklad
    Předpona Nepovinné. Tato předpona se ořízne 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. TestApp:
    Z popisku Výběrem existujícího popisku omezte export na hodnoty klíčů s určitým popiskem. Pokud popisek nevyberete, exportují se ve výchozím nastavení jenom hodnoty klíče s popiskem Bez popisku. Viz poznámka níže. píchnutí
    V určitém čase Nepovinné. Vyplňte import hodnot klíčů z určitého bodu v čase. Toto je bod v čase hodnot klíčů ve vybraném úložišti konfigurace. Formát: "RRRR-MM-DDThh:mm:ssZ". Toto pole je výchozí hodnotou aktuálního bodu v čase hodnot klíče, když je pole prázdné. 07/28/2022 12:00:00 AM
    Typ souboru Vyberte typ souboru, který exportujete mezi Yaml, Properties nebo Json. JSON
    Oddělovač Oddělovač je oddělovač pro zploštění hodnot klíče na Json/Yaml. Podporuje hierarchickou strukturu konfigurace a nevztahuje se na soubory vlastností a příznaky funkcí. Vyberte jednu z následujících možností: ., ,, :, ;, /, , , -_, nebo (bez oddělovače). ;

    Důležité

    Pokud popisek Od nevyberete, exportují se pouze hodnoty klíč-hodnoty bez popisků. Pokud chcete exportovat hodnotu klíče s popiskem, musíte vybrat jeho popisek. Všimněte si, že na portálu můžete vybrat pouze jeden popisek pro každý export, pokud chcete exportovat hodnoty klíčů se všemi zadanými popisky, použijte rozhraní příkazového řádku.

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

Exportovali jste hodnoty klíčů, které mají popisek "prod" z konfiguračního souboru, v jejich stavu od 28. 7. 2021 12:00:00 a ořízli jste předponu TestApp. Hodnoty jsou v souboru oddělené hodnotou ";".

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.

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.

    Snímek obrazovky webu Azure Portal, který se exportuje z App Configuration Storu

  2. Na kartě Export vyberte v části Cílová služba možnost Konfigurace aplikace.

  3. Vyberte Vybrat prostředek, vyplňte formulář následujícími parametry a vyberte Použít:

    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. my-resource-group
    Prostředek Vyberte obchod App Configuration, který obsahuje konfiguraci, kterou chcete importovat. my-app-config-store
  4. Na stránce se teď zobrazí vybraná cílová služba a ID prostředku. Akce Vybrat prostředek umožňuje přepnout do jiného zdrojového úložiště konfigurace aplikací.

    Poznámka:

    Na obrazovce se zobrazí zpráva, která indikuje, že hodnoty klíčů byly úspěšně načteny.

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

    Parametr Popis Příklad
    Z popisku Vyberte aspoň jeden popisek pro export hodnot s odpovídajícími popisky. Když vyberete všechny , exportuje hodnoty klíčů s libovolným popiskem a (bez popisku) omezí export na hodnoty klíčů bez popisku. píchnutí
    V určitém čase Nepovinné. Vyplňte import hodnot klíčů z určitého bodu v čase. Toto je bod v čase hodnot klíčů ve vybraném úložišti konfigurace. Formát: "RRRR-MM-DDThh:mm:ssZ". Toto pole je výchozí hodnotou aktuálního bodu v čase hodnot klíče, když je pole prázdné. 07/28/2022 12:00:00 AM
    Přepsání výchozích popisků klíč-hodnota Nepovinné. Ve výchozím nastavení používají importované položky jejich aktuální popisek. Zaškrtněte políčko a zadejte popisek, který má tyto výchozí hodnoty přepsat vlastním popiskem. new
  6. Chcete-li pokračovat v exportu, vyberte Použít .

Exportovali jste příznaky klíč-hodnoty a funkce, které mají popisek "prod" z App Configuration Storu, v jejich stavu od 28. 7. 2022 12:00:00 a přiřadili jim popisek "nový".

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 v současné době nepodporuje.

Na webu Azure Portal postupujte takto:

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

    Snímek obrazovky webu Azure Portal s exportem ze služby App Service

  2. Na kartě Export vyberte v části Cílová služba službu App Services.

  3. Vyberte Vybrat prostředek, vyplňte formulář následujícími parametry a vyberte Použít:

    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í pro export. my-resource-group
    Prostředek Vyberte službu App Service, která obsahuje konfiguraci, kterou chcete exportovat. my-app-service
  4. Na stránce se teď zobrazí vybraná cílová služba a ID prostředku. Akce Vybrat prostředek umožňuje přepnout na jiný cílový prostředek služby App Service.

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

    Parametr Popis Příklad
    Předpona Nepovinné. Tato předpona se ořízne z každé exportované vlastnosti key-value "key". 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:
    Exportovat jako odkaz Nepovinné. Zkontrolujte, jestli chcete exportovat hodnoty klíčů do služby App Service jako odkazy na App Configuration. Další informace
    V určitém čase Nepovinné. Vyplňte export hodnot klíčů z určitého bodu v čase. Toto je bod v čase hodnot klíčů ve vybraném úložišti konfigurace. Formát: "RRRR-MM-DDThh:mm:ssZ". Toto pole je výchozí hodnotou aktuálního bodu v čase hodnot klíče, když je pole prázdné. 07/28/2022 12:00:00 AM
    Z popisku Nepovinné. Výběrem existujícího popisku omezte export na hodnoty klíčů s určitým popiskem. Pokud popisek nevyberete, exportují se pouze hodnoty klíče s popiskem Bez popisku. píchnutí
  6. Chcete-li pokračovat v exportu, vyberte Použít .

Exportovali jste hodnoty klíč-hodnoty, které mají popisek "prod" z prostředku služby App Service, v jejich stavu od 28. 7. 2021 12:00:00 a ořízli jste předponu TestApp. Hodnoty klíče byly exportovány s typem obsahu ve formátu JSON.

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.

Snímek obrazovky s nastavením konfigurace služby App Service Exportovaný odkaz na konfiguraci aplikace ve službě App Service (portál).

Chybové zprávy

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

  • Vybraný soubor musí být v rozmezí od 1 do 2097152 bajtů.: Soubor je příliš velký. Vyberte menší soubor.
  • 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 chcete importovat hodnoty klíčů z App Configuration Storu, musíte mít k ho obchodu přístup. V případě potřeby povolte veřejný přístup pro zdrojové úložiště nebo k němu přistupovat ze schváleného privátního koncového bodu. Pokud jste právě povolili veřejný přístup, počkejte až 5 minut, než se mezipaměť aktualizuje.

Další kroky