Azure Resource Manager 템플릿을 사용하여 Azure Managed Lustre 파일 시스템 만들기

ARM(Azure Resource Manager) 템플릿을 사용하여 Azure Managed Lustre 파일 시스템 만들기를 자동화할 수 있습니다. 이 문서에서는 기본 절차를 설명하고 필요한 파일의 예를 제공합니다.

이 문서에서는 ARM 템플릿을 만들기 위한 두 가지 방법의 예를 제공합니다.

• JSON을 사용하여 ARM 템플릿을 직접 만듭니다. 자세한 내용은 JSON 템플릿 구문을 참조 하세요.
• 더 간단한 구문을 사용하여 구성 세부 정보를 제공하는 Bicep을 사용합니다. 템플릿을 배포하면 Bicep 파일이 ARM 템플릿 파일로 변환됩니다. 자세한 내용은 Bicep 설명서를 참조 하세요.

이러한 옵션에 대한 자세한 내용은 템플릿에 대한 JSON 및 Bicep 비교를 참조 하세요.

파일 시스템 유형 및 크기 선택

템플릿을 작성하기 전에 Azure Managed Lustre 파일 시스템에 대해 몇 가지 결정을 내려야 합니다. 구성 옵션에 대한 자세한 내용은 Azure Managed Lustre 파일 시스템 만들기의 설정 세부 정보를 참조하세요.

템플릿을 사용하는 경우 만들 Azure Managed Lustre 파일 시스템의 기본 형식을 정의하는 SKU를 지정합니다. SKU는 제품 계층을 나타냅니다. 디스크 유형, 지원되는 스토리지 양 및 최대 처리량 용량과 같은 시스템 품질을 설정합니다. Azure Portal을 사용하여 Azure Managed Lustre 파일 시스템을 만드는 경우 해당 기능을 선택하여 간접적으로 시스템 유형을 지정합니다.

다음 표에서는 지원되는 각 SKU의 처리량 및 스토리지 크기에 대한 값을 보여 줍니다. 이러한 SKU는 지속성 SSD 스토리지를 사용하는 파일 시스템을 만듭니다.

나열된 최대값보다 큰 스토리지 값이 필요한 경우 지원 티켓을 열어 옵션을 탐색할 수 있습니다.

SKU 기능을 확인하려면 Azure Portal을 사용하여 관리되는 Lustre 파일 시스템을 만드는 워크플로를 사용할 수 있습니다. SKU 관련 설정은 파일 시스템 세부 정보 아래의 기본 사항 탭에 있습니다.

템플릿 파일 만들기

구성 옵션을 결정한 후 템플릿 파일을 만들 수 있습니다. 템플릿 파일은 Azure Managed Lustre 파일 시스템에 대한 구성 세부 정보를 포함하는 JSON 또는 Bicep 파일입니다.

템플릿 속성 값

ARM 템플릿을 사용하여 Azure Managed Lustre 파일 시스템을 만들려면 템플릿 파일에 다음 정보를 포함해야 합니다. 정확한 구문은 Bicep과 JSON 간에 다르므로 리터럴 값에 대한 예제를 참조하세요.

파일 시스템

ID

속성

암호화 설정

HSM 설정

유지 관리 기간

이 속성은 timeOfDayUTC 24시간 클록 형식을 사용합니다. 예를 들어 22:30 오후 10시 30분입니다. 패턴은 .입니다 ^([0-9]|0[0-9]|1[0-9]|2[0-3]):[0-5][0-9]$.

루트 Squash 설정

SKU name

템플릿을 사용하여 파일 시스템 배포

다음 예제 단계에서는 Azure CLI 명령을 사용하여 새 리소스 그룹을 만들고 Azure Managed Lustre 파일 시스템을 만듭니다. 이 단계에서는 이 문서의 앞부분에서 설명한 대로 파일 시스템 형식 및 크기를 이미 선택하고 템플릿 파일을 만들었다고 가정합니다. 또한 모든 필수 구성 요소를 충족하는지 확인합니다.

1. 기본 구독을 설정합니다.

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

2. 필요에 따라 Azure Managed Lustre 파일 시스템에 대한 새 리소스 그룹을 만듭니다. 기존 리소스 그룹을 사용하려면 이 단계를 건너뛰고 템플릿 명령을 실행할 때 기존 리소스 그룹의 이름을 제공합니다.

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

   파일 시스템은 동일한 구독에 있는 한 자체 리소스 그룹 외부에서 리소스를 사용할 수 있습니다.

3. 템플릿을 사용하여 Azure Managed 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": "eastus",
            "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.net/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: 'eastus'
  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.net/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 개요