Ebben a rövid útmutatóban megtudhatja, hogyan építhet ki és helyezhet üzembe alkalmazáserőforrásokat Azure egy Azure fejlesztői parancssori felület (azd) sablonnal és csak néhány azd parancs használatával.
azd sablonok olyan szabványos kódtárak, amelyek tartalmazzák az alkalmazás forráskódját, valamint azd konfigurációs és infrastruktúrafájlokat Azure erőforrások kiépítéséhez. A azd sablonokról, valamint az Azure erőforrások előkészítési és üzembe helyezési folyamatának felgyorsításáról a Mi az Azure fejlesztői CLI-sablonok?.
A sablon kiválasztása és üzembe helyezése
A következő sablonnal építhet ki és telepíthet egy alkalmazást az Azure-ra.
React webalkalmazás Python API-val és MongoDB-vel az Azure-on
Kontainerizált React Web App Java API-val és MongoDB-vel Azure
Az Awesome AZD sablongyűjtemény webhelyéről kiválaszthatja az Ön igényeinek megfelelő sablont is. Függetlenül attól, hogy melyik sablont használja, a fejlesztői környezetben meg fogja kapni a sablonkódot, és képes lesz parancsokat futtatni az alkalmazás létrehozására, újratelepítésére és figyelésére az Azure-ban.
Válassza ki a kívánt környezetet a folytatáshoz:
A helyi fejlesztési környezet kiváló választás a hagyományos fejlesztési munkafolyamatokhoz. Klónozza a sablontárházat a saját eszközére, és parancsokat futtat egy helyi telepített változaton azd.
Előfeltételek
A projekt inicializálása
Fájlkezelő vagy terminálon hozzon létre egy új üres könyvtárat, és váltson rá.
Futtassa a azd init parancsot, és adja meg a paraméterként használni kívánt sablont:
azd init --template todo-nodejs-mongo
azd init --template todo-python-mongo
azd init --template todo-csharp-cosmos-sql
azd init --template todo-java-mongo-aca
Amikor a rendszer kéri, adjon meg egy környezetnevet( például azdquickstart), amely beállítja a Azure erőforrások tárolására létrehozott erőforráscsoport elnevezési előtagját.
Mi az a környezetnév azd?
A környezet megadása után klónozza a sablonprojektet a gépére, azd és inicializálja a projektet.
Az alkalmazáserőforrások kiépítése és üzembe helyezése
Futtassa a azd auth login parancsot, és azd elindít egy böngészőt a bejelentkezési folyamat befejezéséhez.
azd auth login
Futtassa a azd up következő parancsot:
azd up
Miután bejelentkezett Azure, a rendszer a következő információkat fogja kérni:
| Paraméter |
Leírás |
Azure Location |
Az Azure hely, ahol az erőforrások üzembe lesznek helyezve. |
Azure Subscription |
Az Azure előfizetés, amelyben az erőforrások üzembe lesznek helyezve. |
Jelölje ki a kívánt értékeket, és nyomja le az Enter billentyűt. A azd up parancs a következő feladatokat kezeli a sablonkonfiguráció és az infrastruktúrafájlok használatával:
- Létrehozza és konfigurálja az összes szükséges Azure erőforrást (
azd provision), beleértve a következőket:
- Hozzáférési szabályzatok és szerepkörök a fiókhoz
- Szolgáltatásközi kommunikáció felügyelt identitásokkal
- Csomagolja és üzembe helyezi a kódot (
azd deploy)
Ha a azd up parancs sikeresen befejeződött, a parancssori felület két hivatkozást jelenít meg a létrehozott erőforrások megtekintéséhez:
- ToDo API-alkalmazás
- ToDo webalkalmazás előtér
Megjegyzés
Annyiszor hívhatja meg azd up , amennyit csak szeretne, és frissítéseket is üzembe helyezhet az alkalmazáson.
Az üzembe helyezés meghiúsulhat, mert egy erőforrás nem helyezhető üzembe a kijelölt régióban. Mivel ez egy gyors kezdés, nyugodtan törölheti a .azure címtárat, és próbálkozhat újra azd up. Amikor a rendszer kéri, válasszon egy másik régiót. Egy speciálisabb forgatókönyvben szelektíven szerkesztheti a címtárban lévő fájlokat a .azure régió módosításához.
A Azure fejlesztői cli egy Visual Studio Code bővítményt biztosít, amely leegyszerűsíti a azd funkciók használatát. Használhatja például a parancspaletta felületét parancsok futtatásához. Az előttünk álló lépések elvégzéséhez telepítenie kell a Azure Fejlesztői CLI-bővítményt a Visual Studio Code számára.
A Azure Fejlesztői parancssori felület bővítmény telepítése
Nyissa meg a Visual Studio Code.
A Nézet menüben válassza a Bővítmények lehetőséget.
A keresőmezőbe írja be Azure Developer CLI.
Válassza a Telepítés lehetőséget , és várja meg, amíg a telepítési folyamat befejeződik.
Új alkalmazás inicializálása
Nyissa meg egy üres könyvtárat a Visual Studio Code-ban.
A Nézet menüben válassza a Parancspaletta...
Keresse meg a Azure Developer CLI (azd): Initialize app (init) parancsot, és nyomja le az Enter billentyűt. A azd up parancs utasítást ad azd az alkalmazáserőforrások kiépítésére és üzembe helyezésére.
Válassza a Sablon kiválasztása munkafolyamatot .
Keresse meg a React webalkalmazás Node.js API-val és MongoDB-vel az Azure-on sablont, és nyomja meg az Enter billentyűt a kiválasztáshoz.
Visual Studio Code klónozza a azd sablont. A sablon tartalmazza az infrastruktúrát kódfájlokként a infra mappában, és egy mintaalkalmazást a src mappában. Az infrastruktúraként kódolt fájlok kiépítik az alkalmazás üzembe helyezésekor szükséges erőforrásokat az Azure-on.
Keresse meg a React webalkalmazást Python API-val és MongoDB-vel az Azure felületen sablont, és nyomja meg az Enter billentyűt a kiválasztáshoz.
Visual Studio Code klónozza a azd sablont. A sablon tartalmazza az infrastruktúrát kódfájlokként a infra mappában, és egy mintaalkalmazást a src mappában. A kódként megadott infrastruktúra fájlok biztosítják az alkalmazás által üzembe helyezéskor igényelt szükséges erőforrásokat az Azure-on.
Keresse meg a React webalkalmazást C# API-val és MongoDB-vel az Azure-on sablont, és nyomja meg az Enter billentyűt a kiválasztáshoz.
Visual Studio Code lemásolja a azd sablont. A sablon tartalmazza az infrastruktúrát kódfájlokként a infra mappában, és egy mintaalkalmazást a src mappában. A kódfájlokként kezelt infrastruktúra biztosítja az alkalmazás által az üzembe helyezéskor igényelt szükséges erőforrásokat az Azure platformon.
Keresse meg a Kontainerizált React webalkalmazást Java API-val és MongoDB-vel a Azure sablonon, és nyomja le az Enter billentyűt az it.awesome-azd kiválasztásához.
A Visual Studio Code letölti és klónozza a azd sablont. A sablon tartalmazza az infrastruktúrát kódfájlokként a infra mappában, és egy mintaalkalmazást a src mappában. Az infrastruktúra mint kód fájlok kiépítik az alkalmazás üzembe helyezésekor szükséges erőforrásokat az Azure-on.
A sablon klónozása után Visual Studio Code megnyit egy terminált, amely a környezet nevének megadását kéri. Adjon meg egy rövid nevet, például azdvscode-ot , és nyomja le az Enter billentyűt.
Enter a new environment name: [? for help] azdvscode
A környezet neve befolyásolja a Azure kiépített erőforrások elnevezését, és létrehoz egy mappát a .azure sablonkönyvtárban bizonyos környezeti beállítások tárolásához.
Az alkalmazáserőforrások kiépítése és üzembe helyezése
Nyissa meg a parancskatalógust, és keresse meg a Azure Developer CLI (azd): Package, Provision and Deploy(up) parancsot, és nyomja le az Enter billentyűt. A azd up parancs utasítást ad azd az alkalmazáserőforrások kiépítésére és üzembe helyezésére.
Visual Studio Code megnyit egy terminálablakot a kiépítési és üzembehelyezési folyamat előrehaladásának megjelenítéséhez.
azd az erőforrások üzembe helyezésekor a init folyamat során kiválasztott előfizetési és helybeállításokat használja.
Megjegyzés
A kiépítési és üzembe helyezési folyamat több percet is igénybe vehet.
Amikor az üzembe helyezési folyamat befejeződött, válassza a hivatkozást a kimeneti ablakban, amelyet azd a webhely böngészőben való elindításához adott meg.
A kódterek nagyszerű lehetőséget jelentenek a fejlesztők számára, akik inkább tárolóalapú felhőkörnyezetekben dolgoznak, és nem telepítik helyileg az eszközöket vagy függőségeket.
A kódtér beállítása
- A fájllista felett kattintson a Használja ezt a sablont>Megnyitás kódtérben.
A Codespaces használatával minden előfeltétel telepítve van, beleértve a azd Visual Studio Code bővítményt.
Képernyőkép arról, hogy az új Codespace hogyan fog kinézni az elindítás után.
A sablon futtatása
A Codespace létrehozása után kattintson a jobb gombbal az azure.yaml fájlra a gyökérkönyvtárban. A beállítások között válassza a up (erőforrások kiépítése és kód üzembe helyezése Azure) lehetőséget.
A parancs futtatásakor a azd up rendszer kérni fogja, hogy adja meg a következő adatokat, és jelentkezzen be egy webböngésző és egy hitelesítési kód használatával:
| Paraméter |
Leírás |
Environment Name |
Az összes Azure erőforrás tárolására létrehozott erőforráscsoport előtagja. Mi az a környezetnév azd? Bármikor létrehozhat új környezetet a következővel azd env new: . |
Azure Location |
Az Azure hely, ahol az erőforrások üzembe lesznek helyezve. |
Azure Subscription |
Az Azure előfizetés, amelyben az erőforrások üzembe lesznek helyezve. |
Ez a folyamat eltarthat egy ideig, mivel a parancs a azd up következő feladatokat kezeli:
- Létrehozza és konfigurálja az összes szükséges Azure erőforrást (
azd provision).
- Hozzáférési szabályzatokat és szerepköröket konfigurál a fiókjához.
- Szolgáltatásközi kommunikációt valósít meg a felügyelt identitásokkal.
- A kódot csomagolja és üzembe helyezi (
azd deploy).
Miután megadta a szükséges paramétereket, és a azd up parancs befejeződik, a CodeSpaces terminál két Azure portálhivatkozást jelenít meg a létrehozott erőforrások megtekintéséhez:
- ToDo API-alkalmazás
- ToDo webalkalmazás felület
Mi történt?
A parancs sikeres végrehajtása azd up után:
- A
azd up futtatása után az ön által megadott Azure-előfizetésre lettek kiépítve a sablon README.md fájljában hivatkozott Azure-erőforrások. Ezeket a Azure erőforrásokat most már megtekintheti a Azure portálon.
- Az alkalmazás Azure lett létrehozva és üzembe helyezve. A parancs webalkalmazás URL-kimenetének
azd up használatával megkeresheti a teljesen működőképes alkalmazást.
Megjegyzés
- Alkalmazásának energiaellátását és üzembe helyezését is annyiszor kérheti
azd up meg, amennyit csak szeretne.
- A webböngésző indítását igénylő futtatás és hibakeresés jelenleg nem támogatott, mert ismert korlátozás van a GitHub Codespaces-ben. A jobb élmény érdekében javasoljuk a Codespaces használatát a Desktopban.
A DevContainer egy Docker-rendszerkép, amely tartalmazza a sablon helyi azd gépen való használatához szükséges összes előfeltételt. Nagyszerű választás azoknak a fejlesztőknek, akik a tárolóalapú környezeteket részesítik előnyben, amelyek továbbra is helyi eszközön futnak, és nem felhőszolgáltatást, például GitHub Codespace-eket.
Előfeltételek
A projekt inicializálása
Nyisson meg egy terminált, hozzon létre egy új üres könyvtárat, és váltson rá.
Futtassa a következő parancsot a projekt inicializálásához:
azd init --template todo-nodejs-mongo
azd init --template todo-python-mongo
azd init --template todo-csharp-cosmos-sql
azd init --template todo-java-mongo-aca
A parancs futtatásakor a azd init rendszer a következő információk megadását kéri:
| Paraméter |
Leírás |
Environment Name |
Az összes Azure erőforrás tárolására létrehozott erőforráscsoport előtagja. Mi az a környezet neve azd? Bármikor létrehozhat új környezetet a következővel azd env new: . |
A DevContainer megnyitása
- Nyissa meg a projektet a VS Code-ban.
- Nyomja le az F1 billentyűt, és válassza a következőt:
Remote-Containers: Rebuild and Reopen in Container
Parancs futtatása up
Futtassa az alábbi parancsot:
azd up
A parancs futtatásakor a azd up rendszer a következő információk megadását kéri:
| Paraméter |
Leírás |
Azure Location |
Az Azure hely, ahol az erőforrások üzembe lesznek helyezve. |
Azure Subscription |
Az Azure előfizetés, amelyben az erőforrások üzembe lesznek helyezve. |
A azd up parancs futtatása eltarthat egy ideig, amíg végrehajtja a következő lépéseket:
- Létrehozza és konfigurálja az összes szükséges Azure erőforrást (
azd provision), beleértve a következőket:
- Hozzáférési szabályzatok és szerepkörök a fiókhoz
- Szolgáltatásközi kommunikáció felügyelt identitásokkal
- Csomagolja és üzembe helyezi a kódot (
azd deploy)
Miután megadta a szükséges paramétereket, és a azd up parancs befejeződik, a parancssori felület két Azure portálhivatkozást jelenít meg a létrehozott erőforrások megtekintéséhez:
- ToDo API-alkalmazás
- ToDo webalkalmazás előtér
Megjegyzés
Annyiszor futtatható azd up , amennyit csak szeretne, és az alkalmazást ugyanabban a régióban és az első futtatáskor megadott konfigurációs értékekkel is üzembe helyezheti.
Erőforrások megtisztítása
Ha már nincs szüksége a cikkben létrehozott erőforrásokra, futtassa az alábbi parancsot az alkalmazás leállításához:
azd down
Ha egy másik régióba szeretne újra telepíteni, törölje a .azure könyvtárat, mielőtt újra futtatná a azd up parancsot. Egy speciálisabb forgatókönyvben szelektíven szerkesztheti a címtárban lévő fájlokat a .azure régió módosításához.
Segítség kérése
Ha további információt szeretne megtudni arról, hogyan nyújthat be hibát, kérhet segítséget vagy javasolhat új funkciót a Azure fejlesztői parancssori felületéhez, látogasson el a troubleshooting és támogatás oldalra.
Következő lépések