将 Azure 文件卷装载到容器组 - Azure Container Instances

项目
08/07/2023

默认情况下，Azure 容器实例是无状态的。如果容器重启、崩溃或停止，其所有状态都会丢失。若要将状态保持至超过容器寿命，必须从外部存储装载卷。如本文中所示，Azure 容器实例可以装载使用 Azure 文件创建的 Azure 文件共享。 Azure 文件提供了承载在 Azure 存储中的完全托管的文件共享，这些共享项可通过行业标准的服务器消息块 (SMB) 协议进行访问。将 Azure 文件共享与 Azure 容器实例配合使用可以提供文件共享功能，类似于将 Azure 文件共享与 Azure 虚拟机配合使用。

限制

可以仅将 Azure 文件共享装载到 Linux 容器。请在概述中详细了解 Linux 和 Windows 容器组的功能支持差异。
Azure 文件共享卷装载需要 Linux 容器作为根运行。
Azure 文件共享卷装载仅限于 CIFS 支持。

注意

将 Azure 文件共享装载到容器实例类似于 Docker 绑定装载。如果将共享安装到含有文件或目录的容器目录中，装载会掩盖文件或目录，使其在容器运行时不可访问。

重要

如果要将容器组部署到 Azure 虚拟网络中，则必须将服务终结点添加到 Azure 存储帐户。

必须先创建 Azure 文件共享，才能将其用于 Azure 容器实例。运行以下脚本来创建存储帐户，以托管文件共享和共享本身。存储帐户名必须是全局唯一的，因此该脚本会向基础字符串添加一个随机值。

# Change these four parameters as needed
ACI_PERS_RESOURCE_GROUP=myResourceGroup
ACI_PERS_STORAGE_ACCOUNT_NAME=mystorageaccount$RANDOM
ACI_PERS_LOCATION=chinaeast2
ACI_PERS_SHARE_NAME=acishare

# Create the storage account with the parameters
az storage account create \
    --resource-group $ACI_PERS_RESOURCE_GROUP \
    --name $ACI_PERS_STORAGE_ACCOUNT_NAME \
    --location $ACI_PERS_LOCATION \
    --sku Standard_LRS

# Create the file share
az storage share create \
  --name $ACI_PERS_SHARE_NAME \
  --account-name $ACI_PERS_STORAGE_ACCOUNT_NAME

获取存储凭证

若要在 Azure 容器实例中将 Azure 文件共享装载为卷，需要 3 个值：存储帐户名、共享名和存储访问密钥。

存储帐户名称 - 如果你使用了前面的脚本，则存储帐户名称存储在 $ACI_PERS_STORAGE_ACCOUNT_NAME 变量中。若要查看帐户名称，请键入以下命令：
```
echo $ACI_PERS_STORAGE_ACCOUNT_NAME
```
共享名称 - 此值已知（在前面的脚本中定义为 acishare）

存储帐户密钥 - 可以使用以下命令找到此值：

STORAGE_KEY=$(az storage account keys list --resource-group $ACI_PERS_RESOURCE_GROUP --account-name $ACI_PERS_STORAGE_ACCOUNT_NAME --query "[0].value" --output tsv)
echo $STORAGE_KEY

部署容器并装载卷 - CLI

若要使用 Azure CLI 将 Azure 文件共享作为卷装载到容器中，请在使用 az container create 创建容器时指定共享和卷装载点。如果已执行前面的步骤，则可以使用以下命令装载先前创建的共享以创建容器：

az container create \
    --resource-group $ACI_PERS_RESOURCE_GROUP \
    --name hellofiles \
    --image mcr.microsoft.com/azuredocs/aci-hellofiles \
    --dns-name-label aci-demo \
    --ports 80 \
    --azure-file-volume-account-name $ACI_PERS_STORAGE_ACCOUNT_NAME \
    --azure-file-volume-account-key $STORAGE_KEY \
    --azure-file-volume-share-name $ACI_PERS_SHARE_NAME \
    --azure-file-volume-mount-path /aci/logs/

--dns-name-label 值在创建容器实例的 Azure 区域中必须是唯一的。如果在执行命令时收到 DNS 名称标签错误消息，请更新前一命令中的值。

管理已装载卷中的文件

在容器启动后，可以使用通过 Microsoft aci-hellofiles 映像部署的简单 Web 应用在你指定的装载路径下的 Azure 文件共享中创建小的文本文件。使用 az container show 命令获取 Web 应用的完全限定域名 (FQDN)：

az container show --resource-group $ACI_PERS_RESOURCE_GROUP \
  --name hellofiles --query ipAddress.fqdn --output tsv

使用应用保存文本后，可使用 Azure 门户或 Microsoft Azure 存储资源管理器之类的工具检索及检查写入到文件共享的文件。

部署容器并装载卷 - YAML

你还可以使用 Azure CLI 和 YAML 模板部署容器组并在容器中装载卷。在部署由多个容器组成的容器组时，通过 YAML 模板进行部署是首选方法。

以下 YAML 模板定义了一个容器组，其中包含使用 aci-hellofiles 映像创建的容器。该容器将之前创建的 Azure 文件共享 acishare 装载为卷。在指定的位置，输入承载着文件共享的存储帐户的名称和存储密钥。

与 CLI 示例中一样，dnsNameLabel 值在创建容器实例的 Azure 区域中必须是唯一的。如果需要，请在 YAML 文件中更新该值。

apiVersion: '2019-12-01'
location: chinaeast2
name: file-share-demo
properties:
  containers:
  - name: hellofiles
    properties:
      environmentVariables: []
      image: mcr.microsoft.com/azuredocs/aci-hellofiles
      ports:
      - port: 80
      resources:
        requests:
          cpu: 1.0
          memoryInGB: 1.5
      volumeMounts:
      - mountPath: /aci/logs/
        name: filesharevolume
  osType: Linux
  restartPolicy: Always
  ipAddress:
    type: Public
    ports:
      - port: 80
    dnsNameLabel: aci-demo
  volumes:
  - name: filesharevolume
    azureFile:
      sharename: acishare
      storageAccountName: <Storage account name>
      storageAccountKey: <Storage account key>
tags: {}
type: Microsoft.ContainerInstance/containerGroups

若要使用 YAML 模板进行部署，请将前面的 YAML 保存到名为 deploy-aci.yaml 的文件中，然后使用 --file 参数执行 az container create 命令：

# Deploy with YAML template
az container create --resource-group myResourceGroup --file deploy-aci.yaml

部署容器并装载卷 - 资源管理器

除了 CLI 和 YAML 部署外，还可以使用 Azure 资源管理器模板来部署容器组并在容器中装载卷。

首先，在模板的容器组 properties 节中填充 volumes 数组。

然后，针对容器组中要在其中装载卷的每个容器，在容器定义的 properties 部分中填充 volumeMounts 数组。

以下资源管理器模板定义了一个容器组，其中包含使用 aci-hellofiles 映像创建的容器。该容器将之前创建的 Azure 文件共享 acishare 装载为卷。在指定的位置，输入承载着文件共享的存储帐户的名称和存储密钥。

与前面的示例中一样，dnsNameLabel 值在创建容器实例的 Azure 区域中必须是唯一的。如果需要，请在模板中更新该值。

{
  "$schema": "https://schema.management.azure.com/schemas/2015-01-01/deploymentTemplate.json#",
  "contentVersion": "1.0.0.0",
  "variables": {
    "container1name": "hellofiles",
    "container1image": "mcr.microsoft.com/azuredocs/aci-hellofiles"
  },
  "resources": [
    {
      "name": "file-share-demo",
      "type": "Microsoft.ContainerInstance/containerGroups",
      "apiVersion": "2019-12-01",
      "location": "[resourceGroup().location]",
      "properties": {
        "containers": [
          {
            "name": "[variables('container1name')]",
            "properties": {
              "image": "[variables('container1image')]",
              "resources": {
                "requests": {
                  "cpu": 1,
                  "memoryInGb": 1.5
                }
              },
              "ports": [
                {
                  "port": 80
                }
              ],
              "volumeMounts": [
                {
                  "name": "filesharevolume",
                  "mountPath": "/aci/logs"
                }
              ]
            }
          }
        ],
        "osType": "Linux",
        "ipAddress": {
          "type": "Public",
          "ports": [
            {
              "protocol": "tcp",
              "port": "80"
            }
          ],
          "dnsNameLabel": "aci-demo"
        },
        "volumes": [
          {
            "name": "filesharevolume",
            "azureFile": {
                "shareName": "acishare",
                "storageAccountName": "<Storage account name>",
                "storageAccountKey": "<Storage account key>"
            }
          }
        ]
      }
    }
  ]
}

若要使用资源管理器模板进行部署，请将前面的 JSON 保存到名为 deploy-aci.json 的文件中，然后使用 --template-file 参数执行 az deployment group create 命令：

# Deploy with Resource Manager template
az deployment group create --resource-group myResourceGroup --template-file deploy-aci.json

装载多个卷

若要将多个卷装载到容器实例中，必须使用 Azure 资源管理器模板、YAML 文件或其他编程方法进行部署。若要使用模板或 YAML 文件，请提供共享详细信息，并通过在文件的 properties 部分填充 volumes 数组来定义卷。

例如，如果已在存储帐户 myStorageAccount 中创建两个 Azure 文件存储（名为 share1 和 share2），资源管理器模板中的 volumes 数组将类似于以下内容：

"volumes": [{
  "name": "myvolume1",
  "azureFile": {
    "shareName": "share1",
    "storageAccountName": "myStorageAccount",
    "storageAccountKey": "<storage-account-key>"
  }
},
{
  "name": "myvolume2",
  "azureFile": {
    "shareName": "share2",
    "storageAccountName": "myStorageAccount",
    "storageAccountKey": "<storage-account-key>"
  }
}]

接下来，针对容器组中希望装载卷的每个容器，在容器定义的 properties 部分填充 volumeMounts 数组。例如，填充以下内容将装载之前定义的两个卷：myvolume1 和 myvolume2：

"volumeMounts": [{
  "name": "myvolume1",
  "mountPath": "/mnt/share1/"
},
{
  "name": "myvolume2",
  "mountPath": "/mnt/share2/"
}]

后续步骤

了解如何在 Azure 容器实例中装载其他卷类型：

在 Azure 容器实例中装载 Azure 文件共享

限制

创建 Azure 文件共享