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.
A Azure Portal kövesse az alábbi lépéseket:
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.
Az Importálás lapon válassza a Konfigurációs fájl lehetőséget a Forrásszolgáltatás területen.
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 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.
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) 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.
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.
A Azure Portal kövesse az alábbi lépéseket:
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.
Az Importáláslapon válassza App Configuration lehetőséget a Forrásszolgáltatás területen.
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."
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) 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.
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.
Az Azure Portalon:
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.
Az Importálás lapon válassza az App Services lehetőséget a Forrásszolgáltatás területen.
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.
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) 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.
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.
A Azure Portal kövesse az alábbi lépéseket:
Keresse meg a App Configuration tárat, és válassza az Importálás/exportálás lehetőséget.
Az Exportálás lapon válassza a Konfigurációs fájl lehetőséget a Célszolgáltatás területen.
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.
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.
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.
A Azure Portal kövesse az alábbi lépéseket:
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.
Az Exportálás lapon válassza a App Configurationlehetőséget a Célszolgáltatás területen.
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 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.
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 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.
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.
A Azure Portal kövesse az alábbi lépéseket:
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.
Az Exportálás lapon válassza az App Services lehetőséget a Célszolgáltatás területen.
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 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.
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 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.
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.