A statikus Azure-webalkalmazás megtervezése
Végső célja az alkalmazás Azure-beli üzemeltetése. Az Azure Static Web Apps az összes szükséges Azure-erőforrás kiépítéséről gondoskodik Ön helyett.
Ahhoz azonban, hogy az alkalmazást üzembe lehessen helyezni, szükség van rá, hogy a módosítások elvégzése során valami létrehozza az alkalmazást. Ezeket a módosításokat az adattárba küldött véglegesítésekkel vagy lekéréses kérelmekkel lehet elvégezni. Az Azure Static Web Apps egyik fő funkciója, hogy beállítson egy GitHub Actions-munkafolyamatot az alkalmazás létrehozásához és közzétételéhez.
Az Azure Static Web Apps-erőforrás létrehozásakor az létrehozza a GitHub Actions-munkafolyamatot. A munkafolyamat azonnal aktiválódik, és gondoskodik az alkalmazás létrehozásáról és közzétételéről. A rendszer emellett minden alkalommal aktiválja a munkafolyamatot, amikor módosítja a megfigyelt ágat az adattárban.
Azure Static Web Apps
A webalkalmazások üzembe helyezésének két automatizált aspektusa van. Az első azokat a mögöttes Azure-erőforrásokat építi ki, amelyekből az alkalmazás áll. A második egy GitHub Actions-munkafolyamat, amely létrehozza és közzéteszi az alkalmazást.
Amikor az Azure Static Web Apps használatával teszi közzé az alkalmazást a weben, gyorsan üzemeltetheti a webalkalmazást és skálázható API-kat. Emellett egy egységes létrehozási és üzembe helyezési munkafolyamatot is használhat, amelyet a GitHub Actions biztosít.
A Static Web Apps-példány csatlakoztatása a GitHubhoz
Az Azure Static Web Apps úgy lett kialakítva, hogy alkalmazásokat üzemeltetjen, miközben a forráskód a GitHubon él. Statikus Web Apps-példány létrehozásakor bejelentkezik a GitHubra, és megadja az alkalmazás kódját tartalmazó adattárat.
Az adattárban három mappa elérési útját is meg kell adnia, hogy az alkalmazást automatikusan létre lehessen hozni és üzembe lehessen helyezni:
| Location | Hely – példa | Leírás | Required |
|---|---|---|---|
| Alkalmazás helye | Client | A webalkalmazás forráskódjának helye | Igen |
| Kimeneti hely | wwwroot | Az alkalmazás buildösszetevőinek helye | Nem |
| Az API helye | API | Az API forráskódjának helye | Nem |
A kimeneti hely az alkalmazás közzétételi könyvtárának relatív elérési útja. Tegyük fel például, hogy van egy alkalmazásunk a Client helyen, amely a bin/<build profile>/<framework>/publish/wwwroot mappában helyezi el a kimeneti létrehozási eszközeit. Ebben az esetben csak erre a helyre kell megadnia wwwroot , mivel a közzétételi rendszer gondoskodik az előtag többi részéről.
Statikus eszközök létrehozása a forráskódból a GitHub Actions használatával
A GitHub-adattár forráskódot tartalmaz, nem statikus objektumokat, ezért a közzététel előtt létre kell építeni.
Static Web Apps-példány létrehozásakor az Azure létrehoz egy GitHub Actions-munkafolyamatot az adattárban. A munkafolyamat minden alkalommal, amikor leküldi a módosításokat, vagy lekéréses kérelmet hoz létre a kibocsátott ágon, a munkafolyamat létrehozza az alkalmazást. Ez a folyamat az Azure által kiszolgált statikus eszközökké alakítja a forráskódot. A build befejezése után a művelet üzembe helyezi az objektumokat.
A GitHub Actions-művelet bekerül az adattár .github/workflows mappájába. Igény szerint áttekintheti vagy módosíthatja ezt a fájlt. Az erőforrás létrehozásakor megadott beállításokat a GitHub Actions-művelet fájljában tárolja a rendszer.
Az Azure Functions szolgáltatással integrált API
Ha az alkalmazás api-t igényel, azure Functions-projektként implementálhatja az adattárban, és a Static Web Apps-példány automatikusan telepíti és üzemelteti. Az alkalmazást összeállító és üzembe helyező GitHub Actions-munkafolyamat megkeresi az API-t az adattárban az API-hely elérési útján megadott mappa nevével.
Mi a teendő, ha nem rendelkezik API-val? Nem kell aggódnia. Ha az Azure Static Web Apps nem talál API-t a megadott mappában, nem tesz közzé API-t, de továbbra is közzéteszi az alkalmazást.
Következő lépések
Mire van szüksége ahhoz, hogy közzétehesse a webalkalmazást az Azure Static Web Appsben? Mindössze az alkalmazásra van szükség a GitHub-adattárban.