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

Pré-requisitos

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

• Este artigo requer a versão v2.83.0 do CLI do Azure ou posterior. Para obter mais informações, consulte Como instalar a CLI do Azure. Desative extensões, por exemplo, aks-preview caso ocorram problemas. Instale ou atualize extensões conforme necessário:

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

• Você precisa do cliente de linha de comando Kubernetes, kubectl. Já está instalado se estiveres a usar Azure Cloud Shell. Você pode instalá-lo localmente executando o az aks install-cli comando.

• Verifique se a sua região-alvo é suportada nas regiões de Armazenamento de Contêiner da Azure.

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

  • Usa Linux como tipo de sistema operativo (o Windows não é suportado).
  • Selecione um SKU de máquina virtual (VM) que suporte discos de dados NVMe locais se planeia usar o tipo de armazenamento NVMe local, como VMs otimizadas para armazenamento ou aceleradas por GPU .
  • Para clusters existentes, certifique-se de que os pools de nós já utilizam um SKU de VM suportado antes de ativar o Azure Container Storage.

• Se usar o Elastic SAN pela primeira vez na subscrição, execute este comando de registo único:

  az provider register --namespace Microsoft.ElasticSan
  

Definir contexto de subscrição

Defina seu contexto de assinatura do Azure usando o az account set comando. Pode visualizar os IDs de subscrição ao executar az account list --output table. Substitua <subscription-id> pelo seu ID de subscrição.

az account set --subscription <subscription-id>

Criar um grupo de recursos

Um grupo de recursos Azure é um contentor lógico para recursos. Quando crias um grupo de recursos, especificas uma localização. Essa localização armazena metadados do grupo de recursos e serve como a região padrão para os recursos que crias sem uma região explícita.

Criar um grupo de recursos com az group create. Substitua <resource-group-name> pelo nome do seu grupo de recursos e <location> por uma região Azure como eastus, westus2, westus3, ou westeurope. Se ativares o Azure Container Storage num cluster AKS existente, usa 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 Azure Container Storage num novo cluster AKS

Escolha o cenário que corresponde ao seu ambiente.

Instalação apenas para instaladores

Execute o seguinte comando para criar um novo cluster AKS e instalar o Armazenamento de Contêineres do Azure. Substitua <cluster-name> e <resource-group> por 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

O desdobramento pode demorar até 5 minutos. A instalação do driver CSI é adiada até criar uma classe de armazenamento ou ativar um tipo de armazenamento mais tarde.

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

Instalador + instalação tipo de armazenamento

Execute o seguinte comando para criar um novo cluster AKS e instalar o Armazenamento de Contêineres do Azure. Substitua <cluster-name> e <resource-group> por 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

Este comando instala o instalador, implementa o driver local NVMe CSI e cria uma classe de armazenamento padrão chamada local-csi. Pode instalar e usar tanto o NVMe local como o Elastic SAN fornecendo uma lista como ephemeralDisk elasticSan.

Instale o Azure Container Storage num cluster AKS existente

Instalação apenas para instaladores

Execute o seguinte comando para habilitar o Armazenamento de Contêiner do Azure em um cluster 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

O desdobramento pode demorar até 5 minutos. Quando termina, o cluster tem instalado o componente instalador Azure Container Storage. A instalação do driver CSI é adiada até criar uma classe de armazenamento ou ativar um tipo de armazenamento mais tarde. Siga as instruções para criar uma classe de armazenamento NVMe local ou uma classe de armazenamento Elastic SAN .

Instalador + instalação tipo de armazenamento

Execute o seguinte comando para habilitar o Armazenamento de Contêiner do Azure em um cluster AKS existente. Substitua <cluster-name>, <resource-group> com os seus próprios valores, e especifique quais tipos de armazenamento quer usar.

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

Este comando instala o instalador, implementa o driver Elastic SAN CSI e cria uma classe de armazenamento padrão chamada azuresan-csi. Pode instalar e usar tanto o NVMe local como o Elastic SAN fornecendo uma lista como ephemeralDisk elasticSan.

Instalar o acelerador distribuído para armazenamento na cloud (pré-visualização)

Ative a aceleração distribuída para armazenamento na cloud num cluster do AKS existente, utilizando o valor distributedAccelerator. A maiúscula A é obrigatória. A extensão instala-se no recurso de cluster gerido do AKS; não precisas de ligar o cluster ao Arc.

Utilize aks-preview a versão 22.0.0b9 ou posterior. Instalar ou atualizar a extensão, verificar a sua versão, instalar ou atualizar connectedk8s e k8s-extension para gerir 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 à cache. Aplique a etiqueta dacs.azure.com/processing-unit=cpu através da configuração de node-pool, preservando quaisquer etiquetas personalizadas existentes. Siga Verificar o pool de nós da cache.

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

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

Este 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 de recurso personalizada (CRD). Não instalas um quadro de pré-requisitos separado nem geres tu próprio a versão Helm da extensão. Por defeito, não cria uma StorageClass nem provisiona um recurso de cache e pods de servidor de cache. A instalação bem-sucedida de extensões não significa por si só que uma cache esteja pronta para tráfego de aplicações.

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

Para remover DACS, siga Remover acelerador distribuído para armazenamento na cloud. Apagar recursos de cache enquanto o controlador está a funcionar e depois desativar o DACS. A desativação remove o controlador e o pré-requisito gerido DaemonSet; não removas esses pré-requisitos separadamente.

Pré-requisitos

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

• Este artigo requer a versão v2.83.0 do CLI do Azure ou posterior. Para obter mais informações, consulte Como instalar a CLI do Azure. Desative extensões, por exemplo, aks-preview caso ocorram problemas. Instale ou atualize extensões conforme necessário:

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

• Você precisa do cliente de linha de comando Kubernetes, kubectl. Já está instalado se estiveres a usar Azure Cloud Shell. Você pode instalá-lo localmente executando o az aks install-cli comando.

• Verifique se a sua região-alvo é suportada nas regiões de Armazenamento de Contêiner da Azure.

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

  • Usa Linux como tipo de sistema operativo (o Windows não é suportado).
  • Selecione um SKU de máquina virtual (VM) que suporte discos de dados NVMe locais, como VMs otimizadas para armazenamento ou aceleradas por GPU .
  • Para clusters existentes, certifique-se de que os pools de nós já utilizam um SKU de VM suportado antes de ativar o Azure Container Storage.

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

• Se usar o Elastic SAN pela primeira vez na subscrição, execute este comando de registo único:

  az provider register --namespace Microsoft.ElasticSan
  

Definir contexto de subscrição

O Terraform pode determinar uma subscrição alvo do Azure através de vários métodos:

• subscription_id no bloco de fornecedores
• ARM_SUBSCRIPTION_ID variável de ambiente
• CLI do Azure subscrição predefinida
• Identidade gerida (quando em execução no Azure)

Para uso local, defina o contexto CLI do Azure:

az account set --subscription <subscription-id>

Se implementares com o Terraform pela primeira vez na subscrição, executa este comando de registo ú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 Azure Container Storage num novo cluster AKS

1. Num diretório de trabalho vazio, crie um main.tf ficheiro com a seguinte configuração mínima de um cluster AKS. Atualize os nomes dos recursos, localizações e tamanhos das VMs para satisfazer os seus 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. Inicialize o diretório de trabalho para descarregar o fornecedor AzureRM.

   terraform init
   

3. Revê as alterações planeadas.

   terraform plan
   

4. Aplique a configuração para criar o grupo de recursos, o cluster AKS e a extensão Azure Container Storage. O destacamento normalmente demora 5 minutos.

   terraform apply
   

Quando termina, o cluster tem instalado o componente instalador Azure Container Storage. A instalação do driver CSI é adiada até criares uma classe de armazenamento. Siga as instruções para criar uma classe de armazenamento NVMe local ou uma classe de armazenamento Elastic SAN .

Instale o Azure Container Storage num cluster AKS existente

Se o seu cluster AKS já existir e o gerir fora do Terraform, ainda pode ativar o Azure Container Storage ao criar apenas o recurso de extensão. Use uma fonte de dados para consultar o 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 for um novo diretório de trabalho) seguido de terraform apply instalar o Azure Container Storage no cluster alvo. O destacamento normalmente demora 5 minutos.

Quando termina, o cluster tem instalado o componente instalador Azure Container Storage. A instalação do driver CSI é adiada até criares uma classe de armazenamento. Siga as instruções para criar uma classe de armazenamento NVMe local ou uma classe de armazenamento Elastic SAN .