Instalar o Armazenamento de Contêineres do Azure para uso com o Serviço de Kubernetes do Azure

Pré-requisitos

• Se você não tiver uma assinatura do Azure, crie uma conta gratuita antes de começar.

• Este artigo requer a versão da CLI do Azure v2.83.0 ou posterior. Para obter mais informações, veja Como instalar a CLI do Azure. Desabilite extensões, como aks-preview se ocorrerem problemas. Instale ou atualize as extensões conforme necessário:

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

• Você precisa do cliente de linha de comando do Kubernetes. kubectl Ele já está instalado se você estiver usando o Azure Cloud Shell. Você pode instalá-lo localmente executando o az aks install-cli comando.

• Verifique se a região de destino tem suporte nas regiões do Armazenamento de Contêineres do Azure.

• Planeje a configuração do pool de nós:

  • Use o Linux como o tipo de sistema operacional (o Windows não tem suporte).
  • Selecione um SKU de VM (máquina virtual) que dê suporte a discos de dados NVMe locais se você planeja usar o tipo de armazenamento NVMe local, como VMs com otimização de armazenamento ou aceleradas por GPU .
  • Para clusters existentes, certifique-se de que os pools de nós já estejam usando uma SKU de VM compatível antes de habilitar o Armazenamento de Contêineres do Azure.

• Se você usar o Elastic SAN pela primeira vez na assinatura, execute este comando de registro único:

  az provider register --namespace Microsoft.ElasticSan
  

Definir o contexto da assinatura

Defina o contexto da sua assinatura do Azure usando o comando az account set. Você pode exibir IDs de assinatura executando az account list --output table. Substitua <subscription-id> por sua ID da assinatura.

az account set --subscription <subscription-id>

Criar um grupo de recursos

Um grupo de recursos do Azure é um contêiner lógico para recursos. Ao criar um grupo de recursos, especifique um local. Esse local armazena metadados do grupo de recursos e serve como a região padrão para recursos criados sem uma região explícita.

Crie um grupos de recursos usando az group create. Substitua <resource-group-name> pelo nome do grupo de recursos e <location> por uma região do Azure, como eastus, westus2, westus3ou westeurope. Se você habilitar o Armazenamento de Contêineres do Azure em um cluster do AKS existente, use o grupo de recursos que já hospeda o cluster.

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

Se o grupo de recursos for criado com êxito, você verá uma saída semelhante a este exemplo:

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

Instalar o Armazenamento de Contêineres do Azure em um novo cluster do AKS

Escolha o cenário que corresponde ao seu ambiente.

Instalação somente do instalador

Execute o comando a seguir para criar um novo cluster do AKS e instalar o Armazenamento de Contêineres do Azure. Substitua <cluster-name> e <resource-group> pelos seus próprios valores e especifique qual tipo de VM você deseja usar.

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

A implantação pode levar até 5 minutos. A instalação do driver CSI é adiada até que você crie uma classe de armazenamento ou habilite um tipo de armazenamento posteriormente.

Siga as instruções para criar uma classe de armazenamento NVMe local ou uma classe de armazenamento Elástico SAN .

Instalação do instalador + instalação de tipo de armazenamento

Execute o comando a seguir para criar um novo cluster do AKS e instalar o Armazenamento de Contêineres do Azure. Substitua <cluster-name> e <resource-group> pelos seus próprios valores e especifique qual tipo de VM você deseja usar.

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

Esse comando instala o instalador, implanta o driver CSI NVMe local e cria uma classe de armazenamento padrão chamada local-csi. Você pode instalar e usar o NVMe local e o Elastic SAN fornecendo uma lista como ephemeralDisk elasticSan.

Instalar o Armazenamento de Contêineres do Azure em um cluster do AKS existente

Instalação somente do instalador

Execute o comando a seguir para habilitar o Armazenamento de Contêineres do Azure em um cluster do AKS existente. Substitua <cluster-name> e <resource-group> pelos seus próprios valores.

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

A implantação pode levar até 5 minutos. Quando for concluído, o cluster terá o componente instalador do Armazenamento de Contêiner do Azure instalado. A instalação do driver CSI é adiada até que você crie uma classe de armazenamento ou habilite um tipo de armazenamento posteriormente. Siga as instruções para criar uma classe de armazenamento NVMe local ou uma classe de armazenamento Elástico SAN .

Instalação do instalador + instalação de tipo de armazenamento

Execute o comando a seguir para habilitar o Armazenamento de Contêineres do Azure em um cluster do AKS existente. Substitua <cluster-name> e <resource-group> pelos seus próprios valores, e especifique qual tipo de armazenamento você deseja usar.

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

Esse comando instala o instalador, implanta o driver ELASTIC SAN CSI e cria uma classe de armazenamento padrão chamada azuresan-csi. Você pode instalar e usar o NVMe local e o Elastic SAN fornecendo uma lista como ephemeralDisk elasticSan.

Instalar o acelerador distribuído para armazenamento em nuvem (prévia)

Ative o acelerador distribuído para armazenamento em nuvem em um cluster AKS existente usando o distributedAccelerator valor. A letra maiúscula A é obrigatória. A extensão se instala no recurso de cluster gerenciado do AKS; você não precisa conectar o cluster ao Arc.

Use aks-preview versão 22.0.0b9 ou posterior. Instale ou atualize a extensão, verifique sua versão, instale ou atualize connectedk8s e k8s-extension para gerenciar e inspecionar a extensão 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 ativar o DACS, selecione um pool de nós Linux com discos de dados NVMe locais dedicados ao cache. Aplique o rótulo dacs.azure.com/processing-unit=cpu por meio da configuração de pool de nós, preservando quaisquer etiquetas personalizadas existentes. Siga Verificar o pool de nós de cache.

Execute o seguinte comando, substituindo <cluster-name> e <resource-group> com seus valores:

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

Esse comando instala a distributedaccelerator extensão, o controlador DACS e o pré-requisito NVMe DaemonSet em kube-system, e a caches.storage.azure.com definição personalizada de recurso (CRD). Você não instala um gráfico de pré-requisitos separado nem gerencia o release do Helm da extensão por conta própria. Ele não cria uma StorageClass nem provisiona um recurso de cache e pods de servidor de cache por padrão. A instalação bem-sucedida de extensões não significa por si só que um cache está pronto para tráfego de aplicações.

Passe distributedAccelerator sozinho neste comando, em vez de combiná-lo com as opções de armazenamento de volumes persistentes mostradas anteriormente. Antes de provisionar servidores de cache, verifique se os pré-requisitos gerenciados estão prontos em cada nó de cache rotulado. Para a configuração do cache e o fluxo de trabalho da aplicação, veja Comece com acelerador distribuído para armazenamento em nuvem no AKS.

Para remover DACS, siga Remover acelerador distribuído para armazenamento em nuvem. Exclua os recursos do cache enquanto o controlador está rodando, depois desative o DACS. A desativação remove o controlador e o pré-requisito gerenciado DaemonSet; não remova esses pré-requisitos separadamente.

Pré-requisitos

• Se você não tiver uma assinatura do Azure, crie uma conta gratuita antes de começar.

• Este artigo requer a versão da CLI do Azure v2.83.0 ou posterior. Para obter mais informações, veja Como instalar a CLI do Azure. Desabilite extensões, como aks-preview se ocorrerem problemas. Instale ou atualize as extensões conforme necessário:

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

• Você precisa do cliente de linha de comando do Kubernetes. kubectl Ele já está instalado se você estiver usando o Azure Cloud Shell. Você pode instalá-lo localmente executando o az aks install-cli comando.

• Verifique se a região de destino tem suporte nas regiões do Armazenamento de Contêineres do Azure.

• Planeje a configuração do pool de nós:

  • Use o Linux como o tipo de sistema operacional (o Windows não tem suporte).
  • Selecione um SKU de máquina virtual (VM) que dê suporte a discos de dados NVMe locais, como VMs com otimização de armazenamento ou aceleradas por GPU .
  • Para clusters existentes, certifique-se de que os pools de nós já estejam usando uma SKU de VM compatível antes de habilitar o Armazenamento de Contêineres do Azure.

• Instale o Terraform versão 1.5 ou posterior e confirme a instalação com terraform version. O Terraform pode reutilizar a autenticação da CLI do Azure.

• Se você usar o Elastic SAN pela primeira vez na assinatura, execute este comando de registro único:

  az provider register --namespace Microsoft.ElasticSan
  

Definir o contexto da assinatura

O Terraform pode determinar uma assinatura do Azure de destino por meio de vários métodos:

• subscription_id no bloco do provedor
• Variável de ambiente ARM_SUBSCRIPTION_ID
• Assinatura padrão da CLI do Azure
• Identidade gerenciada (ao executar no Azure)

Para uso local, defina o contexto da CLI do Azure:

az account set --subscription <subscription-id>

Se você estiver realizando a implantação com o Terraform pela primeira vez na assinatura, execute este comando de registro único:

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

Instalar o Armazenamento de Contêineres do Azure em um novo cluster do AKS

1. Em um diretório de trabalho vazio, crie um main.tf arquivo com a seguinte configuração mínima de um cluster do AKS. Atualize os nomes de recursos, os locais e os tamanhos da VM para atender às suas necessidades.

   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. Inicialize o diretório de trabalho para baixar o provedor do AzureRM.

   terraform init
   

3. Examine as alterações planejadas.

   terraform plan
   

4. Aplique a configuração para criar o grupo de recursos, o cluster do AKS e a extensão de Armazenamento de Contêiner do Azure. A implantação normalmente leva 5 minutos.

   terraform apply
   

Quando for concluído, o cluster terá o componente instalador do Armazenamento de Contêiner do Azure instalado. A instalação do driver CSI é adiada até que você crie uma classe de armazenamento. Siga as instruções para criar uma classe de armazenamento NVMe local ou uma classe de armazenamento Elástico SAN .

Instalar o Armazenamento de Contêineres do Azure em um cluster do AKS existente

Se o cluster do AKS já existir e você gerenciá-lo fora do Terraform, você ainda poderá habilitar o Armazenamento de Contêineres do Azure criando apenas o recurso de extensão. Use uma fonte de dados para pesquisar a ID do cluster.

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"
}

Execute terraform init (se este for um novo diretório de trabalho) seguido de terraform apply instalar o Armazenamento de Contêineres do Azure no cluster de destino. A implantação normalmente leva 5 minutos.

Quando for concluído, o cluster terá o componente instalador do Armazenamento de Contêiner do Azure instalado. A instalação do driver CSI é adiada até que você crie uma classe de armazenamento. Siga as instruções para criar uma classe de armazenamento NVMe local ou uma classe de armazenamento Elástico SAN .