使用 GitHub Actions 發佈 API

已完成

您已將 API 新增到 Web 應用程式,且他們都在本機執行。 現在可以將您的 API 和應用程式發佈到 Azure 靜態 Web 應用程式。

如果您建立了 Azure Static Web Apps 執行個體,並要求它監看您的主分支,系統就會為您產生 GitHub Action。 GitHub Action 會接聽您存放庫的主分支,以認可並提取要求。 然後,當 GitHub Action 偵測到這些變更,就會建立並發佈您的應用程式。

當您建立 Azure Static Web Apps 資源時,您已透過接受 Api 的預設值來提供 API 專案的資料夾位置。 Azure Static Web Apps 在該資料夾中建立並部署了 Azure Functions 應用程式。 不過,因為尚未建立 HTTP GET API,所以應用程式無法運作。

觸發 GitHub Action

只要 GitHub Action 偵測到主分支中發生變更,就會隨時建立並發佈您的 Web 應用程式和 API。 您可以直接認可,或是對主分支建立提取要求。 這兩個變更都會觸發 GitHub Action。 在主分支上偵測到的變更時,會觸發 GitHub Action 在與您的即時網站相同的 URL 上發佈應用程式

具有預覽 URL 的生產前環境

有時,您想要先在預備網站中查看變更,然後再發佈到即時網站。 Azure Static Web Apps 可讓您透過生產前環境查看變更,這些環境都有自己的預覽 URL。 您可以針對 GitHub Action 所監看的分支建立提取要求,以便建立生產前環境。 您的即時網站不會受到影響。 相反地,您的應用程式新版本會建立在自己的生產前環境中。 如果您返回 GitHub 檢查提取要求,會發現生產前版本的連結張貼在 [交談] 索引標籤中。

下表顯示 Azure Static Web Apps 如何將您的應用程式發佈到不同的 URL。 您的應用程式會發佈到某個 URL,而對相同分支的提取要求則會發佈到另一個 URL。 這些自動產生的 URL 是由 Azure Static Web Apps 針對生產應用程式和提取要求提供。 您可以選擇性地將自訂網域指派給生產應用程式。

來源 描述 URL
分支 即時網站 URL 範例 https://purple-rain-062d03304.azurestaticapps.net/
提取要求 #5 預覽 URL 範例 https://purple-rain-062d03304-5.<location>.azurestaticapps.net/

您目前正在 api 分支中運作。 您將會從 API 分支中向主分支的發出提取要求。 如果您對主分支建立提取要求,GitHub Action 會將應用程式發佈到生產前環境。

工作流程完成組建和部署應用程式之後,GitHub Bot 會將註解新增至您的提取要求。 此註解包含生產前環境 URL 的連結。 您可以選取此連結以查看您的暫存變更。

接下來,您會建立提取要求,並造訪應用程式的暫存版本。