使用 Azure 资源管理器 模板创建 Azure 托管 Lustre 文件系统

可以使用 Azure 资源管理器 （ARM） 模板自动创建 Azure 托管 Lustre 文件系统。 本文介绍了基本过程，并提供了所需文件的示例。

本文提供了用于创建 ARM 模板的两种不同的方法的示例：

• 使用 JSON 直接创建 ARM 模板。 若要了解详细信息，请参阅 JSON 模板语法。
• 使用 Bicep，它使用更简单的语法来提供配置详细信息。 部署模板时，Bicep 文件将转换为 ARM 模板文件。 若要了解详细信息，请参阅 Bicep 文档。

若要详细了解这些选项，请参阅 比较用于模板的 JSON 和 Bicep。

选择文件系统类型和大小

在编写模板之前，必须就 Azure 托管 Lustre 文件系统做出一些决策。 若要了解有关配置选项的详细信息，请参阅“创建 Azure 托管 Lustre 文件系统”中的设置详细信息。

使用模板时，请指定 SKU 以定义要创建的 Azure 托管 Lustre 文件系统的基本类型。 SKU 表示产品层。 它设置系统质量，例如磁盘类型、支持的存储量和最大吞吐量容量。 如果使用Azure 门户创建 Azure 托管 Lustre 文件系统，则通过选择其功能间接指定系统类型。

下表显示了每个受支持的 SKU 的吞吐量和存储容量值。 这些 SKU 创建使用持久 SSD 存储的文件系统。 默认最大值是订阅默认可用的容量限制。 您可以通过提交支持工单，申请将容量提高到支持的最大上限。

若要使订阅能够部署容量大于默认最大值的文件系统， 请开具支持票证。

若要检查 SKU 功能，可以使用工作流通过Azure 门户创建托管 Lustre 文件系统。 SKU 特定设置位于文件系统详细信息下的基本信息选项卡上。

创建模板文件

确定配置选项后，可以创建模板文件。 模板文件是一个 JSON 或 Bicep 文件，其中包含 Azure 托管 Lustre 文件系统的配置详细信息。

模板属性值

若要使用 ARM 模板创建 Azure 托管 Lustre 文件系统，需要在模板文件中包括以下信息。 Bicep 和 JSON 之间的确切语法不同，因此请查阅文本值的示例。

文件系统

Identity

属性

加密设置

HSM 设置

维护时段

该 timeOfDayUTC 属性使用 24 小时制格式。 例如， 22:30 表示下午 10：30。 模式为 ^([0-9]|0[0-9]|1[0-9]|2[0-3]):[0-5][0-9]$.

根用户压缩设置

SKU 名称

使用模板部署文件系统

以下示例步骤使用 Azure CLI 命令创建新的资源组，并在其中创建 Azure 托管 Lustre 文件系统。 这些步骤假定你已 选择文件系统类型和大小 并 创建了模板文件，如本文前面所述。 此外，请确保满足所有 先决条件。

1. 设置默认订阅：

   az account set --subscription "<subscription-id>"
   az account show
   

2. （可选）为 Azure 托管 Lustre 文件系统创建新的资源组。 如果要使用现有资源组，请跳过此步骤，并在运行模板命令时提供现有资源组的名称。

   az group create --name <rg-name> --location <region-short-name>
   

   只要资源位于同一订阅中，文件系统就可以在其自己的资源组外部使用资源。

3. 使用模板部署 Azure 托管 Lustre 文件系统。 语法取决于是使用 JSON 还是 Bicep 文件，以及文件数。

   可以将 Bicep 和 JSON 模板部署为单个文件或多个文件。 有关详细信息并查看每个选项的确切语法，请参阅 ARM 模板文档。

   示例 JSON 命令：

   az deployment group create \
     --name <example-deployment> \
     --resource-group <resource-group-name> \
     --template-file azlustre-template.json
   

   Bicep 命令示例：

   az deployment group create \
    --resource-group <ResourceGroupName> \
    --template-file azlustre.bicep
   

JSON 示例：

本部分显示 JSON 模板文件的示例内容。 创建自己的 ARM 模板时，可以删除可选参数。

{
    "$schema": "https://schema.management.azure.com/schemas/2019-04-01/deploymentTemplate.json#",
    "contentVersion": "1.0.0.0",
    "resources": [
        {
            "type": "Microsoft.StorageCache/amlFilesystems",
            "apiVersion": "2024-03-01",
            "name": "amlfs-example",
            "location": "chinanorth3",
            "tags": {
              "Dept": "ContosoAds"
            },
            "sku": {
              "name": "AMLFS-Durable-Premium-250"
            },
            "identity": {
              "type": "UserAssigned",
              "userAssignedIdentities": {
                "/subscriptions/aaaa0a0a-bb1b-cc2c-dd3d-eeeeee4e4e4e/resourceGroups/<rg-name>/providers/Microsoft.ManagedIdentity/userAssignedIdentities/<identity-name>": {}
              }
            },
            "properties": {
              "encryptionSettings": {
                "keyEncryptionKey": {
                  "keyUrl": "https://<keyvault-name>.vault.azure.cn/keys/kvk/<key>",
                  "sourceVault": {
                    "id": "/subscriptions/aaaa0a0a-bb1b-cc2c-dd3d-eeeeee4e4e4e/resourceGroups/<rg-name>/providers/Microsoft.KeyVault/vaults/<keyvault-name>"
                  }
                }
              },
              "filesystemSubnet": "/subscriptions/aaaa0a0a-bb1b-cc2c-dd3d-eeeeee4e4e4e/resourceGroups/<rg-name>/providers/Microsoft.Network/virtualNetworks/<vnet-name>/subnets/<subnet-name>",
              "hsm": {
                "settings": {
                  "container": "/subscriptions/aaaa0a0a-bb1b-cc2c-dd3d-eeeeee4e4e4e/resourceGroups/<rg-name>/providers/Microsoft.Storage/storageAccounts/<storage-account-name>/blobServices/default/containers/<container-name>",
                  "loggingContainer": "/subscriptions/aaaa0a0a-bb1b-cc2c-dd3d-eeeeee4e4e4e/resourceGroups/<rg-name>/providers/Microsoft.Storage/storageAccounts/<storage-account-name>/blobServices/default/containers/<logging-container-name>",
                  "importPrefixesInitial": [
                    "/"
                  ]
                }
              },
              "maintenanceWindow": {
                "dayOfWeek": "Saturday",
                "timeOfDayUTC": "22:00"
              },
              "rootSquashSettings": {
                "mode": "All",
                "noSquashNidLists": "10.0.0.[5-6]@tcp;10.0.1.2@tcp",
                "squashGID": "99",
                "squashUID": "99"
              },
              "storageCapacityTiB": "16"
            },
            "zones": [
              "1"
            ],
        }
    ],
    "outputs": {}
}

Bicep示例

本部分显示 Bicep 文件的示例内容。 创建自己的参数时，可以删除可选参数。

resource filesystem 'Microsoft.StorageCache/amlFilesystems@2024-03-01' = {
  name: 'amlfs-example'
  location: 'chinanorth3'
  tags: {
    Dept: 'ContosoAds'
  }
  sku: {
    name: 'AMLFS-Durable-Premium-250'
  }
  identity: {
    type: 'UserAssigned'
    userAssignedIdentities: {
      '/subscriptions/aaaa0a0a-bb1b-cc2c-dd3d-eeeeee4e4e4e/resourceGroups/<rg-name>/providers/Microsoft.ManagedIdentity/userAssignedIdentities/<identity-name>': {}
    }
  }
  properties: {
    encryptionSettings: {
      keyEncryptionKey: {
        keyUrl: 'https://<keyvault-name>.vault.azure.cn/keys/kvk/<key>'
        sourceVault: {
          id: '/subscriptions/aaaa0a0a-bb1b-cc2c-dd3d-eeeeee4e4e4e/resourceGroups/<rg-name>/providers/Microsoft.KeyVault/vaults/<keyvault-name>'
        }
      }
    }
    filesystemSubnet: '/subscriptions/aaaa0a0a-bb1b-cc2c-dd3d-eeeeee4e4e4e/resourceGroups/<rg-name>/providers/Microsoft.Network/virtualNetworks/<vnet-name>/subnets/<subnet-name>'
    hsm: {
      settings: {
        container: '/subscriptions/aaaa0a0a-bb1b-cc2c-dd3d-eeeeee4e4e4e/resourceGroups/<rg-name>/providers/Microsoft.Storage/storageAccounts/<storage-account-name>/blobServices/default/containers/<container-name>'
        importPrefixesInitial: [
          '/'
        ]
        loggingContainer: '/subscriptions/aaaa0a0a-bb1b-cc2c-dd3d-eeeeee4e4e4e/resourceGroups/<rg-name>/providers/Microsoft.Storage/storageAccounts/<storage-account-name>/blobServices/default/containers/<logging-container-name>'
      }
    }
    maintenanceWindow: {
      dayOfWeek: 'Saturday'
      timeOfDayUTC: '22:00'
    }
    rootSquashSettings: {
      mode: 'All'
      noSquashNidLists: '10.0.0.[5-6]@tcp;10.0.1.2@tcp'
      squashGID: 99
      squashUID: 99
    }
    storageCapacityTiB: 16
  }
  zones: [
    '1'
  ]
}

相关内容

• Azure Managed Lustre 概述