Az API közzététele GitHub Actions-műveletekkel

Befejeződött

Hozzáadta az API-t a webalkalmazáshoz, és mindkettő helyileg fut. Eljött az ideje, hogy közzétegye az API-t és a webalkalmazást az Azure Static Web Apps-ban.

Amikor létrehozta az Azure Static Web Apps-példányt, és arra utasította, hogy figyelje a main ágat, a rendszer generált Önnek egy GitHub Actions-műveletet. A GitHub-művelet figyeli az adattár fő ágát a véglegesítésekhez és lekéréses kérelmekhez. Ezután amikor a GitHub Actions-művelet észleli ezeket a módosításokat, létrehozza és közzéteszi az alkalmazást.

Az Azure Static Web Apps-erőforrás létrehozásakor az API-projekt mappahelyét az API alapértelmezett értékének elfogadásával adta meg. Az Azure Static Web Apps ebben a mappában építette és telepítette az Azure Functions alkalmazást. Az alkalmazás azonban nem működött, mert a HTTP GET API még nincs létrehozva.

A GitHub Actions-művelet aktiválása

A GitHub Actions-művelet készen áll a webalkalmazás és az API létrehozására és közzétételére, amint a main ág módosítását észleli. Végezhet véglegesítést közvetlenül, vagy létrehozhat egy lekéréses kérelmet a main ágra vonatkozóan. Mindkét módosítás aktiválja a GitHub-műveletet. Ha a fő ágon változások észlelhetők, a GitHub-művelet aktiválódik, hogy az alkalmazást ugyanazon az URL-címen tegye közzé az élő webhelyen.

Előkészületi környezetek előzetes URL-címekkel

Előfordulhat, hogy egy átmeneti helyen szeretné megtekinteni a módosításokat, mielőtt közzéteszi azokat az élő webhelyen. Az Azure Static Web Apps lehetővé teszi a módosítások megtekintését olyan előkészületi környezeteken keresztül, amelyek mindegyike saját előzetes verziójú URL-címekkel rendelkezik. Előkészületi környezetet úgy hozhat létre, hogy lekéréses kérelmet hoz létre azon ágon, amelyet a GitHub-művelet figyel. Az élő webhelyre nincs hatással. Ehelyett az alkalmazás egy új verziója jön létre a saját előkészületi környezetben. Ha visszalép, és ellenőrzi a lekéréses kérelmet a GitHubon, láthatja, hogy az előkészületi verzióra mutató hivatkozás megjelenik a Beszélgetés lapon.

Az alábbi táblázat azt mutatja be, hogy az Azure Static Web Apps hogyan teszi közzé az alkalmazást különböző URL-címeken. Az alkalmazás egy adott URL-címen, míg az ugyanarra az ágra vonatkozó lekéréses kérelmek egy másik URL-címen végeznek közzétételt. Ezeket az automatikus URL-címeket az Azure Static Web Apps biztosítja az éles alkalmazáshoz és a lekéréses kérelmekhez. Igény szerint egyéni tartományt is hozzárendelhet az éles alkalmazáshoz.

Source Leírás URL
main ág Példa egy élő webhely URL-címére https://purple-rain-062d03304.azurestaticapps.net/
5. lekéréses kérelem Példa egy előnézeti URL-címre https://purple-rain-062d03304-5.<location>.azurestaticapps.net/

Jelenleg az api ágat használja. Lekéréses kérelmet küld az API-ágról a ágra. Amikor létrehozza a lekéréses kérelmet a ágon, a GitHub-művelet közzéteszi az alkalmazást egy előkészületi környezetben.

Miután a munkafolyamat befejezte az alkalmazás összeállítását és üzembe helyezését, a GitHub-robot megjegyzést fűz a lekéréses kérelemhez. Ez a megjegyzés az előkészületi környezet URL-címére mutató hivatkozást tartalmaz. Erre a hivatkozásra kattintva megtekintheti a szakaszos módosításokat.

Ezután létrehoz egy lekéréses kérelmet, és felkeresi az alkalmazás szakaszos verzióját.