Konfigurációs adatok importálása vagy exportálása

Az Azure App Configuration támogatja az adatimportálási és -exportálási műveleteket. Ezekkel a műveletekkel tömegesen dolgozhat konfigurációs adatokkal, és adatokat cserélhet az Alkalmazáskonfigurációs tár és a kódprojekt között. Beállíthat például egy alkalmazáskonfigurációs áruházat tesztelésre, egy másikat pedig éles környezetben. Az alkalmazásbeállításokat átmásolhatja közöttük, hogy ne kelljen kétszer megadnia az adatokat.

Ez a cikk az Adatok importálásához és exportálásához nyújt útmutatást az Azure Portal vagy az Azure CLI használatával. Ha kódként konfigurálta a konfigurációt , és a GitHubon vagy az Azure DevOpsban kezeli a konfigurációkat, beállíthatja a folyamatban lévő konfigurációs fájlok importálását a GitHub Actions használatával, vagy használhatja az Azure Pipeline Importálási feladatot.

Adatok importálása

Az importálás konfigurációs adatokat hoz létre egy alkalmazáskonfigurációs tárolóba egy meglévő forrásból. Az importálási függvénnyel adatokat migrálhat egy alkalmazáskonfigurációs tárolóba, vagy összesítheti az adatokat több forrásból.

Ez az útmutató az alkalmazáskonfigurációs adatok importálását mutatja be:

• egy konfigurációs fájlból JSON-, YAML- vagy Properties-fájlból
• alkalmazáskonfigurációs áruházból
• az Azure App Service-ből
• az Azure Kubernetes Service ConfigMaps szolgáltatásból

Adatok importálása konfigurációs fájlból

A kulcsértékek fájlból való importálásához kövesse az alábbi lépéseket.

portál

Az Azure Portalon kövesse az alábbi lépéseket:

1. Lépjen az Alkalmazáskonfigurációs áruházba, és válassza az Importálás/exportálás lehetőséget az Operatív menüből.

   

2. Alapértelmezés szerint az Importálás választógomb van kiválasztva. A Forrás típusa csoportban válassza a Konfigurációs fájl lehetőséget.

3. Töltse ki az űrlapot a következő paraméterekkel:

   Paraméter	Leírás	Példa
   Fájltípus	Válassza ki az importáláshoz használt fájltípust: YAML, Properties vagy JSON.	JSON

4. Kattintson a Tallózás gombra, és válassza ki az importálni kívánt fájlt.

5. Töltse ki az űrlap következő részét:

   Paraméter	Leírás	Példa
   Fájltartalom-profil	Válasszon ki egy tartalomprofilt: Alapértelmezett vagy KVSet. Az alapértelmezett fájltartalomprofil a meglévő programozási keretrendszerek vagy rendszerek által széles körben elfogadott hagyományos konfigurációs fájlséma, amely támogatja a JSON, YAML vagy Properties fájlformátumokat. A KVSet fájltartalomprofilja egy olyan fájlséma, amely egy alkalmazáskonfigurációs kulcs-érték összes tulajdonságát tartalmazza, beleértve a kulcsot, az értéket, a címkét, a tartalomtípust és a címkéket.	Alapértelmezett
   Importálás módja	Az importálási mód azt határozza meg, hogy figyelmen kívül hagyja-e az azonos kulcsértékeket. Az Egyezés figyelmen kívül hagyása beállítással a rendszer figyelmen kívül hagyja az áruház azon kulcsértékeket, amelyek megegyeznek a konfigurációs fájlban lévő értékekkel. A Minden beállítással a konfigurációs fájl összes kulcsértéke frissül.	Egyezés figyelmen kívül hagyása
   Funkciójelző kizárása	Ha be van jelölve, a funkciójelzők nem lesznek importálva.	Kijelöletlen
   Szigorú	Ha a jelölőnégyzet be van jelölve, az áruházban a megadott előtaggal és címkével rendelkező kulcsértékek, amelyek nem szerepelnek a konfigurációs fájlban, törlődnek, ha a Fájl tartalomprofil alapértelmezett értékre van állítva. Ha a Fájl tartalomprofilja KVSet értékre van állítva, a rendszer törli az áruházban azokat a kulcsértékeket, amelyek nem szerepelnek a konfigurációs fájlban. Ha a jelölőnégyzet nincs bejelölve, az áruházban nem lesznek kulcsértékek törölve.	Kijelöletlen
   Elválasztó	Az elválasztó a JSON- vagy YAML-fájlok kulcs-értékre való összesimításához használt elválasztó. A tulajdonságfájlok és a funkciójelzők figyelmen kívül lesznek hagyva. A támogatott értékek közé tartozik a nincs-elválasztó, a pont (.), a vessző (,), a pontosvessző (;), a kötőjel (-), az aláhúzásjel (_), a kettős aláhúzás (__), a perjel (/) és a kettőspont (:).	:
   Mélység	Opcionális. A JSON- vagy YAML-fájlok kulcs-érték párokba való összesimításának mélysége. Alapértelmezés szerint a fájlok a legmélyebb szintre vannak kibontva, ha egy elválasztó van kiválasztva. Ez a beállítás nem alkalmazható tulajdonságfájlokra vagy funkciójelölőkre.
   Előtag hozzáadása	Opcionális. Ha meg van adva, egy előtag lesz hozzáadva az összes importált kulcsérték kulcsnevéhez.	TestApp:
   Címke hozzáadása	Opcionális. Ha meg van adva, a megadott címke az összes importált kulcsértékhez hozzá lesz rendelve.	bök
   Tartalomtípus hozzáadása	Opcionális. Ha meg van adva, a megadott tartalomtípus hozzá lesz adva az összes importált kulcsértékhez.	JSON (alkalmazás/json)
   Címkék hozzáadása	Opcionális. Ha meg van adva, a megadott címkék az összes importált kulcsértékhez hozzá lesznek adva.	{címke: címke1}

6. Az importálás folytatásához válassza az Alkalmaz lehetőséget.

Sikeresen importált kulcsértékeket egy JSON-fájlból. A kulcsnevek az : elválasztó segítségével lettek laposítva, és a TestApp: előtaggal ellátva. Az összes importált kulcsérték a prod címkével, a application/json tartalomtípussal és a tag: tag1 címkével van ellátva.

Azure CLI

Az Azure CLI-ben kövesse az alábbi lépéseket. Ha nem telepítette helyileg az Azure CLI-t, használhatja az Azure Cloud Shellt is.

1. Adja meg az importálási parancsot az appconfig kv import , és adja hozzá a következő paramétereket:

   Paraméter	Leírás	Példa
   --name	Adja meg annak az alkalmazáskonfigurációs tárolónak a nevét, amelybe adatokat szeretne importálni.	my-app-config-store
   --source	Adja meg file , hogy az alkalmazáskonfigurációs adatokat fájlból importálja.	file
   --path	Adja meg az importálni kívánt adatokat tartalmazó fájl helyi elérési útját.	C:/Users/john/Downloads/data.json
   --format	Adja meg a yaml, a tulajdonságok vagy a json értéket az importálni kívánt fájl formátumának jelzéséhez.	json

2. Opcionálisan adja hozzá a következő paramétereket is:

   Paraméter	Leírás	Példa
   --separator	Opcionális. Az elválasztó a kulcsértékek JSON/YAML-hez való simításának elválasztójele. A hierarchikus struktúra exportálásához szükséges, és a tulajdonságfájlok és a funkciójelölők figyelmen kívül lesznek hagyva. Válasszon egyet a következő lehetőségek közül: ., ,, , :, ;/, -, , _. —	;
   --prefix	Opcionális. A kulcselőtag a kulcs első része. Az előtagok a kulcsértékek csoportjainak kezelésére használhatók egy konfigurációs tárban. Ez az előtag hozzá lesz fűzve az egyes importált kulcsértékek "key" tulajdonságának elejéhez.	TestApp:
   --label	Opcionális. Adjon meg egy címkét, amely hozzá lesz rendelve az importált kulcsértékekhez.	prod
   --content-type	Opcionális. Adjon meg appconfig/kvset vagy application/json, ha az importált tartalom Key Vault-hivatkozásból vagy JSON-fájlból áll.	application/json

   Példa: importálja az összes kulcsértéket és funkciójelzőt egy JSON-fájlból, alkalmazza a "prod" címkét, és fűzze hozzá a "TestApp" előtagot. Adja hozzá az "application/json" tartalomtípust.

   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. A parancssor megjeleníti a következő módosítások listáját. Az importálás megerősítéséhez válassza a ylehetőséget.

   

Kulcsértékeket importált egy JSON-fájlból, és hozzárendelte a "prod" címkét és a "TestApp:" előtagot. A rendszer az ";" elválasztót használja, és az importált kulcsértékek tartalomtípusa "JSON".

További választható paraméterekért és példákért tekintse meg az az appconfig kv importálást.

Adatok importálása alkalmazáskonfigurációs áruházból

Importálhat értékeket az egyik Alkalmazáskonfigurációs áruházból egy másik Alkalmazáskonfigurációs áruházba, vagy importálhat értékeket egy Alkalmazáskonfigurációs áruházból ugyanarra az Alkalmazáskonfigurációs áruházba, hogy megkettőzhesse az értékeit, és különböző paramétereket, például új címkét vagy tartalomtípust alkalmazhasson.

Az alábbi lépéseket követve importálhat kulcsértékeket és funkciójelzőket egy Azure App Configuration Store-ból.

portál

Az Azure Portalon kövesse az alábbi lépéseket:

1. Lépjen az Alkalmazáskonfigurációs áruházba, és válassza az Importálás/exportálás lehetőséget az Operatív menüből.

   

2. Alapértelmezés szerint az Importálás választógomb van kiválasztva. A Forrás típusa területen válassza az Alkalmazáskonfiguráció lehetőséget.

3. Válasszon ki egy alkalmazáskonfigurációs tárolót az adatok importálásához, és töltse ki az űrlapot a következő paraméterekkel:

   Paraméter	Leírás	Példa
   Előfizetés	Az aktuális előfizetés alapértelmezés szerint ki van választva.	saját előfizetés
   Erőforráscsoport	Válasszon egy erőforráscsoportot, amely az importálandó konfigurációval rendelkező Alkalmazáskonfigurációs tárolót tartalmazza. Alapértelmezés szerint az aktuális erőforráscsoport van kiválasztva.	saját erőforráscsoport
   Erőforrás	Válassza ki az importálni kívánt konfigurációt tartalmazó alkalmazáskonfigurációs áruházat.	másik-alkalmazás-konfiguráció-áruház

4. Töltse ki az űrlap következő részét:

   Paraméter	Leírás	Példa
   Kijelölési mód	Válassza ki, hogy a normál kulcsértékekből szeretne-e importálni, ami az alapértelmezett beállítás, vagy pillanatképből.	Alapértelmezett
   Kulcsszűrő	A kulcsértékek importáláshoz használt kulcsnév alapján történő szűrésére szolgál. Ha nincs megadva kulcs, minden kulcs választható.	Teszteléssel kezdődik
   Adott időpontban	Opcionális. Töltse ki ezt a mezőt, ha kulcsértékeket szeretne importálni egy adott időpontból a kiválasztott konfigurációs tárban. Amennyiben üresen marad, alapértelmezésként a kulcsértékek aktuális időpontját veszi.	2022. 07. 28. 12:00:00
   Címkéről	Jelöljön ki egy vagy több címkét a címkékhez társított kulcsértékek importálásához. Ha nincs kijelölve címke, az összes címke kiválasztható.	bök
   Funkciójelző kizárása	Ha be van jelölve, a funkciójelzők nem lesznek importálva.	Kijelöletlen
   Előtag hozzáadása	Opcionális. Ha meg van adva, egy előtag lesz hozzáadva az összes importált kulcsérték kulcsnevéhez.	TestApp:
   Címkék felülbírálása	Opcionális. Alapértelmezés szerint a forráskulcs-értékek eredeti címkéi megmaradnak. A felülbírálásukhoz jelölje be a jelölőnégyzetet, és adjon meg egy új címkét az importált kulcsértékekhez.	új
   Tartalomtípusok felülbírálása	Opcionális. Alapértelmezés szerint a forráskulcs-értékek eredeti tartalomtípusai megmaradnak. A felülbírálásukhoz jelölje be a jelölőnégyzetet, és adjon meg egy új tartalomtípust az importált kulcsértékekhez. Vegye figyelembe, hogy a funkciójelölők tartalomtípusa nem bírálható felül.	JSON (alkalmazás/json)

5. Az importálás folytatásához válassza az Alkalmaz lehetőséget.

2021. január 28-án, 0 órakor importálta a kulcs-érték párokat egy App Configuration áruházból, a kulcsnevek a test előtaggal és a prod címkével kezdődnek. A kulcsnevekhez előtagként lett hozzáadva TestApp:. Az összes importált kulcsértékhez hozzá lett rendelve a címke new és a tartalomtípus application/json.

Azure CLI

Az Azure CLI-ben kövesse az alábbi lépéseket. Ha nem telepítette helyileg az Azure CLI-t, használhatja az Azure Cloud Shellt is.

1. Adja meg az importálási parancsot az appconfig kv import , és adja meg a következő paramétereket:

   Paraméter	Leírás	Példa
   --name	Adja meg annak az Alkalmazáskonfigurációs áruháznak a nevét, amelybe adatokat szeretne importálni	my-app-config-store
   --source	Írja be a appconfig jelet, hogy jelezze: adatokat importál egy alkalmazáskonfigurációs tárból.	appconfig
   --src-name	Adja meg annak az Alkalmazáskonfigurációs áruháznak a nevét, amelyből adatokat szeretne importálni.	my-source-app-config
   --src-label	Korlátozza az importálást egy adott címkével rendelkező kulcsértékekre. Ha nem használja ezt a paramétert, csak a null címkével rendelkező kulcsértékek lesznek importálva. Támogatja a csillagjelet szűrőként: írja be * az összes címkét; abc* az összes abc előtagú címkét.	prod

2. Opcionálisan adja hozzá a következő paramétereket:

   Paraméter	Leírás	Példa
   --label	Opcionális. Adjon meg egy címkét, amely hozzá lesz rendelve az importált kulcsértékekhez.	new
   --content-type	Opcionális. Adjon meg appconfig/kvset vagy application/json, ha az importált tartalom Key Vault-hivatkozásból vagy JSON-fájlból áll. A tartalomtípus csak az importált kulcsértékek esetében bírálható felül. A funkciójelölők tartalomtípusának alapértelmezett értéke az "application/vnd.microsoft.appconfig.ff+json; charset=utf-8", és ez a paraméter nem változtatja meg.	application/json

   Példa: importálja a kulcsértékeket és a funkciójelzőket a "prod" címkével egy másik alkalmazáskonfigurációból, és rendelje hozzájuk az "új" címkét. Adja hozzá az "application/json" tartalomtípust.

   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. A parancssor megjeleníti a következő módosítások listáját. Az importálás megerősítéséhez válassza a ylehetőséget.

   

A kulcsértékeket a "prod" címkével importálta egy Alkalmazáskonfigurációs áruházból, és hozzárendelte az "új" címkét. Az importált kulcsértékek tartalomtípusa "JSON".

További választható paraméterekért és példákért tekintse meg az az appconfig kv importálást.

Adatok importálása az Azure App Service-ből

A kulcsértékek Azure App Service-ből való importálásához kövesse az alábbi lépéseket.

Megjegyzés:

Az App Service jelenleg nem támogatja a funkciójelzőket. Az App Service-be importált összes funkciójelző automatikusan kulcsértékekké alakul. Az App Service-erőforrások csak kulcsértékeket tartalmazhatnak.

portál

Az Azure Portalon:

1. Lépjen az Alkalmazáskonfigurációs áruházba, és válassza az Importálás/exportálás lehetőséget az Operatív menüből.

   

2. Alapértelmezés szerint az Importálás választógomb van kiválasztva. A Forrás típusa területen válassza az App Services lehetőséget.

3. Válasszon ki egy alkalmazáskonfigurációs tárolót az adatok importálásához, és töltse ki az űrlapot a következő paraméterekkel:

   Paraméter	Leírás	Példa
   Előfizetés	Az aktuális előfizetés alapértelmezés szerint ki van választva.	saját előfizetés
   Erőforráscsoport	Válasszon ki egy erőforráscsoportot, amely az importálandó konfigurációval rendelkező App Service-t tartalmazza.	saját erőforráscsoport
   Erőforrás	Válassza ki az importálni kívánt konfigurációt tartalmazó App Service-t.	my-app-service

4. Töltse ki az űrlap következő részét:

   Paraméter	Leírás	Példa
   Beállítások frissítése hivatkozás céljából	Ha be van jelölve, az App Service alkalmazásbeállításai frissülnek az importált kulcsértékek alkalmazáskonfigurációs hivatkozásaira. Ez lehetővé teszi az alkalmazásbeállítások kezelését az alkalmazáskonfigurációban. Az App Service automatikusan lekéri az aktuális értéket az Alkalmazáskonfigurációból. További információt az App Service és az Azure Functions alkalmazáskonfigurációs hivatkozásainak használata című témakörben talál.	Ellenőrizve
   Előtag hozzáadása	Opcionális. Ha meg van adva, egy előtag lesz hozzáadva az összes importált kulcsérték kulcsnevéhez.	TestApp:
   Címke hozzáadása	Opcionális. Ha meg van adva, a megadott címke az összes importált kulcsértékhez hozzá lesz rendelve.	bök
   Tartalomtípus hozzáadása	Opcionális. Ha meg van adva, a megadott tartalomtípus hozzá lesz adva az összes importált kulcsértékhez.	JSON (alkalmazás/json)

5. Az importálás folytatásához válassza az Alkalmaz lehetőséget.

Egy App Service-ből az összes alkalmazásbeállítást kulcsértékekként importálta, és hozzárendelte a címkét prod és az előtagot TestApp:. Az importált kulcsértékek tartalomtípusa a application/jsonkövetkezőképpen van beállítva: .

Azure CLI

Az Azure CLI-ben kövesse az alábbi lépéseket. Ha nem telepítette helyileg az Azure CLI-t, használhatja az Azure Cloud Shellt is.

1. Adja meg az importálási parancsot az appconfig kv import , és adja hozzá a következő paramétereket:

   Paraméter	Leírás	Példa
   --name	Adja meg annak az alkalmazáskonfigurációs tárolónak a nevét, amelybe adatokat szeretne importálni.	my-app-config-store
   --source	Írja be appservice, hogy importálja az alkalmazáskonfigurációs adatokat az Azure App Service-ből.	appservice
   --appservice-account	Adja meg az App Service ARM-azonosítóját, vagy használja az App Service nevét, ha ugyanabban az előfizetésben és erőforráscsoportban van, mint az appkonfiguráció.	/subscriptions/123/resourceGroups/my-resource-group/providers/Microsoft.Web/sites/my-app-service vagy my-app-service

2. Opcionálisan adja hozzá a következő paramétereket is:

   Paraméter	Leírás	Példa
   --prefix	Opcionális. A kulcselőtag egy kulcs-érték "key" tulajdonságának első része. Az előtagok a kulcsértékek csoportjainak kezelésére használhatók egy konfigurációs tárban. Ez az előtag hozzá lesz fűzve az egyes importált kulcsértékek "key" tulajdonságának elejéhez.	TestApp:
   --label	Opcionális. Adjon meg egy címkét, amely hozzá lesz rendelve az importált kulcsértékekhez. Ha nem ad meg címkét, a null címke hozzá lesz rendelve a kulcsértékekhez.	prod
   --content-type	Opcionális. Az appconfig/kvset vagy az application/json megadása jelzi, hogy az importált tartalom Key Vault-referencia vagy JSON-fájl.	application/json

   Az --appservice-account érték lekéréséhez használja a az webapp show --resource-group <resource-group> --name <resource-name> parancsot.

   Példa: importálja az összes alkalmazásbeállítást az App Service-ből kulcsértékekként a "prod" címkével, az Alkalmazáskonfigurációs áruházba, és adjon hozzá egy "TestApp:" előtagot.

   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. A parancssor megjeleníti a következő módosítások listáját. Az importálás megerősítéséhez válassza a ylehetőséget.

   

Az App Service-ből az összes alkalmazásbeállítást kulcsértékekként importálta, hozzárendelte a "prod" címkét, és hozzáadott egy "TestApp:" előtagot. Az importált kulcsértékek tartalomtípusa "JSON".

További választható paraméterekért és példákért tekintse meg az az appconfig kv importálást.

Adatok importálása az Azure Kubernetes Service ConfigMaps szolgáltatásból

Az alábbi lépéseket követve importálhat kulcsértékeket az Azure Kubernetes Service ConfigMaps szolgáltatásból. A szolgáltatás portáltámogatása fejlesztés alatt áll, az Azure CLI használatával importálhat az AKS-ből.

portál

A szolgáltatáshoz az Azure Portal támogatása fejlesztés alatt áll.

Azure CLI

Az Azure CLI-ben kövesse az alábbi lépéseket. Ha nem telepítette helyileg az Azure CLI-t, használhatja az Azure Cloud Shellt is.

1. Adja meg az importálási parancsot az appconfig kv import , és adja hozzá a következő paramétereket:

   Paraméter	Leírás	Példa
   --name	Adja meg annak az alkalmazáskonfigurációs tárolónak a nevét, amelybe adatokat szeretne importálni.	my-app-config-store
   --source	Adja meg aks , hogy alkalmazáskonfigurációs adatokat importáljon az Azure Kubernetes Service-ből.	aks
   --aks-cluster	Adja meg az Azure Kubernetes Service ARM-azonosítóját, vagy használja az Azure Kubernetes Service nevét, ha ugyanabban az előfizetésben és erőforráscsoportban van, mint az alkalmazáskonfiguráció.	/subscriptions/123/resourceGroups/my-resource-group/providers/Microsoft.ContainerService/managedClusters/my-aks-cluster vagy my-aks-cluster
   --configmap-namespace	Adja meg az importálni kívánt ConfigMap névterét.	default
   --configmap-name	Adja meg az importálni kívánt ConfigMap nevét.	my-configmap

2. Opcionálisan adja hozzá a következő paramétereket is:

   Paraméter	Leírás	Példa
   --prefix	Opcionális. A kulcselőtag egy kulcs-érték "key" tulajdonságának első része. Az előtagok a kulcsértékek csoportjainak kezelésére használhatók egy konfigurációs tárban. Ez az előtag hozzá lesz fűzve az egyes importált kulcsértékek "key" tulajdonságának elejéhez.	TestApp:
   --label	Opcionális. Adjon meg egy címkét, amely hozzá lesz rendelve az importált kulcsértékekhez. Ha nem ad meg címkét, a null címke hozzá lesz rendelve a kulcsértékekhez.	test
   --content-type	Opcionális. Az appconfig/kvset vagy az application/json megadása jelzi, hogy az importált tartalom Key Vault-referencia vagy JSON-fájl.	application/json
   --format	Opcionális. Adja meg a yaml, tulajdonságok vagy json formátumot az importálandó ConfigMap formátumának jelzéséhez.	json
   --separator	Opcionális. Az elválasztó a kulcs-érték párok laposításának elválasztójele. A hierarchikus struktúra exportálásához szükséges, és a tulajdonságfájlok és a funkciójelölők figyelmen kívül lesznek hagyva. Válasszon egyet a következő lehetőségek közül: ., ,, , :, ;/, -, , _. —	;

   Az --aks-cluster érték lekéréséhez használja a az aks show --resource-group <resource-group> --name <aks-cluster-name> parancsot.

   Példa: importálja az összes beállítást az AKS Configmap-ból kulcsértékekként a "test" címkével, az Alkalmazáskonfigurációs áruházba, és adjon hozzá egy "TestApp:" előtagot.

   az appconfig kv import --name my-app-config-store --source aks --aks-cluster /subscriptions/123/resourceGroups/my-resource-group/providers/Microsoft.ContainerService/managedClusters/my-aks-cluster --configmap-namespace default --configmap-name my-configmap --label test --prefix TestApp:
   

3. A parancssor megjeleníti a következő módosítások listáját. Az importálás megerősítéséhez válassza a ylehetőséget.

   

Az AKS ConfigMap összes beállítását kulcsértékekként importálta, hozzárendelte a "test" címkét, és hozzáadta a "TestApp:" előtagot.

További választható paraméterekért és példákért tekintse meg az az appconfig kv importálást.

Adatexportálás

Az Alkalmazáskonfigurációban tárolt konfigurációs adatok exportálása másik helyre. Az exportálási függvény használatával például adatokat menthet egy alkalmazáskonfigurációs tárolóból egy olyan fájlba, amely beágyazható az alkalmazáskódba az üzembe helyezés során.

Ez az útmutató bemutatja, hogyan exportálhatja az alkalmazáskonfigurációs adatokat:

• egy konfigurációs fájlba JSON-, YAML- vagy Properties-fájlban
• alkalmazáskonfigurációs áruházba
• Azure App Service-erőforrásba

Adatok exportálása konfigurációs fájlba

Ezeket a lépéseket követve exportálhatja a konfigurációs adatokat egy alkalmazáskonfigurációs tárolóból egy JSON-, YAML- vagy Tulajdonságokfájlba.

portál

Az Azure Portalon kövesse az alábbi lépéseket:

1. Lépjen az Alkalmazáskonfigurációs áruházba, és válassza az Importálás/exportálás lehetőséget.

   

2. Válassza az Exportálás választógombot, majd a Cél típusa területen válassza a Konfigurációs fájl lehetőséget.

3. Töltse ki az űrlapot a következő paraméterekkel:

   Paraméter	Leírás	Példa
   Fájltípus	Válassza ki az exportáláshoz szükséges fájltípust: YAML, Properties vagy JSON.	JSON
   Fájltartalom-profil	Válasszon ki egy tartalomprofilt: Alapértelmezett vagy KVSet. Az alapértelmezett fájltartalomprofil a meglévő programozási keretrendszerek vagy rendszerek által széles körben elfogadott hagyományos konfigurációs fájlséma, amely támogatja a JSON, YAML vagy Properties fájlformátumokat. A KVSet fájltartalomprofilja egy olyan fájlséma, amely egy alkalmazáskonfigurációs kulcs-érték összes tulajdonságát tartalmazza, beleértve a kulcsot, az értéket, a címkét, a tartalomtípust és a címkéket.	Alapértelmezett
   Kijelölési mód	Itt adhatja meg, hogy a normál kulcsértékekből , amely az alapértelmezett beállítás, vagy pillanatképből szeretne-e exportálni.	Alapértelmezett
   Kulcsszűrő	Kulcsértékek szűrésére szolgál az exportálás kulcsneve alapján. Ha nincs megadva kulcs, minden kulcs választható.	A TestApp alkalmazással kezdődik:
   Adott időpontban	Opcionális. Ezt a mezőt kitöltve exportálhatja a kulcsértékeket egy adott időpontból a kiválasztott konfigurációs tárban. Amennyiben üresen marad, alapértelmezésként a kulcsértékek aktuális időpontját veszi.	2022. 07. 28. 12:00:00
   Címkéről	Jelölje ki a címkét a címkékhez társított kulcsértékek exportálásához. Ha nincs kijelölve címke, az összes címke kiválasztható. Vegye figyelembe, hogy a fájltartalom-profillal Default való exportáláskor csak egy címkét jelölhet ki. Egynél több címkével rendelkező kulcsértékek exportálásához használja a fájltartalom-profilt KVSet .	bök
   Előtag eltávolítása	Opcionális. Ha meg van adva, az előtag el lesz távolítva az azt tartalmazó összes exportált kulcsérték kulcsnevéből.	TestApp:
   Elválasztó	Az elválasztó a kulcsnevek szegmentálásához és a JSON- vagy YAML-fájlok hierarchikus konfigurációinak kulcsértékekből való rekonstruálásához használt elválasztó. A tulajdonságfájlok és a funkciójelzők figyelmen kívül lesznek hagyva. A támogatott értékek közé tartozik az elválasztójel, a pont (.), a vessző (,), a pontosvessző (;), a kötőjel (-), az aláhúzásjel (_), a kettős aláhúzás (__), a perjel (/) és a kettőspont (:).	:

4. Az exportálás befejezéséhez válassza az Exportálás lehetőséget.

A kulcsértékeket 2021. július 28-án éjfélkor exportálta egy Alkalmazáskonfigurációs áruházból JSON-fájlba, a TestApp: kezdésű kulcsnevekkel és a prod címkével. Az előtagot TestApp: levágták a kulcsnevekből, az elválasztó : pedig a kulcsnevek szegmentálására és a hierarchikus JSON-formátum rekonstruálására szolgál.

Azure CLI

Az Azure CLI-ben kövesse az alábbi lépéseket. Ha nem telepítette helyileg az Azure CLI-t, használhatja az Azure Cloud Shellt is.

1. Adja meg az exportálási parancsot az appconfig kv export , és adja hozzá a következő paramétereket:

   Paraméter	Leírás	Példa
   --name	Adja meg az exportálni kívánt kulcsértékeket tartalmazó Alkalmazáskonfigurációs áruház nevét.	my-app-config-store
   --destination	Írja be file , hogy jelezze, hogy adatokat exportál egy fájlba.	file
   --path	Adja meg azt az elérési utat, ahová menteni szeretné a fájlt.	C:/Users/john/Downloads/data.json
   --format	Adja meg yaml, properties vagy json adja meg az exportálni kívánt fájl formátumát.	json
   --label	Adjon meg egy címkét a kulcsértékek és a funkciójelzők exportálásához ezzel a címkével. Ha nem ad meg címkét, alapértelmezés szerint csak a kulcsértékeket és a funkciójelzőket exportálja címke nélkül. Megadhat egy címkét, több címkét is megadhat, ha elválasztja őket a címkével ,, vagy az * összes címkét figyelembe veszi.	prod

   Fontos

   Ha nem jelöl ki címkét, csak a címkék nélküli kulcsértékek lesznek exportálva. Ha címkével szeretne exportálni egy kulcsértéket, ki kell választania annak címkéjét.

2. Opcionálisan adja hozzá a következő paramétereket is:

   Paraméter	Leírás	Példa
   --separator	Opcionális. Az elválasztó a kulcsértékek JSON/YAML-hez való simításának elválasztójele. A hierarchikus struktúra exportálásához szükséges, és a tulajdonságfájlok és a funkciójelölők figyelmen kívül lesznek hagyva. Válasszon egyet a következő lehetőségek közül: ., ,, , :, ;/, -, , _. —	;
   --prefix	Opcionális. Az egyes kulcsértékek "kulcs" tulajdonságából levágandó előtag. A kulcselőtag a kulcs első része. Az előtagok a kulcsértékek csoportjainak kezelésére használhatók egy konfigurációs tárban. A rendszer figyelmen kívül hagyja az előtagot a funkciójelzők esetében.	TestApp:

   Példa: exportálja az összes kulcsértéket és funkciójelzőt "prod" címkével egy JSON-fájlba.

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

3. A parancssor megjeleníti a fájlba exportált kulcsértékek listáját. Az exportálás megerősítéséhez válassza a ylehetőséget.

   

A változatfunkció-jelzők a Microsoft Szolgáltatásfelügyeleti sémával exportálhatók egy fájlba, míg a többi funkciójelölőt a .NET szolgáltatásfelügyeleti sémával exportálja a kompatibilitás érdekében. Ha a funkciójelzőket kizárólag a Microsoft Szolgáltatáskezelési sémával szeretné exportálni, állítsa a AZURE_APPCONFIG_FM_COMPATIBLE környezeti változót Hamis értékre.

Olyan kulcsértékeket és funkciójelölőket exportált, amelyek "prod" címkével rendelkeznek egy konfigurációs fájlba, és levágták a "TestApp" előtagot. Az értékeket a fájlban lévő ";" választja el egymástól.

További választható paraméterekért és példákért tekintse meg az az appconfig kv exportálást.

Adatok exportálása alkalmazáskonfigurációs áruházba

Az alábbi lépéseket követve exportálhatja a kulcsértékeket és a funkciójelzőket egy Azure App Configuration Store-ba.

Az egyik Alkalmazáskonfigurációs áruházból exportálhat értékeket egy másik Alkalmazáskonfigurációs áruházba, vagy exportálhat értékeket egy Alkalmazáskonfigurációs áruházból ugyanarra az Alkalmazáskonfigurációs áruházba, hogy megkettőzhesse az értékeit, és különböző paramétereket, például új címkét vagy tartalomtípust alkalmazhasson.

portál

Az Azure Portalon kövesse az alábbi lépéseket:

1. Lépjen az exportálni kívánt adatokat tartalmazó Alkalmazáskonfigurációs tárolóba, és válassza az Importálás/exportálás lehetőséget az Operatív menüből.

   

2. Válassza az Exportálás választógombot, majd a Cél típusa területen válassza az Alkalmazáskonfiguráció lehetőséget.

3. Töltse ki az űrlapot a következő paraméterekkel:

   Paraméter	Leírás	Példa
   Kijelölési mód	Itt adhatja meg, hogy a normál kulcsértékekből , amely az alapértelmezett beállítás, vagy pillanatképből szeretne-e exportálni.	Alapértelmezett
   Kulcsszűrő	Kulcsértékek szűrésére szolgál az exportálás kulcsneve alapján. Ha nincs megadva kulcs, minden kulcs választható.	A TestApp alkalmazással kezdődik:
   Adott időpontban	Opcionális. Ezt a mezőt kitöltve exportálhatja a kulcsértékeket egy adott időpontból a kiválasztott konfigurációs tárban. Amennyiben üresen marad, alapértelmezésként a kulcsértékek aktuális időpontját veszi.	2022. 07. 28. 12:00:00
   Címkéről	Jelöljön ki egy vagy több címkét a címkékhez társított kulcsértékek exportálásához. Ha nincs kijelölve címke, az összes címke kiválasztható.	bök
   Funkciójelző kizárása	Ha be van jelölve, a funkciójelzők nem lesznek exportálva.	Kijelöletlen

4. Válassza ki a céltárolót, és töltse ki az űrlapot a következő paraméterekkel:

   Paraméter	Leírás	Példa
   Előfizetés	Az aktuális előfizetés alapértelmezés szerint ki van választva.	saját előfizetés
   Erőforráscsoport	Válasszon ki egy erőforráscsoportot, amely tartalmazza azt az alkalmazáskonfigurációs tárolót, ahová exportálni szeretné a konfigurációt. Alapértelmezés szerint az aktuális erőforráscsoport van kiválasztva.	saját erőforráscsoport
   Erőforrás	Válassza ki azt az alkalmazáskonfigurációs áruházat, ahová exportálni szeretné a konfigurációt.	másik-alkalmazás-konfiguráció-áruház

5. Töltse ki az űrlap következő részét:

   Paraméter	Leírás	Példa
   Előtag eltávolítása	Opcionális. Ha meg van adva, az előtag el lesz távolítva az azt tartalmazó összes exportált kulcsérték kulcsnevéből.	TestApp:
   Címkék felülbírálása	Opcionális. Alapértelmezés szerint a forráskulcs-értékek eredeti címkéi megmaradnak. A felülbírálásukhoz jelölje be a jelölőnégyzetet, és adjon meg egy új címkét az exportált kulcsértékekhez.	új
   Tartalomtípusok felülbírálása	Opcionális. Alapértelmezés szerint a forráskulcs-értékek eredeti tartalomtípusai megmaradnak. A felülbírálásukhoz jelölje be a jelölőnégyzetet, és adjon meg egy új tartalomtípust az exportált kulcsértékekhez. Vegye figyelembe, hogy a funkciójelölők tartalomtípusa nem bírálható felül.	JSON (alkalmazás/json)

6. Az exportálás folytatásához válassza az Alkalmaz elemet.

A kulcsértékeket 2022. július 28-án, éjfélkor exportálta egy Alkalmazáskonfigurációs áruházból, amelynek a kulcsnevei a következővel TestApp: kezdődnek, és a címke prod, egy másik Alkalmazáskonfigurációs áruházba. Az exportált kulcsértékeknél eltávolították a kulcselőtagot TestApp:, majd hozzárendelték a címkét new és a tartalomtípust application/json.

Azure CLI

Az Azure CLI-ben kövesse az alábbi lépéseket. Ha nem telepítette helyileg az Azure CLI-t, használhatja az Azure Cloud Shellt is.

1. Adja meg az exportálási parancsot az appconfig kv export , és adja meg a következő paramétereket:

   Paraméter	Leírás	Példa
   --name	Adja meg az exportálni kívánt kulcsértékeket tartalmazó Alkalmazáskonfigurációs áruház nevét.	my-app-config-store
   --destination	Adja meg appconfig , hogy adatokat exportáljon egy alkalmazáskonfigurációs áruházba.	appconfig
   --dest-name	Adja meg annak az alkalmazáskonfigurációs tárolónak a nevét, amelybe adatokat szeretne exportálni.	my-other-app-config-store
   --label	Adjon meg egy címkét a kulcsértékek és a funkciójelzők exportálásához ezzel a címkével. Ha nem ad meg címkét, alapértelmezés szerint csak a kulcsértékeket és a funkciójelzőket exportálja címke nélkül. Megadhat egy címkét, több címkét is megadhat, ha elválasztja őket ,, vagy az * összes címkét figyelembe veszi.	prod

   Fontos

   Ha az exportálni kívánt kulcsértékek címkéket tartalmaznak, a parancsot --label kell használnia, és be kell írnia a megfelelő címkéket. Ha nem jelöl ki címkét, csak a címkék nélküli kulcsértékek lesznek exportálva. Vesszőjel (,) használatával jelöljön ki több címkét, vagy használja * az összes címkét, beleértve a null címkét (nincs címke).

2. Opcionálisan adja hozzá a következő paramétert is:

   Paraméter	Leírás	Példa
   --dest-label	Opcionális. Adjon meg egy célcímkét, és rendelje hozzá ezt a címkét az exportált kulcsértékekhez.	new

   Példa: exportálja a kulcsértékeket és a funkciójelzőket a "prod" címkével egy másik Alkalmazáskonfigurációs áruházba, és adja hozzá az "új" célcímkét.

   az appconfig kv export --name my-app-config-store --destination appconfig --dest-name my-other-app-config-store --dest-label new --label prod
   

3. A parancssor megjeleníti a fájlokba exportált kulcsértékek listáját. Az exportálás megerősítéséhez válassza a ylehetőséget.

   

Olyan kulcsértékeket és funkciójelölőket exportált, amelyek "prod" címkével rendelkeznek egy Alkalmazáskonfigurációs áruházból, és hozzárendelte őket az "új" címkéhez.

További választható paraméterekért és példákért tekintse meg az az appconfig kv importálást.

Adatok exportálása az Azure App Service-be

A kulcsértékek Azure App Service-be való exportálásához kövesse az alábbi lépéseket.

Megjegyzés:

A funkciójelzők App Service-be való exportálása nem támogatott.

portál

Az Azure Portalon kövesse az alábbi lépéseket:

1. Lépjen az Alkalmazáskonfigurációs áruházba, és válassza az Importálás/exportálás lehetőséget az Operatív menüből.

   

2. Válassza az Exportálás választógombot, majd a Cél típusa területen válassza az App Services lehetőséget.

3. Az Exportálás hivatkozásként beállítás alapértelmezés szerint be van jelölve. Ha a jelölőnégyzet be van jelölve, az App Service alkalmazásbeállításai alkalmazáskonfigurációs hivatkozásként jelennek meg az exportált kulcsértékekhez. Így kezelheti a beállításokat az App Configurationban, és az App Service automatikusan lekérte az aktuális értékeket az App Configurationból. További információt az App Service és az Azure Functions alkalmazáskonfigurációs hivatkozásainak használata című témakörben talál. Ha a jelölőnégyzet nincs bejelölve, a kulcs és az érték közvetlenül az App Service-be lesz exportálva. Ne felejtse el újra exportálni az adatokat, amikor módosításokat hajt végre az Alkalmazáskonfigurációban annak érdekében, hogy az alkalmazás átvegye a frissítéseket.

4. Töltse ki az űrlapot a következő paraméterekkel:

   Paraméter	Leírás	Példa
   Kijelölési mód	Itt adhatja meg, hogy a normál kulcsértékekből , amely az alapértelmezett beállítás, vagy pillanatképből szeretne-e exportálni.	Alapértelmezett
   Kulcsszűrő	Kulcsértékek szűrésére szolgál az exportálás kulcsneve alapján. Ha nincs megadva kulcs, minden kulcs választható.	A TestApp alkalmazással kezdődik:
   Adott időpontban	Opcionális. Ezt a mezőt kitöltve exportálhatja a kulcsértékeket egy adott időpontból a kiválasztott konfigurációs tárban. Amennyiben üresen marad, alapértelmezésként a kulcsértékek aktuális időpontját veszi.	2022. 07. 28. 12:00:00
   Címkéről	Jelöljön ki egy címkét a címkéhez társított kulcsértékek exportálásához.	bök

5. Válasszon ki egy céltárolót, és töltse ki az űrlapot a következő paraméterekkel:

   Paraméter	Leírás	Példa
   Előfizetés	Az aktuális előfizetés alapértelmezés szerint ki van választva.	saját előfizetés
   Erőforráscsoport	Válasszon ki egy erőforráscsoportot, amely tartalmazza azt az App Service-t, ahová exportálni szeretné a konfigurációt.	saját erőforráscsoport
   Erőforrás	Válassza ki azt az App Service-t, ahová exportálni szeretné a konfigurációt.	my-app-service

6. Igény szerint töltse ki az űrlap következő részét:

   Paraméter	Leírás	Példa
   Előtag eltávolítása	Opcionális. Ha meg van adva, az előtag el lesz távolítva az azt tartalmazó összes exportált kulcsérték kulcsnevéből.	TestApp:

7. Az exportálás folytatásához válassza az Alkalmaz elemet.

A kulcsértékeket 2022. július 28-án, 0:00 órakor exportálta egy App Configuration-áruházból, olyan kulcsnevekkel, amelyek TestApp:-sal kezdődnek, és a prod címkével, egy App Service-erőforrás alkalmazásbeállításaiba. Az előtag TestApp: el lett távolítva az exportált kulcsnevekről.

Ha bejelölte a jelölőnégyzetet, hogy hivatkozásként exportálja a kulcsértékeket, az exportált kulcsértékek alkalmazáskonfigurációs hivatkozásként jelennek meg az App Service-erőforrás konfigurációs beállításainak "Forrás" oszlopában.

Azure CLI

Az Azure CLI-ben kövesse az alábbi lépéseket. Ha nem telepítette helyileg az Azure CLI-t, használhatja az Azure Cloud Shellt is.

1. Adja meg az exportálási parancsot az appconfig kv export , és adja meg a következő paramétereket:

   Paraméter	Leírás	Példa
   --name	Adja meg az exportálni kívánt kulcsértékeket tartalmazó Alkalmazáskonfigurációs áruház nevét.	my-app-config-store
   --destination	Írja be appservice , hogy jelezze, hogy adatokat exportál az App Service-be.	appservice
   --appservice-account	Adja meg az App Service ARM-azonosítóját, vagy használja az App Service nevét, ha ugyanabban az előfizetésben és erőforráscsoportban van, mint az appkonfiguráció.	/subscriptions/123/resourceGroups/my-as-resource-group/providers/Microsoft.Web/sites/my-app-service vagy my-app-service
   --label	Opcionális. Adjon meg egy címkét a kulcsértékek és a funkciójelzők exportálásához ezzel a címkével. Ha nem ad meg címkét, alapértelmezés szerint csak a kulcsértékeket és a funkciójelzőket exportálja címke nélkül.	prod

   Az --appservice-account érték lekéréséhez használja a az webapp show --resource-group <resource-group> --name <resource-name> parancsot.

2. Szükség esetén előtagot is hozzáadhat:

   Paraméter	Leírás	Példa
   --prefix	Opcionális. Az exportált kulcs-érték "key" tulajdonságából levágandó előtag. A kulcselőtag a kulcs első része. Az előtagok a kulcsértékek csoportjainak kezelésére használhatók egy konfigurációs tárban.	TestApp:

   Példa: exportálja a "prod" címkével rendelkező összes kulcsértéket egy App Service-alkalmazásba, és vágja le a "TestApp" előtagot.

   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:
   

   A parancssor megjeleníti az App Service-erőforrásba exportált kulcsértékek listáját. Az exportálás megerősítéséhez válassza a ylehetőséget.

   

   A "prod" címkével rendelkező összes kulcsértéket exportálta egy Azure App Service-erőforrásba, és levágta a "TestApp:" előtagot.

3. Megadhat egy alkalmazáskonfigurációs referenciaként exportálandó jelzőt.

   Paraméter	Leírás
   --export-as-reference -r	Opcionális. Adja meg, hogy a kulcsértékek alkalmazáskonfigurációs hivatkozásként legyenek-e exportálva az App Service-be. További információ.

   Példa: exportálja az összes kulcsértéket a "prod" címkével egy App Service-alkalmazás alkalmazáskonfigurációs hivatkozásaként.

   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
   

   A parancssor megjeleníti az App Service-erőforrás alkalmazáskonfigurációs hivatkozásaként exportálandó kulcsértékek listáját. Az exportálás megerősítéséhez válassza a ylehetőséget.

   

   A "prod" címkével ellátott összes kulcsértéket exportálta egy Azure App Service-erőforrás alkalmazáskonfigurációs hivatkozásaként. Az App Service-erőforrásban az importált kulcsértékek alkalmazáskonfigurációs hivatkozásként jelennek meg a "Forrás" oszlopban.

   

További választható paraméterekért és példákért tekintse meg az az appconfig kv exportálást.

Hibaüzenetek

Az alkalmazáskonfiguráció kulcsértékeinek importálása vagy exportálása során a következő hibaüzenetek jelenhetnek meg:

• A nyilvános hozzáférés le van tiltva az áruházban, vagy olyan privát végpontról fér hozzá, amely nem szerepel az áruház privát végpontjának konfigurációjában. Ha az Alkalmazáskonfigurációs áruházban engedélyezve vannak a privát végpontok, alapértelmezés szerint csak a konfigurált virtuális hálózaton belülről érheti el. Győződjön meg arról, hogy az Azure Portalt vagy a CLI-t futtató gép ugyanahhoz a virtuális hálózathoz csatlakozik, mint a privát végpont. Ha most engedélyezte a nyilvános hálózati hozzáférést az Alkalmazáskonfigurációs áruházhoz, várjon legalább 5 percet, mielőtt újra próbálkozik a gyorsítótár frissítésének engedélyezéséhez.

Következő lépések

Integrálás a CI/CD-folyamattal