Compartir a través de


Implementación de grupos de disponibilidad en Kubernetes con DH2i DxOperator en Azure Kubernetes Service

Se aplica a: SQL Server - Linux

En este tutorial se explica cómo configurar grupos de disponibilidad Always On (AG) de SQL Server para contenedores SQL Server basados en Linux implementados en un clúster de Kubernetes de Azure Kubernetes Service (AKS), mediante DH2i DxOperator. Estos procedimientos también son aplicables a los clústeres de Red Hat OpenShift en Azure; la distinción principal es la implementación de un clúster de Red Hat OpenShift en Azure, seguido de sustituir comandos kubectl por oc en los pasos siguientes.

Nota:

Microsoft admite los componentes de movimiento de datos, AG y SQL Server. DH2i es responsable del soporte técnico del producto DxEnterprise, que incluye la administración de clústeres y cuórum. DxOperator es una extensión de software para Kubernetes que utiliza definiciones de recursos personalizadas para automatizar la implementación de clústeres de DxEnterprise. DxEnterprise proporciona toda la instrumentación para crear, configurar, administrar y proporcionar conmutación automática por error para las cargas de trabajo del AG de SQL Server en Kubernetes.

Puede registrarse para obtener una licencia gratuita de software DxEnterprise. Para más información, consulte la guía de inicio rápido de DxOperator.

Con los pasos mencionados en este artículo, aprenderá a implementar un elemento StatefulSet y a utilizar la solución DH2i DxOperator para crear y configurar un AG con tres réplicas alojadas en AKS.

Este tutorial se compone de los siguientes pasos:

  • Creación de un objeto configmap en el clúster de AKS con la configuración mssql-conf
  • Instalación de DxOperator
  • Creación de objetos secretos
  • Implementación de un AG de SQL de réplica 3 mediante el archivo YAML
  • Conectar a SQL Server

Requisitos previos

  • Un clúster de Kubernetes o Azure Kubernetes Service (AKS).

  • Una licencia de DxEnterprise válida con las características de grupo de disponibilidad y los túneles habilitados. Para obtener más información, consulte la edición para desarrolladores para el uso en entornos que no son de producción o el software DxEnterprise para cargas de trabajo de producción.

Cree el objeto configmap

  1. En AKS, cree el objeto configmap, que tiene la configuración mssql-conf en función de sus requisitos. En este ejemplo, creará configMap mediante un archivo denominado mssqlconfig.yaml con los parámetros siguientes.

    apiVersion: v1
    kind: ConfigMap
    metadata:
      name: mssql-config
    data:
      mssql.conf: |
        [EULA]
        accepteula = Y
    
        [sqlagent]
        enabled = true
    
  2. Cree el objeto ejecutando el siguiente comando.

    kubectl apply -f ./mssqlconfig.yaml
    

Cree objetos secretos

Cree un secreto para almacenar la contraseña sa de SQL Server.

kubectl create secret generic mssql --from-literal=MSSQL_SA_PASSWORD="Password123"

Cree un secreto para almacenar la clave de licencia para DH2i. Visite el sitio web de DH2i para obtener una licencia de desarrollador. En el ejemplo siguiente, reemplace XXXX-XXXX-XXXX-XXXX con su clave de licencia.

kubectl create secret generic dxe --from-literal=DX_PASSKEY="Password123" --from-literal=DX_LICENSE=XXXX-XXXX-XXXX-XXXX

Instalación de DxOperator

Para instalar DxOperator, debe descargar el archivo YAML DxOperator mediante el ejemplo siguiente y después aplicar el archivo YAML.

  1. Implemente el YAML que describe cómo configurar un AG mediante el siguiente comando. Guarde el archivo con un nombre personalizado, como DxOperator.yaml.

    curl -L https://dxoperator.dh2i.com/dxesqlag/files/v1.yaml -o DxOperator.yaml
    kubectl apply –f DxOperator.yaml
    
  2. Después de instalar el operador, puede implementar contenedores de SQL Server, configurar el grupo de disponibilidad, definir réplicas e implementar y configurar el clúster DxEnterprise. Este es un archivo YAML de implementación de ejemplo denominado DxEnterpriseSqlAg.yaml, que puede cambiar para adaptarse a sus requisitos.

    apiVersion: dh2i.com/v1
    kind: DxEnterpriseSqlAg
    metadata:
      name: contoso-sql
    spec:
      synchronousReplicas: 3
      asynchronousReplicas: 0
      # ConfigurationOnlyReplicas are only allowed with availabilityGroupClusterType set to EXTERNAL
      configurationOnlyReplicas: 0
      availabilityGroupName: AG1
      # Listener port for the availability group (uncomment to apply)
      availabilityGroupListenerPort: 51433
      # For a contained availability group, add the option CONTAINED
      availabilityGroupOptions: null
      # Valid options are EXTERNAL (automatic failover) and NONE (no automatic failover)
      availabilityGroupClusterType: EXTERNAL
      createLoadBalancers: true
      template:
        metadata:
          labels:
            label: example
          annotations:
            annotation: example
        spec:
          dxEnterpriseContainer:
            image: "docker.io/dh2i/dxe:latest"
            imagePullPolicy: Always
            acceptEula: true
            clusterSecret: dxe
            vhostName: VHOST1
            joinExistingCluster: false
            # QoS – guaranteed (uncomment to apply)
            #resources:
              #limits:
                #memory: 1Gi
                #cpu: '1'
            # Configuration options for the required persistent volume claim for DxEnterprise
            volumeClaimConfiguration:
              storageClassName: null
              resources:
                requests:
                  storage: 1Gi
          mssqlServerContainer:
            image: "mcr.microsoft.com/mssql/server:latest"
            imagePullPolicy: Always
            mssqlSecret: mssql
            acceptEula: true
            mssqlPID: Developer
            mssqlConfigMap: mssql-config
            # QoS – guaranteed (uncomment to apply)
            #resources:
              #limits:
                #memory: 2Gi
                #cpu: '2'
            # Configuration options for the required persistent volume claim for SQL Server
            volumeClaimConfiguration:
              storageClassName: null
              resources:
                requests:
                  storage: 2Gi
          # Additional side-car containers, such as mssql-tools (uncomment to apply)
          #containers:
          #- name: mssql-tools
              #image: "mcr.microsoft.com/mssql-tools"
              #command: [ "/bin/sh" ]
              #args: [ "-c", "tail -f /dev/null" ]
    
  3. Implementación del archivo DxEnterpriseSqlAg.yaml.

    kubectl apply -f DxEnterpriseSqlAg.yaml
    

Creación del agente de escucha del grupo de disponibilidad

Aplique el siguiente YAML para agregar un equilibrador de carga estableciendo el selector en el valor de metadata.name en el paso anterior. En este ejemplo, es contoso-sql.

apiVersion: v1
kind: Service
metadata:
  name: contoso-cluster-lb
spec:
  type: LoadBalancer
  selector:
    dh2i.com/entity: contoso-sql
  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

Verifique las asignaciones de implementación y equilibrador de carga.

kubectl get pods
kubectl get services

Debería ver una salida similar al ejemplo siguiente:

NAME                     TYPE           CLUSTER-IP   EXTERNAL-IP     PORT(S)                                         AGE
contoso-cluster-lb       LoadBalancer   10.1.0.21    172.212.20.29   1433:30484/TCP,14033: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

PS /home/aravind> 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