Remarque
L’accès à cette page nécessite une autorisation. Vous pouvez essayer de vous connecter ou de modifier des répertoires.
L’accès à cette page nécessite une autorisation. Vous pouvez essayer de modifier des répertoires.
Azure Container Storage est un service de gestion, de déploiement et d’orchestration basés sur le cloud conçu pour les conteneurs. Utilisez ce tutoriel pour installer la dernière version de production d’Azure Container Storage sur un cluster Azure Kubernetes Service (AKS), que vous créez un cluster ou activez le service sur un cluster existant.
Cet article explique comment installer Azure Container Storage en utilisant deux flux pris en charge (programme d’installation seul ou programme d’installation + fonctionnalité), comment l’installation des composants est déclenchée, et comment vérifier et dépanner votre déploiement. Les types de stockage de volumes persistants installent des pilotes qui implémentent l’interface Container Storage Interface (CSI). Azure Container Storage peut également activer et gérer un accélérateur distribué pour le stockage cloud (DACS), qui installe une extension distincte et ne crée pas de StorageClass.
Si vous préférez la version open source d’Azure Container Storage, consultez le référentiel local-csi-driver pour obtenir d’autres instructions d’installation.
À la fin de ce tutoriel, vous pouvez :
- Préparer votre environnement Azure CLI
- Créer ou sélectionner un groupe de ressources pour votre cluster
- Vérifiez que les types de machines virtuelles de votre pool de nœuds répondent aux critères d’installation
- Installer Azure Container Storage en créant un cluster AKS ou en l’activant sur un cluster existant
Important
Cet article s’applique au stockage conteneur Azure (version 2.x.x). Pour les versions antérieures, consultez la documentation stockage de conteneurs Azure (version 1.x.x). Si azure Container Storage (version 1.x.x) est déjà installé sur votre cluster AKS, supprimez-le en suivant ces étapes.
Prérequis
Si vous n’avez pas d’abonnement Azure, créez un compte gratuit avant de commencer.
Cet article nécessite Azure CLI version v2.83.0 ou ultérieure. Pour plus d’informations, consultez Comment installer Azure CLI. Désactivez les extensions telles que
aks-previewsi des problèmes se produisent. Installez ou mettez à jour les extensions si nécessaire :az extension add --upgrade --name k8s-extension-
az extension add --upgrade --name elastic-san(SAN élastique uniquement)
Vous avez besoin du client de ligne de commande Kubernetes.
kubectlElle est déjà installée si vous utilisez Azure Cloud Shell. Vous pouvez l’installer localement en exécutant laaz aks install-clicommande.Vérifiez si votre région cible est prise en charge dans Les régions de stockage de conteneurs Azure.
Planifiez la configuration de votre pool de nœuds :
- Utilisez Linux comme type de système d’exploitation (Windows n’est pas pris en charge).
- Sélectionnez une référence SKU de machine virtuelle qui prend en charge les disques de données NVMe locaux si vous envisagez d’utiliser le type de stockage NVMe local, tel que les machines virtuelles optimisées pour le stockage ou les machines virtuelles accélérées par GPU .
- Pour les clusters existants, vérifiez que les pools de nœuds utilisent déjà une référence SKU de machine virtuelle prise en charge avant d’activer Le stockage de conteneurs Azure.
Si vous utilisez elastic SAN pour la première fois dans l’abonnement, exécutez cette commande d’inscription unique :
az provider register --namespace Microsoft.ElasticSan
Définir le contexte de l’abonnement
Définissez le contexte de votre abonnement Azure à l’aide de la commande az account set. Vous pouvez afficher les ID d’abonnement en exécutant az account list --output table. Remplacez <subscription-id> par votre ID d’abonnement.
az account set --subscription <subscription-id>
Créer un groupe de ressources
Un groupe de ressources Azure est un conteneur logique pour les ressources. Lorsque vous créez un groupe de ressources, vous spécifiez un emplacement. Cet emplacement stocke les métadonnées du groupe de ressources et sert de région par défaut pour les ressources que vous créez sans région explicite.
Créez un groupe de ressources avec az group create. Remplacez <resource-group-name> par le nom de votre groupe de ressources et <location> par une région Azure telle que eastus, , westus2ou westus3westeurope. Si vous activez Azure Container Storage sur un cluster AKS existant, utilisez le groupe de ressources qui héberge déjà le cluster.
az group create --name <resource-group-name> --location <location>
Si le groupe de ressources est créé avec succès, vous voyez une sortie similaire à cet exemple :
{
"id": "/subscriptions/<guid>/resourceGroups/myContainerStorageRG",
"location": "eastus",
"managedBy": null,
"name": "myContainerStorageRG",
"properties": {
"provisioningState": "Succeeded"
},
"tags": null
}
Installer Azure Container Storage sur un nouveau cluster AKS
Choisissez le scénario qui correspond à votre environnement.
Important
Azure Container Storage installe la dernière version principale par défaut. Vous pouvez épingler une version majeure avec --container-storage-version. Vous ne pouvez pas épingler des versions mineures ou correctives.
Installation propre à l'installateur
Exécutez la commande suivante pour créer un cluster AKS et installer Azure Container Storage. Remplacez <cluster-name> et <resource-group> par vos propres valeurs et spécifiez le type de machine virtuelle que vous souhaitez utiliser.
az aks create -n <cluster-name> -g <resource-group> --node-vm-size Standard_L8s_v3 --enable-azure-container-storage --generate-ssh-keys
Le déploiement peut prendre jusqu’à 5 minutes. L’installation du pilote CSI est différée jusqu’à ce que vous créiez une classe de stockage ou activez un type de stockage ultérieurement.
Suivez les instructions pour créer une classe de stockage NVMe locale ou une classe de stockage SAN élastique .
Programme d'installation + installation de type de stockage
Exécutez la commande suivante pour créer un cluster AKS et installer Azure Container Storage. Remplacez <cluster-name> et <resource-group> par vos propres valeurs et spécifiez le type de machine virtuelle que vous souhaitez utiliser.
az aks create -n <cluster-name> -g <resource-group> --node-vm-size Standard_L8s_v3 --enable-azure-container-storage ephemeralDisk --generate-ssh-keys
Cette commande installe le programme d’installation, déploie le pilote CSI NVMe local et crée une classe de stockage par défaut appelée local-csi. Vous pouvez installer et utiliser NVMe local et Elastic SAN en fournissant une liste telle que ephemeralDisk elasticSan.
Installer Azure Container Storage sur un cluster AKS existant
Installation propre à l'installateur
Exécutez la commande suivante pour activer Azure Container Storage sur un cluster AKS existant. Remplacez <cluster-name> et <resource-group> par vos propres valeurs.
az aks update -n <cluster-name> -g <resource-group> --enable-azure-container-storage
Le déploiement peut prendre jusqu’à 5 minutes. Une fois l’opération terminée, le cluster dispose du composant d’installation du stockage conteneur Azure installé. L’installation du pilote CSI est différée jusqu’à ce que vous créiez une classe de stockage ou activez un type de stockage ultérieurement. Suivez les instructions pour créer une classe de stockage NVMe locale ou une classe de stockage SAN élastique .
Programme d'installation + installation de type de stockage
Exécutez la commande suivante pour activer Azure Container Storage sur un cluster AKS existant. Remplacez <cluster-name> et <resource-group> par vos propres valeurs, et spécifiez quel type de stockage vous souhaitez utiliser.
az aks update -n <cluster-name> -g <resource-group> --enable-azure-container-storage elasticSan
Cette commande installe le programme d’installation, déploie le pilote CSI ELASTIC SAN et crée une classe de stockage par défaut appelée azuresan-csi. Vous pouvez installer et utiliser NVMe local et Elastic SAN en fournissant une liste telle que ephemeralDisk elasticSan.
Installer un accélérateur distribué pour le stockage cloud (aperçu)
Activez l’accélérateur distribué pour le stockage cloud sur un cluster AKS existant en utilisant la valeur distributedAccelerator. La majuscule A est obligatoire. L’extension s’installe sur la ressource de cluster managé AKS ; vous n’avez pas besoin de connecter le cluster par Arc.
Utilisez aks-preview la version 22.0.0b9 ou une version ultérieure. Installez ou mettez à niveau l’extension, vérifiez sa version, puis installez ou mettez à niveau connectedk8s et k8s-extension pour gérer et inspecter l’extension 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
Avant d’activer le DACS, sélectionnez un pool de nœuds Linux avec des disques de données NVMe locaux dédiés au cache. Appliquez l’étiquette dacs.azure.com/processing-unit=cpu via la configuration du pool de nœuds, en préservant les étiquettes personnalisées existantes. Suivez les instructions de la section Vérifier le pool de nœuds du cache.
Caution
L’activation du DACS installe un DaemonSet préalable qui découvre, formate et monte les disques NVMe locaux sur des nœuds de cache étiquetés. Étiquetez uniquement les nœuds avec des disques qui ne sont pas revendiqués par un autre composant de stockage.
Exécutez la commande suivante, en remplaçant <cluster-name> et <resource-group> avec vos valeurs :
az aks update \
--name <cluster-name> \
--resource-group <resource-group> \
--enable-azure-container-storage distributedAccelerator
Cette commande installe l’extension distributedaccelerator , le contrôleur DACS et le prérequis NVMe DaemonSet dans kube-system, ainsi que la caches.storage.azure.com définition personnalisée des ressources (CRD). Vous n’installez pas un chart de prérequis séparé ni ne gérez vous-même la release Helm de l’extension. Il ne crée pas de StorageClass ni ne provisionne par défaut une ressource de cache et des pods de serveur cache. L’installation réussie de l’extension ne garantit pas, à elle seule, que le cache est prêt à traiter le trafic des applications.
Passe distributedAccelerator seul dans cette commande plutôt que de le combiner avec les options de stockage à volumes persistants montrées précédemment. Avant de provisionner des serveurs cache, vérifiez que les prérequis gérés sont prêts sur chaque nœud de cache identifié. Pour la configuration du cache et le flux de travail applicatif, voir Démarrer avec un accélérateur distribué pour le stockage cloud sur AKS.
Pour supprimer les DACS, suivez les instructions de Supprimer l’accélérateur distribué pour le stockage cloud. Supprime les ressources du cache pendant que le contrôleur tourne, puis désactive le DACS. La désactivation supprime le contrôleur et le prérequis géré DaemonSet ; ne supprimez pas ces prérequis séparément.
- Préparer Terraform et s’authentifier auprès d’Azure
- Définir votre groupe de ressources et la configuration du cluster AKS
- Vérifiez que les types de machines virtuelles de votre pool de nœuds répondent aux critères d’installation
- Appliquer Terraform pour déployer Azure Container Storage ou l’activer sur un cluster existant
Important
Cet article s’applique au stockage conteneur Azure (version 2.x.x). Pour les versions antérieures, consultez la documentation stockage de conteneurs Azure (version 1.x.x). Si azure Container Storage (version 1.x.x) est déjà installé sur votre cluster AKS, supprimez-le en suivant ces étapes.
Prérequis
Si vous n’avez pas d’abonnement Azure, créez un compte gratuit avant de commencer.
Cet article nécessite Azure CLI version v2.83.0 ou ultérieure. Pour plus d’informations, consultez Comment installer Azure CLI. Désactivez les extensions telles que
aks-previewsi des problèmes se produisent. Installez ou mettez à jour les extensions si nécessaire :az extension add --upgrade --name k8s-extension-
az extension add --upgrade --name elastic-san(SAN élastique uniquement)
Vous avez besoin du client de ligne de commande Kubernetes.
kubectlElle est déjà installée si vous utilisez Azure Cloud Shell. Vous pouvez l’installer localement en exécutant laaz aks install-clicommande.Vérifiez si votre région cible est prise en charge dans Les régions de stockage de conteneurs Azure.
Planifiez la configuration de votre pool de nœuds :
- Utilisez Linux comme type de système d’exploitation (Windows n’est pas pris en charge).
- Sélectionnez une référence SKU de machine virtuelle qui prend en charge les disques de données NVMe locaux, tels que les machines virtuelles optimisées pour le stockage ou les machines virtuelles accélérées par GPU .
- Pour les clusters existants, vérifiez que les pools de nœuds utilisent déjà une référence SKU de machine virtuelle prise en charge avant d’activer Le stockage de conteneurs Azure.
Installez Terraform version 1.5 ou ultérieure et confirmez l’installation avec
terraform version. Terraform peut réutiliser votre authentification Azure CLI.Si vous utilisez elastic SAN pour la première fois dans l’abonnement, exécutez cette commande d’inscription unique :
az provider register --namespace Microsoft.ElasticSan
Définir le contexte de l’abonnement
Terraform peut déterminer un abonnement Azure cible via plusieurs méthodes :
-
subscription_iddans le bloc du fournisseur - Variable d’environnement
ARM_SUBSCRIPTION_ID - Abonnement Azure CLI par défaut
- Identité managée (lors de l’exécution dans Azure)
Pour une utilisation locale, définissez le contexte Azure CLI :
az account set --subscription <subscription-id>
Si vous effectuez un déploiement avec Terraform pour la première fois dans l’abonnement, exécutez cette commande d’inscription unique :
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
Installer Azure Container Storage sur un nouveau cluster AKS
Important
Azure Container Storage installe automatiquement la dernière version disponible et se met à jour automatiquement. La sélection manuelle de version n’est pas prise en charge.
Dans un répertoire de travail vide, créez un
main.tffichier avec la configuration minimale suivante d’un cluster AKS. Mettez à jour les noms de ressources, les emplacements et les tailles de machine virtuelle pour répondre à vos besoins.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" }Initialisez le répertoire de travail pour télécharger le fournisseur AzureRM.
terraform initPassez en revue les modifications planifiées.
terraform planAppliquez la configuration pour créer le groupe de ressources, le cluster AKS et l’extension Stockage conteneur Azure. Le déploiement prend généralement 5 minutes.
terraform apply
Une fois l’opération terminée, le cluster dispose du composant d’installation du stockage conteneur Azure installé. L’installation du pilote CSI est différée jusqu’à ce que vous créiez une classe de stockage. Suivez les instructions pour créer une classe de stockage NVMe locale ou une classe de stockage SAN élastique .
Installer Azure Container Storage sur un cluster AKS existant
Si votre cluster AKS existe déjà et que vous le gérez en dehors de Terraform, vous pouvez toujours activer Azure Container Storage en créant uniquement la ressource d’extension. Utilisez une source de données pour rechercher l’ID de 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"
}
Exécutez terraform init (s’il s’agit d’un nouveau répertoire de travail) suivi de terraform apply l’installation d’Azure Container Storage sur le cluster ciblé. Le déploiement prend généralement 5 minutes.
Une fois l’opération terminée, le cluster dispose du composant d’installation du stockage conteneur Azure installé. L’installation du pilote CSI est différée jusqu’à ce que vous créiez une classe de stockage. Suivez les instructions pour créer une classe de stockage NVMe locale ou une classe de stockage SAN élastique .
Vérifier l’installation
Se connecter au cluster AKS
Avant d’exécuter les commandes de vérification, vérifiez que votre kubeconfig local est défini sur le cluster cible :
az aks get-credentials --resource-group <resource-group-name> --name <cluster-name>
Si vous gérez plusieurs clusters, ajoutez --overwrite-existing pour remplacer un contexte existant ou utilisez-le --context pour définir un nom de contexte unique.
Vérifier le programme d’installation (mode installer uniquement)
Après une activation effectuée uniquement par le programme d’installation, vérifiez que celui-ci est bien présent :
kubectl get deploy -n kube-system | grep acstor
Sortie attendue :
acstor-cluster-manager 2/2 2 2 4d9h
acstor-geneva 2/2 2 2 4d9h
Vérifier l’accélérateur distribué pour le stockage cloud
Pour une installation DACS, vérifiez l’extension plutôt que de chercher une StorageClass :
az k8s-extension show \
--cluster-type managedClusters \
--cluster-name <cluster-name> \
--resource-group <resource-group> \
--name distributedaccelerator \
--query '{extensionType:extensionType,provisioningState:provisioningState,currentVersion:currentVersion,releaseTrain:releaseTrain}' \
--output table
Confirmez que le type d’extension est microsoft.distributedaccelerator et que son état de provisionnement est Succeeded. Le currentVersion champ affiche la version installée. Le nom de la ressource d’extension est minuscule distributedaccelerator, contrairement à l’option distributedAcceleratorde stockage de la CLI .
Après la connexion au cluster, vérifiez le contrôleur, le DaemonSet préalable et le CRD :
kubectl rollout status deployment/dacs-manager --namespace kube-system --timeout=5m
kubectl get deployment dacs-manager --namespace kube-system
kubectl rollout status daemonset/dacs-prereq --namespace kube-system --timeout=10m
kubectl get daemonset dacs-prereq --namespace kube-system
kubectl get pods --namespace kube-system --selector app.kubernetes.io/name=dacs-prereq --output wide
kubectl get crd caches.storage.azure.com
Continuer seulement après que l’extension soit dans cet Succeeded état, que le contrôleur ait une réplique prête, et que le DaemonSet prérequis ait un pod Ready sur chaque nœud de cache identifié. Un DaemonSet sans aucune réplique désirée ne vérifie pas la préparation au NVMe. Si une vérification échoue, voir Dépannage de l’accélérateur distribué pour le stockage cloud.
Les étapes de vérification de la classe de stockage et des pilotes CSI qui suivent s’appliquent aux types de stockage à volumes persistants, et non aux DACS.
Vérifier la présence de la classe de stockage
Après avoir créé une classe de stockage ou activé un type de stockage, vérifiez la classe de stockage :
kubectl get sc
Exemple de sortie :
NAME PROVISIONER RECLAIMPOLICY VOLUMEBINDINGMODE ALLOWVOLUMEEXPANSION AGE
azuresan-csi san.csi.azure.com Delete Immediate false 4d7h
local-csi localdisk.csi.acstor.io Delete WaitForFirstConsumer true 4d5h
Vérification de l’installation du pilote
Vérifiez les composants attendus après la création de la classe de stockage ou l’installation du type de stockage :
kubectl get pod -n kube-system | grep acstor
Exemple de sortie :
pod/acstor-azuresan-csi-driver-jrqd2 7/7 Running 0 142m
pod/acstor-azuresan-csi-driver-tcdp8 7/7 Running 0 142m
pod/acstor-cluster-manager-76c67496f9-8ln5d 2/2 Running 0 3h54m
pod/acstor-cluster-manager-76c67496f9-b4c8q 2/2 Running 0 3h54m
pod/acstor-geneva-588bcbcc67-4tr5d 3/3 Running 0 3h54m
pod/acstor-geneva-588bcbcc67-k7j7k 3/3 Running 0 3h54m
pod/acstor-node-agent-46v47 1/1 Running 0 142m
pod/acstor-node-agent-6c99m 1/1 Running 0 142m
pod/acstor-otel-collector-4lfgz 1/1 Running 0 142m
pod/acstor-otel-collector-hw9nd 1/1 Running 0 142m
Débogage
À des fins de débogage, surveillez le système pendant le déploiement des composants :
kubectl get events -n kube-system --watch
kubectl get pod -n kube-system --watch
Inspectez les ressources personnalisées HelmRelease et OCIRepository utilisées par le programme d’installation :
kubectl describe helmreleases.helm.installer.acstor.io -n kube-system
kubectl describe ocirepositories.source.installer.acstor.io -n kube-system
Étapes suivantes
- Utiliser Azure Container Storage avec NVMe local
- Utiliser le stockage de conteneurs Azure avec un SAN élastique
- Commencez avec l’accélérateur distribué pour le stockage cloud sur AKS (aperçu)
- Vue d’ensemble du déploiement d’une base de données PostgreSQL hautement disponible sur Azure Kubernetes Service (AKS)
- Foire aux questions (FAQ) sur le stockage de conteneurs Azure