podpora konfigurace Aplikace Azure konfiguračních souborů

Běžným způsobem ukládání konfiguračních dat je použití souborů. Pokud chcete ke správě konfiguračních dat použít Azure App Configuration, ale aktuálně používáte soubory, nemusíte data zadávat ručně. Konfigurační soubory můžete importovat pomocí nástrojů.

Pokud plánujete spravovat data v App Configuration, je operace importu jednorázová migrace dat. Další možností je pokračovat ve správě konfiguračních dat v souborech a opakovaně importovat soubory jako součást procesu kontinuální integrace a průběžného doručování (CI/CD). Tento případ nastane, když přijmete konfiguraci jako kód.

Při použití konfiguračních souborů jsou k dispozici dva profily obsahu souborů:

Výchozí profil obsahu souboru: Schéma konvenčního konfiguračního souboru
Profil obsahu souboru KVSet: Schéma obsahující všechny vlastnosti klíč-hodnota konfigurace aplikace

Tento článek popisuje oba profily obsahu souborů. Poskytuje také příklady importu a exportu konfiguračních souborů. Příklady používají Azure CLI, ale koncepty v tomto článku platí také pro jiné metody importu konfigurace aplikací.

Profil obsahu souboru: výchozí

V nástrojích App Configuration je výchozím profilem obsahu souboru konvenční schéma konfiguračního souboru, které je široce přijímané stávajícími programovacími architekturami a systémy. Tento profil se používá v nástrojích pro import služby App Configuration, jako jsou Azure Portal, Azure CLI, úloha Import konfigurace aplikací v Azure Pipelines a GitHub Actions. App Configuration podporuje formáty souborů JSON, YAML a Properties.

Tento profil je užitečný, pokud chcete soubor použít jako záložní konfiguraci pro vaši aplikaci nebo místní konfiguraci během vývoje. Při importu konfiguračního souboru určíte, jak chcete data transformovat na hodnoty klíče a příznaky funkcí konfigurace aplikace.

Následující konfigurační soubor ,appsettings.json, poskytuje příklad výchozího profilu obsahu souboru. Tento soubor obsahuje jedno nastavení konfigurace a jeden příznak funkce.

{
    "Logging": {
        "LogLevel": {
            "Default": "Warning"
        }
    },
    "feature_management": {
        "feature_flags": [
            {
                "id": "Beta",
                "enabled": false
            }
        ]
    }
}

Pokud chcete tento soubor importovat do konfigurace aplikace, spusťte následující příkaz Azure CLI. Použije dev popisek pro nastavení a příznak funkce a použije dvojtečku (:) jako oddělovač pro zploštění názvu klíče.

az appconfig kv import --label dev --separator : --name <App-Configuration-store-name> --source file --path appsettings.json --format json

Volitelně můžete do předchozího příkazu přidat následující parametr: --profile appconfig/default. Parametr je volitelný, protože výchozí profil je appconfig/default.

Odkazy služby Azure Key Vault vyžadují při importu určitý typ obsahu. V důsledku toho je budete uchovávat v samostatném souboru, jak je znázorněno v následujícím souboru ,keyvault-refs.json:

{
    "Database:ConnectionString": {
        "uri": "https://<Key-Vault-name>.vault.azure.net/secrets/db-secret"
    }  
}

Pokud chcete importovat tento soubor, spusťte následující příkaz Azure CLI. Použije test popisek na odkaz služby Key Vault a použije typ referenčního obsahu služby Key Vault.

az appconfig kv import --label test --content-type "application/vnd.microsoft.appconfig.keyvaultref+json;charset=utf-8" --name <App-Configuration-store-name> --source file --path keyvault-refs.json --format json

Následující tabulka obsahuje všechna importovaná data v obchodě App Configuration Store:

Key	Hodnota	Popisek	Typ obsahu
.appconfig.featureflag/Beta	{"id":"Beta","description":","enabled": false,"conditions":{"client_filters":[]}}	Dev	application/vnd.microsoft.appconfig.ff+json; charset=utf-8
Protokolování:LogLevel:Default	Upozorňující	Dev
Database:ConnectionString	{"uri":"https://<Key-Vault-name>.vault.azure.net/secrets/db-secret"}	test	application/vnd.microsoft.appconfig.keyvaultref+json; charset=utf-8

Profil obsahu souboru: KVSet

V nástrojích App Configuration je profil obsahu souboru KVSet schéma souboru, které obsahuje všechny vlastnosti klíče konfigurace aplikace. Zahrnuté jsou název klíče, jeho hodnota, jeho popisek, typ obsahu a značky. Protože jsou v souboru všechny vlastnosti klíč-hodnota, nemusíte při importu souboru zadávat pravidla transformace.

Při použití profilu KVSet můžete v jednom souboru definovat běžné hodnoty klíčů, odkazy na službu Key Vault a příznaky funkcí. V důsledku toho je tento profil užitečný, pokud chcete spravovat všechna data konfigurace aplikací v jednom souboru a importovat je v jednom kroku.

Soubory, které tento profil používají, jsou ve formátu JSON. Specifikace schématu najdete ve schématu souboru KVSet.

Následující soubor ,appconfigdata.json, je založen na profilu obsahu souboru KVSet. Tento soubor obsahuje příznak funkce, odkaz služby Key Vault a standardní hodnotu klíče.

{
  "items": [
    {
      "key": ".appconfig.featureflag/Beta",
      "value": "{\"id\":\"Beta\",\"description\":\"Beta feature\",\"enabled\":true,\"conditions\":{\"client_filters\":[]}}",
      "label": "dev",
      "content_type": "application/vnd.microsoft.appconfig.ff+json;charset=utf-8",
      "tags": {}
    },
    {
      "key": "Database:ConnectionString",
      "value": "{\"uri\":\"https://<Key-Vault-name>.vault.azure.net/secrets/db-secret\"}",
      "label": "test",
      "content_type": "application/vnd.microsoft.appconfig.keyvaultref+json;charset=utf-8",
      "tags": {}
    },
    {
      "key": "Logging:LogLevel:Default",
      "value": "Debug",
      "label": "dev",
      "content_type": null,
      "tags": {}
    }
  ]
}

V předchozí části příklad ukazuje, jak importovat data do úložiště App Configuration. Tato data můžete exportovat do souboru pomocí následujícího příkazu Azure CLI:

az appconfig kv export --profile appconfig/kvset --label * --name <App-Configuration-store-name> --destination file --path appconfigdata.json --format json

Po exportu souboru ho otevřete v textovém editoru a proveďte následující změny:

Nastavte vlastnost příznaku funkce Betaenabled na hodnotu true.
Nastavte vlastnost Logging:LogLevel:Default na Debug.

Pokud chcete naimportovat aktualizovaný soubor do App Configuration Store, spusťte následující příkaz CLI s parametrem --profile appconfig/kvset. U výchozího profilu obsahu souboru nemusíte zadávat pravidla transformace dat, jako je oddělovač, popisek nebo typ obsahu. Všechny potřebné informace už jsou v souboru.

az appconfig kv import --profile appconfig/kvset --name <App-Configuration-store-name> --source file --path appconfigdata.json --format json

Poznámka:

Profil obsahu souboru KVSet se v současné době podporuje v:

Azure CLI verze 2.30.0 a novější.
Úloha importu služby Azure App Configuration verze 10.0.0 a novější
Azure Portal.

Následující tabulka obsahuje všechna importovaná data v obchodě App Configuration Store:

Key	Hodnota	Popisek	Typ obsahu
.appconfig.featureflag/Beta	{"id":"Beta","description":"Beta funkce","enabled":true,"conditions":{"client_filters":[]}}	Dev	application/vnd.microsoft.appconfig.ff+json; charset=utf-8
Protokolování:LogLevel:Default	Debug	Dev
Database:ConnectionString	{"uri":"https://<Key-Vault-name>.vault.azure.net/secrets/db-secret"}	test	application/vnd.microsoft.appconfig.keyvaultref+json; charset=utf-8

Další kroky

Konfigurace jako kód

Import a export konfiguračních dat

Váš názor

Byla tato stránka užitečná?

Last updated on 2025-09-22