Disable automatic distribution of data across CSVs on AKS on Azure Stack HCI and Windows Server
Like every person is different, every Kubernetes cluster is different based on your use cases and requirements. To give you more flexibility and options in your Azure Kubernetes Service (AKS) on-premises deployment, you can now choose whether to enable or disable automatic distribution of your cluster data in the July 2022 update!
A year ago, we introduced automatic distribution of virtual machine data across multiple cluster shared volumes (CSVs). The cluster data was auto distributed in the cluster shared volumes through a round robin scheduling method. When data needed to be stored, AKS on-prem would check the CSVs one by one to see which was available to be used. For example, if the first CSV checked was not available, then AKS on-prem would move on to the next one until it found one that could be used. While this is perfectly fine for most deployment scenarios and helps build resiliency in case of storage outages, sometimes you may want to only have one dedicated CSV to store data in a particular cluster deployment. Before, there was no opt-out option for auto distribution but now, with the July release of AKS on-prem, you have the option of disabling auto distribution and selecting the CSV you would like to be used for all your deployment data!
To try out this new feature, it’s a few simple parameter changes in your set up. You can only turn off auto distribution on a new deployment, so the feature cannot changed existing deployment. After deployment of the AKS on-prem host, the setting cannot be changed. When you’re setting your host configurations with the `Set-AksHciConfig` command, use the new parameter `-createAutoConfigContainers` with the value `$false`. The default is to set the value as `$true`, so if you skip this step, auto distribution will happen by default. If ‘-createAutoConfigContainers’ is set to false, then the path that is specified in the parameter ‘-imageDir’ will be the only CSV that is used to store cluster data in your deployment.
Check out the example below of how `Set-AksHciConfig` would look with auto distribution disabled!
Set-AksHciConfig -createAutoConfigContainers $false -imageDir c:\ClusterStorage\Volume2\ImageStore -workingDir c:\ClusterStorage\Volume1\WorkDir -cloudConfigLocation c:\clusterstorage\volume1\Config -vnet $vnet -cloudservicecidr "172.16.10.10/16"
*This command is an example and assumes that you have already set your `-vnet` configurations. You can find more details about the new parameter on the Set-AksHciConfig PowerShell reference documentation.
And that’s all you need! Try out AKS on Azure Stack HCI and Window Server with this new feature through the links below!
Useful links:
Try for free: https://aka.ms/AKS-HCI-Evaluate
Tech Docs: https://aka.ms/AKS-HCI-Docs
Issues and Roadmap: https://github.com/azure/aks-hci
Evaluate on Azure: https://aka.ms/AKS-HCI-EvalOnAzure
Published on:
Learn moreRelated posts
Announcing: Dynamic Data Masking for Azure Cosmos DB (Preview)
Today marks a big step forward with the public preview of Dynamic Data Masking (DDM) for Azure Cosmos DB. This feature helps organizations pro...
Use Azure SRE Agent with Azure Cosmos DB: Smarter Diagnostics for Your Applications
We’re excited to announce the Azure Cosmos DB SRE Agent built on Azure SRE Agent; a new capability designed to simplify troubleshooting and im...
General Availability: Priority-Based Execution in Azure Cosmos DB
Have you ever faced a situation where two different workloads share the same container, and one ends up slowing down the other? This is a comm...
Announcing Preview of Online Copy Jobs in Azure Cosmos DB: Migrate Data with Minimal Downtime!
We are excited to announce the preview of Online Copy Jobs, a powerful new feature designed to make data migration between containers seamless...
Azure Developer CLI (azd) Nov 2025 – Container Apps (GA), Layered Provisioning (Beta), Extension Framework, and Aspire 13
This post announces the November release of the Azure Developer CLI (`azd`). The post Azure Developer CLI (azd) Nov 2025 – Container App...
Announced at Ignite 2025: Azure DocumentDB, MCP Toolkit, Fleet Analytics, and more!
Microsoft Ignite 2025 kicked off with a wave of announcements for Azure Cosmos DB and Azure DocumentDB, setting the tone for a week of innovat...
Automating Microsoft Fabric Workspace Creation with Azure DevOps Pipelines
In today’s fast-paced analytics landscape, Microsoft Fabric has become the leader of enterprise BI implementations, one of the fundamental con...
New T-SQL AI Features are now in Public Preview for Azure SQL and SQL database in Microsoft Fabric
At the start of this year, we released a new set of T-SQL AI features for embedding your relational data for AI applications. Today, we have b...