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

適用於：適用於 PostgreSQL 的 Azure 資料庫 - 單一伺服器

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

必要條件

您需要：

• 具有有效訂用帳戶的 Azure 帳戶。 免費建立帳戶。
• 具有範例數據的 GitHub 存放庫 （data.sql）。 如果您沒有 GitHub 帳戶，請免費註冊。
• 適用於 PostgreSQL 的 Azure 資料庫 彈性伺服器實例。
  • 快速入門：在 Azure 入口網站 中建立 適用於 PostgreSQL 的 Azure 資料庫 - 彈性伺服器實例

工作流程檔案概觀

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

檔案內有兩個區段：

產生部署認證

az ad sp create-for-rbac --name "myML" --role contributor \
                            --scopes /subscriptions/<subscription-id>/resourceGroups/<group-name> \
                            --json-auth

  {
    "clientId": "<GUID>",
    "clientSecret": "<GUID>",
    "subscriptionId": "<GUID>",
    "tenantId": "<GUID>",
    (...)
  }

複製 適用於 PostgreSQL 的 Azure 資料庫 彈性伺服器 連接字串

在 Azure 入口網站 中，移至您的 適用於 PostgreSQL 的 Azure 資料庫 彈性伺服器實例，然後開啟 設定> 連線 ion 字串。 複製 ADO.NET 連接字串。 取代 your_database 和 your_password 的預留位置值。 連接字串 看起來會像這樣。

psql host={servername.postgres.database.azure.com} port=5432 dbname={your_database} user={adminusername} password={your_database_password} sslmode=require

您可以使用 連接字串 作為 GitHub 秘密。

設定 GitHub 祕密

新增您的工作流程

1. 移至 GitHub 存放庫的 [動作]。

2. 選取 [自行設定工作流程]。

3. 刪除工作流程檔案 on: 區段之後的所有內容。 例如，剩餘的工作流程看起來可能像這樣。

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

4. 重新命名您的工作流程 PostgreSQL for GitHub Actions ，並新增簽出和登入動作。 這些動作會檢查您的網站程序代碼，並使用您稍早建立的 GitHub 秘密向 Azure 進行驗證。

   • 服務主體
   • OpenID Connect

   name: PostgreSQL for GitHub Actions
   
   on:
   push:
       branches: [ main ]
   pull_request:
       branches: [ main ]
   
   jobs:
   build:
       runs-on: ubuntu-latest
       steps:
       - uses: actions/checkout@v1
       - uses: azure/login@v1
       with:
           creds: ${{ secrets.AZURE_CREDENTIALS }}
   

5. 使用 Azure PostgreSQL 部署動作來連線到 適用於 PostgreSQL 的 Azure 資料庫 彈性伺服器實例。 將取代 POSTGRESQL_SERVER_NAME 為您的伺服器名稱。 您應該在存放庫根層級有名為 data.sql 的 適用於 PostgreSQL 的 Azure 資料庫 彈性伺服器資料檔。

    - uses: azure/postgresql@v1
      with:
       connection-string: ${{ secrets.AZURE_POSTGRESQL_CONNECTION_STRING }}
       server-name: POSTGRESQL_SERVER_NAME
       plsql-file: './data.sql'
   

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

   • 服務主體
   • OpenID Connect

   name: PostgreSQL for GitHub Actions
   
   on:
   push:
       branches: [ main ]
   pull_request:
       branches: [ main ]
   
   
   jobs:
   build:
       runs-on: ubuntu-latest
       steps:
       - uses: actions/checkout@v1
       - uses: azure/login@v1
       with:
           client-id: ${{ secrets.AZURE_CREDENTIALS }}
   
   - uses: azure/postgresql@v1
     with:
       server-name: POSTGRESQL_SERVER_NAME
       connection-string: ${{ secrets.AZURE_POSTGRESQL_CONNECTION_STRING }}
       plsql-file: './data.sql'
   
       # Azure logout
   - name: logout
     run: |
        az logout
   

檢閱您的部署

1. 移至 GitHub 存放庫的 [動作]。

2. 開啟第一個結果，以查看工作流程的執行詳細記錄。

   

清除資源

當您 適用於 PostgreSQL 的 Azure 資料庫 不再需要彈性的伺服器資料庫和存放庫時，請刪除資源群組和 GitHub 存放庫來清除您部署的資源。

下一步