Share via


Azure Managed Lustre fájlrendszer Létrehozás Azure Resource Manager-sablonokkal

Az Azure Managed Lustre fájlrendszerének létrehozását azure Resource Manager-sablonokkal automatizálhatja. Ez a cikk ismerteti az alapszintű eljárást, és példákat ad a szükséges fájlokra.

A sablonokkal kapcsolatos további információkért lásd: Azure Resource Manager-sablonok.

Ez a cikk két különböző módszert mutat be az Azure Resource Manager-sablonok létrehozásához:

  • A JSON használatával közvetlenül hozhat létre Azure Resource Manager-sablonokat. Lásd: JSON-sablon szintaxisa.
  • Használja a Bicepet, amely egyszerűbb szintaxist használ a konfiguráció részleteinek megadásához. A sablon üzembe helyezésekor a Bicep-fájlok Azure Resource Manager sablonfájlokká lesznek konvertálva. Tekintse meg a Bicep dokumentációját.

További információ a lehetőségekről: A JSON és a Bicep összehasonlítása sablonokhoz.

Fájlrendszer típusának és méretének kiválasztása

Mielőtt sablont ír, döntéseket kell hoznia az Azure Managed Lustre fájlrendszerről. A konfigurációs lehetőségekről további információt az Azure Managed Lustre fájlrendszer Létrehozás című témakörben talál.

Ha sablont használ, adjon meg egy termékváltozatnevet a létrehozandó Azure Managed Lustre-rendszer alaptípusának meghatározásához. Ha a Azure Portal használja az Azure Managed Lustre létrehozásához, közvetetten adja meg a rendszer típusát a képességeinek kiválasztásával.

Az Azure-ban a termékváltozat a létrehozandó erőforrás funkcióinak egy készletét határozza meg. Az Azure Managed Lustre fájlrendszer esetében a termékváltozat olyan rendszerminőségeket állít be, mint a használt lemezek típusa, a támogatott tárterület mennyisége és a maximális átviteli sebesség.

Jelenleg a következő termékváltozatok támogatottak:

  • AMLFS-Durable-Premium-40
  • AMLFS-Durable-Premium-125
  • AMLFS-Durable-Premium-250
  • AMLFS-Durable-Premium-500

Ezek a termékváltozatok tartós SSD-tárolót használó fájlrendszert hoznak létre. Az alábbi táblázat az egyes termékváltozatok átviteli sebességének és tárolási méretének értékeit mutatja be:

SKU Átviteli sebesség TiB-tárolónként Tárolási perc Tárterület max. 1 Növekmény
AMLFS-Durable-Premium-40 40 MB/másodperc 48 TB 768 TB 48 TB
AMLFS-Durable-Premium-125 125 MB/másodperc 16 TB 128 TB 16 TB
AMLFS-Durable-Premium-250 250 MB/másodperc 8 TB 128 TB 8 TB
AMLFS-Durable-Premium-500 500 MB/másodperc 4 TB 128 TB 4 TB

1 Ha a felsorolt maximálisnál nagyobb tárolási értékekre van szüksége, támogatási jegyet nyithat a lehetőségek megismeréséhez.

A Azure Portal létrehozási munkafolyamatával ellenőrizheti a termékváltozat képességeit. Az SKU-specifikus beállítások az Alapvető beállítások lapon találhatók a Fájlrendszer részletei területen.

Tipp

Az elérhető termékváltozatok nevének ellenőrzéséhez használható parancsok kötelező információi című témakörben talál további információt.

Sablonfájl Létrehozás

Miután eldöntötte a konfigurációs beállításokat, létrehozhat egy sablonfájlt. A sablonfájl egy JSON- vagy Bicep-fájl, amely az Azure Managed Lustre fájlrendszer konfigurációs adatait tartalmazza. Ez a szakasz ismerteti a sablonfájlba belefoglalandó szükséges és nem kötelező információkat.

Az összes lehetséges konfigurációs lehetőséget tartalmazó fájlok esetében lásd: JSON-mintafájlok és Minta Bicep-fájl.

Szükséges adatok

Ez a szakasz ismerteti az Azure Resource Manager-sablonfájlokban az Azure Managed Lustre fájlrendszer létrehozásához szükséges információkat. A pontos szintaxis eltér a Bicep és a JSON között, ezért tekintse meg a literálértékek nyelvtípusonkénti példáit.

  • Létrehozandó erőforrástípus – Ez az érték közli az Azure Resource Manager, hogy az érték Microsoft.StorageCache/amlFileSystems és az API-verzió kombinációjának átadásával azure managed lustre fájlrendszert hoz létre.

    Az erőforrástípus többféleképpen is létrehozható:

    • A cikk JSON-példájában az erőforrástípus értéke szó szerint át lesz adva a template.json fájlban, de az API-verzió értéke a parameters.json fájlból lesz beolvasva.
    • A Bicep-példában az erőforrástípus és az API-verzió együtt lesz átadva a sablonfájl elején.
  • API-verzió – Az Azure Managed Lustre létrehozandó verziója.

    Az AKTUÁLIS API-verzió megkeresése:

    az provider show --namespace Microsoft.StorageCache --query "resourceTypes[?resourceType=='amlFilesystems'].apiVersions" --out table
    
  • Termékváltozat neve – A fájlrendszer teljesítménymodellje vagy AMLFS-Durable-Premium-125AMLFS-Durable-Premium-250.

    Az alábbi paranccsal keresse meg az elérhető termékváltozatokat (használja az aktuális API-verziót):

    az rest --url https://management.azure.com/subscriptions/<subscription_id>/providers/Microsoft.StorageCache/skus/?api-version=<version> | jq '.value[].name' | grep AMLFS| uniq
    
  • Location – Annak az Azure-régiónak a neve, ahol a fájlrendszer létrejön.

    Az Azure Managed Lustre által támogatott régiók és rendelkezésre állási zónák megkeresése:

    az provider show --namespace Microsoft.StorageCache --query "resourceTypes[?resourceType=='amlFilesystems'].zoneMappings[].{location: location, zones: to_string(zones)}" --out table
    

    Megjegyzés

    Ez a parancs megjeleníti az Azure-régiók megjelenítendő nevét; a rövidebb name értéket kell használnia (például használja az "eastus" értéket az "USA keleti régiója" helyett).

    Ez a parancs a megjelenítendő névből adja vissza a rövid nevet. Az USA nyugati régiója egy példa; ez a parancs a következőt adja westusvissza:

    az account list-locations --query "[?displayName=='West US'].name" --output tsv
    
  • Rendelkezésre állási zóna – Az Azure-régióban használandó rendelkezésre állási zóna.

    A Hely területen található előző paranccsal keresse meg a rendelkezésre állási zónákat. Adjon meg egyetlen rendelkezésre állási zónát a rendszer számára.

  • Fájlrendszer neve – Ennek az Azure Managed Lustre fájlrendszernek a felhasználó által látható neve.

  • Fájlrendszer alhálózata – A fájlrendszer által használt alhálózat. Adja meg az alhálózat URI-ját; például: /subscriptions/<SubscriptionID>/resourceGroups/<VnetResourceGroupName>/providers/Microsoft.Network/virtualNetworks/<VnetName>/subnets/<SubnetName>.

  • Tárolási kapacitás – Az Azure Managed Lustre-fürt mérete a TiB-ben. Az értékek a termékváltozattól függenek. További információ: A fájlrendszer típusának és méretének kiválasztása.

  • Karbantartási időszak – Két értéket igényel, amelyek beállítják a karbantartási időszakot. Ezek az értékek heti 30 perces időszakot határoznak meg, amely alatt a rendszerfrissítések elvégezhetők.

    • A hét napja (például Sunday)
    • Nap időpontja (UTC) (például 22:00)

Opcionális információk

Az ebben a szakaszban szereplő paraméterek nem kötelezőek, vagy csak akkor szükségesek, ha adott funkciókat használ.

  • Címkék – Ezt a lehetőséget akkor használja, ha azure-beli erőforrás-metaadat-címkéket szeretne beállítani.

  • Blobintegrációs beállítások – Adja meg ezeket az értékeket, hogy integrált Blob Storage-tárolót használjon ezzel a fájlrendszerrel. További információ: Blobintegráció.

    • Container – A Lustre hierarchikus tárolókezeléshez (HSM) használandó blobtároló erőforrás-azonosítója.
    • Naplózási tároló – Egy külön tároló erőforrás-azonosítója az importálási és exportálási naplók tárolásához. A naplózási tárolónak ugyanabban a tárfiókban kell lennie, mint az adattárolónak.
    • Importálási előtag (nem kötelező) – Ha ez az érték meg van adva, csak az importálási előtag-sztringgel kezdődő blobok lesznek importálva az Azure Managed Lustre fájlrendszerbe. Ha nem adja meg, az alapértelmezett érték a /, amely megadja, hogy a tárolóban lévő összes blob importálva legyen.
  • Ügyfél által felügyelt kulcsbeállítások – Adja meg ezeket az értékeket, ha Azure-Key Vault szeretne használni az adatok azure managed lustre rendszerben való titkosításához használt titkosítási kulcsok szabályozásához. Alapértelmezés szerint az adatok a Microsoft által felügyelt titkosítási kulcsokkal lesznek titkosítva.

    • Identitástípus – állítsa be úgy, hogy UserAssigned bekapcsolja az ügyfél által felügyelt kulcsokat.
    • Titkosítási Key Vault – A titkosítási kulcsokat tároló Azure Key Vault erőforrás-azonosítója.
    • Titkosítási kulcs URL-címe – Az adatok titkosításához használandó kulcs azonosítója.
    • Felügyelt identitás – Egy felhasználó által hozzárendelt felügyelt identitás, amelyet az Azure Managed Lustre fájlrendszer az Azure Key Vault eléréséhez használ. További információ: Ügyfél által felügyelt titkosítási kulcsok használata.

A fájlrendszer üzembe helyezése a sablon használatával

Ezek a példalépések azure CLI-parancsokkal hoznak létre egy új erőforráscsoportot, és létrehoznak benne egy Azure Managed Lustre fájlrendszert.

Az üzembe helyezés előtt győződjön meg arról, hogy végrehajtja a következő lépéseket:

A fájlrendszer sablonnal történő üzembe helyezéséhez kövesse az alábbi lépéseket:

  1. Alapértelmezett előfizetés beállítása:

    az account set --subscription "<SubscriptionID>"
    az account show
    
  2. Ha szeretné, hozzon létre egy új erőforráscsoportot az Azure Managed Lustre fájlrendszerhez. Ha meglévő erőforráscsoportot szeretne használni, hagyja ki ezt a lépést, és adja meg a meglévő erőforráscsoport nevét a sablonparancs végrehajtásakor.

    az group create --name <ResourceGroupName> --location <RegionShortname>
    

    A fájlrendszer a saját erőforráscsoporton kívüli erőforrásokat is használhat, ha ugyanabban az előfizetésben vannak.

  3. Helyezze üzembe az Azure Managed Lustre fájlrendszert a sablon használatával. A szintaxis attól függően eltérő, hogy JSON- vagy Bicep-fájlokat használ-e, és hogy hány fájlt használ.

    Bicep- és JSON-sablonokat is üzembe helyezhet egyetlen vagy több fájlként. További információt és az egyes beállítások pontos szintaxisát az Azure Resource Manager-sablonok dokumentációjában talál.

    Példa JSON-parancsra:

    az deployment group create \
      --name <ExampleDeployment> \
      --resource-group <ResourceGroupName> \
      --template-file azlustre-template.json \
      --parameters @azlustre-parameters.json
    

    Példa Bicep-parancsra:

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

JSON-fájlok mintája

Ez a szakasz egy sablonfájl és egy külön paraméterfájl mintatartalmát mutatja be. Ezek a fájlok tartalmazzák az összes lehetséges konfigurációs beállítást. A választható paramétereket eltávolíthatja saját Azure Resource Manager-sablon létrehozásakor.

Sablonfájl

Ez a szakasz egy sablonfájl példatartalmát mutatja be:

{
    "$schema": "https://schema.management.azure.com/schemas/2019-04-01/deploymentTemplate.json#",
    "contentVersion": "1.0.0.0",
    "parameters": {
        "location": {
            "type": "String"
        },
        "apiVersion": {
            "type": "String"
        },
        "fileSystemName": {
            "type": "String"
        },
        "availabilityZone": {
            "type": "Array"
        },
        "subnetId": {
            "type": "String"
        },
        "storageCapacityTiB": {
            "type": "Int"
        },
        "container": {
            "type": "String"
        },
        "loggingContainer": {
            "type": "String"
        },
        "importPrefix": {
            "type": "String"
        },
        "dayOfWeek": {
            "type": "String"
        },
        "timeOfDay": {
            "type": "String"
        },
        "encryptionKeyUrl": {
            "type": "String"
        },
        "encryptionVault": {
            "type": "String"
        }
    },
    "resources": [
        {
            "type": "Microsoft.StorageCache/amlFileSystems",
            "apiVersion": "[parameters('apiVersion')]",
            "name": "[parameters('fileSystemName')]",
            "location": "[parameters('location')]",
            "tags": {
                "MyTagName": "TagValue"
            },
            "sku": {
                "name": "AMLFS-Durable-Premium-250"
            },
            "identity": {
                "type": "UserAssigned",
                "userAssignedIdentities": {
                    "/subscriptions/<subscription_id>/resourcegroups/<identity_resource_group>/providers/Microsoft.ManagedIdentity/userAssignedIdentities/<name_of_identity>": {}
                }
            },
            "properties": {
                "storageCapacityTiB": "[parameters('storageCapacityTiB')]",
                "zones": "[parameters('availabilityZone')]",
                "filesystemSubnet": "[parameters('subnetId')]",
                "hsm": {
                    "settings": {
                        "container": "[parameters('container')]",
                        "loggingContainer": "[parameters('loggingContainer')]",
                        "importPrefix": "[parameters('importPrefix')]"
                    }
                },
                "maintenanceWindow": {
                    "dayOfWeek": "[parameters('dayOfWeek')]",
                    "timeOfDay": "[parameters('timeOfDay')]"
                },
                "encryptionSettings": {
                    "keyEncryptionKey": {
                        "keyUrl": "[parameters('encryptionKeyUrl')]",
                        "sourceVault": {
                            "id": "[parameters('encryptionVault')]"
                        }
                    }
                }
            }
        }
    ],
    "outputs": {}
}

Paraméterfájl

Ez a szakasz egy paraméterfájl példatartalmát mutatja be:

{
    "$schema": "https://schema.management.azure.com/schemas/2015-01-01/deploymentParameters.json#",
    "contentVersion": "1.0.0.0",
    "parameters": {
        "location": {
            "value": "eastus"
        },
        "apiVersion": {
            "value": "2023-05-01"
        },
        "fileSystemName": {
            "value": "amlfs-example"
        },
        "availabilityZone": {
            "value": [
                "1"
            ]
        },
        "subnetId": {
            "value": "/subscriptions/<subscription_id>/resourceGroups/<vnet_resource_group>/providers/Microsoft.Network/virtualNetworks/<vnet>/subnets/<subnet>"
        },
        "storageCapacityTiB": {
            "value": 4
        },
        "container": {
            "value": "/subscriptions/<subscription_id>/resourceGroups/<storage_account_resource_group>/providers/Microsoft.Storage/storageAccounts/<storage_account_name>/blobServices/default/containers/<container_name>"
        },
        "loggingContainer": {
            "value": "/subscriptions/<subscription_id>/resourceGroups/<storage_account_resource_group>/providers/Microsoft.Storage/storageAccounts/<storage_account_name>/blobServices/default/containers/<log_container_name>"
        },
        "importPrefix": {
            "value": ""
        },
        "dayOfWeek": {
            "value": "Saturday"
        },
        "timeOfDay": {
            "value": "16:45"
        },
        "encryptionKeyUrl": {
            "value": "<encryption_key_URL>"
        },
        "encryptionVault": {
            "value": "/subscriptions/<subscription_id>/resourceGroups/<keyvault_resource_group>/providers/Microsoft.KeyVault/vaults/<keyvault_name>"
        }
    }
}

Bicep-mintafájl

Ez a példa egy Azure Managed Lustre-sablon összes lehetséges értékét tartalmazza. A sablon létrehozásakor távolítsa el a nem kötelező értékeket, amelyeket nem szeretne.

resource fileSystem 'Microsoft.StorageCache/amlFileSystems@2023-05-01' = {
  name: 'fileSystemName'
  location: 'eastus'
  tags: {
    'test-tag': 'test'
  }
  sku: {
    name: 'AMLFS-Durable-Premium-250'
  }
  identity: {
    type: 'UserAssigned'
    userAssignedIdentities: {
      '/subscriptions/<subscription_id>/resourcegroups/<identity_resource_group>/providers/Microsoft.ManagedIdentity/userAssignedIdentities/<name_of_identity>': {
      }
    }
  }
  properties: {
    storageCapacityTiB: 8
    zones: [ 1 ]
    filesystemSubnet: '/subscriptions/<subscription_id>/resourceGroups/<vnet_resource_group>/providers/Microsoft.Network/virtualNetworks/<vnet>/subnets/<subnet>'
    hsm: {
      settings: {
        container: '/subscriptions/<subscription_id>/resourceGroups/<storage_account_resource_group>/providers/Microsoft.Storage/storageAccounts/<storage_account_name>/blobServices/default/containers/<container_name>'
        loggingContainer: '/subscriptions/<subscription_id>/resourceGroups/<storage_account_resource_group>/providers/Microsoft.Storage/storageAccounts/<storage_account_name>/blobServices/default/containers/<log_container_name>'
        importPrefix: ''
      }
    }
    maintenanceWindow: {
      dayOfWeek: 'Friday'
      timeOfDay: '21:00'
    }
    encryptionSettings: {
      keyEncryptionKey: {
        keyUrl: '<encryption_key_URL>'
        sourceVault: {
          id: '/subscriptions/<subscription_id>/resourceGroups/<keyvault_resource_group>/providers/Microsoft.KeyVault/vaults/<keyvault_name>'
        }
      }
    }
  }
}

Következő lépések