Oktatóanyag: ARM-sablonok folyamatos integrálása az Azure Pipelines szolgáltatással

Az előző oktatóanyagban egy csatolt sablont telepít. Ebben az oktatóanyagban megtudhatja, hogyan használhatja az Azure Pipelinest az Azure Resource Manager-sablon (ARM-sablon) projektjeinek folyamatos létrehozására és üzembe helyezésére.

Az Azure DevOps fejlesztői szolgáltatásokat nyújt a csapatok számára a munka megtervezéséhez, a kódfejlesztésben való együttműködéshez, valamint alkalmazások létrehozásához és üzembe helyezéséhez. A fejlesztők az Azure DevOps Services használatával dolgozhatnak a felhőben. Az Azure DevOps olyan integrált funkciókkal rendelkezik, amelyeket a webböngészőn vagy IDE-ügyfélen keresztül érhet el. Az Azure Pipelines ezen funkciók egyike. Az Azure Pipelines egy teljes körű folyamatos integrációs (CI) és folyamatos kézbesítési (CD) szolgáltatás. Az előnyben részesített Git-szolgáltatóval működik, és a legtöbb nagyobb felhőszolgáltatásban üzembe helyezhető. Ezután automatizálhatja a kód összeállítását, tesztelését és üzembe helyezését a Microsoft Azure-ban, a Google Cloud Platformban vagy az Amazon Web Servicesben.

Ez az oktatóanyag a következő feladatokat mutatja be:

Ha még nincs Azure-előfizetése, kezdés előtt hozzon létre egy ingyenes fiókot.

Előfeltételek

Az oktatóanyag elvégzéséhez az alábbiakra van szükség:

• Egy GitHub-fiók, amellyel tárházat hozhat létre a sablonjaihoz. Ha még nem rendelkezik fiókkal, ingyen létrehozhat egyet. További információ a GitHub-adattárak használatáról: GitHub-adattárak létrehozása.
• Telepítse a Git szoftvert. Ez az oktatóanyag a Git Basht vagy a Git Shellt használja. Útmutatást a Git telepítése című témakörben talál.
• Egy Azure DevOps-szervezet. Ha még nem rendelkezik fiókkal, ingyen létrehozhat egyet. Lásd: Szervezet vagy projektgyűjtemény létrehozása.
• (nem kötelező) Visual Studio Code Resource Manager Tools kiterjesztéssel. Lásd a rövid útmutatót: ARM-sablonok létrehozása a Visual Studio Code-tal.

GitHub-adattár előkészítése

A GitHub segítségével tárolhatja a projekt forráskódját, beleértve a Resource Manager-sablonokat is. Egyéb támogatott adattárakért lásd az Azure DevOps által támogatott adattárakat.

GitHub-adattár létrehozása

Ha nem rendelkezik GitHub-fiókkal, tekintse meg az előfeltételeket.

1. Jelentkezzen be a GitHubra.

2. Válassza ki a fiók képét a jobb felső sarokban, majd válassza az Adattárak lehetőséget.

   

3. Válassza az Új gombot, egy zöld gombot.

4. Az Adattár nevére írja be az adattár nevét. Például: ARMPipeline-repo. Ne felejtse el lecserélni bármelyik ARMPipeline-t a projekt nevére. Az oktatóanyag elvégzéséhez választhatja a nyilvános vagy a privát lehetőséget. Ezután válassza az Adattár létrehozása lehetőséget.

5. Írja le az URL-címet. Az adattár URL-címe a következő formátum – https://github.com/[YourAccountName]/[YourRepositoryName].

Ezt az adattárat távoli adattárnak nevezzük. Ugyanazon projekt minden fejlesztője klónozhatja a saját helyi adattárát, és egyesítheti a távoli adattár módosításait.

A távoli adattár klónozása

1. Nyissa meg a Git Shellt vagy a Git Basht. See Prerequisites.

2. Ellenőrizze, hogy az aktuális mappa a GitHub-e.

3. Futtassa az alábbi parancsot:

   git clone https://github.com/[YourAccountName]/[YourGitHubRepositoryName]
   cd [YourGitHubRepositoryName]
   mkdir create_web_app
   cd create_web_app
   pwd
   

   Cserélje le [YourAccountName] a GitHub-fiók nevére, és cserélje le [YourGitHubRepositoryName] az előző eljárásban létrehozott adattár nevére.

A create_web_app mappa a sablon tárolására szolgáló mappa. A pwd parancs megjeleníti a mappa elérési útját. Az elérési úton mentheti a sablont az alábbi eljárásban.

Rövid útmutatósablon letöltése

A sablonok létrehozása helyett letöltheti a sablonokat, és mentheti őket a create_web_app mappába.

• A fő sablon: https://raw.githubusercontent.com/Azure/azure-docs-json-samples/master/get-started-deployment/linked-template/azuredeploy.json
• A csatolt sablon: https://raw.githubusercontent.com/Azure/azure-docs-json-samples/master/get-started-deployment/linked-template/linkedStorageAccount.json

A rendszer mind a mappanevet, mind a fájlneveket a folyamat során használja. Ha módosítja ezeket a neveket, frissítenie kell a folyamatban használt neveket.

A sablon leküldése a távoli adattárba

Az azuredeploy.json hozzá lett adva a helyi adattárhoz. Ezután feltölti a sablont a távoli adattárba.

1. Ha nincs megnyitva, nyissa meg a Git Shellt vagy a Git Basht.

2. Módosítsa a könyvtárat a helyi adattár create_web_app mappájába.

3. Ellenőrizze, hogy az azuredeploy.json fájl szerepel-e a mappában.

4. Futtassa az alábbi parancsot:

   git add .
   git commit -m "Add web app templates."
   git push origin main
   

   Előfordulhat, hogy figyelmeztetést kap az LF-ről. Figyelmen kívül hagyhatja a figyelmeztetést. a főág . Általában minden frissítéshez létrehoz egy ágat. Az oktatóanyag egyszerűsítése érdekében közvetlenül a fő ágat kell használnia.

5. Tallózással keresse meg a GitHub-adattárat egy böngészőből. Az URL-cím a következő https://github.com/[YourAccountName]/[YourGitHubRepository]: . Látnia kell a create_web_app mappát és a mappában lévő két fájlt.

6. Válassza az azuredeploy.json lehetőséget a sablon megnyitásához.

7. Válassza a Nyers gombot. Az URL-cím a következővel https://raw.githubusercontent.comkezdődik: .

8. Másolja az URL-címet. Ezt az értéket akkor kell megadnia, ha az oktatóanyag későbbi részében konfigurálja a folyamatot.

Eddig létrehozott egy GitHub-adattárat, és feltöltötte a sablonokat az adattárba.

DevOps-projekt létrehozása

Egy DevOps-szervezetre van szükség, mielőtt továbbléphet a következő eljárásra. Ha nincs ilyenje, tekintse meg az Előfeltételek című témakört.

1. Jelentkezzen be az Azure DevOpsba.

2. Válasszon ki egy DevOps-szervezetet balról, majd válassza az Új projektet. Ha nincs projektje, a projekt létrehozása lap automatikusan megnyílik.

3. Írja be a következő értékeket:

   

   • Projekt neve: Adjon meg egy projektnevet. Az oktatóanyag elején kiválasztott projektnevet használhatja.
   • Láthatóság: Válassza a Privát lehetőséget.

   Használja a többi tulajdonság alapértelmezett értékét.

4. Select Create.

Hozzon létre egy szolgáltatáskapcsolatot, amellyel projekteket helyezhet üzembe az Azure-ban.

1. Válassza a Projektbeállítások lehetőséget a bal oldali menü alján.

2. Válassza ki a Szolgáltatáskapcsolatok lehetőséget a Folyamatok területen.

3. Válassza a Szolgáltatáskapcsolat létrehozása, az Azure Resource Manager, majd a Tovább gombot.

4. Válassza a Szolgáltatásnév (automatikus) lehetőséget, majd a Tovább gombot.

5. Írja be a következő értékeket:

   • Hatókör szintje: válassza az Előfizetés lehetőséget.
   • Előfizetés: Válassza ki előfizetését.
   • Erőforráscsoport: Hagyja üresen.
   • Csatlakozás ion neve: adjon meg egy kapcsolatnevet. Például: ARMPipeline-conn. Írja le ezt a nevet, a folyamat létrehozásakor szüksége lesz a névre.
   • Hozzáférési engedély megadása az összes folyamathoz. (kiválasztva)

6. Válassza a Mentés parancsot.

Folyamat létrehozása

Eddig a következő feladatokat végezte el. Ha kihagyja az előző szakaszokat, mert ismeri a GitHubot és a DevOpsot, a folytatás előtt el kell végeznie a feladatokat.

• Hozzon létre egy GitHub-adattárat, és mentse a sablonokat az adattár create_web_app mappájába.
• Hozzon létre egy DevOps-projektet, és hozzon létre egy Azure Resource Manager-szolgáltatáskapcsolatot.

Folyamat létrehozása sablon üzembe helyezésének lépésével:

1. Válassza a Folyamatok lehetőséget a bal oldali menüből.

2. Válassza a Folyamat létrehozása lehetőséget.

3. Válassza a GitHub lehetőséget a Connect (Csatlakozás) lapon. Ha a rendszer kéri, adja meg a GitHub hitelesítő adatait, majd kövesse az utasításokat. Ha a következő képernyő jelenik meg, válassza a Csak az adattárak kiválasztása lehetőséget, és ellenőrizze, hogy az adattár szerepel-e a listában, mielőtt a Jóváhagyás > Telepítés lehetőséget választja.

   

4. A Kiválasztás lapon válassza ki az adattárat. Az alapértelmezett név a következő [YourAccountName]/[YourGitHubRepositoryName]: .

5. A Konfigurálás lapon válassza a Starter-folyamatot. Az azure-pipelines.yml folyamatfájlt két szkriptlépéssel jeleníti meg.

6. Törölje a két szkriptlépést az .yml fájlból.

7. Vigye a kurzort a sorba a lépések után:

8. Válassza a Képernyő jobb oldalán található Segéd megjelenítése lehetőséget a Feladatok panel megnyitásához.

9. Válassza ki az ARM-sablon üzembe helyezését.

10. Írja be a következő értékeket:

    • deploymentScope: Válassza ki az erőforráscsoportot. A hatókörökről további információt az üzembehelyezési hatókörök című témakörben talál.
    • Azure Resource Manager-kapcsolat: Válassza ki a korábban létrehozott szolgáltatáskapcsolat nevét.
    • Előfizetés: Adja meg a célelőfizetés azonosítóját.
    • Művelet: Válassza ki az erőforráscsoport létrehozása vagy frissítése 2 műveletet hajt végre – 1. új erőforráscsoport-név megadása esetén hozzon létre egy erőforráscsoportot; 2. helyezze üzembe a megadott sablont.
    • Erőforráscsoport: Adjon meg egy új erőforráscsoportnevet. Például: ARMPipeline-rg.
    • Hely: Válasszon egy helyet az erőforráscsoporthoz, például az USA középső régiójához.
    • Sablon helye: Válassza ki a fájl URL-címét, ami azt jelenti, hogy a feladat az URL-cím használatával keresi a sablonfájlt. Mivel a relativePath a fő sablonban van használatban, és a relativePath csak URI-alapú üzemelő példányokon támogatott, itt url-címet kell használnia.
    • Sablonhivatkozás: Adja meg a GitHub-adattár előkészítése szakasz végén kapott URL-címet. A következővel https://raw.githubusercontent.comkezdődik: .
    • Sablonparaméterek hivatkozása: Hagyja üresen ezt a mezőt. A paraméterértékeket a felülbírálási sablon paraméterei között adja meg.
    • Sablonparaméterek felülbírálása: Enter -projectName [EnterAProjectName].
    • Üzembe helyezési mód: Válassza a Növekményes lehetőséget.
    • Üzembe helyezés neve: Adja meg a DeployPipelineTemplate nevet. Válassza a Speciális lehetőséget, mielőtt megjelenik az üzembe helyezés neve.

    

11. Válassza a Hozzáadás lehetőséget.

    A feladatról további információt az Azure Resource Group üzembe helyezési feladatában és az Azure Resource Manager-sablon üzembe helyezési feladatában talál.

    Az .yml fájlnak a következőhöz hasonlónak kell lennie:

    

12. Válassza a Mentés és futtatás lehetőséget.

13. A Mentés és futtatás panelen válassza a Mentés és futtatás lehetőséget. A YAML-fájl egy példánya a csatlakoztatott adattárba lesz mentve. A YAML-fájlt az adattár tallózásával tekintheti meg.

14. Ellenőrizze, hogy a folyamat sikeresen végrehajtva van-e.

    

Az üzemelő példány ellenőrzése

1. Jelentkezzen be az Azure Portalra.
2. Nyissa meg az erőforráscsoportot. A név a folyamat YAML-fájljában megadott név. Egy tárfiókot kell létrehoznia. A tárfiók neve a tárolóval kezdődik.
3. Válassza ki a tárfiók nevét a megnyitásához.
4. Válassza ki a tulajdonságokat. Figyelje meg, hogy a replikáció helyileg redundáns tárolás (LRS).

Frissítés és ismételt üzembe helyezés

Amikor frissíti a sablont, és leküldi a módosításokat a távoli adattárba, a folyamat automatikusan frissíti az erőforrásokat, ebben az esetben a tárfiókot.

1. Nyissa meg a linkedStorageAccount.json fájlt a helyi adattárból a Visual Studio Code-ban vagy bármely szövegszerkesztőben.

2. Frissítse a storageAccountType defaultValue értékéta Standard_GRS értékre. Tekintse meg a következő képernyőképet:

   

3. Save the changes.

4. A git Bash/Shell következő parancsainak futtatásával küldje el a módosításokat a távoli adattárba.

   git pull origin main
   git add .
   git commit -m "Update the storage account type."
   git push origin main
   

   Az első parancs (pull) szinkronizálja a helyi adattárat a távoli adattárral. A folyamat YAML-fájlja csak a távoli adattárhoz lett hozzáadva. A pull parancs futtatása letölti a YAML-fájl egy példányát a helyi ágba.

   A negyedik parancs (push) feltölti a módosított linkedStorageAccount.json fájlt a távoli adattárba. A távoli adattár fő ágának frissítésével a rendszer újra aktiválja a folyamatot.

A módosítások ellenőrzéséhez ellenőrizze a tárfiók Replikáció tulajdonságát. Lásd : Az üzembe helyezés ellenőrzése.

Clean up resources

Ha már nincs szükség az Azure-erőforrásokra, törölje az üzembe helyezett erőforrásokat az erőforráscsoport törlésével.

1. Az Azure Portalon válassza az Erőforráscsoport lehetőséget a bal oldali menüben.
2. A Szűrés név alapján mezőben adja meg az erőforráscsoport nevét.
3. Válassza ki az erőforráscsoport nevét.
4. A felső menüben válassza az Erőforráscsoport törlése lehetőséget.

Érdemes lehet törölni a GitHub-adattárat és az Azure DevOps-projektet is.

További lépések

Gratulálunk, befejezte ezt a Resource Manager-sablon üzembe helyezési oktatóanyagát. Tudassa velünk, ha bármilyen megjegyzése és javaslata van a visszajelzési szakaszban. Thanks! Készen áll arra, hogy megismerkedjen a sablonokkal kapcsolatos speciálisabb fogalmakkal. A következő oktatóanyag részletesebben ismerteti, hogy a sablonreferenciák dokumentációjával segít-e az üzembe helyezendő erőforrások meghatározásában.