快速入門：使用 GitHub Actions 連線至適用於 MySQL 的 Azure 資料庫 - 彈性伺服器

藉由使用工作流程將資料庫更新部署至適用於 MySQL 的 Azure 資料庫彈性伺服器，來開始使用 GitHub Actions。

先決條件

您需要：

具有有效訂用帳戶的 Azure 帳戶。免費建立帳戶。
GitHub 帳戶。如果您沒有 GitHub 帳戶，請免費註冊。
具有範例資料 (data.sql) 的 GitHub 存放庫。

重要事項

本快速入門假設您已將 GitHub 存放庫複製至電腦，以便視需要將相關聯的 IP 位址新增至防火牆規則。
適用於 MySQL 的 Azure 資料庫彈性伺服器執行個體。
- 快速入門：在 Azure 入口網站中建立適用於 MySQL 的 Azure 資料庫彈性伺服器執行個體

工作流程檔案概觀

GitHub Actions 工作流程是由您存放庫內 /.github/workflows/ 路徑中的 YAML (.yml) 檔案所定義的。此定義包含組成工作流程的各種步驟與參數。

檔案內有兩個區段：

區段	工作
驗證	1. 產生部署認證。
部署	1.部署資料庫。

若要搭配 OIDC 使用Azure 登入動作，您必須在 Microsoft Entra 應用程式或使用者指派的受控身分識別上設定同盟身分憑證。

選項 1：Microsoft Entra 應用程式

使用 Azure 入口網站、Azure CLI或 Azure PowerShell，建立具有服務主體的 Microsoft Entra 應用程式。
複製 用戶端標識碼、訂用帳戶標識碼和 Directory （tenant）標識碼 的值，以便稍後在 GitHub Actions 工作流程中使用。
透過 Azure 入口網站、 Azure CLI 或 Azure PowerShell 將適當的角色指派給您的服務主體。
在 Microsoft Entra 應用程式上設定同盟身份認證，以信任 GitHub Actions 發行的令牌至您的 GitHub 存放庫。

選項 2：使用者指派的受控識別

建立使用者指派的受控識別。
複製 用戶端標識碼、訂用帳戶標識碼和 Directory （tenant）標識碼 的值，以便稍後在 GitHub Actions 工作流程中使用。
將適當的角色指派給使用者指派的受控識別。
在使用者指派的受控識別上設定同盟身分識別認證 (部分機器翻譯)，以信任 GitHub Actions 簽發給 GitHub 存放庫的權杖。

複製 MySQL 連接字串

在 Azure 入口網站中，移至適用於 MySQL 的 Azure 資料庫彈性伺服器執行個體，然後開啟 [設定]>[連接字串]。複製 ADO.NET 連接字串。取代 your_database 和 your_password 的預留位置值。

重要事項

若為適用於 MySQL 的 Azure 資料庫單一伺服器，請使用 Uid=adminusername@servername。請注意，需要 @servername。
若為適用於 MySQL 的 Azure 資料庫彈性伺服器，請使用 Uid=adminusername 而不含 @servername。

您將使用此連接字串作為 GitHub 秘密。

設定 GitHub 祕密

OpenID 連線
服務主體

您必須將應用程式的 用戶端識別碼、 目錄（租使用者）標識碼和訂用帳戶 識別碼 提供給登入動作。這些值可以直接在工作流程中提供，也可以儲存於 GitHub 祕密中，並在您的工作流程中參考。將值儲存為 GitHub 祕密是較安全的選項。

在 GitHub (英文) 中，前往您的存放庫。
選取 [安全性] > [祕密和變數] > [動作]。
選取 [新增存放庫祕密]。

備註

若要增強公用存放庫中的工作流程安全性，請使用環境秘密，而不是存放庫秘密。如果環境需要核准，則作業在其中一位必要的檢閱者核准之前，無法存取環境秘密。

建立 AZURE_CLIENT_ID、AZURE_TENANT_ID 與 AZURE_SUBSCRIPTION_ID 的祕密。從 Microsoft Entra 應用程式或使用者指派的受控識別中複製這些值，以用於 GitHub 機密：

GitHub 祕密	Microsoft Entra 應用程式或使用者指派的受管理識別
AZURE_CLIENT_ID	用戶端識別碼
AZURE_SUBSCRIPTION_ID	訂用帳戶識別碼
AZURE_TENANT_ID	目錄 (租用戶) 識別碼

備註

基於安全理由，建議使用 GitHub Secrets，而不是將值直接傳遞至工作流程。

在 GitHub (英文) 中，前往您的存放庫。
移至導覽功能表中的 [設定]。
選取 [安全性] > [祕密和變數] > [動作]。
選取 [新增存放庫祕密]。
將得自 Azure CLI 命令的整個 JSON 輸出貼到祕密的 [值] 欄位中。將祕密命名為 AZURE_CREDENTIALS。
選取 [新增祕密]。

新增您的工作流程

移至 GitHub 存放庫的 [動作]。
選取 [自行設定工作流程]。
刪除工作流程檔案 on: 區段之後的所有內容。例如，剩餘的工作流程看起來可能會像這樣。
```
name: CI

on:
push:
    branches: [ main ]
pull_request:
    branches: [ main ]
```

重新命名工作流程 MySQL for GitHub Actions，並新增簽出和登入動作。這些動作會簽出您的站台碼，並使用您稍早建立的 AZURE_CREDENTIALS GitHub 祕密向 Azure 進行驗證。

OpenID 連線
服務主體

name: MySQL for GitHub Actions

on:
    push:
        branches: [ main ]
    pull_request:
        branches: [ main ]

jobs:
    build:
        runs-on: windows-latest
        steps:
        - uses: actions/checkout@v1
        - uses: azure/login@v2
            with:
              client-id: ${{ secrets.AZURE_CLIENT_ID }}
              tenant-id: ${{ secrets.AZURE_TENANT_ID }}
              subscription-id: ${{ secrets.AZURE_SUBSCRIPTION_ID }}

name: MySQL for GitHub Actions

on:
    push:
        branches: [ main ]
    pull_request:
        branches: [ main ]

jobs:
    build:
        runs-on: windows-latest
        steps:
        - uses: actions/checkout@v1
        - uses: azure/login@v1
            with:
                creds: ${{ secrets.AZURE_CREDENTIALS }}

使用 Azure MySQL 的「部署」動作來連線到您的 MySQL 執行個體。以伺服器的名稱取代 MYSQL_SERVER_NAME。在存放庫的根層級中，您應該會有名為 data.sql 的 MySQL 資料檔案。
```
- uses: azure/mysql@v1
  with:
    server-name: MYSQL_SERVER_NAME
    connection-string: ${{ secrets.AZURE_MYSQL_CONNECTION_STRING }}
    sql-file: './data.sql'
```

將動作新增至 Azure 登出，完成您的工作流程。以下為完成的工作流程。檔案會出現在存放庫的 .github/workflows 資料夾中。

OpenID 連線
服務主體

name: MySQL for GitHub Actions

on:
  push:
      branches: [ main ]
  pull_request:
      branches: [ main ]
jobs:
    build:
        runs-on: windows-latest
        steps:
          - uses: actions/checkout@v1
          - uses: azure/login@v2
            with:
              client-id: ${{ secrets.AZURE_CLIENT_ID }}
              tenant-id: ${{ secrets.AZURE_TENANT_ID }}
              subscription-id: ${{ secrets.AZURE_SUBSCRIPTION_ID }}
          - uses: azure/mysql@v1
            with:
              server-name: MYSQL_SERVER_NAME
              connection-string: ${{ secrets.AZURE_MYSQL_CONNECTION_STRING }}
              sql-file: './data.sql'

            # Azure logout
          - name: logout
            run: |
              az logout

name: MySQL for GitHub Actions

on:
  push:
      branches: [ main ]
  pull_request:
      branches: [ main ]
jobs:
    build:
        runs-on: windows-latest
        steps:
          - uses: actions/checkout@v1
          - uses: azure/login@v2
            with:
              creds: ${{ secrets.AZURE_CREDENTIALS }}

          - uses: azure/mysql@v1
            with:
              server-name: MYSQL_SERVER_NAME
              connection-string: ${{ secrets.AZURE_MYSQL_CONNECTION_STRING }}
              sql-file: './data.sql'

            # Azure logout
          - name: logout
            run: |
              az logout

檢閱您的部署

移至 GitHub 存放庫的 [動作]。
開啟第一個結果，以查看工作流程的執行詳細記錄。

清除資源

當您不再需要 Azure Database for MySQL 彈性伺服器資料庫和存放庫時，請刪除資源群組和 GitHub 存放庫，以清除您部署的資源。

後續步驟

了解 Azure 和 GitHub 整合

意見反應

此頁面對您有幫助嗎？

Last updated on 2025-10-13