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.
Megjegyzés:
Válasszon egy projektnevet. Ha végighalad az oktatóanyagon, cserélje le az ARMPipelineProj bármelyikét a projekt nevére. Ez a projektnév az erőforrásnevek létrehozására szolgál. Az erőforrások egyike egy tárfiók. A tárfiók nevének 3 és 24 karakter közötti hosszúságúnak kell lennie, és csak számokat és kisbetűket tartalmazhat. A névnek egyedinek kell lennie. A sablonban a tárfiók neve a projekt neve, amelyhez hozzá van fűzve az áruház , a projekt nevének pedig 3 és 11 karakter közöttinek kell lennie. A projektnévnek tehát meg kell felelnie a tárfiók követelményeinek, és 11 karakternél kevesebb karakterből áll.
Ez az oktatóanyag a következő feladatokat mutatja be:
- GitHub-adattár előkészítése
- Azure DevOps-projekt létrehozása
- Azure-folyamat létrehozása
- A folyamat üzembe helyezésének ellenőrzése
- A sablon frissítése és ismételt üzembe helyezés
- Clean up resources
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.
Válassza ki a fiók képét a jobb felső sarokban, majd válassza az Adattárak lehetőséget.
Válassza az Új gombot, egy zöld gombot.
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.
Í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
Nyissa meg a Git Shellt vagy a Git Basht. See Prerequisites.
Ellenőrizze, hogy az aktuális mappa a GitHub-e.
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.
Ha nincs megnyitva, nyissa meg a Git Shellt vagy a Git Basht.
Módosítsa a könyvtárat a helyi adattár create_web_app mappájába.
Ellenőrizze, hogy az azuredeploy.json fájl szerepel-e a mappában.
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.
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.Válassza az azuredeploy.json lehetőséget a sablon megnyitásához.
Válassza a Nyers gombot. Az URL-cím a következővel
https://raw.githubusercontent.com
kezdődik: .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.
Jelentkezzen be az Azure DevOpsba.
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.
Í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.
Select Create.
Hozzon létre egy szolgáltatáskapcsolatot, amellyel projekteket helyezhet üzembe az Azure-ban.
Válassza a Projektbeállítások lehetőséget a bal oldali menü alján.
Válassza ki a Szolgáltatáskapcsolatok lehetőséget a Folyamatok területen.
Válassza a Szolgáltatáskapcsolat létrehozása, az Azure Resource Manager, majd a Tovább gombot.
Válassza a Szolgáltatásnév (automatikus) lehetőséget, majd a Tovább gombot.
Í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)
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:
Válassza a Folyamatok lehetőséget a bal oldali menüből.
Válassza a Folyamat létrehozása lehetőséget.
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.
A Kiválasztás lapon válassza ki az adattárat. Az alapértelmezett név a következő
[YourAccountName]/[YourGitHubRepositoryName]
: .A Konfigurálás lapon válassza a Starter-folyamatot. Az azure-pipelines.yml folyamatfájlt két szkriptlépéssel jeleníti meg.
Törölje a két szkriptlépést az .yml fájlból.
Vigye a kurzort a sorba a lépések után:
Válassza a Képernyő jobb oldalán található Segéd megjelenítése lehetőséget a Feladatok panel megnyitásához.
Válassza ki az ARM-sablon üzembe helyezését.
Í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.com
kezdő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.
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:
Válassza a Mentés és futtatás lehetőséget.
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.
Ellenőrizze, hogy a folyamat sikeresen végrehajtva van-e.
Az üzemelő példány ellenőrzése
- Jelentkezzen be az Azure Portalra.
- 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.
- Válassza ki a tárfiók nevét a megnyitásához.
- 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.
Nyissa meg a linkedStorageAccount.json fájlt a helyi adattárból a Visual Studio Code-ban vagy bármely szövegszerkesztőben.
Frissítse a storageAccountType defaultValue értékét a Standard_GRS értékre. Tekintse meg a következő képernyőképet:
Save the changes.
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. Apull
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.
- Az Azure Portalon válassza az Erőforráscsoport lehetőséget a bal oldali menüben.
- A Szűrés név alapján mezőben adja meg az erőforráscsoport nevét.
- Válassza ki az erőforráscsoport nevét.
- 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.