Instalación de Azure Container Storage para su uso con Azure Kubernetes Service

Requisitos previos

• Si no tiene una suscripción a Azure, cree una cuenta gratuita antes de empezar.

• En este artículo se requiere la versión v2.83.0 o posterior de la CLI de Azure. Para obtener más información, consulte Cómo instalar la CLI de Azure. Deshabilite extensiones como, por aks-preview ejemplo, si se producen problemas. Instale o actualice las extensiones según sea necesario:

  • az extension add --upgrade --name k8s-extension
  • az extension add --upgrade --name elastic-san (Solo SAN elástico)

• Necesita el cliente de línea de comandos de Kubernetes, kubectl. Ya está instalado si usa Azure Cloud Shell. Para instalarlo localmente, ejecute el az aks install-cli comando .

• Compruebe si la región de destino es compatible con las regiones de Azure Container Storage.

• Planee la configuración del grupo de nodos:

  • Use Linux como tipo de sistema operativo (No se admite Windows).
  • Seleccione una SKU de máquina virtual (VM) que admita discos de datos NVMe locales si tiene previsto usar el tipo de almacenamiento NVMe local, como máquinas virtuales optimizadas para almacenamiento o aceleradas por GPU .
  • En el caso de los clústeres existentes, asegúrese de que los grupos de nodos ya usan una SKU de máquina virtual compatible antes de habilitar Azure Container Storage.

• Si usa Elastic SAN por primera vez en la suscripción, ejecute este comando de registro único:

  az provider register --namespace Microsoft.ElasticSan
  

Establecimiento del contexto de la suscripción

Establezca el contexto de la suscripción ejecutando el comando az account set. Puede ver los identificadores de suscripción mediante la ejecución de az account list --output table. Reemplace <subscription-id> con el Id. de suscripción.

az account set --subscription <subscription-id>

Crear un grupo de recursos

Un grupo de recursos de Azure es un contenedor lógico para los recursos. Al crear un grupo de recursos, especifique una ubicación. Esa ubicación almacena los metadatos del grupo de recursos y actúa como la región predeterminada para los recursos que cree sin una región explícita.

Cree un grupo de recursos mediante az group create. Reemplace <resource-group-name> por el nombre del grupo de recursos y <location> por una región de Azure como eastus, westus2, westus3o westeurope. Si habilita Azure Container Storage en un clúster de AKS existente, use el grupo de recursos que ya hospeda el clúster.

az group create --name <resource-group-name> --location <location>

Si el grupo de recursos se crea correctamente, verá un resultado similar al de este ejemplo:

{
  "id": "/subscriptions/<guid>/resourceGroups/myContainerStorageRG",
  "location": "eastus",
  "managedBy": null,
  "name": "myContainerStorageRG",
  "properties": {
    "provisioningState": "Succeeded"
  },
  "tags": null
}

Instalación de Azure Container Storage en un nuevo clúster de AKS

Elija el escenario que coincida con el entorno.

Instalación solo mediante el instalador

Ejecute el comando siguiente para crear un nuevo clúster de AKS e instalar Azure Container Storage. Reemplace <cluster-name> y <resource-group> por sus propios valores y especifique qué tipo de máquina virtual desea usar.

az aks create -n <cluster-name> -g <resource-group> --node-vm-size Standard_L8s_v3 --enable-azure-container-storage --generate-ssh-keys

La implementación puede tardar hasta 5 minutos. La instalación del controlador CSI se aplaza hasta que se crea una clase de almacenamiento o se habilita un tipo de almacenamiento más adelante.

Siga las instrucciones para crear una clase de almacenamiento NVMe local o una clase de almacenamiento elastic SAN .

instalación con instalador + tipo de almacenamiento

Ejecute el comando siguiente para crear un nuevo clúster de AKS e instalar Azure Container Storage. Reemplace <cluster-name> y <resource-group> por sus propios valores y especifique qué tipo de máquina virtual desea usar.

az aks create -n <cluster-name> -g <resource-group> --node-vm-size Standard_L8s_v3 --enable-azure-container-storage ephemeralDisk --generate-ssh-keys

Este comando instala el instalador, implementa el controlador NVMe CSI local y crea una clase de almacenamiento predeterminada denominada local-csi. Puede instalar y usar NVMe local y Elastic SAN proporcionando una lista como ephemeralDisk elasticSan.

Instalación de Azure Container Storage en un clúster de AKS existente

Instalación solo mediante el instalador

Ejecute el comando siguiente para habilitar Azure Container Storage en un clúster de AKS existente. Reemplace <cluster-name> y <resource-group> con sus propios valores.

az aks update -n <cluster-name> -g <resource-group> --enable-azure-container-storage

La implementación puede tardar hasta 5 minutos. Cuando se completa, el clúster tiene instalado el componente del instalador de Azure Container Storage. La instalación del controlador CSI se aplaza hasta que se crea una clase de almacenamiento o se habilita un tipo de almacenamiento más adelante. Siga las instrucciones para crear una clase de almacenamiento NVMe local o una clase de almacenamiento elastic SAN .

instalación con instalador + tipo de almacenamiento

Ejecute el comando siguiente para habilitar Azure Container Storage en un clúster de AKS existente. Reemplace <cluster-name> y <resource-group> por sus propios valores y especifique qué tipo de almacenamiento desea usar.

az aks update -n <cluster-name> -g <resource-group> --enable-azure-container-storage elasticSan

Este comando instala el instalador, implementa el controlador Elastic SAN CSI y crea una clase de almacenamiento predeterminada denominada azuresan-csi. Puede instalar y usar NVMe local y Elastic SAN proporcionando una lista como ephemeralDisk elasticSan.

Instalar un acelerador distribuido para almacenamiento en la nube (vista previa)

Activa el acelerador distribuido para almacenamiento en la nube en un clúster AKS existente usando el distributedAccelerator valor. Se requiere la mayúscula A . La extensión se instala en el recurso de clúster administrado de AKS; no necesitas conectar el clúster a Arc.

Usa aks-preview la versión 22.0.0b9 o posterior. Instale o actualice la extensión, compruebe su versión e instale o actualice connectedk8s y k8s-extension para gestionar e inspeccionar la ampliación del DACS:

az extension add --name aks-preview --upgrade --yes
az extension show --name aks-preview --query version --output tsv
az extension add --name connectedk8s --upgrade --yes
az extension add --name k8s-extension --upgrade --yes

Antes de habilitar DACS, selecciona un pool de nodos Linux con discos de datos NVMe locales dedicados a la caché. Aplica la dacs.azure.com/processing-unit=cpu etiqueta a través de la configuración de nodo-pool, preservando cualquier etiqueta personalizada existente. Siga estos pasos: Verificar el grupo de nodos de caché.

Ejecuta el siguiente comando, reemplazando <cluster-name> y <resource-group> con tus valores:

az aks update \
  --name <cluster-name> \
  --resource-group <resource-group> \
  --enable-azure-container-storage distributedAccelerator

Este comando instala la distributedaccelerator extensión, el controlador DACS y el prerrequisito NVMe DaemonSet en kube-system, y la caches.storage.azure.com definición de recurso personalizada (CRD). No es necesario instalar una tabla de requisitos previos por separado ni gestionar uno mismo la versión de Helm de la extensión. No crea una StorageClass ni provisiona un recurso de caché ni pods de servidor de caché por defecto. Una instalación exitosa de extensiones no significa por sí sola que una caché esté lista para el tráfico de aplicaciones.

Pase distributedAccelerator por separado en este comando, en lugar de combinarlo con las opciones de almacenamiento de volúmenes persistentes mostradas anteriormente. Antes de aprovisionar servidores de caché, verifica que los prerrequisitos gestionados estén listos en cada nodo de caché etiquetado. Para la configuración de caché y el flujo de trabajo de la aplicación, consulte Empezar con acelerador distribuido para el almacenamiento en la nube en AKS.

Para eliminar DACS, sigue Eliminar acelerador distribuido para almacenamiento en la nube. Elimina los recursos de caché mientras el controlador está en marcha y luego desactiva los DACS. La desactivación elimina el controlador y el prerrequisito gestionado DaemonSet; no elimines esos prerrequisitos por separado.

Requisitos previos

• Si no tiene una suscripción a Azure, cree una cuenta gratuita antes de empezar.

• En este artículo se requiere la versión v2.83.0 o posterior de la CLI de Azure. Para obtener más información, consulte Cómo instalar la CLI de Azure. Deshabilite extensiones como, por aks-preview ejemplo, si se producen problemas. Instale o actualice las extensiones según sea necesario:

  • az extension add --upgrade --name k8s-extension
  • az extension add --upgrade --name elastic-san (Solo SAN elástico)

• Necesita el cliente de línea de comandos de Kubernetes, kubectl. Ya está instalado si usa Azure Cloud Shell. Para instalarlo localmente, ejecute el az aks install-cli comando .

• Compruebe si la región de destino es compatible con las regiones de Azure Container Storage.

• Planee la configuración del grupo de nodos:

  • Use Linux como tipo de sistema operativo (No se admite Windows).
  • Seleccione una SKU de máquina virtual (VM) que admita discos de datos NVMe locales, como máquinas virtuales optimizadas para almacenamiento o aceleradas por GPU .
  • En el caso de los clústeres existentes, asegúrese de que los grupos de nodos ya usan una SKU de máquina virtual compatible antes de habilitar Azure Container Storage.

• Instale terraform versión 1.5 o posterior y confirme la instalación con terraform version. Terraform puede reutilizar la autenticación de la CLI de Azure.

• Si usa Elastic SAN por primera vez en la suscripción, ejecute este comando de registro único:

  az provider register --namespace Microsoft.ElasticSan
  

Establecimiento del contexto de la suscripción

Terraform puede determinar una suscripción de Azure de destino a través de varios métodos:

• subscription_id en el bloque de proveedor
• Variable de entorno ARM_SUBSCRIPTION_ID
• Suscripción predeterminada de la CLI de Azure
• Identidad administrada (cuando se ejecuta en Azure)

Para su uso local, establezca el contexto de la CLI de Azure:

az account set --subscription <subscription-id>

Si utiliza Terraform por primera vez en la suscripción, ejecute este comando de registro por única vez:

az provider register --namespace Microsoft.KubernetesConfiguration

# Wait for registration to complete (can take a few minutes)
az provider show --namespace Microsoft.KubernetesConfiguration --query "registrationState" -o tsv

Instalación de Azure Container Storage en un nuevo clúster de AKS

1. En un directorio de trabajo vacío, cree un main.tf archivo con la siguiente configuración mínima de un clúster de AKS. Actualice los nombres de recursos, las ubicaciones y los tamaños de máquina virtual para cumplir los requisitos.

   terraform {
     required_version = ">= 1.5.0"
     required_providers {
       azurerm = {
         source  = "hashicorp/azurerm"
         version = "~> 4.0"
       }
     }
   }
   
   provider "azurerm" {
     features {}
   }
   
   resource "azurerm_resource_group" "rg" {
     name     = "demo-aks-rg"
     location = "eastus"
   }
   
   resource "azurerm_kubernetes_cluster" "aks" {
     name                = "demo-aks-cluster"
     dns_prefix          = "demo-aks"
     location            = azurerm_resource_group.rg.location
     resource_group_name = azurerm_resource_group.rg.name
   
     default_node_pool {
       name       = "systempool"
       vm_size    = "Standard_L8s_v3"
       node_count = 3
     }
   
     identity {
       type = "SystemAssigned"
     }
   }
   
   resource "azurerm_kubernetes_cluster_extension" "container_storage" {
     # NOTE: the `name` parameter must be "acstor" for Azure CLI compatibility
     name           = "acstor"
     cluster_id     = azurerm_kubernetes_cluster.aks.id
     extension_type = "microsoft.azurecontainerstoragev2"
   }
   

2. Inicialice el directorio de trabajo para descargar el proveedor de AzureRM.

   terraform init
   

3. Revise los cambios planeados.

   terraform plan
   

4. Aplique la configuración para crear el grupo de recursos, el clúster de AKS y la extensión de Azure Container Storage. La implementación suele tardar 5 minutos.

   terraform apply
   

Cuando se completa, el clúster tiene instalado el componente del instalador de Azure Container Storage. La instalación del controlador CSI se aplaza hasta que se crea una clase de almacenamiento. Siga las instrucciones para crear una clase de almacenamiento NVMe local o una clase de almacenamiento elastic SAN .

Instalación de Azure Container Storage en un clúster de AKS existente

Si el clúster de AKS ya existe y lo administra fuera de Terraform, todavía puede habilitar Azure Container Storage mediante la creación del recurso de extensión. Use un origen de datos para buscar el identificador del clúster.

terraform {
  required_version = ">= 1.5.0"
  required_providers {
    azurerm = {
      source  = "hashicorp/azurerm"
      version = "~> 4.0"
    }
  }
}

provider "azurerm" {
  features {}
}

data "azurerm_kubernetes_cluster" "existing" {
  name                = "existing-aks"
  resource_group_name = "existing-aks-rg"
}

resource "azurerm_kubernetes_cluster_extension" "container_storage" {
  # NOTE: the `name` parameter must be "acstor" for Azure CLI compatibility
  name           = "acstor"
  cluster_id     = data.azurerm_kubernetes_cluster.existing.id
  extension_type = "microsoft.azurecontainerstoragev2"
}

Ejecute terraform init (si se trata de un nuevo directorio de trabajo) seguido de terraform apply para instalar Azure Container Storage en el clúster de destino. La implementación suele tardar 5 minutos.

Cuando se completa, el clúster tiene instalado el componente del instalador de Azure Container Storage. La instalación del controlador CSI se aplaza hasta que se crea una clase de almacenamiento. Siga las instrucciones para crear una clase de almacenamiento NVMe local o una clase de almacenamiento elastic SAN .