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

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 a App Configuration tároló és a kódprojekt között. Beállíthat például egy App Configuration tárolót 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 útmutatót nyújt az adatok App Configuration használatával történő importálásához és exportálásához. Ha folyamatos szinkronizálást szeretne beállítani a GitHub-adattárral, tekintse meg a GitHub Actions és az Azure Pipelines-feladatokat.

Az adatokat az Azure Portal vagy az Azure CLI használatával importálhatja vagy exportálhatja.

Adatok importálása

Az importálás a konfigurációs adatokat egy App Configuration tárolóba helyezi egy meglévő forrásból. Az importálási függvénnyel adatokat migrálhat egy App Configuration több forrásból származó adatok tárolására vagy összesítésére.

Ez az útmutató bemutatja, hogyan importálhat App Configuration adatokat:

• egy konfigurációs fájlból a Json, Yaml vagy Properties fájlban
• App Configuration áruházból
• Azure App Service

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.

Megjegyzés

A funkciójelölők fájlból történő importálása nem támogatott. Ha egy konfigurációs fájl funkciójelölőket tartalmaz, azok automatikusan normál kulcsértékekként lesznek importálva.

Portál

A Azure Portal kövesse az alábbi lépéseket:

1. Keresse meg a App Configuration áruházat, és válassza az Importálás/exportálás lehetőséget a Műveletek menüben.

   

2. Az Importálás lapon válassza a Konfigurációs fájl lehetőséget a Forrásszolgáltatás területen.

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

   Paraméter	Leírás	Példa
   Nyelv esetén	Válassza ki az importálni kívánt fájl nyelvét a .NET, a Java (Spring) és az Egyéb között.	.NET
   Fájltípus	Válassza ki az importálandó fájl típusát a Yaml, a Tulajdonságok és a Json között.	Json

4. Válassza a Mappa ikont, és tallózással keresse meg az importálni kívánt fájlt.

   Megjegyzés

   Megjelenik egy üzenet a képernyőn, amely jelzi, hogy a fájl beolvasása sikerült.

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

   Paraméter	Leírás	Példa
   Elválasztó	Az elválasztó az importált konfigurációs fájlban elemzett karakter, amely elkülöníti a konfigurációs tárhoz hozzáadandó kulcsértékeket. Válasszon a következő lehetőségek közül: ., ,, :, ;, /, -, _, — .	;
   Előtag	Választható. A kulcselőtag a kulcs-érték "kulcs" tulajdonságának első része. Az előtagokkal kulcsértékcsoportok kezelhetők egy konfigurációs tárolóban. A beírt előtag a fájlból importált összes kulcsérték "key" tulajdonságának elejéhez lesz hozzáfűzve.	TestApp:
   Címke	Választható. Válasszon ki egy meglévő címkét, vagy írjon be egy új címkét, amely hozzá lesz rendelve az importált kulcsértékekhez.	Prod
   Tartalomtípus	Választható. Jelezze, hogy JSON-fájlt importál vagy Key Vault hivatkozásokat. A Key Vault hivatkozásokról további információt a Key Vault-hivatkozások használata ASP.NET Core alkalmazásban című témakörben talál.	JSON (alkalmazás/json)

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

Kulcsértékeket importált egy JSON-fájlból, hozzárendelte hozzájuk a "prod" címkét és a "TestApp" előtagot. A rendszer a ":" elválasztót használja, és az összes importált kulcsértékhez "JSON" tartalomtípus van beállítva.

Azure CLI

Az Azure CLI-ben kövesse az alábbi lépéseket. Ha nincs helyileg telepítve az Azure CLI, igény szerint használhatja az Azure Cloud Shell.

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 a App Configuration tárolónak a nevét, amelybe adatokat szeretne importálni.	my-app-config-store
   --source	Adja meg file , hogy alkalmazáskonfigurációs adatokat importál egy fájlból.	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	Az importálandó fájl formátumának jelzéséhez adja meg a yaml, a properties vagy a json értéket.	json

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

   Paraméter	Leírás	Példa
   --separator	Választható. Az elválasztó a kulcsértékek Json/Yaml-hez való simításának elválasztója. Ez a hierarchikus struktúra exportálásához szükséges, és figyelmen kívül lesz hagyva a tulajdonságfájlok és a funkciójelölők esetében. Válasszon az alábbi lehetőségek közül: ., ,, :, ;, /, -, , _, . —	;
   --prefix	Választható. A kulcselőtag a kulcsok első része. Az előtagokkal kulcsértékcsoportok kezelhetők egy konfigurációs tárolóban. Ez az előtag minden importált kulcs-érték "key" tulajdonságának elejéhez lesz hozzáfűzve.	TestApp:
   --label	Választható. Adjon meg egy címkét, amely hozzá lesz rendelve az importált kulcsértékekhez.	prod
   --content-type	Választható. Adja meg vagy application/json adja megappconfig/kvset, hogy az importált tartalom egy Key Vault hivatkozásból vagy egy JSON-fájlból áll.	application/json

   Példa: importálja az összes kulcsértéket és funkciójelölő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 lehetőséget y.

   

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

További választható paramétereket és példákat az az appconfig kv import című témakörben talál.

Adatok importálása App Configuration tárolóból

Importálhat értékeket egy App Configuration tárolóból egy másik App Configuration tárolóba, vagy importálhat értékeket egy App Configuration tárolóból ugyanarra a App Configuration tárolóra, hogy megkettőzhesse az értékeit, és különböző paramétereket, például új címkét vagy tartalomtípust alkalmazzon.

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

Portál

A Azure Portal kövesse az alábbi lépéseket:

1. Keresse meg a App Configuration áruházat, és válassza az Importálás/exportálás lehetőséget a Műveletek menüben.

   

2. Az Importáláslapon válassza App Configuration lehetőséget a Forrásszolgáltatás területen.

3. Válassza az Erőforrás kiválasztása lehetőséget, töltse ki az űrlapot a következő paraméterekkel, majd válassza az Alkalmaz lehetőséget:

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

   Megjegyzés

   A "Hozzáférési kulcsok sikeresen beolvasva" üzenet azt jelzi, hogy az App Configuration tárolóval való kapcsolat sikeres volt."

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

   Paraméter	Leírás	Példa
   A címkéből	Jelöljön ki legalább egy címkét a megfelelő címkékkel rendelkező értékek importálásához. Az összes kijelölése bármilyen címkével importálja a kulcsértékeket, és a (Nincs címke) címke nélküli kulcsértékre korlátozza az importálást.	Prod
   Adott időpontban	Választható. Töltse ki, ha kulcsértékeket szeretne importálni egy adott időpontból. Ez a kiválasztott konfigurációs tár kulcsértékeinek időpontja. Formátum: "YYYY-MM-DDThh:mm:ssZ". Ez a mező alapértelmezés szerint a kulcsértékek aktuális időpontjára esik, ha üres marad.	2022. 07. 28. 12:00:00
   Az alapértelmezett kulcs-érték címkék felülbírálása	Választható. Alapértelmezés szerint az importált elemek az aktuális címkéjüket használják. Jelölje be a jelölőnégyzetet, és adjon meg egy címkét, amely felülírja ezeket az alapértelmezett értékeket egy egyéni címkével.	Új
   Az alapértelmezett kulcs-érték tartalomtípus felülbírálása	Választható. Alapértelmezés szerint az importált elemek az aktuális tartalomtípusukat használják. Jelölje be a jelölőnégyzetet, és jelölje be Key Vault Hivatkozás vagy JSON (alkalmazás/json) elemet a Tartalomtípus területen, és adja meg, hogy az importált tartalom egy Key Vault hivatkozásból vagy egy 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 alapértelmezett tartalomtípusa az "application/vnd.microsoft.appconfig.ff+json;charset=utf-8", és ez a paraméter nem frissíti.	JSON (alkalmazás/json)

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

2021. január 28-án, 12:00-kor importálta a "prod" címkével ellátott kulcsértékeket és funkciójelölőket egy App Configuration áruházból, és hozzárendelte hozzájuk az "új" címkét. Minden importált kulcsértékhez "JSON" tartalomtípus van beállítva.

Azure CLI

Az Azure CLI-ben kövesse az alábbi lépéseket. Ha nincs helyileg telepítve az Azure CLI, igény szerint használhatja az Azure Cloud Shell.

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 a App Configuration tárolónak a nevét, amelybe adatokat szeretne importálni	my-app-config-store
   --source	Adja megappconfig, hogy adatokat importáljon egy App Configuration tárolóból.	appconfig
   --src-name	Adja meg annak a App Configuration tárolónak 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 star szűrőként való megjelölést: írja be * az összes címkét; abc* az abc előtaggal rendelkező összes címkéhez.	prod

2. Igény szerint adja hozzá a következő paramétereket:

   Paraméter	Leírás	Példa
   --label	Választható. Adjon meg egy címkét, amely hozzá lesz rendelve az importált kulcsértékekhez.	new
   --content-type	Választható. Adja meg vagy application/json adja megappconfig/kvset, hogy az importált tartalom egy Key Vault hivatkozásból vagy egy 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 alapértelmezett tartalomtípusa alapértelmezés szerint "application/vnd.microsoft.appconfig.ff+json;charset=utf-8", és ez a paraméter nem frissíti.	application/json

   Példa: importálja a kulcsértékeket és a funkciójelölőket a "prod" címkével egy másik App Configuration, é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 lehetőséget y.

   

Importálta a "prod" címkével rendelkező kulcsértékeket egy App Configuration tárolóból, és hozzárendelte hozzájuk az "új" címkét. Minden importált kulcsértékhez "JSON" tartalomtípus van beállítva.

További választható paramétereket és példákat az az appconfig kv import című témakörben talál.

Adatok importálása Azure App Service

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

Megjegyzés

App Service jelenleg nem támogatja a funkciójelölőket. A App Service importált funkciójelölők automatikusan kulcsértékekké lesznek konvertálva. A App Service erőforrások csak kulcsértékeket tartalmazhatnak.

Portál

Az Azure Portalon:

1. Keresse meg a App Configuration áruházat, és válassza az Importálás/exportálás lehetőséget a Műveletek menüben.

   

2. Az Importálás lapon válassza az App Services lehetőséget a Forrásszolgáltatás területen.

3. Válassza az Erőforrás kiválasztása lehetőséget, töltse ki az űrlapot a következő paraméterekkel, majd válassza az Alkalmaz lehetőséget:

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

   Megjegyzés

   Megjelenik egy üzenet, amely a forrásból App Service erőforrásból sikeresen lekért kulcsértékek számát jelzi.

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

   Paraméter	Leírás	Példa
   Előtag	Választható. A kulcselőtag a kulcsértékek "key" tulajdonságának első része. Az előtagok a kulcsértékek csoportjainak kezelésére használhatók a konfigurációs tárolókban. Ez az előtag minden importált kulcs-érték "key" tulajdonságának elejéhez lesz hozzáfűzve.	TestApp:
   Címke	Választható. Jelöljön ki egy meglévő címkét, vagy adjon meg egy új címkét, amely hozzá lesz rendelve az importált kulcsértékekhez.	Prod
   Tartalomtípus	Választható. Jelezze, hogy az importált fájl egy Key Vault hivatkozás vagy egy JSON-fájl. A Key Vault hivatkozásokkal kapcsolatos további információkért tekintse meg a Key Vault hivatkozások használata ASP.NET Core alkalmazásban című témakört.	JSON (alkalmazás/json)

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

Kulcsértékekként importálta az összes alkalmazásbeállítást egy App Service, és hozzárendelte őket a "prod" címkéhez és a TestApp előtaghoz. Minden importált kulcsértékhez "JSON" tartalomtípus van beállítva.

Azure CLI

Az Azure CLI-ben kövesse az alábbi lépéseket. Ha nincs helyileg telepítve az Azure CLI, használhatja az Azure Cloud Shell.

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 a App Configuration tárolónak a nevét, amelybe adatokat szeretne importálni.	my-app-config-store
   --source	Adja megappservice, hogy jelezze, hogy alkalmazáskonfigurációs adatokat importál Azure App Service.	appservice
   --appservice-account	Adja meg a App Service ARM-azonosítóját, vagy használja a App Service nevét, ha az ugyanabban az előfizetésben és erőforráscsoportban található, mint a App Configuration.	/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	Választható. 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 a konfigurációs tárolókban. Ez az előtag minden importált kulcs-érték "key" tulajdonságának elejéhez lesz hozzáfűzve.	TestApp:
   --label	Választható. 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 lesz hozzárendelve a kulcsértékekhez.	prod
   --content-type	Választható. Adja meg az appconfig/kvset vagy az application/json kifejezést, hogy az importált tartalom egy Key Vault hivatkozásból vagy egy JSON-fájlból áll.	application/json

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

   Példa: importálja az összes alkalmazásbeállítást a App Service kulcsértékekként a "prod" címkével, a App Configuration tárolóba, é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ő változások listáját. Az importálás megerősítéséhez válassza a lehetőséget y.

   

Az összes alkalmazásbeállítást kulcsértékekként importálta a App Service, hozzárendelte őket a "prod" címkéhez, és hozzáadta a "TestApp:" előtagot. Minden importált kulcsértékhez "JSON" tartalomtípus van beállítva.

További választható paraméterekért és példákért lépjen az az appconfig kv import területre.

Adatok exportálása

Exportálja a App Configuration tárolt konfigurációs adatokat egy másik célhelyre. Az exportálási függvénnyel például adatokat menthet egy App Configuration 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 App Configuration adatokat:

• egy konfigurációs fájlba json, Yaml vagy Properties
• App Configuration áruházba
• Azure App Service erőforrásra

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

Az alábbi 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 Properties-fájlba.

Megjegyzés

A szolgáltatásjelölők App Configuration tárolóból konfigurációs fájlba való exportálása jelenleg csak a parancssori felületen támogatott.

Portál

A Azure Portal kövesse az alábbi lépéseket:

1. Keresse meg a App Configuration tárat, és válassza az Importálás/exportálás lehetőséget.

   

2. Az Exportálás lapon válassza a Konfigurációs fájl lehetőséget a Célszolgáltatás területen.

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

   Paraméter	Leírás	Példa
   Előtag	Választható. Ez az előtag az egyes kulcsértékek "kulcs" tulajdonságából lesz levágva. A kulcselőtag a kulcsok első része. Az előtagok a kulcsértékek csoportjainak kezelésére használhatók a konfigurációs tárolókban.	TestApp:
   Forráscímke	Válasszon ki egy meglévő címkét, ha az exportálást egy adott címkével rendelkező kulcsértékekre szeretné korlátozni. Ha nem jelöl ki címkét, alapértelmezés szerint csak a "Nincs címke" címkével rendelkező kulcsértékek lesznek exportálva. Lásd az alábbi megjegyzést.	Prod
   Adott időpontban	Választható. Töltse ki, ha kulcsértékeket szeretne importálni egy adott időpontból. Ez a kiválasztott konfigurációs tár kulcsértékeinek időpontja. Formátum: "YYYY-MM-DDThh:mm:ssZ". Ez a mező alapértelmezés szerint a kulcsértékek aktuális időpontjára esik, ha üres marad.	2022. 07. 28. 12:00:00
   Fájltípus	Válassza ki az exportálni kívánt fájl típusát a Yaml, a Tulajdonságok vagy a Json között.	JSON
   Elválasztó	Az elválasztó a kulcsértékek Json/Yaml-hez való simításának elválasztója. Támogatja a konfiguráció hierarchikus struktúráját, és nem vonatkozik a tulajdonságfájlokra és a funkciójelölőkre. Válasszon a következő lehetőségek közül: ., ,, :, ;, /, -, _, — vagy (Nincs elválasztó).	;

   Fontos

   Ha nem jelöl ki Feladó 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 jelölnie annak címkéjét. Vegye figyelembe, hogy exportálásonként csak egy címkét választhat ki a portálon, ha a kulcsértékeket az összes megadott címkével szeretné exportálni, használja a parancssori felületet.

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

Olyan kulcsértékeket exportált, amelyek "prod" címkével rendelkeznek egy konfigurációs fájlból, állapotukban 2021. 07. 28. 12:00:00 órától, és levágta a "TestApp" előtagot. Az értékeket a fájlban a ";" választja el egymástól.

Azure CLI

Az Azure CLI-ben kövesse az alábbi lépéseket. Ha nincs helyileg telepítve az Azure CLI, igény szerint használhatja az Azure Cloud Shell.

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ó App Configuration tároló nevét.	my-app-config-store
   --destination	Adja meg file , 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	properties Az exportálni kívánt fájl formátumának megadásához írja be yamla vagy json a értéket.	json
   --label	Adjon meg egy címkét, amellyel kulcsértékeket és funkciójelölőket exportálhat ezzel a címkével. Ha nem ad meg címkét, alapértelmezés szerint csak a kulcsértékeket és a címke nélküli funkciójelölőket exportálja. Megadhat egy címkét, több címkét is megadhat, ha el szeretné különíteni őket a paranccsal ,, vagy a használatával * az összes címkét figyelembe veheti.	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 jelölnie annak címkéjét.

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

   Paraméter	Leírás	Példa
   --separator	Választható. Az elválasztó a kulcsértékek Json/Yaml-hez való simításának elválasztója. Ez a hierarchikus struktúra exportálásához szükséges, és figyelmen kívül lesz hagyva a tulajdonságfájlok és a funkciójelölők esetében. Válasszon az alábbi lehetőségek közül: ., ,, :, ;, /, -, , _, . —	;
   --prefix	Választható. Az egyes kulcsértékek "key" tulajdonságából levágandó előtag. A kulcselőtag a kulcsok első része. Az előtagokkal kulcsértékcsoportok kezelhetők egy konfigurációs tárolóban. A rendszer figyelmen kívül hagyja az előtagot a funkciójelölők esetében.	TestApp:

   Példa: exportálja az összes "prod" címkével rendelkező kulcsértéket és funkciójelölőt 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 lehetőséget y.

   

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ágta a "TestApp" előtagot. Az értékeket a fájlban a ";" választja el egymástól.

További választható paramétereket és példákat az az appconfig kv export című témakörben talál.

Adatok exportálása App Configuration tárolóba

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

Exportálhat értékeket egy App Configuration tárolóból egy másik App Configuration tárolóba, vagy exportálhat értékeket egy App Configuration tárolóból ugyanarra a App Configuration tárolóra, hogy megkettőzhesse az értékeit, és különböző paramétereket, például új címkét vagy tartalomtípust alkalmazzon.

Portál

A Azure Portal kövesse az alábbi lépéseket:

1. Tallózással keresse meg az exportálni kívánt adatokat tartalmazó App Configuration tárolót, és válassza az Importálás/exportálás lehetőséget a Műveletek menüben.

   

2. Az Exportálás lapon válassza a App Configurationlehetőséget a Célszolgáltatás területen.

3. Válassza az Erőforrás kiválasztása lehetőséget, töltse ki az űrlapot a következő paraméterekkel, majd válassza az Alkalmaz lehetőséget:

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

4. A lapon ekkor megjelenik a kiválasztott célszolgáltatás és erőforrás-azonosító. Az Erőforrás kiválasztása művelet lehetővé teszi, hogy másik forrás-App Configuration tárolóra váltson.

   Megjegyzés

   Megjelenik egy üzenet a képernyőn, amely jelzi, hogy a kulcsértékek beolvasása sikerült.

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

   Paraméter	Leírás	Példa
   A címkéből	Jelöljön ki legalább egy címkét a megfelelő címkékkel rendelkező értékek exportálásához. Az összes kijelölése bármilyen címkével exportálja a kulcsértékeket, a (Nincs címke) pedig címke nélküli kulcsértékekké korlátozza az exportálást.	Prod
   Adott időpontban	Választható. Töltse ki, ha kulcsértékeket szeretne importálni egy adott időpontból. Ez a kiválasztott konfigurációs tár kulcsértékeinek időpontja. Formátum: "YYYY-MM-DDThh:mm:ssZ". Ez a mező alapértelmezés szerint a kulcsértékek aktuális időpontjára esik, ha üres marad.	2022. 07. 28. 12:00:00
   Az alapértelmezett kulcs-érték címkék felülbírálása	Választható. Alapértelmezés szerint az importált elemek az aktuális címkéjüket használják. Jelölje be a jelölőnégyzetet, és adjon meg egy címkét, amely felülírja ezeket az alapértelmezett értékeket egy egyéni címkével.	Új

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

Olyan kulcsértékeket és funkciójelölőket exportált, amelyek "prod" címkével rendelkeznek egy App Configuration áruházból, állapotukban 2022. 07. 28. 12:00:00 órától, és hozzárendelte őket az "új" címkéhez.

Azure CLI

Az Azure CLI-ben kövesse az alábbi lépéseket. Ha nincs helyileg telepítve az Azure CLI, használhatja az Azure Cloud Shell.

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ó App Configuration tároló nevét.	my-app-config-store
   --destination	Adja megappconfig, hogy jelezze, hogy adatokat exportál egy App Configuration tárolóba.	appconfig
   --dest-name	Adja meg annak a App Configuration tárolónak a nevét, amelybe adatokat szeretne exportálni.	my-other-app-config-store
   --label	Adjon meg egy címkét, amellyel kulcsértékeket és funkciójelölőket exportálhat ezzel a címkével. Ha nem ad meg címkét, alapértelmezés szerint csak a kulcsértékeket és a funkciójelölőket exportálja címkével. Egy címkét beírhat, több címkét is megadhat, ha elválasztja őket a címkével ,, vagy a használatával * az összes címkét figyelembe veheti.	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. Használjon vesszőjelet (,) több címke kijelöléséhez, 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	Választható. 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ójelölőket a "prod" címkével egy másik App Configuration tárolóba, é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 lehetőséget y.

   

Olyan kulcsértékeket és funkciójelölőket exportált, amelyek "prod" címkével rendelkeznek egy App Configuration áruházból, és hozzárendelték az "új" címkét.

További választható paraméterekért és példákért lépjen az az appconfig kv import területre.

Adatok exportálása Azure App Service

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

Megjegyzés

A funkciójelölők App Service való exportálása jelenleg nem támogatott.

Portál

A Azure Portal kövesse az alábbi lépéseket:

1. Keresse meg a App Configuration tárolót, és válassza az Importálás/exportálás lehetőséget az Operations (Műveletek) menüből.

   

2. Az Exportálás lapon válassza az App Services lehetőséget a Célszolgáltatás területen.

3. Válassza az Erőforrás kiválasztása lehetőséget, töltse ki az űrlapot a következő paraméterekkel, majd válassza az Alkalmaz lehetőséget:

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

4. A lapon megjelenik a kiválasztott Célszolgáltatás és erőforrás-azonosító. Az Erőforrás kiválasztása művelet lehetővé teszi, hogy másik célra App Service erőforrásra váltson.

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

   Paraméter	Leírás	Példa
   Előtag	Választható. Ez az előtag minden exportált kulcs-érték "key" tulajdonságából ki lesz vágva. A kulcselőtag a kulcsok első része. Az előtagok a kulcsértékek csoportjainak kezelésére használhatók a konfigurációs tárolókban. A rendszer figyelmen kívül hagyja az előtagot a funkciójelölők esetében.	TestApp:
   Exportálás hivatkozásként	Választható. Ellenőrizze, hogy exportálja-e a kulcsértékeket App Service App Configuration hivatkozásként. További információ
   Adott időpontban	Választható. Töltse ki a kitöltést a kulcsértékek adott időpontból való exportálásához. Ez a kiválasztott konfigurációs tár kulcsértékeinek időpontja. Formátum: "YYYY-MM-DDThh:mm:ssZ". Ez a mező alapértelmezés szerint a kulcsértékek aktuális időpontjára van bekapcsolva, ha üresen marad.	2022. 07. 28. 12:00:00
   Forráscímke	Választható. Válasszon ki egy meglévő címkét, ha az exportálást egy adott címkével rendelkező kulcsértékekre szeretné korlátozni. Ha nem jelöl ki címkét, csak a "Nincs címke" címkével rendelkező kulcsértékek lesznek exportálva.	Prod

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

Olyan kulcsértékeket exportált, amelyek "prod" címkével rendelkeznek egy App Service erőforrásból, állapotuk szerint 2021. 07. 28. 12:00:00 órától, és levágta a "TestApp" előtagot. A kulcsértékek JSON formátumú tartalomtípussal lettek exportálva.

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

Azure CLI

Az Azure CLI-ben kövesse az alábbi lépéseket. Ha nincs helyileg telepítve az Azure CLI, használhatja az Azure Cloud Shell.

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ó App Configuration tároló nevét.	my-app-config-store
   --destination	Adja megappservice, hogy jelezze, hogy adatokat exportál App Service.	appservice
   --appservice-account	Adja meg a App Service ARM-azonosítóját, vagy használja a App Service nevét, ha az ugyanabban az előfizetésben és erőforráscsoportban található, mint a App Configuration.	/subscriptions/123/resourceGroups/my-as-resource-group/providers/Microsoft.Web/sites/my-app-service vagy my-app-service
   --label	Választható. Adjon meg egy címkét, amellyel kulcsértékeket és funkciójelölőket exportálhat ezzel a címkével. Ha nem ad meg címkét, alapértelmezés szerint csak a kulcsértékeket és a funkciójelölőket exportálja címkével.	prod

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

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

   Paraméter	Leírás	Példa
   --prefix	Választható. Az exportált kulcs-érték "key" tulajdonságából levágandó előtag. A kulcselőtag a kulcsok első része. Az előtagok a kulcsértékek csoportjainak kezelésére használhatók a konfigurációs tárolókban.	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 lehetőséget y.

   

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

3. Megadhat egy jelölőt, amely App Configuration referenciaként exportálható.

   Paraméter	Leírás
   --export-as-reference -r	Választható. Adja meg, hogy a kulcsértékek App Configuration hivatkozásként legyenek-e exportálva App Service. További információk.

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

   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 azon kulcsértékek listáját, amelyek alkalmazáskonfigurációs hivatkozásként lesznek exportálva egy App Service erőforrásra. Az exportálás megerősítéséhez válassza a lehetőséget y.

   

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

   

További választható paraméterekért és példákért lépjen az az appconfig kv exportra.

Hibaüzenetek

A kulcsértékek importálása vagy exportálás App Configuration a során a következő hibaüzenetek jelenhetnek meg:

• A kijelölt fájlnak 1 és 2097152 bájt között kell lennie: a fájl túl nagy. Válasszon egy kisebb fájlt.
• 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 kulcsértékeket szeretne importálni egy App Configuration tárolóból, hozzá kell férnie az adott tárolóhoz. Szükség esetén engedélyezze a nyilvános hozzáférést a forrástárhoz, vagy egy jóváhagyott privát végpontról. Ha csak most engedélyezte a nyilvános hozzáférést, várjon akár 5 percet, amíg a gyorsítótár frissül.

Következő lépések

Integráció CI-/CD-folyamattal