Környezeti változók használata webhelybeállításokkal

A webhelybeállítások környezeti változói lehetővé teszik a készítők és a rendszergazdák számára a konfigurációs értékek rugalmas kezelését a környezetek között. Gördülékenyebb alkalmazás-életciklus-kezelést (ALM) és telepítési folyamatokat tesznek lehetővé. További információ: Környezeti változók Power Platform.

Megoldás a továbbfejlesztett adatmodellhez

A környezeti változók használatával meghatározhatja a helybeállítások értékeit a különböző környezetekben a továbbfejlesztett adatmodellel. Bár a standard adatmodell üzembehelyezési profilokra támaszkodik, a továbbfejlesztett modell lehetővé teszi a környezetspecifikus beállítások dinamikus konfigurálását környezeti változók használatával.

Főbb definíciók

A környezeti változók webhelybeállításokkal való használatának megismeréséhez ismerkedjen meg a következő fő definíciókkal:

• Környezeti változó: Olyan változó, amely egy olyan környezetre jellemző konfigurációs értékeket tartalmaz, amelyekre az alkalmazás vagy a szolgáltatások hivatkozhatnak.

• Webhelybeállítások: A webhely viselkedését befolyásoló konfigurálható tulajdonságok, például az identitásszolgáltató webhelybeállításai, a progresszív webalkalmazások és a biztonsági munkaterület speciális beállításai.

• Környezeti változó referenciája: Egy webhelybeállításon belüli környezeti változóra mutató mutató, amely lehetővé teszi a dinamikus értékfeloldást futásidőben.

Juttatások

A webhelybeállítások környezeti változói számos előnnyel járnak, többek között a következőkkel:

• Egyszerűsítse az ALM-et a webhelybeállítások nem kódolt értékeinek elkerülésével.
• Egyszerűsítse a több környezetre kiterjedő telepítéseket környezetspecifikus konfigurációkkal.
• Engedélyezze a webhely viselkedésének dinamikus frissítéseit a megoldások újbóli üzembe helyezése nélkül.

A működés leírása

Ez a cikk azt ismerteti, hogyan működnek a környezeti változók a webhelybeállításokkal. Az alábbi leírás egy magas szintű áttekintés:

1. A készítők környezeti változókat határoznak meg a Power Pages felügyeleti alkalmazásban vagy a megoldástervezőben.
2. A helybeállítások statikus értékek helyett ezekre a környezeti változókra hivatkoznak.
3. A hely elérésekor a rendszer feloldja a hivatkozott környezeti változó értékét, és alkalmazza azt.

Környezeti változók beállítása a webhelybeállításokhoz

Előfeltételek

A környezeti változók webhelybeállításokkal való használatához meg kell felelnie a következő előfeltételeknek:

• A helynek olyan környezetben kell lennie, ahol a továbbfejlesztett adatmodell engedélyezve van.
• A környezeti változók működéséhez Power Pages a következő verziók szükségesek:
  • Dataverse Szerver verzió 9.2.25013.x
  • Power Pages Csomag verziója 1.0.2501.x
  • Power Pages Futásidejű verzió 9.7.1.x

Környezeti változók használata a webhelybeállításokban

Környezeti változók használata a webhelybeállításokban:

1. Nyissa meg a Kezelés alkalmazást Power Pages , és lépjen a Webhely beállításaihoz.

2. Válassza ki a környezeti változóval konfigurálni kívánt webhelybeállítást.

3. Válassza ki a forrást környezeti változóként .

   

4. Ha már létrejött egy környezeti változó definíciója, válassza a Környezeti változó keresést. Megjelenik egy legördülő menü a kiválasztáshoz.

   

5. Ha nem létezik környezeti változó definíciója, válassza az Új környezeti változó definíciója lehetőséget , és töltse ki a szükséges mezőket, például a Tulajdonos , a Séma neve , a Megjelenítendő név és aTípus mezőket. Jegyezze fel a sémanév értékét, mivel ezt kell használnia, amikor egy környezeti változót társít egy webhelybeállításhoz.

   

6. A környezeti változó definíciójának létrehozása után kiválasztható a Környezeti változó keresési vezérlőjében. Keresse meg és válassza ki a séma nevét a webhelybeállításhoz való kapcsoláshoz.

Megjegyzés

• Az "adatforrás" adattípus nem támogatott.
• A "titkos" adattípusú, környezeti változók nem konfigurálhatók a kulcstartó részleteinek megadása nélkül.
• A webhelybeállításhoz PWAFeature használja a false és a {"status":"disable"} true értékét {"status":"enable"} .

Környezetspecifikus értékek frissítése

Annak érdekében, hogy a webhely beállításai megfelelően legyenek konfigurálva az egyes környezetekhez, kövesse az alábbi lépéseket a környezetspecifikus értékek frissítéséhez a felügyeleti alkalmazásban vagy a Power Pages tervezési studióban.

Megjegyzés

Nem minden webhelybeállítás rendelkezik megfelelő konfigurációs lehetőséggel a tervezőstúdióban.

Power Pages Felügyeleti alkalmazás

1. Minden környezethez (például fejlesztés, minőségbiztosítás és éles környezet) nyissa meg a Power Pages felügyeleti alkalmazást.
2. Keresse meg a környezeti változót a társított webhelybeállítás megnyitásával.
3. Válassza ki a környezeti változót .
4. Az Értékek szakaszban válassza az Új környezeti változó értéke lehetőséget .
5. Adjon meg egy értéket , majd válassza a Mentés és bezárás lehetőséget.

Design stúdió

1. Minden környezethez (például fejlesztés, minőségbiztosítás és éles környezet) lépjen a tervezőstúdióba.

2. Keresse meg a helybeállításnak megfelelő konfigurációs beállítást.

3. Frissítse az értéket.

4. Mentse a konfigurációt.

   

Fontos

• Amikor a tervezőstúdióban megtekint egy webhelybeállítást, értesítés jelenik meg, ha környezeti változót használ. Ha szerkeszti az értéket, az frissíti az összes hivatkozott webhelybeállítást a környezetben.
• Ha egy webhelybeállítás adattípusa titkosként van megjelölve, a mező le van tiltva a tervezőstúdióban, így a készítők nem szerkeszthetik az értékeit. Emellett a Key Vault titkos kulcsok olvasása vagy írása a tervezési stúdió beállításaiban nem támogatott.

A környezeti változó beállítása után kövesse az alábbi további lépéseket:

1. Navigáljon egy megoldáshoz, és adja hozzá a meglévő webhelyet, és ellenőrizze, hogy a releváns környezeti változók is szerepelnek-e.
2. Exportálja a megoldást, majd importálja a kívánt célkörnyezetbe.

A célkörnyezetbe való importálási folyamat során rendeljen hozzá egy értéket a környezeti változóhoz. Az érték módosítása frissíti a megfelelő webhelybeállításokat a célkörnyezetben.

Környezeti változók kezelése

A webhelybeállításokat környezeti változókkal kezelheti, függetlenül attól, hogy manuálisan vagy folyamatokon keresztül helyezi üzembe a megoldásokat.

Megoldások

Állítsa be a környezeti változókat és helyeket különböző környezetekben az alábbi lépésekkel:

1. Környezeti változók beállítása a forráskörnyezetben:

   1. Nyissa meg a portált Power Pages vagy portált Power Apps .

   2. Lépjen a forráskörnyezetben található Megoldások elemre .

   3. A megoldáson belül adjon hozzá egy új környezeti változót a szükséges adatok megadásával és mentésével.

      

      

   4. Adja hozzá a meglévő webhelyet a megoldáshoz.

2. Webhelybeállítások konfigurálása:

   1. Nyissa meg a Kezelés alkalmazást, és nyissa meg a Power Pages Webhely beállításait .
   2. Válassza ki a környezethez definiálni kívánt webhelybeállítást.
   3. A legördülő menüben válasszon ki vagy hozzon létre egy környezeti változót. A felhasználók ebben a legördülő menüben megtekinthetik és kiválaszthatják a megoldási folyamaton keresztül létrehozott környezeti változókat.

Megjegyzés

A webhely beállításaiban a legördülő menü megjeleníti a megoldási folyamat használatával létrehozott környezeti változók nevét, így a felhasználók könnyen kiválaszthatják és társíthatják őket.

• A célkörnyezetbe való importálási folyamat során a rendszer kéri, hogy rendeljen hozzá egy értéket a környezeti változóhoz.
• A környezeti változó módosításai frissítik a megfelelő helybeállításokat a célkörnyezet új értékével.

Folyamatok

Ha folyamatokat használ a megoldások üzembe helyezéséhez, meg kell adnia a célkörnyezet környezeti változójának értékét. Ha frissíti, frissítse a megfelelő webhelybeállításokat, hogy azok tükrözzék az új értéket.

A webhelybeállítások környezeti változóit támogató felületek

A környezeti változókat a következő felületeken használhatja a webhelybeállításokhoz:

• Power Pages Felügyeleti alkalmazás: Környezeti változók létrehozása és kezelése.
• Design Studio: Megtekintheti vagy szerkesztheti a webhely beállításait környezeti változókkal.
• Megoldástervező: Környezeti változók belefoglalása az ALM-folyamatba.
• Folyamattelepítések: Környezetspecifikus konfigurációk kezelése és ellenőrzése az üzembe helyezés során.

Törölje a gyorsítótárat a frissítések után

Ha módosítja a környezeti változó értékét vagy az alapértelmezett értéket, manuálisan törölje a gyorsítótárat az alábbi módszerek egyikével:

1. Válassza a Szinkronizálás lehetőséget a tervezőstúdióban . ...

   

2. Törölje a gyorsítótárat a portálról:

   1. Jelentkezzen be a portálra rendszergazdaként, és lépjen a webhelyre az /_services/about URL-címhez fűzve. Például: https://contoso.powerappsportals.com/_services/about.

      

   2. A portál részletei lapon válassza a Gyorsítótár törlése lehetőséget.

3. Indítsa újra a portált a Power Platform felügyeleti központból.

Hibaelhárítás

Az alábbiakban felsorolunk néhány különböző okot, amelyek miatt hibákat tapasztalhat, amikor környezeti változókat használ a webhelybeállításokkal:

• Eltérés a környezeti változó értékében és a várt típusban

  Ha például egy webhelybeállítás, például Search/Enabled logikai értéket vár (igaz/hamis), de a környezeti változó érvénytelen értéket tartalmaz (például "abc"), vagy hiányzik, az problémákat okoz.

• Nem támogatott környezeti változó forrástípusa

  Ez a probléma akkor fordul elő, ha a környezeti változó nem támogatott módon van konfigurálva, például a forrás típusát "adattárolásra" állítja.

• Key Vault hozzáférési problémák

  Ez a probléma akkor fordulhat elő, ha a környezeti változó forrása Key Vault, de a futtatókörnyezetből hiányoznak az engedélyek, vagy hiányzik a titkos kulcs.

Ajánlott eljárások

A webhelybeállítások környezeti változóival végzett munka során fontos követni az ajánlott eljárásokat a hatékony és eredményes felügyelet érdekében. Íme néhány kulcsfontosságú ajánlás:

• Használat

  Ezt a funkciót csak az ALM-mel kapcsolatos beállításokhoz vagy titkos kulcsokhoz használja. Kerülje az összes webhelybeállításhoz való használatát, mert teljesítményromláshoz vezethet.

• Változók konzisztens elnevezése

  Használjon konzisztens neveket a környezeti változókhoz, hogy könnyebben azonosíthatók legyenek.

• Változók dokumentuma

  Tartson fenn egy referenciadokumentumot, amely felsorolja az összes környezeti változót, azok célját és alapértelmezett értékeit.

• Tesztelje alaposan

  Ellenőrizze a módosításokat egy nem éles környezetben, mielőtt alkalmazná őket az éles környezetben.

• Használja a leírásokat

  A leírás mezőben magyarázza el a változó célját.

Környezeti változók konfigurálása titkos kulcsként

A környezeti változók titkos kulcsként való konfigurálásához és használatához Power Pages kövesse az alábbi lépéseket:

1. Konfiguráljon egy környezeti változót titkos kulcsként. További információ: Környezeti változók használata titkos Azure Key Vault.

2. Adjon hozzá engedélyeket a titkos kulcs eléréséhez a portálról.

   1. A Azure Portal szerezze be az alkalmazás nevét a webhelyének megfelelő alkalmazásregisztrációkban Power Pages .
   2. Az alkalmazás neve megegyezik a webhely nevével, a "Portals-" előtaggal. Ha a webhely neve Woodgrove Bank Applications, akkor az alkalmazás neve a Azure Portal Portals-Woodgrove Bank Applications. Jegyezze meg az alkalmazás regisztrációs nevét későbbi használatra.
   3. Jelentkezzen be a Azure Portal , és lépjen a Key Vaults.

3. Hozzon létre egy új kulcstartót, vagy használjon egy meglévőt.

   Új kulcstartó létrehozásakor válasszon egy engedélymodellt. Válassza az Azure szerepköralapú hozzáférés-vezérlést vagy Key Vault hozzáférési szabályzatot. A megfelelő lépések megtekintéséhez válassza a következő lapot a választott engedélymodell alapján:

Azure szerepköralapú hozzáférés-vezérlés

1. Nyissa meg a kulcstartót a Azure Portal.
2. Válassza a Hozzáférés-vezérlés (IAM) lehetőséget a bal oldali menüben.
3. Válassza a + Hozzáadás lehetőséget az oldal tetején, majd válassza a Szerepkör-hozzárendelés hozzáadása lehetőséget .
4. A Feladatfüggvény-szerepkörök lapon keressen rá a Key Vault titkos kulcsok felhasználójára, válassza ki, majd kattintson a Tovább gombra.
5. A Hozzáférés hozzárendelése mezőben válassza a Felhasználó, csoport vagy szolgáltatásnév lehetőséget.
6. Válassza a + Válasszon tagokat , és keresse meg webhelye alkalmazásregisztrációs nevét a korábban leírtak szerint.
7. Válassza ki a webhelyhez tartozó alkalmazást, majd kattintson a Tovább gombra.
8. Válassza az Áttekintés + hozzárendelés lehetőséget.

A webhely most már rendelkezik engedélyekkel a kulcstartóból származó titkos kulcsok olvasásához.

Key Vault hozzáférési szabályzat

1. Válassza a Hozzáférési szabályzatok lehetőséget a bal oldali menüben.
2. Válassza a + Létrehozás lehetőséget az oldal tetején.
3. A Titkos engedélyek alattválassza a Következő lekérése>lehetőséget.
4. Keressen rá a webhely alkalmazásregisztrációs nevére a korábban leírtak szerint.
5. Válassza ki a webhely alkalmazását, majd kattintson a Tovább gombra .
6. Válassza a Létrehozás parancsot.

A webhely most már rendelkezik engedélyekkel a kulcstartóból származó titkos kulcsok olvasásához.

4. Adja hozzá a kulcsot titkos kulcsként a kulcstartóhoz. Megtudhatja, hogyan hozhat létre titkos kulcsot az Azure Key Vaultban a Beállítás és a titkos kulcs lekérése az Azure Key Vaultból a Azure Portal.

GYIK

1. Használhatok környezeti változókat bármely webhelybeállításhoz?
   Igen, a dinamikus értékeket támogató webhelybeállítások használhatnak környezeti változókat.

2. Mi történik, ha nincs megadva környezetspecifikus érték?
   Az alapértelmezett érték tartalékként használatos.

3. Szerkeszthetem a környezeti változók értékeit közvetlenül az éles környezetben?
   Igen, de győződjön meg arról, hogy a változtatásokat tesztelték és dokumentálták a nem kívánt következmények elkerülése érdekében.

Összegzés

A webhelybeállítások környezeti változója leegyszerűsíti az ALM-et, javítja a konfigurálhatóságot, és csökkenti a manuális hibák kockázatát. A funkciót alkalmazó készítők és rendszergazdák biztosítják, hogy webhelyeik rugalmasak maradjanak, és igazodjanak a szervezeti telepítési stratégiákhoz.

Kapcsolódó információk

• Webhelyek webhelybeállításainak konfigurálása
• Környezeti változók áttekintése