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

快速入门：在单节点 Ubuntu 群集上安装由 Azure Arc 支持的 Azure 容器存储

2025-05-21

本快速入门介绍如何在新的单节点 Ubuntu 群集上安装 Azure 容器存储。

先决条件

在开始之前，需要符合以下先决条件：

一个 Azure 订阅。如果没有 Azure 订阅，请在开始之前创建一个免费帐户。
启用了 Arc 的 Kubernetes 群集。若要将现有 Kubernetes 群集连接到 Azure Arc，请参阅将现有 Kubernetes 群集连接到 Azure Arc。

参数

需要以下参数值以完成本快速入门：

参数名称	说明
`resource-group`	群集所在的 Azure 资源组的名称。
`cluster-name`	已启用 Arc 的 Kubernetes 群集的名称。

步骤 1：设置最大用户实例数

若要确定是否将 fs.inotify.max_user_instances 设置为 1024，请运行以下命令：

sysctl fs.inotify.max_user_instances

运行此命令后，如果返回值小于 1024，请运行以下命令来增加最大文件数，并重新加载 sysctl 设置：

echo 'fs.inotify.max_user_instances = 1024' | sudo tee -a /etc/sysctl.conf 
sudo sysctl -p

步骤 2：安装 Azure IoT 操作依赖项

运行以下命令以安装 Azure IoT 操作依赖项：

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

步骤 3：安装 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

首先，创建包含以下内容且名为 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"

后续步骤

安装扩展后，可配置某些卷（无论是本地共享边缘卷还是云引入边缘卷）。

通过