Installare Archiviazione di Azure Container per l'uso con il Servizio Azure Kubernetes

Prerequisiti

• Se non si ha una sottoscrizione di Azure, creare un account gratuito prima di iniziare.

• Questo articolo richiede l'interfaccia della riga di comando di Azure versione 2.83.0 o successiva. Per ulteriori informazioni, vedere Come installare l'interfaccia della riga di comando di Azure. Disabilitare le estensioni, ad aks-preview esempio se si verificano problemi. Installare o aggiornare le estensioni in base alle esigenze:

  • az extension add --upgrade --name k8s-extension
  • az extension add --upgrade --name elastic-san (Elastic SAN solo)

• È necessario il client della riga di comando Kubernetes, kubectl. È già installato se si usa Azure Cloud Shell. È possibile installarlo in locale eseguendo il az aks install-cli comando .

• Controllare se l'area di destinazione è supportata nelle aree di Azure Container Storage.

• Pianificare la configurazione del pool di nodi:

  • Usare Linux come tipo di sistema operativo (Windows non è supportato).
  • Selezionare uno SKU di macchina virtuale (VM) che supporta dischi dati NVMe locali se si prevede di usare il tipo di archiviazione NVMe locale, ad esempio macchine virtuali ottimizzate per l'archiviazione o con accelerazione GPU .
  • Per i cluster esistenti, assicurati che i pool di nodi utilizzino già uno SKU di macchina virtuale supportato prima di abilitare Azure Container Storage.

• Se si usa Elastic SAN per la prima volta nella sottoscrizione, eseguire questo comando di registrazione monouso:

  az provider register --namespace Microsoft.ElasticSan
  

Impostare il contesto della sottoscrizione

Impostare il contesto della sottoscrizione di Azure usando il comando az account set. È possibile visualizzare gli ID sottoscrizione eseguendo az account list --output table. Sostituire <subscription-id> con l'ID della sottoscrizione.

az account set --subscription <subscription-id>

Creare un gruppo di risorse

Un gruppo di risorse di Azure è un contenitore logico per le risorse. Quando si crea un gruppo di risorse, si specifica una posizione. Tale posizione archivia i metadati del gruppo di risorse e funge da area predefinita per le risorse create senza un'area esplicita.

Per creare un gruppo di risorse, usare il comando az group create. Sostituire <resource-group-name> con il nome del gruppo di risorse e <location> con un'area di Azure, eastusad esempio , westus2westus3, o westeurope. Se si abilita Azure Container Storage su un cluster AKS esistente, utilizzare il gruppo di risorse che ospita già il cluster.

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

Se il gruppo di risorse viene creato correttamente, viene visualizzato un output simile a questo esempio:

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

Installare Azure Container Storage su un nuovo cluster di Azure Kubernetes Service (AKS)

Scegliere lo scenario corrispondente all'ambiente.

Installazione solo per installatore

Eseguire il comando seguente per creare un nuovo cluster AKS e installare Azure Container Storage. Sostituire <cluster-name> e <resource-group> con i propri valori e specificare il tipo di VM da usare.

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

La distribuzione può richiedere fino a 5 minuti. L'installazione del driver CSI viene posticipata fino a quando non si crea una classe di archiviazione o si abilita un tipo di archiviazione in un secondo momento.

Seguire le istruzioni per creare una classe di archiviazione NVMe locale o una classe di archiviazione SAN elastica .

Installazione del programma Installer e del tipo di installazione di archiviazione

Eseguire il comando seguente per creare un nuovo cluster AKS e installare Azure Container Storage. Sostituire <cluster-name> e <resource-group> con i propri valori e specificare il tipo di VM da usare.

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

Questo comando installa il programma di installazione, distribuisce il driver NVMe CSI locale e crea una classe di archiviazione predefinita denominata local-csi. È possibile installare e usare sia NVMe locale che SAN elastico fornendo un elenco, ephemeralDisk elasticSanad esempio .

Installare Azure Container Storage su un cluster AKS esistente

Installazione solo per installatore

Eseguire il comando seguente per abilitare Azure Container Storage su un cluster AKS esistente. Sostituire <cluster-name> e <resource-group> con valori personalizzati.

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

La distribuzione può richiedere fino a 5 minuti. Quando il processo si completa, il cluster ha installato il componente del programma di installazione di Archiviazione Azure Container. L'installazione del driver CSI viene posticipata fino a quando non si crea una classe di archiviazione o si abilita un tipo di archiviazione in un secondo momento. Seguire le istruzioni per creare una classe di archiviazione NVMe locale o una classe di archiviazione SAN elastica .

Installazione del programma Installer e del tipo di installazione di archiviazione

Eseguire il comando seguente per abilitare Azure Container Storage su un cluster AKS esistente. Sostituire <cluster-name> e <resource-group> con i propri valori e specificare il tipo di archiviazione da usare.

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

Questo comando installa il programma di installazione, distribuisce il driver ELASTIC SAN CSI e crea una classe di archiviazione predefinita denominata azuresan-csi. È possibile installare e usare sia NVMe locale che SAN elastico fornendo un elenco, ephemeralDisk elasticSanad esempio .

Installa un acceleratore distribuito per l'archiviazione cloud (anteprima)

Abilita l'acceleratore distribuito per lo storage cloud su un cluster AKS esistente utilizzando il distributedAccelerator valore. È richiesta la maiuscola A. L'estensione si installa sulla risorsa AKS managed cluster; non è necessario collegare il cluster tramite Arc.

Usa aks-preview la versione 22.0.0b9 o una successiva. Installa o aggiorna l'estensione, verifica la sua versione e installa o aggiorna connectedk8s e k8s-extension per gestire e ispezionare l'estensione 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

Prima di abilitare DACS, seleziona un pool di nodi Linux con dischi dati NVMe locali dedicati alla cache. Applica l'etichetta dacs.azure.com/processing-unit=cpu attraverso la configurazione del node-pool, preservando eventuali etichette personalizzate esistenti. Seguire la procedura Verificare il pool di nodi della cache.

Esegui il seguente comando, sostituendo <cluster-name> e <resource-group> con i tuoi valori:

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

Questo comando installa l'estensione distributedaccelerator , il controller DACS e il prerequisito NVMe DaemonSet in kube-system, e la caches.storage.azure.com definizione personalizzata della risorsa (CRD). Non installi un chart separato dei prerequisiti né gestisci tu stesso la release Helm dell'estensione. Non crea una StorageClass né provisiona una risorsa Cache e pod di server cache di default. L'installazione riuscita di un'estensione non significa da sola che una cache sia pronta per il traffico applicativo.

Specifica distributedAccelerator da solo in questo comando invece di combinarlo con le opzioni di archiviazione del volume persistente mostrate prima. Prima di provisionare i server cache, verifica che i prerequisiti gestiti siano pronti su ogni nodo della cache etichettato. Per la configurazione della cache e il flusso di lavoro dell'applicazione, vedere Introduzione all'acceleratore distribuito per l'archiviazione cloud nel servizio Azure Kubernetes.

Per rimuovere DACS, segui Rimuovere l'acceleratore distribuito per l'archiviazione cloud. Elimina le risorse della cache mentre il controller è in funzione, poi disabilita il DACS. La disabilitazione rimuove il controller e il prerequisito gestito DaemonSet; non rimuovere quei prerequisiti separatamente.

Prerequisiti

• Se non si ha una sottoscrizione di Azure, creare un account gratuito prima di iniziare.

• Questo articolo richiede l'interfaccia della riga di comando di Azure versione 2.83.0 o successiva. Per ulteriori informazioni, vedere Come installare l'interfaccia della riga di comando di Azure. Disabilitare le estensioni, ad aks-preview esempio se si verificano problemi. Installare o aggiornare le estensioni in base alle esigenze:

  • az extension add --upgrade --name k8s-extension
  • az extension add --upgrade --name elastic-san (Elastic SAN solo)

• È necessario il client della riga di comando Kubernetes, kubectl. È già installato se si usa Azure Cloud Shell. È possibile installarlo in locale eseguendo il az aks install-cli comando .

• Controllare se l'area di destinazione è supportata nelle aree di Azure Container Storage.

• Pianificare la configurazione del pool di nodi:

  • Usare Linux come tipo di sistema operativo (Windows non è supportato).
  • Selezionare uno SKU di macchina virtuale (VM) che supporta dischi dati NVMe locali, ad esempio macchine virtuali ottimizzate per l'archiviazione o con accelerazione GPU .
  • Per i cluster esistenti, assicurati che i pool di nodi utilizzino già uno SKU di macchina virtuale supportato prima di abilitare Azure Container Storage.

• Installare Terraform versione 1.5 o successiva e confermare l'installazione con terraform version. Terraform può riutilizzare l'autenticazione del CLI di Azure.

• Se si usa Elastic SAN per la prima volta nella sottoscrizione, eseguire questo comando di registrazione monouso:

  az provider register --namespace Microsoft.ElasticSan
  

Impostare il contesto della sottoscrizione

Terraform può determinare una sottoscrizione di Azure di destinazione tramite più metodi:

• subscription_id nel blocco del provider
• ARM_SUBSCRIPTION_ID variabile di ambiente
• Sottoscrizione predefinita di interfaccia della riga di comando di Azure
• Identità gestita (in esecuzione in Azure)

Per l'uso locale, impostare il contesto della CLI di Azure:

az account set --subscription <subscription-id>

Se si esegue la distribuzione con Terraform per la prima volta nella sottoscrizione, eseguire questo comando di registrazione monouso:

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

Installare Azure Container Storage su un nuovo cluster di Azure Kubernetes Service (AKS)

1. In una cartella di lavoro vuota, crea il file main.tf con la seguente configurazione minima di un cluster AKS. Aggiornare i nomi, le posizioni e le dimensioni delle macchine virtuali per soddisfare i requisiti.

   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. Inizializza la directory di lavoro per scaricare il provider AzureRM.

   terraform init
   

3. Esaminare le modifiche pianificate.

   terraform plan
   

4. Applicare la configurazione per creare il gruppo di risorse, il cluster AKS e l'estensione Azure Container Storage. La distribuzione richiede in genere 5 minuti.

   terraform apply
   

Quando il processo si completa, il cluster ha installato il componente del programma di installazione di Archiviazione Azure Container. L'installazione del driver CSI viene posticipata fino a quando non si crea una classe di archiviazione. Seguire le istruzioni per creare una classe di archiviazione NVMe locale o una classe di archiviazione SAN elastica .

Installare Azure Container Storage su un cluster AKS esistente

Se il tuo cluster AKS esiste già e viene gestito all'esterno di Terraform, è comunque possibile abilitare Azure Container Storage definendo solo la risorsa di estensione. Usare un'origine dati per cercare l'ID 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"
}

Eseguire terraform init (se si tratta di una nuova directory di lavoro) seguito da terraform apply per installare Azure Container Storage sul cluster di destinazione. La distribuzione richiede in genere 5 minuti.

Quando il processo si completa, il cluster ha installato il componente del programma di installazione di Archiviazione Azure Container. L'installazione del driver CSI viene posticipata fino a quando non si crea una classe di archiviazione. Seguire le istruzioni per creare una classe di archiviazione NVMe locale o una classe di archiviazione SAN elastica .