Oktatóanyag: Alkalmazás üzembe helyezése Service Fabric-fürtön CI/CD használatával
Ez az oktatóanyag egy sorozat negyedik része, amely bemutatja, hogyan állíthat be folyamatos integrációt és üzembe helyezést egy Azure Service Fabric-alkalmazáshoz az Azure Pipelines használatával. Szükség van egy már meglévő Service Fabric-alkalmazásra, így példaként a .NET alkalmazás létrehozása szakaszban létrehozott alkalmazás szolgál.
A sorozat harmadik részében az alábbiakkal fog megismerkedni:
- Forráskezelés hozzáadása a projekthez
- Buildfolyamat létrehozása az Azure Pipelinesban
- Kiadási folyamat létrehozása az Azure Pipelinesban
- Alkalmazás automatikus üzembe helyezése és frissítése
Az alábbi oktatóanyagok a következőket ismertetik:
- .NET Service Fabric-alkalmazás létrehozása
- Az alkalmazás üzembe helyezése egy távoli fürtön
- HTTPS-végpont hozzáadása ASP.NET Core kezelőfelületi szolgáltatáshoz
- A CI/CD konfigurálása az Azure Pipelines használatával
- Figyelés és diagnosztika beállítása az alkalmazáshoz
Előfeltételek
Az oktatóanyag elkezdése előtt:
- Ha nem rendelkezik Azure-előfizetéssel, hozzon létre egy ingyenes fiókot
- Telepítse a Visual Studio 2019-et , és telepítse az Azure fejlesztési , ASP.NET- és webfejlesztési számítási feladatait.
- A Service Fabric SDK telepítése
- Hozzon létre egy Service Fabric-fürtöt az Azure-ban, például ennek az útmutatónak a segítségével
- Hozzon létre egy Azure DevOps-szervezetet. A szervezet lehetővé teszi egy projekt létrehozását az Azure DevOpsban, és használhatja az Azure Pipelinest.
A mintául szolgáló szavazóalkalmazás letöltése
Ha nem a sorozat első részében készítette el a Voting mintaalkalmazást, letöltheti. Egy parancssori ablakban futtassa a következő parancsot a mintaalkalmazás-adattár helyi számítógépre történő klónozásához.
git clone https://github.com/Azure-Samples/service-fabric-dotnet-quickstart
Közzétételi profil előkészítése
Most, hogy létrehozott egy alkalmazást , és üzembe helyezte az alkalmazást az Azure-ban, készen áll a folyamatos integráció beállítására. Először készítsen elő egy közzétételi profilt az alkalmazáson belül az Azure Pipelinesban végrehajtott üzembe helyezési folyamat számára. A közzétételi profilt úgy kell konfigurálni, hogy megcélozza a korábban létrehozott fürtöt. Indítsa el a Visual Studiót, és nyisson meg egy már meglévő Service Fabric-alkalmazásprojektet. A Megoldáskezelőben kattintson a jobb gombbal az alkalmazásra, majd válassza a Publish... (Közzététel) lehetőséget.
Az alkalmazásprojektben válasszon ki egy célprofilt a folyamatos integráció munkafolyamata számára. Ilyen lehet például a Cloud. Adja meg a fürt csatlakozási végpontját. Jelölje be az Upgrade the Application (Alkalmazás frissítése) jelölőnégyzetet, hogy az alkalmazás az Azure DevOpsban levő összes üzemelő példány esetében frissüljön. A Mentés hivatkozásra kattintva mentse a beállításokat a közzétételi profilba, majd a Mégse gombra kattintva zárja be a párbeszédpanelt.
A Visual Studio-megoldás megosztása egy új Azure DevOps Git-adattárban
Az alkalmazás forrásfájljait megoszthatja az Azure DevOps egyik projektjében, és ezáltal buildeket hozhat létre.
Új GitHub-adattár és Azure DevOps-adattár létrehozása a Visual Studio 2022 IDE-ből a Git –> Git-adattár létrehozása a Git menüből
Válassza ki a fiókját a legördülő menüben, adja meg az adattár nevét, majd válassza a Létrehozás és leküldés gombot.
Az adattár közzététele új projektet hoz létre az Azure DevOps Services-fiókban a helyi adattár nevével megegyező néven.
Az újonnan létrehozott adattár megtekintéséhez navigáljon a szervezetnévrehttps://dev.azure.com/\><, vigye az egérmutatót a projekt nevére, és válassza az Adattár ikont.
Folyamatos teljesítés konfigurálása az Azure Pipelines használatával
Az Azure Pipelines-buildfolyamatok olyan munkafolyamatokat írnak le, amelyek egymás után végrehajtott buildelési lépésekből állnak. Hozzon létre egy buildfolyamatot, amely létrehozza a Service Fabric-alkalmazáscsomagot és más összetevőket egy Service Fabric-fürtben való üzembe helyezéshez. További tudnivalók az Azure Pipelines buildelési folyamatokról.
Az Azure Pipelines kiadási folyamata olyan munkafolyamatot ír le, amely egy alkalmazáscsomagot telepít egy fürtre. Együttes használatuk esetén a buildfolyamat és a kiadási folyamat a teljes munkafolyamatot végrehajtja, a forrásfájloktól kezdve a fürtön futó alkalmazásig bezárólag. További információ az Azure Pipelines kiadási folyamatairól.
Buildelési folyamat létrehozása
Nyisson meg egy webböngészőt, és keresse meg az új projektet a következő címen: https://dev.azure.com/\<organizationname>/VotingSample
Válassza a Folyamatok lapot, és válassza a Folyamat létrehozása lehetőséget.
Válassza a Use the classic editor to create a pipeline without YAML (Klasszikus szerkesztő használata a folyamat YAML nélküli létrehozásához) elemet.
Válassza ki az Azure Repos Gitet forrásként, VotingSample Team-projektként, VotingApplication-adattárként és fő alapértelmezett ágként manuális és ütemezett buildekhez. Ezután válassza a Folytatás elemet.
A Sablon kiválasztása területen válassza ki az Azure Service Fabric-alkalmazássablont, és válassza az Alkalmaz lehetőséget.
A Feladatok területen adja meg az "Azure Pipelines" kifejezést ügynökkészletként, a windows-2022-et pedig ügynökspecifikációként.
A Triggers (Eseményindítók) lehetőségnél engedélyezze a folyamatos integrációt az Enable continuous integration (Folyamatos integráció engedélyezése) bejelölésével. Az Ágszűrőkben az ág specifikációja alapértelmezés szerint főkiszolgáló. Válassza ki a Save and queue (Mentés és üzenetsorba helyezés) elemet a build manuális elindításához.
A buildek leküldés vagy bejelentkezés hatására is aktiválódnak. A build állapotának ellenőrzéséhez váltson a Buildek lapra. Miután meggyőződött arról, hogy a build sikeresen fut, definiáljon egy kiadási folyamatot, amely üzembe helyezi az alkalmazást egy fürtön.
Kiadási folyamat létrehozása
Válassza a Folyamatok lapot, majd a Kiadásokat, majd az + Új folyamatot. A Select a template (Sablon kiválasztása) területen válassza ki az Azure Service Fabric Deployment (Üzembe helyezés az Azure Service Fabric használatával) sablont a listából, majd kattintson az Apply (Alkalmaz) gombra.
Válassza a Feladatok, majd az +Új lehetőséget új fürtkapcsolat hozzáadásához.
Az Új Service Fabric Csatlakozás ion nézetben válassza a Tanúsítványalapú vagy a Microsoft Entra hitelesítő adatok hitelesítését. Adja meg a tcp://mysftestcluster.southcentralus.cloudapp.azure.com:19000 fürtvégpontját" (vagy annak a fürtnek a végpontját, amelyre üzembe helyez).
Tanúsítványalapú hitelesítéshez adja hozzá a fürt létrehozásához használt kiszolgálótanúsítvány kiszolgálói tanúsítványának ujjlenyomatát . Az ügyféltanúsítvány esetében adja meg az ügyféltanúsítvány-fájl base-64 kódolását. A tanúsítvány base-64 kódolású megfelelőjének beszerzésével kapcsolatos információk a mező felugró súgóablakában találhatók. Adja meg a tanúsítványhoz tartozó jelszót is. Ha nem rendelkezik külön ügyféltanúsítvánnyal, a fürt vagy a kiszolgáló tanúsítványát is használhatja.
A Microsoft Entra hitelesítő adataihoz adja hozzá a fürt létrehozásához használt kiszolgálótanúsítvány kiszolgálói tanúsítványának ujjlenyomatát , valamint a fürthöz való csatlakozáshoz használni kívánt hitelesítő adatokat a Felhasználónév és jelszó mezőkben.
Válassza a Mentés lehetőséget.
Ezután adja hozzá a buildösszetevőt a folyamathoz, hogy a kiadási folyamat megtalálhassa a build kimenetét. Válassza a Folyamat és összetevők lehetőséget–>+Hozzáadás. A Source (Build definition) (Forrás (builddefiníció)) területen válassza ki a korábban létrehozott buildfolyamatot. Válassza a Hozzáadás lehetőséget a buildösszetevő mentéséhez.
Engedélyezze a folyamatos üzembe helyezés eseményindítóját, hogy a kiadás automatikusan létrejöjjön a build elkészültekor. Válassza a villám ikont az összetevőben, engedélyezze az eseményindítót, majd a Mentés gombra kattintva mentse a kiadási folyamatot.
Válassza a Kiadás létrehozása –>Létrehozás lehetőséget a kiadás manuális létrehozásához. A kiadási folyamatot a Releases (Kiadások) lapon követheti nyomon.
Ellenőrizze, hogy az üzembe helyezés sikeres volt-e, és hogy az alkalmazás fut-e a fürtben. Nyisson meg egy webböngészőt, majd navigáljon a következő helyre: https://mysftestcluster.southcentralus.cloudapp.azure.com:19080/Explorer/. Jegyezze fel az alkalmazás verzióját. Ebben a példában ez a következő 1.0.0.20170616.3: .
Módosítások véglegesítse és leküldése, kiadás indítása
A folyamatos integrációs folyamat működésének ellenőrzéséhez adjon be néhány kódmódosítást Azure DevOpsba.
A kód írása során a Visual Studio a Git Changes ablak Változások szakaszában nyomon követi a projekt fájlmódosításait.
A Módosítások nézetben adjon hozzá egy üzenetet, amely leírja a frissítést, és véglegesítse a módosításokat.
A Git Changes ablakban válassza a Leküldés gombot (a felfelé mutató nyíl) az Azure Pipelines kódjának frissítéséhez.
A módosítások Azure Pipelinesba való leküldése automatikusan elindít egy buildet. A build állapotának ellenőrzéséhez váltson a Pipelines (Folyamatok) lapra.https://dev.azure.com/organizationname/VotingSample
A build befejezése után a rendszer automatikusan létrehoz egy kiadást, és megkezdi az alkalmazás frissítését a fürtön.
Ellenőrizze, hogy az üzembe helyezés sikeres volt-e, és hogy az alkalmazás fut-e a fürtben. Nyisson meg egy webböngészőt, majd navigáljon a következő helyre: https://mysftestcluster.southcentralus.cloudapp.azure.com:19080/Explorer/. Jegyezze fel az alkalmazás verzióját. Ebben a példában ez a következő 1.0.0.20170815.3: .
Az alkalmazás frissítése
Módosítsa a kódokat az alkalmazásban. Az előző lépések mentén mentse és véglegesítse a módosításokat.
Az alkalmazás frissítésének megkezdése után a frissítési folyamat állapotát a Service Fabric Explorerben lehet megtekinteni:
Az alkalmazás frissítése eltarthat néhány percig. Ha a frissítés befejeződött, az alkalmazás a következő verziót futtatja majd. Ebben a példában 1.0.0.20170815.4.
Következő lépések
Ez az oktatóanyag bemutatta, hogyan végezheti el az alábbi műveleteket:
- Forráskezelés hozzáadása a projekthez
- Buildelési folyamat létrehozása
- Kiadási folyamat létrehozása
- Alkalmazás automatikus üzembe helyezése és frissítése
Folytassa a következő oktatóanyaggal: