Instalación de volúmenes perimetrales de Almacenamiento de contenedores de Azure habilitado por Azure Arc

En este artículo se describen los pasos para instalar la extensión Azure Container Storage.

Instalación de administradores de certificados y confianza

Azure Container Storage depende de un cert-manager y un trust-manager. Puede traer su propio, o estos están disponibles como una extensión de plataforma que se puede instalar mediante el siguiente comando:

az k8s-extension create --cluster-name "${YOUR-CLUSTER-NAME}" --name "${NAME}-certmgr" --resource-group "${YOUR-RESOURCE-GROUP}" --cluster-type connectedClusters --extension-type microsoft.iotoperations.platform --scope cluster --release-namespace cert-manager

Nota

Azure IoT Operations proporciona esta extensión de plataforma, pero la instalación de la extensión de plataforma no instala Azure IoT Operations en el dispositivo.

Instalación de la extensión de Almacenamiento de contenedores de Azure habilitado por Azure Arc

Instale la extensión Azure Container Storage mediante el comando siguiente:

az k8s-extension create --resource-group "${YOUR-RESOURCE-GROUP}" --cluster-name "${YOUR-CLUSTER-NAME}" --cluster-type connectedClusters --name azure-arc-containerstorage --extension-type microsoft.arc.containerstorage

Nota

De forma predeterminada, el parámetro --release-namespace se establece en azure-arc-containerstorage. Si desea invalidar esta configuración, agregue la marca --release-namespace al siguiente comando y rellénela con los detalles. Los valores establecidos en el momento de la instalación se conservan durante toda la duración de la instalación (incluidas las transformaciones manuales y automáticas).

Importante

Si usa OneLake, debe usar un nombre de extensión único para la variable --name en el comando az k8s-extension create.

Operador de configuración

CRD de configuración

La extensión Azure Container Storage usa una definición de recursos personalizada (CRD) en Kubernetes para configurar el servicio de almacenamiento. Antes de publicar este CRD en el clúster de Kubernetes, la extensión azure Container Storage está inactiva y usa recursos mínimos. Una vez que la CRD se aplica con las opciones de configuración, las clases de almacenamiento, el controlador CSI y los POD de servicio adecuados se implementan para proporcionar los servicios. De este modo, puede personalizar Azure Container Storage para satisfacer sus necesidades y se puede volver a configurar sin volver a instalar la extensión de Kubernetes de Arc. Las configuraciones comunes se incluyen aquí, pero esta CRD ofrece la capacidad de configurar configuraciones no estándar para clústeres de Kubernetes con distintas funcionalidades de almacenamiento.

Clúster de un solo nodo o de dos nodos

Clúster de un solo nodo o de dos nodos con Ubuntu o Edge Essentials

Si ejecuta un clúster de un solo nodo o de dos nodos con Ubuntu o Edge Essentials, siga estas instrucciones:

1. Cree un archivo denominado edgeConfig.yaml con el siguiente contenido:

   apiVersion: arccontainerstorage.azure.net/v1
   kind: EdgeStorageConfiguration
   metadata:
     name: edge-storage-configuration
   spec:
     defaultDiskStorageClasses:
       - "default"
       - "local-path"
   

2. Para aplicar este archivo .yaml, ejecute:

   kubectl apply -f "edgeConfig.yaml"
   

Clúster con varios nodos

Clúster de varios nodos con Ubuntu o Edge Essentials

Azure Container Storage contiene un componente, ACStor, que proporciona una interfaz resistente de lectura-Write-Once para Azure Container Storage. En clústeres con tres o más nodos, este componente proporciona replicación de datos entre los nodos. Para que esta característica se use, uno o varios discos de reserva deben configurarse en un punto de montaje independiente para que ACStor los consuma. Si ejecuta un clúster de Kubernetes de tres o más nodos con Ubuntu o Edge Essentials, siga estas instrucciones:

1. Azure Container Storage no está configurado para consumir discos directamente, sino que requiere que se configuren como punto de montaje. Para configurar un disco sin formato como punto de montaje, configure el disco de la siguiente manera:

   fdisk /dev/sd3 
   mkfs.ext4 /dev/sd3a 
   mkdir /acsa 
   mount /dev/sd3a /acsa
   

   Esto configura el disco sd3 del sistema de reserva con una partición sd3a de disco configurada que estará disponible en /acsa para que ACStor lo use.

2. Cree un archivo denominado edgeConfig.yaml con el siguiente contenido:

   Nota

   Para reubicar el almacenamiento en una ubicación diferente en el disco, actualice diskMountPoint con la ruta de acceso deseada. Evite /mnt como ruta de acceso deseada, a menos que se implemente en una Máquina virtual DNds.

   apiVersion: arccontainerstorage.azure.net/v1
   kind: EdgeStorageConfiguration
   metadata:
     name: edge-storage-configuration
   spec:
     defaultDiskStorageClasses:
       - acstor-arccontainerstorage-storage-pool
   ---
   apiVersion: arccontainerstorage.azure.net/v1
   kind: ACStorConfiguration
   metadata:
     name: acstor-configuration
   spec:
     diskMountPoint: /acsa
     diskCapacity: 10Gi
     createStoragePool:
       enabled: true
       replicas: 3
   

   El spec.diskCapacity parámetro determina la cantidad de espacio en disco asignado a Azure Container Storage que se va a usar. En este ejemplo es de 10 GB, pero se puede modificar para adaptarlo a sus necesidades. En este ejemplo, establecerlo en 10 GB significa que ocupa 10 GB en cada uno de los discos replicados (controlados por el parámetro spec.createStoragePool.replicas), en este caso 3o 30 GB en total. Este es el grupo desde el que funcionarán los volúmenes compartidos locales y los volúmenes de ingesta en la nube, por lo que es fundamental asegurarse de que ha dimensionado correctamente este grupo, ya que no se puede crecer en este momento.

3. Para aplicar este archivo .yaml, ejecute:

   kubectl apply -f "edgeConfig.yaml"
   

AKS/AKS Arc habilitado para Arc

AKS habilitado para Arc o AKS Arc

Si ejecuta un clúster de un solo nodo o de varios nodos con AKS habilitado para Arc o AKS habilitado por Arc, siga estas instrucciones:

1. Cree un archivo denominado edgeConfig.yaml con el siguiente contenido:

   apiVersion: arccontainerstorage.azure.net/v1
   kind: EdgeStorageConfiguration
   metadata:
     name: edge-storage-configuration
   spec:
     defaultDiskStorageClasses:
       - "default"
       - "local-path"
   

2. Para aplicar este archivo .yaml, ejecute:

   kubectl apply -f "edgeConfig.yaml"
   

Pasos siguientes

• Configuración de los volúmenes Perimetrales locales compartidos
• Configuración de los volúmenes perimetrales de ingesta en la nube