☁️ GitHub Actions 自動部署 Docker 映像到 Azure Web App、ECS、GKE 的實戰指南

-

 

📖 文章摘要（Meta Description）

學會如何將 GitHub Actions 建構好的 Docker 映像，自動部署到 Azure Web App、AWS ECS、Google Kubernetes Engine（GKE）。從權限設定到 YAML Workflow 實作，帶你一次搞懂雲端部署流程！

🚀 為什麼用 GitHub Actions 搭配雲平台部署？

CI/CD 不應只停留在「建構映像」，還應該延伸到「部署到生產環境」。透過 GitHub Actions，我們可以：

  • ✅ 持續部署（Continuous Deployment）

  • ✅ 自動推送映像到雲平台

  • ✅ 減少人為操作錯誤

  • ✅ 加速交付週期

🗺 本文目錄

  1. 部署到 Azure Web App

  2. 部署到 AWS ECS Fargate

  3. 部署到 GCP GKE

  4. 結語與延伸閱讀

<a name="azure"></a>

☁️ 1. 部署到 Azure Web App for Containers

✅ 先決條件：

  • 已建立 Azure Web App（Linux 容器類型）

  • 建構完成並推送到 Docker Hub 或 Azure Container Registry (ACR)

🔐 建立 GitHub Secrets：

Key說明
AZURE_WEBAPP_NAMEWeb App 名稱
AZURE_PUBLISH_PROFILE從 Azure Portal 匯出來的發佈設定（Base64）

➡️ Azure Portal → Web App → 部署中心 → 下載發佈設定檔

✍️ Workflow 範例：

  1. name: Deploy to Azure Web App
  3. on:
  4. push:
  5. branches: [main]
  7. jobs:
  8. build-and-deploy:
  9. runs-on: ubuntu-latest
  10. steps:
  11. - uses: actions/checkout@v4
  13. - name: Deploy to Azure Web App
  14. uses: azure/webapps-deploy@v3
  15. with:
  16. app-name: ${{ secrets.AZURE_WEBAPP_NAME }}
  17. publish-profile: ${{ secrets.AZURE_PUBLISH_PROFILE }}
  18. images: yourdockerhubusername/yourapp:latest


<a name="ecs"></a>

🐳 2. 部署到 AWS ECS Fargate

✅ 先決條件：

  • 已建立 ECS Cluster、Task Definition 與 Service

  • 使用 Docker Hub 或 Amazon ECR 儲存映像

🔐 建立 Secrets：

Key說明
AWS_ACCESS_KEY_IDIAM 使用者金鑰
AWS_SECRET_ACCESS_KEYIAM 使用者密鑰
ECS_CLUSTERECS 群組名稱
ECS_SERVICEECS 服務名稱
ECS_TASK_DEFINITIONJSON 定義或已註冊的名稱

✍️ Workflow 範例：

  1. name: Deploy to AWS ECS
  3. on:
  4. push:
  5. branches: [main]
  7. jobs:
  8. deploy:
  9. runs-on: ubuntu-latest
  11. steps:
  12. - uses: actions/checkout@v4
  14. - name: Configure AWS Credentials
  15. uses: aws-actions/configure-aws-credentials@v4
  16. with:
  17. aws-access-key-id: ${{ secrets.AWS_ACCESS_KEY_ID }}
  18. aws-secret-access-key: ${{ secrets.AWS_SECRET_ACCESS_KEY }}
  19. aws-region: ap-northeast-1
  21. - name: Deploy to ECS
  22. uses: aws-actions/amazon-ecs-deploy-task-definition@v1
  23. with:
  24. service: ${{ secrets.ECS_SERVICE }}
  25. cluster: ${{ secrets.ECS_CLUSTER }}
  26. task-definition: ${{ secrets.ECS_TASK_DEFINITION }}


✅ 若有多容器或動態更新映像 URI，可以先 sed 替換 task definition JSON，再註冊新版本。

<a name="gke"></a>

☸️ 3. 部署到 Google Kubernetes Engine（GKE）

✅ 先決條件：

  • 已建立 GKE Cluster 並開啟 Kubernetes API

  • 已將映像推送到 Google Container Registry (GCR) 或 Artifact Registry

  • 已建立 Service Account 並下載 JSON 金鑰檔

🔐 建立 Secrets：

Key說明
GCP_SA_KEYGCP Service Account JSON 金鑰（base64）
GKE_PROJECTGCP 專案名稱
GKE_CLUSTERGKE 群組名稱
GKE_ZONEGKE 區域（如 asia-east1-b）

✍️ Workflow 範例：

  1. name: Deploy to GKE
  3. on:
  4. push:
  5. branches: [main]
  7. jobs:
  8. deploy:
  9. runs-on: ubuntu-latest
  11. steps:
  12. - uses: actions/checkout@v4
  14. - name: Set up GCP credentials
  15. uses: google-github-actions/auth@v1
  16. with:
  17. credentials_json: ${{ secrets.GCP_SA_KEY }}
  19. - name: Set up kubectl
  20. uses: google-github-actions/setup-gcloud@v1
  21. with:
  22. project_id: ${{ secrets.GKE_PROJECT }}
  24. - run: |
  25. gcloud container clusters get-credentials ${{ secrets.GKE_CLUSTER }} \
  26. --zone ${{ secrets.GKE_ZONE }} --project ${{ secrets.GKE_PROJECT }}
  28. - name: Deploy to GKE
  29. run: |
  30. kubectl apply -f k8s/deployment.yaml
  31. kubectl apply -f k8s/service.yaml


📝 你需要在專案內準備好 k8s/deployment.yaml 和 service.yaml 等 Kubernetes 定義檔。

<a name="conclusion"></a>

🧠 結語與延伸學習

透過 GitHub Actions + 雲平台部署，開發者可以打造：

  • 💡 自動化的 CI/CD 工作流程

  • 🚀 更穩定、快速的交付流程

  • ☁️ 無痛整合多雲（Multi-Cloud）架構

留言

張貼留言

這個網誌中的熱門文章

🔍Vue.js 專案錯誤排查：解決 numericFields is not defined 與合併儲存格邏輯最佳化

-
  前言 在前端開發專案中，處理表格數據與 Excel 匯出是常見的需求。 最近在專案中，遇到一個常見但讓人頭痛的錯誤訊息： Uncaught ReferenceError: numericFields is not defined 本文將用簡單的方式，帶你了解這個錯誤的成因、如何修改程式碼，以及如何最佳化「合併儲存格」與「數值加總」的邏輯。 問題場景：表格合併與數值加總 專案中需要達成以下功能： 同一個 APS_PLAN_NO 下，若 TFT4 相同，則 TFT5 欄位要合併。 數值欄位要加總，並以千分位格式輸出。 匯出到 Excel 時，也要套用相同邏輯。 在 Vue 的 rowSpans 計算邏輯中，初始版本如下： const rowSpans = computed ( () => { const rows = filteredData. value const spans = rows. map ( () => { const obj = {} tableHeaders. value . forEach ( key => obj[key] = 0 ) return obj }) ... return spans }) 但是，當我們在 exportToExcel() 使用時，出現了以下錯誤： Uncaught ReferenceError: numericFields is not defined 錯誤原因 這個錯誤訊息代表： 👉 numericFields 在程式中根本沒有宣告，所以瀏覽器不知道它是什麼。 舉例來說，假設我們在程式裡寫了這樣的判斷： if (numericFields. includes (key)) { // 處理數值欄位 } 但其實 numericFields 沒有定義，程式就會直接報錯。 解決方案：定義 numericFields ...
閱讀完整內容

🔎EF Core 連 Oracle 出現 ORA-00600 [kpp_concatq:2] 的完整排錯指南（含 EF Core ToString/CultureInfo 錯誤）

-
  摘要（Meta Description） 在 .NET EF Core 對 Oracle 查詢時，若遭遇 ORA-00600 [kpp_concatq:2] ，多半是查詢優化器在字串型別轉換或重寫（Query Transformation）時踩到版本 Bug。本文以實戰日誌形式，示範如何用 FromSqlRaw + 參數型別/長度對齊 + CAST + Hint 立即止血，並處理 EF Core 另一個常見錯誤：「 CultureInfo 常值被傳進 ToString 造成可能記憶體外洩 」。附可直接套用的程式碼。 目錄 錯誤現象 根因分析 三步驟「立即止血」 安全重構：可直接貼用的程式碼 進階避雷：CTE/MATERIALIZE 與 View 包裝 EF Core ToString / CultureInfo 錯誤的正確處理 版本與長期解法（根治） 效能與穩定性小技巧 檢查清單（Checklist） FAQ 結語 錯誤現象 常見堆疊片段如下（節錄）： Oracle .ManagedDataAccess .Client .OracleException ( 0 x80004005): ORA-00600 : 內部錯誤代碼, 引數: [kpp_concatq:2] , [4] , [3] ...
閱讀完整內容

🛠【ASP.NET Core + Oracle】解決 ORA-00904 "FALSE": 無效的 ID 錯誤與資料欄位動態插入顯示問題

-
  🔍 問題描述 在開發群創光電內部的 APS 排程系統（使用 ASP.NET Core + Vue 3 + Oracle），前端發生多筆錯誤訊息： Request failed with status code 500 Oracle.ManagedDataAccess.Client.OracleException: ORA-00904: "FALSE": 無效的 ID 這是 Oracle 資料庫對布林值處理不一致造成的錯誤，我們後端嘗試將某個欄位 .Where(x => x.FLAG == false) 寫法，經由 EF Core 轉成 SQL： SELECT * FROM TABLE WHERE FLAG = FALSE 而 Oracle 並不支援 FALSE 關鍵字作為布林值 → 導致查詢失敗。 🔧 解決方案 1：避免布林值直接進入 LINQ to SQL EF Core + Oracle 不支援下列語法： .Where(x => x.IsActive == false) // ❌ Oracle 無法解析 FALSE ✅ 解法 ：將布林判斷移至 .ToList() 之後，變成記憶體篩選： var list = await db.Table.Where(x => x.Version == ver).ToListAsync(); var filtered = list.Where(x => !x.IsActive).ToList(); // ✅ 在記憶體中比對布林 🔧 解決方案 2：安全轉換 SEQ_NO 為 Decimal 後端為了將前段表 APSZFRONT 的 SEQ_NO 與 APSZLCM 的 APS_PLAN_SEQ 對應，用到了這段程式碼： Convert.ToDecimal(front.SEQ_NO) 但一旦 SEQ_NO 含有英文字母（例如 GN140CHCAAE90S_20250811_1_531 ），就會丟出 FormatException → 造成 HTTP 500。 ✅ 正確寫法（TryParse 避免失敗） ： de...
閱讀完整內容