Leküldéses beállítások App Configuration az Azure Pipelines használatával
A leküldéses Azure App Configuration feladat kulcsértékeket küld le egy konfigurációs fájlból a App Configuration tárolóba. Ez a feladat teljes körű funkcionalitást tesz lehetővé a folyamaton belül, mivel mostantól lekérheti a beállításokat a App Configuration tárolóból, valamint leküldheti a beállításokat a App Configuration tárolóba.
Előfeltételek
- Azure-előfizetés – ingyenesen létrehozhat egyet
- App Configuration áruház – hozzon létre egyet ingyen
- Azure DevOps-projekt – ingyenes létrehozása
- Azure App Configuration Leküldéses feladat – ingyenesen letölthető a Visual Studio Marketplace-ről.
- Az Azure Pipelines-ügynök 2.206.1-es vagy újabb verziója és a Node 16-os vagy újabb verziója a feladat helyi ügynökökön való futtatásához.
Szolgáltatáskapcsolat létrehozása
A szolgáltatáskapcsolatok hozzáférést biztosítanak az Azure-előfizetés erőforrásaihoz az Azure DevOps-projektből.
Az Azure DevOpsban lépjen a célfolyamatot tartalmazó projektre. A bal alsó sarokban válassza a Projektbeállítások lehetőséget.
A Folyamatok területen válassza a Szolgáltatáskapcsolatok lehetőséget. A jobb felső sarokban válassza az Új szolgáltatáskapcsolat lehetőséget.
Az Új szolgáltatáskapcsolat területen válassza az Azure Resource Manager lehetőséget.
A Hitelesítési módszer párbeszédpanelen válassza a Szolgáltatásnév (automatikus) lehetőséget egy új szolgáltatásnév létrehozásához, vagy válassza a Szolgáltatásnév (manuális) lehetőséget egy meglévő szolgáltatásnév használatához.
Adja meg előfizetését, erőforráscsoportját és a szolgáltatáskapcsolat nevét.
Ha új szolgáltatásnevet hozott létre, keresse meg a szolgáltatáskapcsolathoz rendelt szolgáltatásnév nevét. A következő lépésben új szerepkör-hozzárendelést fog hozzáadni ehhez a szolgáltatásnévhez.
Lépjen a Project Settings>Szolgáltatáskapcsolatok területre.
Válassza ki az új szolgáltatáskapcsolatot.
Válassza a Szolgáltatásnév kezelése lehetőséget.
Jegyezze fel az értéket a Megjelenítendő név mezőben.
Szerepkör-hozzárendelés hozzáadása
Rendelje hozzá a megfelelő App Configuration szerepkör-hozzárendeléseket a feladatban használt hitelesítő adatokhoz, hogy a feladat hozzáférhessen a App Configuration tárolóhoz.
Nyissa meg a célként megadott App Configuration áruházat.
A bal oldali menüben válassza a Hozzáférés-vezérlés (IAM) lehetőséget.
A jobb oldali panelen válassza a Szerepkör-hozzárendelések hozzáadása lehetőséget.
A Szerepkör mezőben válassza App Configuration Adattulajdonos lehetőséget. Ez a szerepkör lehetővé teszi, hogy a feladat a App Configuration tárolóból olvasson és írjon.
Válassza ki az előző szakaszban létrehozott szolgáltatáskapcsolathoz társított szolgáltatásnevet.
Válassza az Áttekintés + hozzárendelés lehetőséget.
Használat buildekben
Ez a szakasz bemutatja, hogyan használhatja a Azure App Configuration Leküldéses feladatot egy Azure DevOps-buildelési folyamatban.
- Lépjen a Build Pipelines (Folyamatfolyamatok) lapra a Pipelines Pipelines>(Folyamatok) elemre kattintva. A buildelési folyamatok dokumentációja itt található.
- Ha új buildfolyamatot hoz létre, a folyamat utolsó lépésében, a Véleményezés lapon válassza a Folyamat jobb oldalán található Asszisztens megjelenítése lehetőséget.
- Ha meglévő buildfolyamatot használ, kattintson a jobb felső sarokban található Szerkesztés gombra.
- Ha új buildfolyamatot hoz létre, a folyamat utolsó lépésében, a Véleményezés lapon válassza a Folyamat jobb oldalán található Asszisztens megjelenítése lehetőséget.
- Keresse meg a Azure App Configuration leküldéses feladatot.
- Konfigurálja a feladathoz szükséges paramétereket, hogy leküldje a kulcsértékeket a konfigurációs fájlból a App Configuration tárolóba. A paraméterek magyarázata az alábbi Paraméterek szakaszban és az egyes paraméterek melletti elemleírásokban érhető el.
- Build mentése és várólistára helyezése. A buildnapló megjeleníti azokat a hibákat, amelyek a feladat végrehajtása során történtek.
Használat a kiadásokban
Ez a szakasz bemutatja, hogyan használhatja a Azure App Configuration Leküldéses feladatot egy Azure DevOps-kiadási folyamatban.
- Lépjen a folyamat kiadási lapjára a Pipelines Releases (Folyamatokkiadásai)> lehetőség kiválasztásával. A kiadási folyamatok dokumentációja itt található.
- Válasszon ki egy meglévő kiadási folyamatot. Ha még nincs ilyenje, az + Új lehetőséget választva hozzon létre egy újat.
- Válassza a szerkesztés gombot a jobb felső sarokban a kiadási folyamat szerkesztéséhez.
- A Feladatok legördülő listában válassza ki azt a fázist , amelyhez hozzá szeretné adni a feladatot. A szakaszokról itt talál további információt.
- Kattintson + annak a feladatnak a mellett, amelyhez új tevékenységet szeretne hozzáadni.
- A Feladatok hozzáadása párbeszédpanelen írja be a Azure App Configuration Leküldés kifejezést a keresőmezőbe, és jelölje ki.
- Konfigurálja a feladaton belüli szükséges paramétereket, hogy leküldje a kulcsértékeket a konfigurációs fájlból a App Configuration tárolóba. A paraméterek magyarázata az alábbi Paraméterek szakaszban és az egyes paraméterek melletti elemleírásokban érhető el.
- Kiadás mentése és várólistára helyezése. A kiadási napló megjeleníti a feladat végrehajtása során felmerülő hibákat.
Paraméterek
A leküldéses App Configuration a következő paramétereket használja:
- Azure-előfizetés: Az elérhető Azure-szolgáltatáskapcsolatokat tartalmazó legördülő lista. Az elérhető Azure-szolgáltatáskapcsolatok listájának frissítéséhez és frissítéséhez nyomja le az Azure-előfizetés frissítése gombot a szövegmező jobb oldalán.
- App Configuration Végpont: Az elérhető konfigurációt betöltő legördülő menü a kiválasztott előfizetésben tárolja a végpontot. Az elérhető konfigurációs tárolók végpontjainak listájának frissítéséhez és frissítéséhez nyomja le a szövegmező jobb oldalán található Refresh App Configuration Endpoint (Végpont frissítése) gombot.
- Konfigurációs fájl elérési útja: A konfigurációs fájl elérési útja. A Konfigurációs fájl elérési útja paraméter a fájladattár gyökerénél kezdődik. A konfigurációs fájl kiválasztásához tallózhat a buildösszetevőben. (
...
gomb a szövegmező jobb oldalán). A támogatott fájlformátumok a fájltartalom-profiltól függenek. Az alapértelmezett profil esetében a támogatott fájlformátumok a yaml, a json és a tulajdonságok. A KvSet-profil esetében a támogatott fájlformátum a json. - Fájltartalom-profil: A konfigurációs fájl tartalomprofilja. Az alapértelmezett érték az Alapértelmezett.
- Alapértelmezett: Az alkalmazások által közvetlenül használható hagyományos konfigurációs fájlformátumokra hivatkozik.
- Kvset: Olyan fájlséma, amely egy App Configuration 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. A Kvset-profil használatakor az "Elválasztó", a "Label", a "Content type", a "Prefix", a "Tags" és a "Depth" tevékenységparaméterek nem alkalmazhatók.
- Importálási mód: Az alapértelmezett érték a Mind. Meghatározza a kulcsértékek importálásának viselkedését.
- Mind: Importálja a konfigurációs fájl összes kulcsértékét a App Configuration.
- Kihagyás-egyezés: Csak azokat a beállításokat importálja, amelyeknek nincs egyező kulcs-értéke App Configuration. Az egyező kulcsértékek kulcsértéknek minősülnek ugyanazokkal a kulccsal, címkével, értékkel, tartalomtípussal és címkékkel.
- Száraz futtatás: Az alapértelmezett érték Nincs bejelölve.
- Bejelölve: Nem történik frissítés a App Configuration. Ehelyett a normál futtatás során végrehajtott frissítéseket a rendszer felülvizsgálja a konzolon.
- Nincs bejelölve: Elvégzi a App Configuration frissítéseit, és nem nyomtat a konzolra.
- Elválasztó: A .json és .yml fájlok simításához használt elválasztó.
- Mélység: A .json- és .yml-fájlok rétegzett mélysége.
- Előtag: A App Configuration tárolóba leküldett kulcsok elejéhez hozzáfűzött sztring.
- Címke: Az egyes kulcs-értékekhez a App Configuration tárolóban lévő címkeként hozzáadott sztring.
- Tartalomtípus: Az egyes kulcs-értékekhez a App Configuration tárolóban lévő tartalomtípusként hozzáadott sztring.
- Címkék: A formátumú
{"tag1":"val1", "tag2":"val2"}
JSON-objektum, amely a App Configuration tárolóba leküldett kulcsértékekhez hozzáadott címkéket definiálja. - Törölje a konfigurációs fájlban nem szereplő kulcsértékeket: Az alapértelmezett érték nincs bejelölve. Ennek a beállításnak a viselkedése a konfigurációs fájl tartalomprofiljától függ.
- Bejelölve:
- Alapértelmezett tartalomprofil: Eltávolítja az összes olyan kulcsértéket a App Configuration tárolóból, amely megegyezik a megadott előtaggal és címkével, mielőtt új kulcsértékeket küld a konfigurációs fájlból.
- Kvset-tartalomprofil: Eltávolítja az összes olyan kulcsértéket a App Configuration tárolóból, amelyek nem szerepelnek a konfigurációs fájlban, mielőtt új kulcsértékeket küld a konfigurációs fájlból.
- Nincs bejelölve: Leküldi az összes kulcsértéket a konfigurációs fájlból a App Configuration tárolóba, és a App Configuration tárolóban lévő összes többi elemet érintetlenül hagyja.
- Bejelölve:
Hibaelhárítás
Ha váratlan hiba történik, a hibakeresési naplók engedélyezhetők a folyamatváltozó system.debug
értékre true
állításával.
GYIK
Hogyan tölthetek fel több konfigurációs fájlt?
Hozzon létre több példányt a Azure App Configuration Leküldéses feladatból ugyanabban a folyamatban több konfigurációs fájl leküldéséhez az App Configuration tárolóba.
Hogyan hozhatok létre Key Vault hivatkozásokat vagy funkciójelölőket ezzel a feladattal?
A kiválasztott fájltartalom-profiltól függően tekintse meg a konfigurációs fájl Azure App Configuration támogatásával kapcsolatos példákat.
Miért kapok 409-et, amikor kulcsértékeket próbálok leküldni a konfigurációs tárolóba?
409-os ütközési hibaüzenet jelenik meg, ha a feladat megpróbál eltávolítani vagy felülírni egy kulcsértéket, amely az App Configuration tárolóban zárolva van.