Inicio rápido: Uso de Almacenamiento de contenedores de Azure con Azure Kubernetes Service

  • Artículo

Azure Container Storage es un servicio de administración, implementación y orquestación de volúmenes basado en la nube creado de forma nativa para contenedores. En este inicio rápido se muestra cómo conectar a un clúster de Azure Kubernetes Service (AKS) basado en Linux, instalar Azure Container Storage y crear un grupo de almacenamiento mediante la CLI de Azure.

Importante

Almacenamiento de contenedores de Azure ya está disponible con carácter general a partir de la versión 1.1.0. Se recomienda la versión de disponibilidad general para usarse en cargas de trabajo de producción.

Requisitos previos

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

  • En este artículo se necesita la versión más reciente de la CLI de Azure (2.35.0 o posteriores). Consulte Cómo instalar la CLI de Azure. Si usa el entorno de Bash en Azure Cloud Shell, ya está instalada la versión más reciente. Si tiene previsto ejecutar los comandos localmente en lugar de en Azure Cloud Shell, asegúrese de ejecutarlos con privilegios administrativos. Para más información, consulte Introducción a Azure Cloud Shell.

  • Necesitará el cliente de línea de comandos de Kubernetes, kubectl. Ya está instalado si usa Azure Cloud Shell o puede instalarlo de manera local ejecutando el comando az aks install-cli.

  • Compruebe si la región de destino se admite en regiones de Azure Container Storage.

  • Si aún no ha creado un clúster de AKS, siga las instrucciones para Instalación de un clúster de AKS.

Introducción

  • Tome nota del identificador de suscripción de Azure. Si quiere usar Azure Elastic SAN como almacenamiento de datos, necesitará un rol de Propietario de Azure Container Storage o rol de Colaborador de Azure Container Storage asignado a la suscripción de Azure. El acceso de nivel de propietario le permite instalar la extensión Azure Container Storage, conceder acceso a sus recursos de almacenamiento y le concede permiso para configurar el recurso Elastic SAN de Azure. El acceso de nivel de colaborador permite instalar la extensión y concede acceso a sus recursos de almacenamiento. Si planea usar discos de Azure o disco efímero como almacenamiento de datos, no necesita permisos especiales en la suscripción.

  • Inicie Azure Cloud Shell, o si usa una instalación local, inicie sesión en Azure mediante el comando az login.

  • Si usa Azure Cloud Shell, es posible que se le pida que monte el almacenamiento. Seleccione la suscripción de Azure donde desea crear la cuenta de almacenamiento y seleccione Crear.

Instalación de la extensión necesaria

Para agregar o actualizar a la versión más reciente de k8s-extension, ejecute el comando siguiente.

az extension add --upgrade --name k8s-extension

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 todas las suscripciones a las que tiene acceso ejecutando el comando az account list --output table. Recuerde reemplazar <subscription-id> por el id. de la suscripción.

az account set --subscription <subscription-id>

Conectarse al clúster

Para conectarse al clúster, use el cliente de línea de comandos de Kubernetes, kubectl. Ya está instalado si usa Azure Cloud Shell o puede instalarlo de manera local ejecutando el comando az aks install-cli.

  1. Configure kubectl para conectarse al clúster ejecutando el comando az aks get-credentials. El siguiente comando:

    • Descarga las credenciales y configura la CLI de Kubernetes para usarlas.
    • Usa ~/.kube/config, la ubicación predeterminada del archivo de configuración de Kubernetes. Puede especificar otra ubicación para el archivo de configuración de Kubernetes con el argumento --file.
    az aks get-credentials --resource-group <resource-group> --name <cluster-name>

  2. Compruebe la conexión al clúster con el comando kubectl get. Este comando devuelve una lista de los nodos del clúster.

    kubectl get nodes

  3. En el siguiente ejemplo de salida, se muestran los nodos en el clúster. Asegúrese de que el estado de todos los nodos se muestre como Ready:

    NAME                                STATUS   ROLES   AGE   VERSION
aks-nodepool1-34832848-vmss000000   Ready    agent   80m   v1.25.6
aks-nodepool1-34832848-vmss000001   Ready    agent   80m   v1.25.6
aks-nodepool1-34832848-vmss000002   Ready    agent   80m   v1.25.6

    Anote el nombre del grupo de nodos. En este ejemplo, sería nodepool1.

Elija una opción de almacenamiento de datos para el grupo de almacenamiento

Antes de implementar Azure Container Storage, deberá decidir qué opción de almacenamiento de back-end desea usar para crear el grupo de almacenamiento y los volúmenes. Actualmente hay tres opciones disponibles:

  • Azure Elastic SAN: Azure Elastic SAN es una buena opción para bases de datos de uso general, servicios de streaming y mensajería, entornos de CD/CI y otras cargas de trabajo de nivel 1 o nivel 2. El almacenamiento se aprovisiona a petición por volumen e instantánea de volumen creados. Varios clústeres pueden acceder simultáneamente a una sola SAN, pero los volúmenes persistentes solo se pueden adjuntar por un consumidor a la vez.

  • Azure Disks: Azure Disks es una buena opción para bases de datos como MySQL, MongoDB y PostgreSQL. El almacenamiento se aprovisiona por tamaño de bloque de almacenamiento de contenedor de destino y tamaño máximo de volumen.

  • Disco efímero: esta opción usa unidades NVMe locales o SSD temporales en los nodos del clúster de AKS. Es extremadamente sensible a la latencia (baja latencia de sub ms), por lo que es mejor para las aplicaciones sin necesidad de durabilidad de datos o con compatibilidad integrada con la replicación de datos, como Cassandra. AKS detecta el almacenamiento efímero disponible en los nodos de AKS y adquiere las unidades para la implementación de volúmenes.

Nota:

Para Azure Elastic SAN y Azure Disks, Azure Container Storage implementará el almacenamiento de respaldo como parte de la instalación. No es necesario crear su propio Elastic SAN ni Azure Disk. Para usar Elastic SAN, necesitará un rol de Propietario de Azure Container Storage o rol de Colaborador de Azure Container Storage en la suscripción de Azure.

Consumo de recursos

Azure Container Storage requiere determinados recursos de nodo para ejecutar componentes para el servicio. En función de la selección del tipo de grupo de almacenamiento, que especificará al instalar Azure Container Storage, estos son los recursos que se consumirán:

Tipo de grupo de almacenamiento Núcleos de CPU RAM
Azure Elastic SAN  None None
Azure Disks 1 1 GiB
Disco efímero: SSD temporal 1 1 GiB
Disco efímero: NVMe local (nivel estándar) 25 % de núcleos (se puede actualizar el nivel de rendimiento)* 1 GiB

Los recursos consumidos son por nodo y se consumirán para cada nodo del grupo de nodos donde se instalará Azure Container Storage. Si los nodos no tienen suficientes recursos, Azure Container Storage no se ejecutará. Kubernetes volverá a intentar inicializar automáticamente estos pods con errores, por lo que si los recursos se liberan, estos pods se pueden inicializar de nuevo.

*En un grupo de almacenamiento, escriba Disco efímero: NVMe local con el nivel de rendimiento estándar (predeterminado), si usa varios tipos de SKU de máquina virtual para los nodos del clúster, el 25 % de los núcleos de CPU consumidos se aplica a la SKU más pequeña usada. Por ejemplo, si usa una combinación de tipos de máquina virtual de 8 núcleos y 16 núcleos, el consumo de recursos es de 2 núcleos. Puede actualizar el nivel de rendimiento para usar un mayor porcentaje de núcleos y lograr una mayor IOPS.

Asegúrese de que el tipo de máquina virtual del clúster cumple los siguientes criterios

Para usar Azure Container Storage, necesitará un grupo de nodos de al menos tres máquinas virtuales Linux. Si usa NVMe local para el grupo de almacenamiento, el grupo de nodos debe contener un mínimo de cuatro máquinas virtuales Linux. Cada máquina virtual debe tener un mínimo de cuatro CPU virtuales (vCPU). Azure Container Storage consumirá un núcleo para el procesamiento de E/S en cada máquina virtual en la que se implemente la extensión.

Siga estas instrucciones al elegir un tipo de máquina virtual para los nodos del clúster. Debe elegir un tipo de máquina virtual que admita Azure Premium Storage.

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

El comando de instalación es diferente dependiendo de si ya tiene una instancia en versión preliminar de Azure Container Storage que se ejecuta en el clúster de AKS o si va a instalar Azure Container Storage en el clúster por primera vez.

Actualización de una instalación de versión preliminar a disponibilidad general

Si ya tiene una instancia en versión preliminar de Azure Container Storage que se ejecuta en el clúster, se recomienda actualizar a la versión más reciente disponible con disponibilidad general (GA) mediante la ejecución del comando siguiente. Si va a instalar Azure Container Storage por primera vez en el clúster, vaya a Instalar Azure Container Storage y crear un grupo de almacenamiento. También puede Instalar Azure Container Storage en grupos de nodos específicos.

az k8s-extension update --cluster-type managedClusters --cluster-name <cluster-name> --resource-group <resource-group> --name azurecontainerstorage --version 1.1.0 --auto-upgrade false --release-train stable

Recuerde reemplazar <cluster-name> y <resource-group> por sus valores propios.

Instalar Azure Container Storage y crear un grupo de almacenamiento

Antes de realizar la instalación, asegúrese de que el clúster de AKS cumpla los requisitos de máquina virtual.

Ejecute el siguiente comando para instalar Azure Container Storage en el clúster y crear un grupo de almacenamiento. Reemplace <cluster-name> y <resource-group> con sus propios valores. Reemplace <storage-pool-type> por azureDisk, ephemeralDisk o elasticSan. Si selecciona ephemeralDisk, también puede especificar --storage-pool-option y los valores pueden ser NVMe o Temp.

Al ejecutar este comando, se habilitará Azure Container Storage en el grupo de nodos del sistema, que de forma predeterminada se denomina nodepool1*. Si quiere habilitarlo en otros grupos de nodos, consulte Instalación de Azure Container Storage en grupos de nodos específicos. Si desea especificar parámetros adicionales, consulte Parámetros del grupo de almacenamiento de Azure Container Storage.

*Si hay grupos de nodos existentes con la etiqueta acstor.azure.com/io-engine:acstor, Azure Container Storage se instalará de forma predeterminada. De lo contrario, se instala en el grupo de nodos del sistema.

Importante

Si ha creado el clúster de AKS con el Azure Portal: es probable que el clúster tenga un grupo de nodos de usuario y un grupo de nodos del sistema o agente. Sin embargo, si el clúster consta solo de un grupo de nodos del sistema, que es el caso de los clústeres de pruebas y desarrollo creados con Azure Portal, primero deberá agregar un nuevo grupo de nodos de usuario y, a continuación, etiquetarlo. Esto se debe a que al crear un clúster de AKS con Azure Portal, se agrega un defecto CriticalAddOnsOnly a la agrupación de nodos del agente o sistema, que bloquea la instalación de Azure Container Storage en el grupo de nodos del sistema. Esta distorsión no se agrega cuando se crea un clúster AKS a través de Azure CLI.

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

La implementación tardará entre 10 y 15 minutos. Cuando finalice, tendrá instalado un clúster de AKS con Azure Container Storage instalado, los componentes del tipo de bloque de almacenamiento elegido habilitado y un bloque de almacenamiento predeterminado. Si desea habilitar tipos de bloque de almacenamiento adicionales para crear grupos de almacenamiento adicionales, consulte Habilitación de tipos de bloque de almacenamiento adicionales.

Importante

Si ha especificado Azure Elastic SAN como almacenamiento de respaldo para su grupo de almacenamiento y no tiene asignado el rol Azure Container Storage Owner ni el rol Azure Container Storage Contributor a la suscripción de Azure, la instalación de Azure Container Storage producirá error y no se creará un grupo de almacenamiento. Si intenta habilitar Azure Elastic SAN como un tipo de grupo de almacenamiento adicional sin ninguno de estos roles, la instalación anterior y los grupos de almacenamiento no se verán afectados y no se creará un grupo de almacenamiento de SAN elástico.

Instalar Azure Container Storage en grupos de nodos específicos

Si desea instalar Azure Container Storage en grupos de nodos específicos, siga estas instrucciones. Los grupos de nodos deben contener al menos tres máquinas virtuales Linux cada uno. Si usa NVMe local para el grupo de almacenamiento, los grupos de nodos deben contener al menos cuatro máquinas virtuales Linux.

  1. Ejecute el siguiente comando para ver la lista de grupos de nodos disponibles. Reemplace <resource-group> y <cluster-name> con sus propios valores.

    az aks nodepool list --resource-group <resource-group> --cluster-name <cluster-name>

  2. Ejecute el comando siguiente para instalar Azure Container Storage en grupos de nodos específicos. Reemplace <cluster-name> y <resource-group> con sus propios valores. Reemplace <storage-pool-type> por azureDisk, ephemeralDisk o elasticSan. Si selecciona ephemeralDisk, también puede especificar --storage-pool-option y los valores pueden ser NVMe o Temp.

    az aks update -n <cluster-name> -g <resource-group> --enable-azure-container-storage <storage-pool-type> --azure-container-storage-nodepools <comma separated values of nodepool names>

Habilitación de tipos de bloques de almacenamiento adicionales

Si desea habilitar un tipo de bloque de almacenamiento que no se ha habilitado originalmente durante la instalación de Azure Container Storage, ejecute el comando siguiente. Reemplace <cluster-name> y <resource-group> con sus propios valores. Para <storage-pool-type>, especifique azureDisk, ephemeralDisk o elasticSan.

Si desea especificar parámetros adicionales del bloque de almacenamiento con este comando, consulte esta tabla.

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

Si el nuevo tipo de bloque de almacenamiento que ha habilitado ocupa más recursos que el tipo de bloque de almacenamiento que ya está habilitado, el consumo de recursos cambiará a la cantidad máxima.

Sugerencia

Si ha agregado un nuevo grupo de nodos al clúster y quiere ejecutar Azure Container Storage en ese grupo de nodos, puede especificar el grupo de nodos con --azure-container-storage-nodepools <nodepool-name> al ejecutar el comando az aks update.

Mostrar los grupos de almacenamiento disponibles

Para obtener la lista de grupos de almacenamiento disponibles, ejecute el siguiente comando:

kubectl get sp -n acstor

Para comprobar el estado de un bloque de almacenamiento, ejecute el siguiente comando:

kubectl describe sp <storage-pool-name> -n acstor

Si el Message no dice StoragePool is ready, el bloque de almacenamiento sigue creando o experimentando un problema. Consulte Solución de problemas de Azure Container Storage.

Deshabilitar tipos de bloque de almacenamiento

Si ya no usa un tipo de bloque de almacenamiento específico y quiere deshabilitarlo para liberar recursos en el grupo de nodos, ejecute el siguiente comando. Reemplace <cluster-name> y <resource-group> con sus propios valores. Para <storage-pool-type>, especifique azureDisk, ephemeralDisk o elasticSan.

az aks update -n <cluster-name> -g <resource-group> --disable-azure-container-storage <storage-pool-type>

Nota:

Si tiene un bloque de almacenamiento existente del tipo que intenta deshabilitar, el tipo de bloque de almacenamiento no se deshabilitará.

Paso siguiente

Para crear volúmenes, seleccione el vínculo para el tipo de almacenamiento de respaldo seleccionado.