Creare un file system lustre gestito di Azure usando i modelli di Azure Resource Manager

È possibile automatizzare la creazione di un file system lustre gestito di Azure usando i modelli di Azure Resource Manager (ARM). Questo articolo illustra la procedura di base e fornisce esempi dei file necessari.

Questo articolo offre esempi di due metodi diversi per la creazione di modelli di Resource Manager:

• Usare JSON per creare direttamente modelli di Resource Manager. Per altre informazioni, vedere sintassi del modello JSON.
• Usare Bicep, che usa una sintassi più semplice per fornire i dettagli di configurazione. Quando si distribuisce il modello, i file Bicep vengono convertiti in file modello di Resource Manager. Per altre informazioni, vedere la documentazione di Bicep.

Per altre informazioni su queste opzioni, vedere Confronto tra JSON e Bicep per i modelli.

Scegliere il tipo e le dimensioni del file system

Prima di scrivere un modello, è necessario prendere alcune decisioni sul file system lustre gestito di Azure. Per altre informazioni sulle opzioni di configurazione, vedere i dettagli di configurazione in Creare un file system lustre gestito di Azure.

Quando si usa un modello, specificare uno SKU per definire il tipo di base del file system lustre gestito di Azure da creare. Lo SKU rappresenta un livello di prodotto. Imposta qualità di sistema, ad esempio il tipo di dischi, la quantità di spazio di archiviazione supportata e la capacità massima di velocità effettiva. Se si usa il portale di Azure per creare il file system lustre gestito di Azure, specificare indirettamente il tipo di sistema selezionandone le funzionalità.

La tabella seguente illustra i valori per la velocità effettiva e le dimensioni di archiviazione in ogni SKU supportato. Questi SKU creano un file system che usa l'archiviazione SSD durevole.

Se sono necessari valori di archiviazione superiori al massimo elencato, è possibile aprire un ticket di supporto per esplorare le opzioni.

Per controllare le funzionalità dello SKU, è possibile usare il flusso di lavoro per la creazione di un file system Lustre gestito usando il portale di Azure. Le impostazioni specifiche dello SKU sono disponibili nella scheda Informazioni di base in Dettagli del file system.

Creare un file modello

Dopo aver deciso le opzioni di configurazione, è possibile creare un file modello. Il file modello è un file JSON o Bicep che contiene i dettagli di configurazione per il file system lustre gestito di Azure.

Valori delle proprietà modello

Per creare un file system lustre gestito di Azure usando un modello di Resource Manager, è necessario includere le informazioni seguenti nel file modello. La sintassi esatta è diversa tra Bicep e JSON, quindi consultare gli esempi per i valori letterali.

File system

Identità

Proprietà

Impostazioni di crittografia

Impostazioni del modulo di protezione hardware

Finestra di manutenzione

La timeOfDayUTC proprietà utilizza un formato di orologio di 24 ore. Ad esempio, 22:30 rappresenta le 10:30 PM. Il modello è ^([0-9]|0[0-9]|1[0-9]|2[0-3]):[0-5][0-9]$.

Impostazioni di squash radice

Nome SKU

Distribuire il file system usando il modello

I passaggi di esempio seguenti usano i comandi dell'interfaccia della riga di comando di Azure per creare un nuovo gruppo di risorse e creare un file system lustre gestito di Azure. I passaggi presuppongono che sia già stato scelto un tipo e dimensioni del file system e che sia stato creato un file modello, come descritto in precedenza in questo articolo. Assicurarsi anche di soddisfare tutti i prerequisiti.

1. Impostare la sottoscrizione predefinita:

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

2. Facoltativamente, creare un nuovo gruppo di risorse per il file system lustre gestito di Azure. Se si vuole usare un gruppo di risorse esistente, ignorare questo passaggio e specificare il nome del gruppo di risorse esistente quando si esegue il comando modello.

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

   Il file system può usare risorse esterne al proprio gruppo di risorse, purché si trovano nella stessa sottoscrizione.

3. Distribuire il file system lustre gestito di Azure usando il modello . La sintassi dipende dal fatto che si usino file JSON o Bicep, insieme al numero di file.

   È possibile distribuire modelli Bicep e JSON come singoli file o più file. Per altre informazioni e per visualizzare la sintassi esatta per ogni opzione, vedere la documentazione del modello di Resource Manager.

   Comando JSON di esempio:

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

   Comando Bicep di esempio:

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

Esempio di JSON

Questa sezione mostra il contenuto di esempio per un file modello JSON. È possibile rimuovere i parametri facoltativi durante la creazione di un modello di Resource Manager personalizzato.

{
    "$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": "eastus",
            "tags": {
              "Dept": "ContosoAds"
            },
            "sku": {
              "name": "AMLFS-Durable-Premium-250"
            },
            "identity": {
              "type": "UserAssigned",
              "userAssignedIdentities": {
                "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/<rg-name>/providers/Microsoft.ManagedIdentity/userAssignedIdentities/<identity-name>": {}
              }
            },
            "properties": {
              "encryptionSettings": {
                "keyEncryptionKey": {
                  "keyUrl": "https://<keyvault-name>.vault.azure.net/keys/kvk/<key>",
                  "sourceVault": {
                    "id": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/<rg-name>/providers/Microsoft.KeyVault/vaults/<keyvault-name>"
                  }
                }
              },
              "filesystemSubnet": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/<rg-name>/providers/Microsoft.Network/virtualNetworks/<vnet-name>/subnets/<subnet-name>",
              "hsm": {
                "settings": {
                  "container": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/<rg-name>/providers/Microsoft.Storage/storageAccounts/<storage-account-name>/blobServices/default/containers/<container-name>",
                  "loggingContainer": "/subscriptions/00000000-0000-0000-0000-000000000000/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": {}
}

Esempio bicep

Questa sezione mostra il contenuto di esempio per un file Bicep. È possibile rimuovere i parametri facoltativi durante la creazione di parametri personalizzati.

resource filesystem 'Microsoft.StorageCache/amlFilesystems@2024-03-01' = {
  name: 'amlfs-example'
  location: 'eastus'
  tags: {
    Dept: 'ContosoAds'
  }
  sku: {
    name: 'AMLFS-Durable-Premium-250'
  }
  identity: {
    type: 'UserAssigned'
    userAssignedIdentities: {
      '/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/<rg-name>/providers/Microsoft.ManagedIdentity/userAssignedIdentities/<identity-name>': {}
    }
  }
  properties: {
    encryptionSettings: {
      keyEncryptionKey: {
        keyUrl: 'https://<keyvault-name>.vault.azure.net/keys/kvk/<key>'
        sourceVault: {
          id: '/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/<rg-name>/providers/Microsoft.KeyVault/vaults/<keyvault-name>'
        }
      }
    }
    filesystemSubnet: '/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/<rg-name>/providers/Microsoft.Network/virtualNetworks/<vnet-name>/subnets/<subnet-name>'
    hsm: {
      settings: {
        container: '/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/<rg-name>/providers/Microsoft.Storage/storageAccounts/<storage-account-name>/blobServices/default/containers/<container-name>'
        importPrefixesInitial: [
          '/'
        ]
        loggingContainer: '/subscriptions/00000000-0000-0000-0000-000000000000/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'
  ]
}

Contenuto correlato

• Panoramica di Managed Lustre di Azure