Skip to content

Commit 8399ac6

Browse files
committed
add manual upgrade command
1 parent e6554f8 commit 8399ac6

File tree

3 files changed

+25
-11
lines changed

3 files changed

+25
-11
lines changed

articles/storage/container-storage/container-storage-aks-quickstart.md

Lines changed: 8 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -1,10 +1,10 @@
11
---
2-
title: Quickstart for using Azure Container Storage with Azure Kubernetes Service (AKS)
2+
title: Quickstart for using Azure Container Storage with Azure Kubernetes Service
33
description: Connect to a Linux-based Azure Kubernetes Service (AKS) cluster, install Azure Container Storage, and create a storage pool.
44
author: khdownie
55
ms.service: azure-container-storage
66
ms.topic: quickstart
7-
ms.date: 07/23/2024
7+
ms.date: 07/24/2024
88
ms.author: kendownie
99
ms.custom: devx-track-azurecli, ignite-2023-container-storage, linux-related-content
1010
---
@@ -122,6 +122,12 @@ Follow these guidelines when choosing a VM type for the cluster nodes. You must
122122
123123
## Install Azure Container Storage on your AKS cluster
124124
125+
If you already have a preview instance of Azure Container Storage running on your cluster, you can skip this section. However, we recommend updating to the latest generally available (GA) version by running the following command. Remember to replace `<cluster-name>` and `<resource-group>` with your own values.
126+
127+
```azurecli-interactive
128+
az k8s-extension update --cluster-type managedClusters --cluster-name <cluster-name> --resource-group <resource-group> --name azurecontainerstorage --version 1.1.0 --auto-upgrade false --release-train stable
129+
```
130+
125131
If your AKS cluster meets the [VM requirements](#ensure-vm-type-for-your-cluster-meets-the-following-criteria), run the following command to install Azure Container Storage on the cluster and create a storage pool. Replace `<cluster-name>` and `<resource-group>` with your own values. Replace `<storage-pool-type>` with `azureDisk`, `ephemeralDisk`, or `elasticSan`. If you select `ephemeralDisk`, you can also specify `--storage-pool-option`, and the values can be `NVMe` or `Temp`.
126132

127133
Running this command will enable Azure Container Storage on the system node pool, which by default is named `nodepool1`\*. If you want to enable it on other node pools, see [Install Azure Container Storage on specific node pools](#install-azure-container-storage-on-specific-node-pools). If you want to specify additional storage pool parameters, see [this table](container-storage-faq.md#storage-pool-parameters).

articles/storage/container-storage/container-storage-faq.md

Lines changed: 15 additions & 7 deletions
Original file line numberDiff line numberDiff line change
@@ -1,9 +1,9 @@
11
---
2-
title: Frequently asked questions (FAQ) for Azure Container Storage
3-
description: Get answers to Azure Container Storage frequently asked questions.
2+
title: Frequently asked questions for Azure Container Storage
3+
description: Get answers to Azure Container Storage frequently asked questions (FAQ).
44
author: khdownie
55
ms.service: azure-container-storage
6-
ms.date: 07/09/2024
6+
ms.date: 07/24/2024
77
ms.author: kendownie
88
ms.topic: conceptual
99
ms.custom: references_regions
@@ -23,6 +23,18 @@ ms.custom: references_regions
2323
**In which Azure regions is Azure Container Storage available?**
2424
[!INCLUDE [container-storage-regions](../../../includes/container-storage-regions.md)]
2525

26+
* <a id="azure-container-storage-update"></a>
27+
**If I already have Azure Container Storage preview installed on my AKS cluster, how can I update to the latest GA version?**
28+
If you have auto-upgrade turned on, Azure Container Storage will update to the latest version automatically. If you don't have auto-upgrade turned on, we recommend updating to the latest generally available (GA) version by running the following command. Remember to replace `<cluster-name>` and `<resource-group>` with your own values.
29+
30+
```azurecli-interactive
31+
az k8s-extension update --cluster-type managedClusters --cluster-name <cluster-name> --resource-group <resource-group> --name azurecontainerstorage --version 1.1.0 --auto-upgrade false --release-train stable
32+
```
33+
34+
* <a id="azure-container-storage-autoupgrade"></a>
35+
**Is there any performance impact when upgrading to a new version of Azure Container Storage?**
36+
If you leave auto-upgrade turned on (recommended), you might experience temporary I/O latency during the upgrade process. If you turn off auto-upgrade and install the new version manually, there won't be any impact; however, you won't get the benefit of automatic upgrades and instant access to new features.
37+
2638
* <a id="storage-pool-parameters"></a>
2739
**What parameters can I specify for the storage pool that's created when Azure Container Storage is installed with the `az aks create` command?**
2840
Refer to [this article](container-storage-storage-pool-parameters.md) for the mandatory and optional storage pool parameters, along with their default values.
@@ -35,10 +47,6 @@ ms.custom: references_regions
3547
**Does Azure Container Storage support read-write-many (RWX) workloads?**
3648
Azure Container Storage doesn't support RWX workloads. However, Azure's first-party Files and Blob CSI drivers are great alternatives and fully supported.
3749

38-
* <a id="azure-container-storage-autoupgrade"></a>
39-
**Is there any performance impact when upgrading to a new version of Azure Container Storage?**
40-
If you leave autoupgrade turned on (recommended), you might experience temporary I/O latency during the upgrade process. If you turn off autoupgrade and install the new version manually, there won't be any impact; however, you won't get the benefit of automatic upgrades and instant access to new features.
41-
4250
* <a id="azure-container-storage-remove"></a>
4351
**How do I remove Azure Container Storage?**
4452
See [Remove Azure Container Storage](remove-container-storage.md).

articles/storage/container-storage/container-storage-introduction.md

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -4,7 +4,7 @@ description: An overview of Azure Container Storage, a service built natively fo
44
author: khdownie
55
ms.service: azure-container-storage
66
ms.topic: overview
7-
ms.date: 07/23/2024
7+
ms.date: 07/24/2024
88
ms.author: kendownie
99
ms.custom:
1010
- references_regions
@@ -17,7 +17,7 @@ Azure Container Storage is a cloud-based volume management, deployment, and orch
1717

1818
> [!IMPORTANT]
1919
> Azure Container Storage isn't available in all Azure regions. See [regional availability](#regional-availability).
20-
> Azure Container Storage is now generally available (GA) beginning with version 1.1.0. The GA version is recommended for production workloads. If you previously installed the Azure Container Storage preview and don't have autoupgrade enabled, be sure to update to the GA version.
20+
> Azure Container Storage is now generally available (GA) beginning with version 1.1.0. The GA version is recommended for production workloads. If you previously installed the Azure Container Storage preview and don't have auto-upgrade enabled, be sure to [update to the GA version](container-storage-aks-quickstart.md#install-azure-container-storage-on-your-aks-cluster).
2121
2222
To get started using Azure Container Storage, see [Use Azure Container Storage with Azure Kubernetes Service](container-storage-aks-quickstart.md) or watch the video.
2323

0 commit comments

Comments
 (0)