A standard logikai alkalmazás munkafolyamatainak buildelésének és üzembe helyezésének automatizálása az Azure DevOps használatával

Az egybérlős Azure Logic Appsben futó standard logikaialkalmazás-munkafolyamatok esetében a Visual Studio Code és az Azure Logic Apps (Standard) bővítmény használatával helyileg fejlesztheti, tesztelheti és tárolhatja a logikai alkalmazásprojektet bármilyen forrásvezérlő rendszer használatával. A munkafolyamatok különböző környezetekben és platformokon való egyszerű és következetes üzembe helyezésének minden előnyét kihasználva azonban automatizálnia kell a buildelési és üzembe helyezési folyamatot is.

Az Azure Logic Apps (Standard) bővítmény eszközeivel automatizált buildelési és üzembehelyezési folyamatokat hozhat létre és tarthat fenn az Azure DevOps használatával. Az automatizálás megkezdése előtt azonban vegye figyelembe a következő elemeket:

• Az Azure logikai alkalmazás erőforrása, ahol munkafolyamatokat hoz létre

• A munkafolyamatok által használt és a Microsoft által felügyelt összekötőkből létrehozott Azure-beli kapcsolatok.

  Ezek a kapcsolatok eltérnek az Azure Logic Apps-futtatókörnyezettel közvetlenül és natívan futtatott kapcsolatoktól.

• Az üzembe helyezni kívánt különböző környezetek adott beállításai és paraméterei

A bővítmény a következő szükséges feladatok elvégzését segíti a buildelés és az üzembe helyezés automatizálásához:

• A kapcsolathivatkozások paraméterezése a tervezéskor. Ez a feladat leegyszerűsíti a különböző környezetekben lévő hivatkozások frissítésének folyamatát a helyi fejlesztési funkciók feltörése nélkül.

• Olyan szkriptek létrehozása, amelyek automatizálják a standard logikai alkalmazás erőforrás üzembe helyezését, beleértve az összes függő erőforrást is.

• Olyan szkriptek létrehozása, amelyek automatizálják az Üzembe helyezést az Azure-ban üzemeltetett kapcsolatokhoz.

• A buildelési folyamat során az Azure Logic Apps-csomagba injektálható környezetspecifikus paraméterek előkészítése a helyi fejlesztési funkciók feltörése nélkül.

• Igény szerinti folyamatok létrehozása az Azure DevOps használatával az infrastruktúra üzembe helyezésének és a buildelési és kiadási folyamatok támogatásához.

Ez az útmutató a következő feladatok elvégzését mutatja be:

1. Hozzon létre egy logikai alkalmazás-munkaterületet és projektet a Visual Studio Code-ban, amely tartalmazza az infrastruktúra üzembe helyezéséhez, a folyamatos integrációhoz (CI) és a folyamatos üzembe helyezéshez (CD) futó folyamatokat létrehozó fájlokat.

2. Hozzon létre kapcsolatot a munkaterület és a Git-adattár között az Azure DevOpsban.

3. Folyamatok létrehozása az Azure DevOpsban.

További információkért tekintse meg a következő dokumentációt:

• Mi az Azure DevOps?
• Mi az Az Azure Pipelines?

Ismert problémák és korlátozások

• Ez a funkció csak a Standard logikai alkalmazásprojekteket támogatja. Ha a Visual Studio Code-munkaterület egy Standard logikai alkalmazásprojektet és egy Functions egyéni kódprojektet is tartalmaz, mindkettő üzembehelyezési szkripteket hoz létre, de az egyéni kódprojektek jelenleg figyelmen kívül lesznek hagyva. Az egyéni kód buildelési folyamatainak létrehozásának képessége az ütemtervben található.

• A bővítmény folyamatokat hoz létre az infrastruktúra üzembe helyezéséhez, a folyamatos integrációhoz (CI) és a folyamatos üzembe helyezéshez (CD). Ön azonban felelős a folyamatok Azure DevOpshoz való csatlakoztatásáért és a megfelelő triggerek létrehozásához.

• A bővítmény jelenleg csak az Azure Resource Management-sablonokat (ARM-sablonokat) támogatja az infrastruktúra üzembehelyezési szkriptjeihez. Más sablonok is tervezés alatt állnak.

Előfeltételek

• Azure-fiók és -előfizetés. Ha még nincs előfizetése, regisztráljon egy ingyenes Azure-fiókra.

• Visual Studio Code az Azure Logic Apps (Standard) bővítménnyel. Ezeknek a követelményeknek való megfeleléshez tekintse meg a Standard munkafolyamatok létrehozása a Visual Studio Code-tal való létrehozásának előfeltételeit.

• Az Azure Logic Apps (Standard) buildelési és kiadási feladatai az Azure DevOps-feladatokhoz. Ezeket a feladatokat az Azure DevOps Marketplace-en találja.

• Egy meglévő Git-adattár az Azure DevOpsban , ahol tárolhatja a logikai alkalmazásprojektet.

• Azure Resource Manager-szolgáltatáskapcsolat egy meglévő szolgáltatásnévvel.

• Egy meglévő Azure-erőforráscsoport , amelyben üzembe szeretné helyezni a logikai alkalmazást.

Logikai alkalmazás munkaterületének, projektének és munkafolyamatának létrehozása

1. A Visual Studio Code tevékenységsávján válassza az Azure ikont.

2. Az Azure-ablakban, a Munkaterület eszköztáron nyissa meg az Azure Logic Apps menüt, és válassza az Új logikaialkalmazás-munkaterület létrehozása lehetőséget.

   

3. Kövesse az utasításokat a következő feladatok elvégzéséhez:

   1. Jelölje ki azt a mappát, amely létrehozza a munkaterületet.

   2. Adja meg a munkaterület nevét.

   3. Válassza ki a projekt típusát: Logikai alkalmazás

   4. Adja meg a logikai alkalmazás projektnevét.

   5. Válassza ki a munkafolyamat-sablont. Adja meg a munkafolyamat nevét.

   6. Válassza ki, hogy meg szeretné-e nyitni a munkaterületet az aktuális Visual Studio Code-ablakban vagy egy új ablakban.

      A Visual Studio Code megjeleníti az új munkaterületet és logikai alkalmazásprojektet.

4. A munkafolyamat-tervező megnyitásához kövesse az alábbi lépéseket:

   1. A logikai alkalmazás projektjében bontsa ki a mappát a munkafolyamat nevével.

   2. Ha még nem nyitotta meg, nyissa meg a workflow.json fájlt, nyissa meg a fájl helyi menüjét, és válassza a Tervező megnyitása lehetőséget.

   3. Amikor a rendszer kéri, hogy engedélyezze a kapcsolatok paraméterezését a projekt betöltésekor, válassza az Igen lehetőséget.

      Ez a kijelölés lehetővé teszi, hogy a projekt paramétereket használjon a kapcsolatdefiníciókban, hogy automatizálhassa a buildelést és az üzembe helyezést a különböző környezetekben.

   4. Az alábbi utasításokat követve jelölje ki az alábbi elemeket:

      • Összekötők használata az Azure-ból

        Feljegyzés

        Ha kihagyja ezt a lépést, csak a futtatókörnyezetben üzemeltetett beépített összekötőket használhatja. A Microsoft által felügyelt, Azure által üzemeltetett összekötők későbbi engedélyezéséhez kövesse az alábbi lépéseket:

        1. Nyissa meg a workflow.json fájl helyi menüjét, és válassza az Összekötők használata az Azure-ból lehetőséget.

        2. Válasszon ki egy meglévő Azure-erőforráscsoportot, amelyet használni szeretne a logikai alkalmazáshoz.

        3. Töltse be újra a munkafolyamat-tervezőt.

      • A logikai alkalmazáshoz használni kívánt meglévő Azure-erőforráscsoport

5. Ha végzett, töltse be újra a munkafolyamat-tervezőt. Ha a rendszer kéri, jelentkezzen be az Azure-ba.

   

Mostantól bármilyen módon szerkesztheti a munkafolyamatot, és helyileg tesztelheti a munkafolyamatot. Minta-munkafolyamat létrehozásához és teszteléséhez tekintse meg a Standard munkafolyamatok létrehozása a Visual Studio Code-tal című témakört.

Üzembehelyezési szkriptek létrehozása

A munkafolyamat létrehozása és helyi tesztelése után hozza létre az üzembehelyezési szkripteket.

1. Az összes projektfájl üres területén nyissa meg a projekt helyi menüjét, és válassza az Üzembehelyezési szkriptek létrehozása lehetőséget.

   

2. Kövesse az utasításokat az alábbi lépések végrehajtásához:

   1. Válassza ki a logikai alkalmazáshoz használni kívánt meglévő Azure-erőforráscsoportot.

   2. Adjon meg egy egyedi nevet a logikai alkalmazás erőforrásának.

   3. Adjon meg egy egyedi nevet a tárfiók-erőforrásnak.

   4. Adjon meg egy egyedi nevet az App Service-csomaghoz.

   5. Válassza ki azt a munkaterületi mappát, ahol létre szeretné hozni a fájlokat.

      Üzembehelyezési mappa helye	Leírás
      Új üzembehelyezési mappa (alapértelmezett)	Hozzon létre egy új mappát az aktuális munkaterületen.
      Másik mappa kiválasztása	Válasszon egy másik mappát az aktuális munkaterületen.

   Ha elkészült, a Visual Studio Code létrehoz egy üzembe helyezés/{logic-app-name} nevű mappát a munkaterület gyökerében. Ez a mappa az ezekben a lépésekben megadott logikai alkalmazásnevet használja.

   Feljegyzés

   Az alábbi fájlok változóinak, alkalmazásbeállításainak és paramétereinek értékei előre fel vannak töltve az ezekben a lépésekben megadott bemenet alapján. Ha egy másik környezetet céloz meg, győződjön meg arról, hogy frissíti a létrehozott paraméterek és változófájlok értékeit.

   

   A {logic-app-name} mappában a következő struktúra található:

   Mappa neve	Fájlnév és leírás
   ADOPipelineScripts	- CD-pipeline.yml: A logikai alkalmazás kódjának üzembe helyezésére vonatkozó utasításokat tartalmazó folyamatos kézbesítési folyamat az Azure-beli logikai alkalmazás erőforrásában. - CD-pipeline-variables.yml: A CD-pipeline.yml fájl által használt változókat tartalmazó YAML-fájl. - CI-pipeline.yml: A logikaialkalmazás-erőforrás Azure-ban való üzembe helyezéséhez szükséges összetevők létrehozásához és létrehozásához szükséges utasításokat tartalmazó folyamatos integrációs folyamat. - CI-pipeline-variables.yml: A CI-pipeline.yml fájl által használt változókat tartalmazó YAML-fájl. - infrastructure-pipeline.yml: A YAML "Infrastructure-as-Code" folyamat, amely tartalmazza az összes ARM-sablon Azure-ba való betöltésére és a infrastructure-pipeline-template.yml fájl lépéseinek végrehajtására vonatkozó utasításokat. - infrastructure-pipeline-template.yml: YAML-folyamatfájl, amely tartalmazza a logikaialkalmazás-erőforrás üzembe helyezésének lépéseit az összes szükséges függőséggel, valamint a forráskód által igényelt felügyelt kapcsolatok üzembe helyezésének lépéseit. - infrastructure-pipeline-variables.yml: EGY YAML-folyamat, amely tartalmazza a infrastructure-pipeline-template.yml fájl lépéseinek végrehajtásához szükséges összes változót.
   ArmTemplates	- {connection-type}.parameters.json: Egy Resource Manager-paraméterfájl, amely tartalmazza a(z) {connection-type} nevű Azure-beli kapcsolat Üzembe helyezéséhez szükséges paramétereket az Azure-ban. Ez a fájl a munkafolyamat minden Azure-beli kapcsolatához létezik. - {connection-type}.template.json: Egy Resource Manager-sablonfájl, amely egy Azure-ban üzemeltetett kapcsolatot jelöl {connection-reference} néven, és tartalmazza a megfelelő kapcsolati erőforrás Azure-ban való üzembe helyezéséhez használt információkat. Ez a fájl a munkafolyamat minden Azure-beli kapcsolatához létezik. - {logic-app-name}.parameters.json: Egy Resource Manager-paraméterfájl, amely tartalmazza a ({logic-app-name} nevű standard logikaialkalmazás-erőforrás üzembe helyezéséhez szükséges paramétereket az Azure-ban, beleértve az összes függőséget is). - {logic-app-name}.template.json: A(z) {logic-app-name} nevű standard logikaialkalmazás-erőforrást képviselő Resource Manager-sablonfájl, amely tartalmazza a logikai alkalmazás erőforrásának Azure-ban való üzembe helyezéséhez használt információkat.
   WorkflowParameters	parameters.json: Ez a JSON-fájl a helyi paraméterek fájljának másolata, és tartalmazza az összes felhasználó által megadott paraméter másolatát, valamint a bővítmény által az Azure által üzemeltetett kapcsolatok paraméterezéséhez létrehozott paraméterek felhőbeli verzióját. Ez a fájl az Azure-ban üzembe helyező csomag összeállítására szolgál.

A munkaterület csatlakoztatása a Git-adattárhoz

1. Kövesse az alábbi lépéseket az adattár inicializálásához:

   1. A Visual Studio Code tevékenységsávján válassza a Forrásvezérlő ikont.

   2. A Forrásvezérlő ablakban válassza az Adattár inicializálása lehetőséget.

   3. A parancssori menüben válassza a Mappa kiválasztása lehetőséget. Jelölje ki a munkaterület gyökérmappáját, majd válassza az Adattár inicializálása lehetőséget.

      

   4. A Forrásvezérlő ablakban válassza az Adattár megnyitása lehetőséget.

   5. A parancssori menüben válassza ki az imént létrehozott adattárat.

   További információ: Visual Studio Code – Adattár inicializálása helyi mappában.

2. Kövesse az alábbi lépéseket a Git-adattár URL-címének lekéréséhez, hogy távolit is hozzáadhatjon:

   1. Az Azure DevOpsban nyissa meg az Azure DevOps-szervezet csapatprojektét.

   2. A bal oldali menüben bontsa ki az Adattárak elemet, és válassza a Fájlok lehetőséget.

   3. A Fájlok panel eszköztárán válassza a Klónozás lehetőséget.

      

   4. A Klónozási adattár ablakban másolja a klón URL-címének HTTPS-verzióját.

      További információ: A Git-adattár klón URL-címének lekérése az Azure-adattárban.

3. Kövesse az alábbi lépéseket egy távoli git-adattár hozzáadásához:

   1. Térjen vissza a Visual Studio Code-hoz és a Forrásvezérlő ablakhoz.

   2. A Forráskövetési adattárak területen nyissa meg az adattár eszköztárán a három pont (...) menüt, és válassza a Távoli>hozzáadás lehetőséget.

      

4. A parancssorba illessze be a másolt URL-címet, és adjon meg egy nevet a távolinak, amely általában a forrás.

   Most létrehozott egy kapcsolatot a Visual Studio Code és az adattár között.

5. Mielőtt beállítja a folyamatokat a következő szakaszban, nyissa meg a CD-pipeline.yml fájlt, és nevezze át a CI-folyamatot az source attribútumban, hogy megfeleljen a használni kívánt CI-folyamat nevének.

   

6. A Forráskövetés ablakban véglegesítse a módosításokat, és tegye közzé őket az adattárban.

   További információ: Kódmódosítások szakasza és véglegesítése.

Folyamatok létrehozása az Azure DevOpsban

Ha az infrastruktúrát a CI- és CD-folyamatokkal együtt szeretné létrehozni az Azure DevOpsban, ismételje meg az alábbi lépéseket az alábbi folyamatfájlok mindegyikéhez:

• infrastructure-pipeline.yml az "Infrastruktúra kódként" folyamathoz.
• CI-pipeline.yml a folyamatos integrációs folyamathoz.
• CD-pipeline.yml a folyamatos kézbesítési folyamathoz.

Folyamat beállítása

1. Az Azure DevOpsban térjen vissza a csapatprojekthez és az Adattárfájlok> panelhez.

2. A Fájlok panelen válassza a Build beállítása lehetőséget.

   

3. Az Inventory your pipeline panelen erősítse meg az adattár adatait, és válassza a Folyamat konfigurálása lehetőséget.

   

4. A Folyamat konfigurálása panelen válassza a Meglévő Azure Pipelines YAML-fájlt.

   

5. A Meglévő YAML-fájl kiválasztása panelen kövesse az alábbi lépéseket a Infrastructure-pipeline.yml fájl kiválasztásához:

   1. Az Ág esetében válassza ki azt az ágat, ahol véglegesítette a módosításokat, például a főágat vagy a kiadási ágat.

   2. Az Elérési út mezőben válassza ki a folyamathoz használni kívánt útvonalat. Az alapértelmezett érték a következő elérési út:

      üzembe helyezés/{logic-app-name}/ADOPipelineScripts/{infrastructure-pipeline-name}.yml

   3. Ha készen áll, válassza a Folytatás lehetőséget.

      

6. A Folyamat konfigurálása panelen válassza a Folyamat áttekintése lehetőséget.

7. A Szabályozott folyamat áttekintése panelen adja meg a következő információkat:

   • Folyamat neve: Adja meg a folyamat nevét.
   • Folyamatmappa: Válassza ki azt a mappát, ahová menteni szeretné a folyamatot, amelynek neve ./deployment/{logic-app-name}/pipelines.

8. Amikor elkészült, válassza a Mentés lehetőséget.

   

Folyamat megtekintése és futtatása

A folyamat megkereséséhez és futtatásához kövesse az alábbi lépéseket:

1. A csapatprojekt bal oldali menüjében bontsa ki a Folyamatok elemet, és válassza a Folyamatok lehetőséget.

2. Az Összes lapra kattintva megtekintheti az összes elérhető folyamatot. Keresse meg és válassza ki a folyamatot.

3. A folyamat eszköztárán válassza a Folyamat futtatása lehetőséget.

   

További információ: Az első folyamat létrehozása.

Lásd még

• A folyamat testreszabása

• A folyamat kezelése az Azure CLI-vel

• Folyamatos integráció az Azure Pipelinessal a Visual Studio Code-ban