你当前正在访问 Microsoft Azure Global Edition 技术文档网站。如果需要访问由世纪互联运营的 Microsoft Azure 中国技术文档网站，请访问 https://docs.azure.cn。

安装由 Azure Arc Edge Volumes 启用的 Azure 容器存储

2025-09-30

本文介绍安装 Azure 容器存储扩展的步骤。

安装证书和信任管理器

Azure 容器存储依赖于 cert-manager 和 trust-manager。可以自带，也可以将这些扩展作为平台扩展提供，可以使用以下命令进行安装：

az k8s-extension create --cluster-name "${YOUR-CLUSTER-NAME}" --name "${NAME}-certmgr" --resource-group "${YOUR-RESOURCE-GROUP}" --cluster-type connectedClusters --extension-type microsoft.iotoperations.platform --scope cluster --release-namespace cert-manager --release-train preview

注释

此平台扩展由 Azure IoT Operations 提供，但安装平台扩展不会在设备上安装 Azure IoT Operations。

安装由 Azure Arc 扩展启用的 Azure 容器存储

使用以下命令安装 Azure 容器存储扩展：

az k8s-extension create --resource-group "${YOUR-RESOURCE-GROUP}" --cluster-name "${YOUR-CLUSTER-NAME}" --cluster-type connectedClusters --name azure-arc-containerstorage --extension-type microsoft.arc.containerstorage

注释

默认情况下，--release-namespace 参数设置为 azure-arc-containerstorage。如果要覆盖此设置，请将 --release-namespace 标志添加到以下命令中，并用您的详细信息填充命令。在安装时设置的任何值都会在整个安装生存期内保留（包括手动和自动升级）。

重要

如果使用 OneLake，则必须为命令中的--name变量使用唯一的扩展名称az k8s-extension create。

配置操作器

配置 CRD

Azure 容器存储扩展使用 Kubernetes 中的自定义资源定义（CRD）来配置存储服务。在 Kubernetes 群集上发布此 CRD 之前，Azure 容器存储扩展处于休眠状态，并且使用最少的资源。使用配置选项应用 CRD 后，将部署相应的存储类、CSI 驱动程序和服务 POD 来提供服务。通过这种方式，可以自定义 Azure 容器存储以满足你的需求，并且可以重新配置它，而无需重新安装 Arc Kubernetes 扩展。此处包含常见配置，但此 CRD 提供了为具有不同存储功能的 Kubernetes 群集配置非标准配置的功能。

具有 Ubuntu 或 Edge Essentials 的单节点或双节点群集

如果使用 Ubuntu 或 Edge Essentials 运行单节点或双节点群集，请按照以下说明作：

创建包含以下内容的名为 edgeConfig.yaml 的文件：

apiVersion: arccontainerstorage.azure.net/v1
kind: EdgeStorageConfiguration
metadata:
  name: edge-storage-configuration
spec:
  defaultDiskStorageClasses:
    - "default"
    - "local-path"

若要应用此 .yaml 文件，请运行：
```
kubectl apply -f "edgeConfig.yaml"
```

具有 Ubuntu 或 Edge Essentials 的多节点群集

Azure 容器存储包含一个组件 ACStor，它提供给 Azure 容器存储一个弹性的只读写接口。在具有三个或多个节点的群集上，此组件提供跨节点的数据复制。若要使用此功能，必须在单独的装入点上配置一个或多个备用磁盘，以便 ACStor 使用。如果使用 Ubuntu 或 Edge Essentials 运行三个或多个节点 Kubernetes 群集，请按照以下说明作：

Azure 容器存储未设置为直接使用磁盘，而是要求将其配置为装入点。若要将原始磁盘设置为装入点，请按如下所示配置磁盘：
```
fdisk /dev/sd3 
mkfs.ext4 /dev/sd3a 
mkdir /acsa 
mount /dev/sd3a /acsa
```
这会设置备用系统磁盘sd3，其中配置了可供 sd3a ACStor 使用的磁盘分区/acsa。
创建包含以下内容的名为 edgeConfig.yaml 的文件：

注释

若要将存储重新定位到磁盘上的其他位置，请使用所需的路径进行更新 diskMountPoint 。除非在 DNds VM 上部署，应避免 /mnt 作为所需路径。
```
apiVersion: arccontainerstorage.azure.net/v1
kind: EdgeStorageConfiguration
metadata:
  name: edge-storage-configuration
spec:
  defaultDiskStorageClasses:
    - acstor-arccontainerstorage-storage-pool
---
apiVersion: arccontainerstorage.azure.net/v1
kind: ACStorConfiguration
metadata:
  name: acstor-configuration
spec:
  diskMountPoint: /acsa
  diskCapacity: 10Gi
  createStoragePool:
    enabled: true
    replicas: 3
```
该 spec.diskCapacity 参数确定为 Azure 容器存储分配的磁盘空间量以利用。此示例中为 10 GB ，但可以修改以满足你的需求。在此示例中，将其设置为 10GB 意味着在复制的每个磁盘（由 spec.createStoragePool.replicas 参数控制）上占用 10GB，在本例中为 3 或 30GB。这是本地共享卷和云引入卷要从中运行的池，因此请务必确保已适当调整此池的大小，因为当前无法增大该池。
若要应用此 .yaml 文件，请运行：
```
kubectl apply -f "edgeConfig.yaml"
```

已启用 Arc 的 AKS 或 AKS Arc

如果运行 Arc 启用的 AKS 或 启用了 Arc 的 AKS 的单节点或多节点群集，请按以下说明进行操作：

创建包含以下内容的名为 edgeConfig.yaml 的文件：

apiVersion: arccontainerstorage.azure.net/v1
kind: EdgeStorageConfiguration
metadata:
  name: edge-storage-configuration
spec:
  defaultDiskStorageClasses:
    - "default"
    - "local-path"

若要应用此 .yaml 文件，请运行：
```
kubectl apply -f "edgeConfig.yaml"
```

后续步骤

反馈

此页面是否有帮助？