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

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.

  1. Az Azure DevOpsban lépjen a célfolyamatot tartalmazó projektre. A bal alsó sarokban válassza a Projektbeállítások lehetőséget.

  2. 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.

  3. Az Új szolgáltatáskapcsolat területen válassza az Azure Resource Manager lehetőséget.

    Képernyőkép az Azure Resource Manager kiválasztásáról az Új szolgáltatáskapcsolat legördülő listából.

  4. 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.

  5. 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.

  1. Lépjen a Project Settings>Szolgáltatáskapcsolatok területre.

  2. Válassza ki az új szolgáltatáskapcsolatot.

  3. Válassza a Szolgáltatásnév kezelése lehetőséget.

  4. Jegyezze fel az értéket a Megjelenítendő név mezőben.

    Képernyőkép a szolgáltatásnév megjelenítendő nevéről.

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.

  1. Nyissa meg a célként megadott App Configuration áruházat.

  2. A bal oldali menüben válassza a Hozzáférés-vezérlés (IAM) lehetőséget.

  3. A jobb oldali panelen válassza a Szerepkör-hozzárendelések hozzáadása lehetőséget.

    Képernyőkép a Szerepkör-hozzárendelések hozzáadása gombról.

  4. 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.

  5. Válassza ki az előző szakaszban létrehozott szolgáltatáskapcsolathoz társított szolgáltatásnevet.

    Képernyőkép a Szerepkör-hozzárendelés hozzáadása párbeszédpanelről.

  6. 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.

  1. 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.

      Képernyőkép egy új folyamat Segéd megjelenítése gombjáról.

    • Ha meglévő buildfolyamatot használ, kattintson a jobb felső sarokban található Szerkesztés gombra.

      Képernyőkép egy meglévő folyamat Szerkesztés gombjáról.

  2. Keresse meg a Azure App Configuration leküldéses feladatot.

    Képernyőkép a Feladat hozzáadása párbeszédpanelről, amelyen Azure App Configuration Leküldés a keresőmezőbe.

  3. 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.

    Képernyőkép az alkalmazáskonfiguráció leküldéses feladat paramétereiről.

  4. 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.

  1. 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ó.
  2. 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.
  3. Válassza a szerkesztés gombot a jobb felső sarokban a kiadási folyamat szerkesztéséhez.
  4. 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.

    Képernyőkép a Feladatok legördülő menü kijelölt szakaszával.

  5. Kattintson + annak a feladatnak a mellett, amelyhez új tevékenységet szeretne hozzáadni.

    A feladat melletti plusz gomb képernyőképe.

  6. 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.
  7. 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.
  8. 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.

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.