Compartir vía


Inicio rápido: Implementación de un clúster de contenedor de SQL Server en Azure

Se aplica a: SQL Server - Linux

En este inicio rápido se muestra cómo configurar una instancia de SQL Server de alta disponibilidad en un contenedor con almacenamiento persistente de Azure Kubernetes Service (AKS) o Red Hat OpenShift. Si se produce un error en la instancia de SQL Server, el orquestador vuelve a crearla automáticamente en un pod nuevo. El servicio de clúster también proporciona resistencia frente a un error de nodo.

En este inicio rápido se usan las herramientas de línea de comandos siguientes para administrar el clúster.

Servicio de clúster Texto de línea de comandos
Azure Kubernetes Service (AKS) kubectl (CLI de Kubernetes)
Red Hat OpenShift en Azure oc (CLI de OpenShift)

Requisitos previos

Creación de una contraseña de administrador del sistema

  1. Cree una contraseña de administrador del sistema en el clúster de Kubernetes. Kubernetes puede administrar información de configuración confidencial (por ejemplo, las contraseñas) como secretos.

  2. Para crear un secreto en Kubernetes denominado mssql que contenga el valor MyC0m9l&xP@ssw0rd de MSSQL_SA_PASSWORD, ejecute el comando siguiente. Recuerde elegir su propia contraseña compleja:

    Importante

    La variable de entorno SA_PASSWORD está en desuso. En su lugar, use MSSQL_SA_PASSWORD.

    kubectl create secret generic mssql --from-literal=MSSQL_SA_PASSWORD="MyC0m9l&xP@ssw0rd"
    

Creación de almacenamiento

Para una base de datos de un clúster de Kubernetes, debe usar el almacenamiento persistente. Configure un volumen persistente y una notificación de volumen persistente en el clúster de Kubernetes mediante los pasos siguientes:

  1. Cree un manifiesto para definir la clase de almacenamiento y la notificación de volumen persistente. El manifiesto especifica el aprovisionamiento de almacenamiento, los parámetros y la directiva de recuperación. El clúster de Kubernetes usa este manifiesto para crear el almacenamiento persistente.

  2. En el siguiente ejemplo de YAML se define una clase de almacenamiento y una notificación de volumen persistente. El almacenamiento de la clase de almacenamiento es azure-disk porque este clúster de Kubernetes está en Azure. El tipo de cuenta de almacenamiento es Standard_LRS. La notificación de volumen persistente se denomina mssql-data. Los metadatos de la notificación de volumen persistente incluyen una anotación que lo vuelve a conectar con la clase de almacenamiento.

    kind: StorageClass
    apiVersion: storage.k8s.io/v1
    metadata:
         name: azure-disk
    provisioner: kubernetes.io/azure-disk
    parameters:
      storageaccounttype: Standard_LRS
      kind: Managed
    ---
    kind: PersistentVolumeClaim
    apiVersion: v1
    metadata:
      name: mssql-data
      annotations:
        volume.beta.kubernetes.io/storage-class: azure-disk
    spec:
      accessModes:
      - ReadWriteOnce
      resources:
        requests:
          storage: 8Gi
    

    Guarde el archivo (por ejemplo, pvc.yaml).

  3. Cree la notificación de volumen persistente en Kubernetes, donde <path to pvc.yaml file> es la ubicación donde guardó el archivo:

    kubectl apply -f <path to pvc.yaml file>
    

    El volumen persistente se crea automáticamente como una cuenta de Azure Storage y se enlaza a la notificación de volumen persistente.

    storageclass "azure-disk" created
    persistentvolumeclaim "mssql-data" created
    
  4. Compruebe la notificación de volumen persistente, donde <persistentVolumeClaim> es el nombre de la notificación de volumen persistente:

    kubectl describe pvc <persistentVolumeClaim>
    

    En el paso anterior, la notificación de volumen persistente se denomina mssql-data. Para ver los metadatos sobre la notificación de volumen persistente, ejecute el siguiente comando:

    kubectl describe pvc mssql-data
    

    Los metadatos devueltos incluyen un valor denominado Volume. Este valor se asigna al nombre del blob.

    Name:          mssql-data
    Namespace:     default
    StorageClass:  azure-disk
    Status:        Bound
    Volume:        pvc-d169b88e-f26d-11e7-bc3e-0a58ac1f09a4
    Labels:        ‹none>
    Annotations:   kubectl.kubernetes.io/last-applied-configuration-{"apiVersion":"v1","kind":"PersistentVolumeClaim","metadata":{"annotations":{"volume.beta.   kubernetes.io/storage-class":"azure-disk"},"name":"mssq1-data...
                   pv.kubernetes.io/bind-completed-yes
                   pv.kubernetes.io/bound-by-controller=yes
                   volume.beta.kubernetes.io/storage-class=azure-disk
                   volume.beta.kubernetes.io/storage-provisioner=kubernetes.io/azure-disk
    Capacity:      8Gi
    Access Modes:  RWO
    Events:        <none>
    

    El valor del volumen coincide con parte del nombre del blob en la siguiente imagen de Azure Portal:

    Captura de pantalla del nombre del blob en Azure Portal.

  5. Compruebe el volumen persistente.

    kubectl describe pv
    

    kubectl devuelve metadatos sobre el volumen persistente que se ha creado automáticamente y se ha enlazado a la notificación de volumen persistente.

Creación de la implementación

El contenedor que hospeda la instancia de SQL Server se describe como un objeto de implementación de Kubernetes. La implementación crea un conjunto de réplicas. El conjunto de réplicas crea el pod.

Crea un manifiesto para describir el contenedor basado en la imagen de Docker mssql-server-linux de SQL Server.

  • El manifiesto hace referencia a la notificación de volumen persistente mssql-server y al secreto mssql que ya ha aplicado al clúster de Kubernetes.
  • El manifiesto también describe un servicio. Este servicio es un equilibrador de carga. El equilibrador de carga garantiza que la dirección IP se conserva después de que se recupere la instancia de SQL Server.
  • El manifiesto describe las solicitudes de recursos y los límites. Se basan en los requisitos mínimos del sistema.
  1. Cree un manifiesto (un archivo YAML) para describir la implementación. En el ejemplo siguiente se describe una implementación, incluido un contenedor basado en la imagen de contenedor de SQL Server.

    apiVersion: apps/v1
    kind: Deployment
    metadata:
      name: mssql-deployment
    spec:
      replicas: 1
      selector:
         matchLabels:
           app: mssql
      template:
        metadata:
          labels:
            app: mssql
        spec:
          terminationGracePeriodSeconds: 30
          hostname: mssqlinst
          securityContext:
            fsGroup: 10001
          containers:
          - name: mssql
            image: mcr.microsoft.com/mssql/server:2022-latest
            resources:
              requests:
                memory: "2G"
                cpu: "2000m"
              limits:
                memory: "2G"
                cpu: "2000m"
            ports:
            - containerPort: 1433
            env:
            - name: MSSQL_PID
              value: "Developer"
            - name: ACCEPT_EULA
              value: "Y"
            - name: MSSQL_SA_PASSWORD
              valueFrom:
                secretKeyRef:
                  name: mssql
                  key: MSSQL_SA_PASSWORD
            volumeMounts:
            - name: mssqldb
              mountPath: /var/opt/mssql
          volumes:
          - name: mssqldb
            persistentVolumeClaim:
              claimName: mssql-data
    ---
    apiVersion: v1
    kind: Service
    metadata:
      name: mssql-deployment
    spec:
      selector:
        app: mssql
      ports:
        - protocol: TCP
          port: 1433
          targetPort: 1433
      type: LoadBalancer
    

    Copie el código anterior en un nuevo archivo denominado sqldeployment.yaml. Actualice los siguientes valores:

    • MSSQL_PID value: "Developer": establece el contenedor para ejecutar la edición SQL Server Developer. La edición Developer no tiene licencia para los datos de producción. Si la implementación es para su uso en producción, establezca la edición adecuada (Enterprise, Standard o Express). Para obtener más información, vea Cómo obtener una licencia de SQL Server.

    • persistentVolumeClaim: este valor requiere una entrada para claimName: que se asigne al nombre usado para la notificación de volumen persistente. En este tutorial se usa mssql-data.

    • name: MSSQL_SA_PASSWORD: Configura la imagen de contenedor para establecer la contraseña de administrador del sistema, tal como se define en esta sección.

      valueFrom:
        secretKeyRef:
          name: mssql
          key: MSSQL_SA_PASSWORD
      

      Cuando Kubernetes implementa el contenedor, hace referencia al secreto denominado mssql para obtener el valor de la contraseña.

    • securityContext: define la configuración de privilegios y control de acceso para un pod o contenedor. En este caso, se especifica a nivel de pod, por lo que todos los contenedores se adhieren a ese contexto de seguridad. En el contexto de seguridad, definimos fsGroup con el valor 10001, que es el identificador de grupo (GID) del grupo mssql. Este valor significa que todos los procesos del contenedor también forman parte del GID 10001 complementario (mssql). El propietario del volumen /var/opt/mssql y todos los archivos creados en ese volumen será el GID 10001 (el grupo mssql).

    Advertencia

    Al usar el tipo de servicio LoadBalancer, se puede acceder a la instancia de SQL Server de forma remota (mediante Internet) en el puerto 1433.

    Guarde el archivo. Por ejemplo, sqldeployment.yaml.

  2. Cree la implementación, donde <path to sqldeployment.yaml file> es la ubicación donde guardó el archivo:

    kubectl apply -f <path to sqldeployment.yaml file>
    

    Se crean la implementación y el servicio. La instancia de SQL Server está en un contenedor, que está conectado al almacenamiento persistente.

    deployment "mssql-deployment" created
    service "mssql-deployment" created
    

    Se crean la implementación y el servicio. La instancia de SQL Server está en un contenedor, que está conectado al almacenamiento persistente.

    Para ver el estado del pod, escriba kubectl get pod.

    NAME                                READY    STATUS    RESTARTS   AGE
    mssql-deployment-3813464711-h312s   1/1      Running   0          17m
    

    El pod tiene un estado de Running. Este estado indica que el contenedor está listo. Una vez creada la implementación, pueden pasar unos minutos hasta que el pod se pueda ver. El retraso se debe a que el clúster extrae la imagen mssql-server-linux del Registro de artefactos Microsoft. Una vez que se extrae la imagen por primera vez, las implementaciones posteriores pueden ser más rápidas si la implementación se realiza en un nodo que ya tiene la imagen almacenada en la memoria caché.

  3. Compruebe que los servicios se está ejecutando. Ejecute el siguiente comando:

    kubectl get services
    

    Este comando devuelve los servicios que se están ejecutando, así como sus direcciones IP internas y externas. Anote la dirección IP externa del servicio mssql-deployment. Use esta dirección IP para conectarse a SQL Server.

    NAME               TYPE           CLUSTER-IP    EXTERNAL-IP     PORT(S)          AGE
    kubernetes         ClusterIP      10.0.0.1      <none>          443/TCP          52m
    mssql-deployment   LoadBalancer   10.0.113.96   52.168.26.254   1433:30619/TCP   2m
    

    Para obtener más información sobre el estado de los objetos en el clúster de Kubernetes, ejecute el comando siguiente. No olvide reemplazar <MyResourceGroup> y <MyKubernetesClustername> po el grupo de recursos y el nombre del clúster de Kubernetes:

    az aks browse --resource-group <MyResourceGroup> --name <MyKubernetesClustername>
    
  4. También puede comprobar que el contenedor se ejecuta como no raíz ejecutando el siguiente comando, donde <nameOfSqlPod> es el nombre del pod de SQL Server:

    kubectl.exe exec <nameOfSqlPod> -it -- /bin/bash
    

    Puede ver el nombre de usuario como mssql si ejecuta whoami. mssql es un usuario no raíz.

    whoami
    

Conexión con la instancia de SQL Server

Puede conectarse a una aplicación desde fuera de la red virtual de Azure mediante la cuenta sa y la dirección IP externa del servicio. Use la contraseña que ha configurado como secreto de OpenShift.

Puede usar las siguientes aplicaciones para conectarse a la instancia de SQL Server.

Conexión con sqlcmd

Para conectarse a sqlcmd, ejecute el siguiente comando:

sqlcmd -S <External IP Address> -U sa -P "MyC0m9l&xP@ssw0rd"

Reemplace los siguientes valores:

  • <External IP Address> por la dirección IP del servicio mssql-deployment.
  • MyC0m9l&xP@ssw0rd por su contraseña compleja

Comprobación de errores y recuperación

Para comprobar los errores y la recuperación, puede eliminar el pod con los pasos siguientes:

  1. Enumere el pod que ejecuta SQL Server.

    kubectl get pods
    

    Anote el nombre del pod que ejecuta SQL Server.

  2. Elimine el pod.

    kubectl delete pod mssql-deployment-0
    

    mssql-deployment-0 es el valor devuelto del paso anterior para el nombre del pod.

Kubernetes vuelve a crear automáticamente el pod para recuperar una instancia de SQL Server y se conecta al almacenamiento persistente. Use kubectl get pods para comprobar que se ha implementado un nuevo pod. Use kubectl get services para comprobar que la dirección IP del nuevo contenedor es la misma.

Limpieza de recursos

Si no tiene previsto seguir los tutoriales siguientes, limpie los recursos innecesarios. Use el comando az group delete para quitar el grupo de recursos, el servicio de contenedor y todos los recursos relacionados. Reemplace <MyResourceGroup> por el nombre del grupo de recursos que contiene el clúster.

az group delete --name <MyResourceGroup> --yes --no-wait