Erstellen eines Azure Managed Lustre-Dateisystems mithilfe von Azure Resource Manager-Vorlagen

Sie können die Erstellung eines Azure Managed Lustre-Dateisystems automatisieren, indem Sie Azure Resource Manager (ARM)-Vorlagen verwenden. In diesem Artikel wird das grundlegende Verfahren erläutert und Beispiele für die benötigten Dateien bereitgestellt.

Dieser Artikel enthält Beispiele für zwei verschiedene Methoden zum Erstellen von ARM-Vorlagen:

• Verwenden Sie JSON, um ARM-Vorlagen direkt zu erstellen. Weitere Informationen finden Sie unter JSON-Vorlagensyntax.
• Verwenden Sie Bicep, die eine einfachere Syntax verwendet, um die Konfigurationsdetails zu liefern. Wenn Sie die Vorlage bereitstellen, werden die Bicep-Dateien in ARM-Vorlagendateien konvertiert. Weitere Informationen finden Sie in der Bicep-Dokumentation.

Weitere Informationen zu diesen Optionen finden Sie unter Vergleich von JSON und Bicep für Vorlagen.

Dateisystemtyp und -größe auswählen

Bevor Sie eine Vorlage schreiben, müssen Sie einige Entscheidungen zu Ihrem Azure Managed Lustre-Dateisystem treffen. Weitere Informationen zu den Konfigurationsoptionen finden Sie in den Setupdetails unter Erstellen eines Azure Managed Lustre-Dateisystems.

Wenn Sie eine Vorlage verwenden, geben Sie eine SKU an, um den grundlegenden Typ des zu erstellenden Azure Managed Lustre-Dateisystems zu definieren. Die SKU stellt eine Produktebene dar. Es legt Systemqualitäten wie den Typ der Datenträger, die unterstützte Speichermenge und die maximale Durchsatzkapazität fest. Wenn Sie das Azure-Portal verwenden, um Ihr Azure Managed Lustre-Dateisystem zu erstellen, geben Sie den Systemtyp indirekt an, indem Sie dessen Funktionen auswählen.

In der folgenden Tabelle sind die Werte für Durchsatz und Speichergröße in jeder unterstützten SKU aufgeführt. Diese SKUs erstellen ein Dateisystem, das dauerhaften SSD-Speicher verwendet.

Wenn Sie Speicherwerte benötigen, die größer als das aufgeführte Maximum sind, können Sie ein Supportticket öffnen, um Optionen zu erkunden.

Um SKU-Funktionen zu überprüfen, können Sie den Workflow zum Erstellen eines Managed Lustre-Dateisystems mithilfe der Azure-Portal verwenden. SKU-spezifische Einstellungen befinden sich auf der Registerkarte "Grundlagen " unter "Dateisystemdetails".

Erstellen einer Vorlagendatei

Nachdem Sie sich für Die Konfigurationsoptionen entschieden haben, können Sie eine Vorlagendatei erstellen. Die Vorlagendatei ist eine JSON- oder Bicep-Datei, die die Konfigurationsdetails für Ihr Azure Managed Lustre-Dateisystem enthält.

Vorlageneigenschaftenwerte

Um ein Azure Managed Lustre-Dateisystem mithilfe einer ARM-Vorlage zu erstellen, müssen Sie die folgenden Informationen in die Vorlagendatei aufnehmen. Die genaue Syntax unterscheidet sich zwischen Bicep und JSON. Lesen Sie daher die Beispiele für die Literalwerte.

Dateisystem

Identität

Eigenschaften

Verschlüsselungseinstellungen

HSM-Einstellungen

Wartungsfenster

Die timeOfDayUTC Eigenschaft verwendet ein 24-Stunden-Format. Stellt beispielsweise 22:30 10:30 Uhr dar. Das Muster lautet ^([0-9]|0[0-9]|1[0-9]|2[0-3]):[0-5][0-9]$.

Stamm-Root-Einstellungen

SKU-Name

Bereitstellen des Dateisystems mithilfe der Vorlage

In den folgenden Beispielschritten werden Azure CLI-Befehle zum Erstellen einer neuen Ressourcengruppe und zum Erstellen eines Azure Managed Lustre-Dateisystems verwendet. Bei den Schritten wird davon ausgegangen, dass Sie bereits einen Dateisystemtyp und eine Größe ausgewählt und eine Vorlagendatei erstellt haben, wie weiter oben in diesem Artikel beschrieben. Stellen Sie außerdem sicher, dass Sie alle Voraussetzungen erfüllen.

1. Legen Sie Ihr Standardabonnement fest:

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

2. Erstellen Sie optional eine neue Ressourcengruppe für Ihr Azure Managed Lustre-Dateisystem. Wenn Sie eine vorhandene Ressourcengruppe verwenden möchten, überspringen Sie diesen Schritt, und geben Sie den Namen der vorhandenen Ressourcengruppe an, wenn Sie den Vorlagenbefehl ausführen.

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

   Ihr Dateisystem kann Ressourcen außerhalb der eigenen Ressourcengruppe verwenden, solange sie sich im selben Abonnement befinden.

3. Stellen Sie das Azure Managed Lustre-Dateisystem mithilfe der Vorlage bereit. Die Syntax hängt davon ab, ob Sie JSON- oder Bicep-Dateien zusammen mit der Anzahl der Dateien verwenden.

   Sie können Bicep- und JSON-Vorlagen als einzelne Dateien oder mehrere Dateien bereitstellen. Weitere Informationen und die genaue Syntax für jede Option finden Sie in der ARM-Vorlagendokumentation.

   Beispiel-JSON-Befehl:

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

   Beispielbefehl Bicep:

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

JSON-Beispiel

Dieser Abschnitt zeigt Beispielinhalte für eine JSON-Vorlagendatei. Sie können optionale Parameter entfernen, wenn Sie eine eigene ARM-Vorlage erstellen.

{
    "$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": {}
}

Bicep-Beispiele

Dieser Abschnitt zeigt Beispielinhalte für eine Bicep-Datei. Beim Erstellen eigener Parameter können Sie optionale Parameter entfernen.

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'
  ]
}

Zugehöriger Inhalt

• Übersicht über Azure Managed Lustre