使用 Azure Kubernetes Service 上的 DH2i DxOperator 在 Kubernetes 上部署可用性群組

適用於：Linux 上的 SQL Server

本教學說明如何使用 DH2i DxOperator，為部署至 Azure Kubernetes Service（AKS）叢集的 Linux 型 SQL Server 容器設定 SQL Server Always On 可用性群組（AG）。這些程序同樣適用於 Azure Red Hat OpenShift 叢集。主要區別在於部署 Azure Red Hat OpenShift 叢集，接著在以下步驟中將指令替換kubectl為oc

透過本文的步驟，你將學習如何部署 StatefulSet，並使用 DH2i DxOperator 建立與配置一個由三個副本架設於 AKS 上的 AG。

本教學課程包含下列步驟：

使用 mssql-conf 設定在 AKS 叢集上建立 ConfigMap 物件
建立祕密物件
安裝 DxOperator
使用 YAML 檔案部署三副本的 SQL Server 可用性群組
連接到 SQL Server

先決條件

Azure Kubernetes Service (AKS) 或 Kubernetes 叢集。
已啟用 AG 功能和通道的有效 DxEnterprise 授權。如需詳細資訊，請參閱非生產環境的開發人員版本，或生產工作負載的 DxEnterprise 軟體。

建立 `ConfigMap` 物件

在 AKS 建立 ConfigMap 物件，根據您的需求，它具有 mssql-conf 設定。在這個範例中，你會使用名為 ConfigMap 且具有下列參數的檔案來建立 mssqlconfig.yaml。
```
apiVersion: v1
kind: ConfigMap
metadata:
  name: mssql-config
data:
  mssql.conf: |
    [EULA]
    accepteula = Y

    [sqlagent]
    enabled = true
```
請執行以下指令建立物件。
```
kubectl apply -f ./mssqlconfig.yaml
```

建立祕密物件

建立祕密以儲存 SQL Server 的 sa 密碼。

kubectl create secret generic mssql --from-literal=MSSQL_SA_PASSWORD="<password>"

注意事項

您的密碼應遵循 SQL Server 預設密碼原則。根據預設，密碼長度必須至少為8個字元，且包含下列四個集合中的三個字元：大寫字母、小寫字母、基底10位數和符號。密碼長度最多可達 128 個字元。盡可能使用長且複雜的密碼。

建立祕密以儲存 DH2i 的授權識別碼。請造訪 DH2i 的網站以取得開發人員授權。在下列範例中，將 XXXX-XXXX-XXXX-XXXX 取代為您的授權識別碼。

kubectl create secret generic dxe --from-literal=DX_PASSKEY="<password>" --from-literal=DX_LICENSE=XXXX-XXXX-XXXX-XXXX

安裝 DxOperator

安裝 DxOperator 時，請依照以下範例下載 DxOperator 的 YAML 檔案，然後套用 YAML 檔案。

請使用以下指令部署描述如何設定 AG 的 YAML 檔案。使用自訂名稱儲存檔案，例如 DxOperator.yaml。
```
curl -L https://dxoperator.dh2i.com/dxsqlag/files/v2.yaml -o DxOperator.yaml
kubectl apply -f DxOperator.yaml
```

安裝操作員後，你可以部署 SQL Server 容器、設定可用性群組、定義副本，並部署與配置 DxEnterprise 叢集。請修改下列範例部署 YAML 檔案 DxSqlAg.yaml，使其符合您的需求。

apiVersion: dh2i.com/v1
kind: DxSqlAg
metadata:
  name: contoso-sql
spec:
 sqlAgConfiguration:
   synchronousReplicas: 3
   asynchronousReplicas: 0
   # ConfigurationOnlyReplicas are only allowed with availabilityGroupClusterType set to EXTERNAL
   configurationOnlyReplicas: 0
   availabilityGroupName: AG1
   # Adds auto-generated load balancers to serviceTemplates for easy cluster access
   # For more customization, use the serviceTemplates section below
   #createLoadBalancers: true
   # Listener port for the availability group (uncomment to apply)
   #availabilityGroupListenerPort: 51433
   # For a contained availability group, add the option CONTAINED
   #availabilityGroupOptions: CONTAINED
   # Disables automatic availability mode switching when scaling down
   #disableModeSwitching: true
  statefulSetSpec:
    podspec:
      dxEnterpriseContainer:
        image: "docker.io/dh2i/dxe:latest"
        imagePullPolicy: Always
        acceptEula: true
        clusterSecret: dxe
        vhostName: VHOST1
        # Configuration options for the required persistent volume claim for DxEnterprise
        #volumeClaimConfiguration:
        # Set custom storage class for DxE PVC
        #storageClassName: example-class
      mssqlServerContainer:
        image: "mcr.microsoft.com/mssql/server:2025-latest"
        imagePullPolicy: Always
        mssqlSecret: mssql
        acceptEula: true
        mssqlPID: Developer
        # Set a non-default SQL Server port. DxOperator will auto-detect
        # the port from other sources too, such as mssqlConfigMap
        mssqlTcpPort: 51444
        # The MSSQL configMap (mssql.conf file)
        mssqlConfigMap: mssql-config
        # Configuration options for the required persistent volume claim for SQL Server
        #volumeClaimConfiguration:
        #  resources:
        #    requests:
        #      storage: 2Gi
      # Additional pod containers, such as mssql-tools
      #containers:
      #- name: mssql-tools
        #image: "mcr.microsoft.com/mssql-tools"
        #command: [ "/bin/sh" ]
        #args: [ "-c", "tail -f /dev/null" ]

部署 DxSqlAg.yaml 檔案。
```
kubectl apply -f DxSqlAg.yaml
```

建立可用性群組接聽程式

更新你的 availabilityGroupListenerPort 檔案中的 DxSqlAg.yaml 值：
```
spec:
  sqlAgConfiguration:
    availabilityGroupListenerPort: 51433
```
套用此檔案：
```
kubectl apply -f DxSqlAg.yaml
```

套用以下 YAML 來為監聽者新增負載平衡器。

apiVersion: v1
kind: Service
metadata:
  name: contoso-cluster-lb
spec:
  type: LoadBalancer
  selector:
    dh2i.com/entity-name: contoso-sql
    # This label points to whichever pod is the active Vhost member
    dh2i.com/active-vhost-vhost1: "true"
  ports:
    - name: sql
      protocol: TCP
      port: 1433
      targetPort: 51444
    - name: listener
      protocol: TCP
      port: 51433
      targetPort: 51433
    - name: dxe
      protocol: TCP
      port: 7979
      targetPort: 7979

確認服務和負載平衡器是否在執行。

kubectl get services

輸出看起來類似於以下範例：

NAME                     TYPE           CLUSTER-IP   EXTERNAL-IP     PORT(S)                                         AGE
contoso-cluster-lb       LoadBalancer   10.1.0.21    172.212.20.29   1433:30484/TCP,51433:30694/TCP,7979:30385/TCP   3m18s
contoso-sql-0            ClusterIP      None         <none>          7979/TCP,7980/TCP,7981/UDP,5022/TCP,1433/TCP    79m
contoso-sql-0-lb         LoadBalancer   10.1.0.210   4.255.19.171    7979:32374/TCP,1433:32444/TCP                   79m
contoso-sql-1            ClusterIP      None         <none>          7979/TCP,7980/TCP,7981/UDP,5022/TCP,1433/TCP    79m
contoso-sql-1-lb         LoadBalancer   10.1.0.158   4.255.19.201    7979:30152/TCP,1433:30868/TCP                   79m
contoso-sql-2            ClusterIP      None         <none>          7979/TCP,7980/TCP,7981/UDP,5022/TCP,1433/TCP    79m
contoso-sql-2-lb         LoadBalancer   10.1.0.159   4.255.19.218    7979:30566/TCP,1433:31463/TCP                   79m
kubernetes               ClusterIP      10.1.0.1     <none>          443/TCP                                         87m

確認三個 SQL Server Pod 都已經在執行。

kubectl get pods

輸出看起來類似於以下範例：

NAME            READY   STATUS    RESTARTS   AGE
contoso-sql-0   2/2     Running   0          74m
contoso-sql-1   2/2     Running   0          74m
contoso-sql-2   2/2     Running   0          74m

意見反應

此頁面對您有幫助嗎？

Last updated on 2026-10-01