Oktatóanyag: A megoldás üzembe helyezésének automatizálása a Microsoft Power Platform GitHub Actions használatával

Ebben az oktatóanyagban a következőket sajátíthatja el:

• Új GitHub-adattár létrehozása
• Két GitHub munkafolyamat létrehozása GitHub Actions használatával Microsoft Power Platform

A munkafolyamatok automatikusan exportálhatják az alkalmazását (nem felügyelt megoldásként) egy fejlesztői környezetből, létrehozhatnak egy buildösszetevőt (felügyelt megoldást), és telepíthetik az alkalmazást az éles környezetébe. Ez az oktatóanyag az Ön által létrehozott ALMLab megoldást használja, valamint a korábbi oktatóanyagokban beállított környezeteket.

Kapcsolódó oktatóanyagok: Első lépések és Modellvezérelt alkalmazáslétrehozása.

GitHub-fiók létrehozása

1. Lépjen a https://github.com oldalra, és válassza a Regisztráció vagy az Ingyenes próbaverzió indítása lehetőséget (vagy jelentkezzen be, ha már rendelkezik fiókkal).

   

2. A fiók létrehozása után hozzon létre egy tárházat a Tárház létrehozása vagy az Új lehetőség kiválasztásával.

   

   Előfordulhat, hogy a következő alternatív kezdőképernyő jelenik meg:

   

3. Hozza létre az új adattárat, és nevezze el poweractionslab. Győződjön meg arról, hogy a repozitorium elindításához válassza a README-fájl hozzáadása lehetőséget, majd válassza a Repozitorium létrehozása lehetőséget.

   

Új titok létrehozása a Service Principal-hitelesítéshez

1. Nyissa meg az adattárat, és válassza a Beállítások lehetőséget. Bontsa ki a Titkos elemek elemet, majd válassza a Műveletek lehetőséget.

2. A Titkok lapon nevezze el a titkot PowerPlatformSPN. Írja be az Ön által létrehozott alkalmazásregisztráció ügyféltitkát az Érték mezőbe, majd válassza a Titkos ügyfélkulcs hozzáadása lehetőséget. Az oktatóanyag későbbi részében az GitHub munkafolyamatokat meghatározó YML-fájlokban szereplő ügyfélkulcsra fog hivatkozni.

   

   A kliens titkos kulcsa most már biztonságosan van tárolva GitHub-secretként.

Hozzon létre egy munkafolyamatot, amely exportálja és kicsomagolja a megoldásfájlt egy új ágba

1. Válassza a Műveletek lehetőséget, majd saját maga állítsa be a munkafolyamatot. Vagy válassza a Konfigurálás lehetőséget az ehhez az adattárhoz javasolt szakasz Egyszerű munkafolyamat mezőjében.

   

2. Megjelenik egy új YAML-fájl, amely egy alapszintű munkafolyamattal segíti a GitHub Actions használatának megkezdését.

   

3. Törölje az előre létrehozott tartalmat, majd illessze be a tartalmat a export-and-branch-solution-with-spn-auth.yml fájlból. Nevezze át a fájlt a következőre export-and-branch-solution.yml: .

   

4. Frissítse a(z) <ENVIRONMENTURL> értékét annak a fejlesztői környezetnek az URL-címével, amelyből exportálni szeretne (például: https://poweractionsdev.crm.dynamics.com).

5. Frissítse az <APPID> és az <TENANT ID> elemeket a saját értékeire.

   • Hitelesítő adatok használata esetén illessze be a(z) export-and-branch-solution.yml fájl tartalmát a export-and-branch-solution-with-spn-auth.yml fájl tartalma helyett. Frissítse a(z) <USERNAME> elemet a környezethez való csatlakozáshoz használt felhasználónévre.

     

   Tipp

   Ha nem ismeri a GitHub Actions-t, és többet szeretne megtudni, tekintse meg a hivatalos dokumentációt a következő címen: https://docs.github.com/en/actions

6. Most már készen áll a módosítások véglegesítésére. Válassza a Véglegesítés indítása lehetőséget , írja be az Exportálási YML létrehozása parancsot a címmezőbe, majd adja hozzá a leírást (nem kötelező). Ezután válassza az Új fájl véglegesítése lehetőséget.

   

Gratulálunk, az első GitHub munkafolyamatot a következő műveletekkel hozta létre:

• Who Am I: Biztosítja, hogy sikeresen kapcsolódjon az exportálni kívánt környezethez.
• Solution exportálása: Exportálja a solutionfájlt a fejlesztői környezetből.
• Megoldás kicsomagolása: A kiszolgáló által exportált megoldásfájl tömörített (zip) fájl konszolidált konfigurációs fájlokkal. Ezek a kezdeti fájlok nem alkalmasak a verziókezelésre, mert nem úgy vannak strukturálva, hogy a verziókezelő rendszerek számára lehetővé tegyék a fájlok közötti eltérések megfelelő megállapítását, és rögzítsék a verziókezelésbe véglegesíteni kívánt módosításokat. Ki kell csomagolnia a megoldásfájlokat, hogy azok megfelelőek legyenek a verziókezelőben való tárolásra és feldolgozásra.
• Ágmegoldás: Új ágat hoz létre az exportált megoldás tárolására.

Az exportálási és a kibontási munkafolyamat tesztelése

1. Ezután ellenőrizze, hogy a munkafolyamat fut-e. Lépjen a Műveletek elemre, válassza a Munkafolyamat futtatása, majd a Munkafolyamat futtatása lehetőséget. Ha más megoldásnevet használ, mint ALMLab, itt módosítsa az értéket, de a többi értéket hagyja változatlanul.

   

2. 5–10 másodperc után elindul a munkafolyamat. A folyamat figyeléséhez válassza ki a futó munkafolyamatot.

   

   

3. A munkafolyamat befejezése után ellenőrizze, hogy létrejön egy új ág a solutions/ALMLab mappába kibontott megoldással. Lépjen a Kód lapra, és nyissa le az ágak legördülő menüt.

4. Válassza ki azt az ágat, amelyet a művelet hozott létre.

5. Ellenőrizze, hogy a solutions/ALMLab mappa létrejött-e az új ágban. Ezután hozzon létre egy pull requestet a módosítások főágba való beolvasztásához. Válassza a Közreműködés lehetőséget, majd a lenyíló panelen válassza a Pull request megnyitása lehetőséget.

6. Ha szeretné, adja hozzá a címet és a leírást a Pull request megnyitása képernyőn, majd válassza a Pull request létrehozása lehetőséget.

7. A képernyő frissül, hogy megjelenjen az új pull request. A pull request létrehozásakor megerősítést kap arról, hogy az ág nem ütközik a főággal. Ez a megerősítés azt jelenti, hogy a módosítások automatikusan beolvaszthatók a főágba. Válassza a Pull request egyesítése lehetőséget, majd az Egyesítés megerősítése lehetőséget. Ha szeretné, válassza az Ág törlése lehetőséget a már megszűnt ág eltávolításához.

   

8. Térjen vissza az alapértelmezett (fő) ághoz, és ellenőrizze, hogy a megoldás elérhető-e ott.

Hozzon létre egy újrafelhasználható munkafolyamatot a build-artefaktum létrehozásához és éles környezetbe történő importálásához

Ebben a szakaszban hozzon létre egy további munkafolyamatot, amely a következőket végzi:

• Létrehoz egy felügyelt megoldást, és közzéteszi azt GitHub-artifaktumként
• Importálja a build-artefaktumot az éles környezetbe

1. Nyissa meg a Műveletek lehetőséget, és válassza az Új munkafolyamat lehetőséget.

   

2. Válassza ki , hogy saját maga állítson be egy munkafolyamatot.

   

3. Nevezze át a munkafolyamat címét erre: release-solution-to-prod-with-inputs. Másolja ki a tartalmat a release-solution-to-prod-with-inputs.yml fájlból, és illessze be az Új fájl szerkesztése képernyőre.

   

4. Véglegesítse a módosításokat. Válassza a Véglegesítés indítása lehetőséget , majd adja meg a címet és a leírást (nem kötelező). Ezután válassza az Új fájl véglegesítése lehetőséget.

   

Hívd meg az újrafelhasználható munkafolyamatot a kiadási eseményre

Ebben a szakaszban az újrahasználható munkafolyamatot hívja meg a kiadási eseményen.

1. Nyissa meg a Műveletek lehetőséget, és válassza az Új munkafolyamat lehetőséget.

   

2. Válassza a munkafolyamat beállítása saját kezüleg lehetőséget.

   

3. Nevezze át a munkafolyamat címét a következőre release-action-call: . Másolja ki a tartalmat a release-action-call.yml fájlból, és illessze be az Új fájl szerkesztése képernyőre.

   

4. Frissítse a következő változókat az új munkafolyamat-fájlban:

   • Frissítsen <BUILD_ENVIRONMENT> a felügyelt megoldás létrehozásához használt buildkörnyezet URL-címével. Példa: https://poweractionsbuild.crm.dynamics.com.
   • Frissítse a(z) <PROD_ENVIRONMENT> elemet annak az éles környezetnek az URL-címére, amelyre telepít. Példa: https://poweractionsprod.crm.dynamics.com.
   • Frissítsen <APP_ID> a Microsoft Azure Portal Alkalmazásregisztrációk paneljén található alkalmazás-(ügyfél-)azonosítóval az oktatóanyag korábbi részében létrehozott regisztráció kiválasztásával.
   • Frissítse a(z) <TENANT_ID> elemet a Microsoft Azure Portal Alkalmazásregisztrációk panelján található címtár-(bérlő-)azonosítóra az oktatóanyag korábbi részében létrehozott regisztráció kiválasztásával.

5. Véglegesítse a módosításokat. Válassza a Véglegesítés indítása lehetőséget, majd adja meg a címet (nem kötelező) és a leírást (nem kötelező). Ezután válassza az Új fájl véglegesítése lehetőséget.

   

A kiadás tesztelése az éles munkafolyamatban

Most már készen áll az utolsó munkafolyamat tesztelésére. Ez a munkafolyamat egy új kiadás éles környezetben való üzembe helyezésekor aktiválódik.

1. Lépjen a(z) Kiadások oldalra.

   

2. Válassza az Új kiadás vázlatának létrehozása lehetőséget.

3. Vegyen fel egy kiadási taget, egy címet, majd válassza a Kiadás közzététele lehetőséget.

4. A futó munkafolyamat megtekintéséhez válassza a Műveletek lehetőséget.

   

5. A futó munkafolyamatot kiválasztva megtekintheti a műveleteket futás közben.

   

6. Várja meg, amíg minden művelet befejeződik.

   

7. A munkafolyamat befejezése után jelentkezzen be az éles környezetbe, és ellenőrizze, hogy a megoldás felügyelt megoldásként van-e üzembe helyezve.

Telepítse a frissítést, és tekintse át a változásokat az éles kiadás előtt

Tesztelje a teljes körű folyamatot, majd tekintse meg, hogyan nézheti meg és ellenőrizheti egy alkalmazás módosításait, mielőtt éles környezetben üzembe helyezné.

1. Nyissa meg az ALMLab-megoldást a fejlesztői környezetben, és válassza a Szerkesztés lehetőséget, vagy válassza a megoldás megjelenített nevét.

   

2. Válassza ki és tekintse meg a Szabadságkérelem táblát.

   

3. Válassza az + Oszlop hozzáadása lehetőséget, és hozza létre az új oszlopot az alábbi ábrán látható módon.

   

   Frissített mezőértékek:**

   • Megjelenített név: Jóváhagyva
   • Adattípus: Igen/Nem

4. Válassza a Kész lehetőséget.

5. Válassza ki a Táblázat mentése lehetőséget.

6. Lépjen vissza a GitHub tárolói Actions lapjára, válassza a Munkafolyamat futtatása lehetőséget, majd a Munkafolyamat futtatása gombot.

   

7. 5–10 másodperc után elindul a munkafolyamat. Válassza ki a futó munkafolyamatot a folyamat figyeléséhez.

   

   

8. A munkafolyamat befejezése után lépjen az új ágra a Kód , majd az Ágak lehetőség kiválasztásával.

   

9. Válassza ki a létrehozott ágat a contribute kibontásával és a Pull request megnyitása kiválasztásával.

10. Adjon hozzá egy címet (nem kötelező), majd válassza a Pull request létrehozása lehetőséget.

11. A tartalomfrissítések után válassza a Módosított fájlok lapot.

12. Figyelje meg, hogy a megoldásban végrehajtott módosítások zöld színnel vannak kijelölve, ami azt jelzi, hogy a fájl ezen szakasza hozzá lett adva az ugyanezen fájl fő ágban található verziójához képest.

13. Lépjen vissza a Beszélgetés lapra. Válassza a Pull requestek lehetőséget, majd válassza ki a korábban létrehozott pull requestet.

14. A Pull request lapon válassza a Squash and merge lehetőséget a frissített megoldásfájl főágba való egyesítéséhez. Ha szeretné, törölje azt, ami most beolvadt a main ágba.

    

15. Az új kiadás létrehozásához és annak ellenőrzéséhez, hogy a frissített megoldás üzembe lett-e helyezve az éles környezetben, kövesse a Az éles környezetbe való kiadás tesztelése munkafolyamat című szakasz lépéseit.

Gratulálunk, sikeresen beállított egy CI/CD-minta-munkafolyamatot a GitHub Actions használatával!

Lásd még

Automatizálja munkafolyamatait az ötlettől az éles környezetig