Azure Resource Manager şablonlarını kullanarak Azure Yönetilen Lustre dosya sistemini İçerik Oluşturucu

Makale
02/24/2024

Azure Resource Manager şablonlarını kullanarak Azure Yönetilen Lustre dosya sistemi oluşturmayı otomatikleştirebilirsiniz. Bu makalede temel yordam açıklanır ve ihtiyacınız olan dosyalara örnekler verilmektedir.

Şablonlar hakkında daha fazla bilgi için bkz. Azure Resource Manager şablonları.

Bu makalede, Azure Resource Manager şablonları oluşturmaya yönelik iki farklı yönteme örnekler verilmektedir:

Doğrudan Azure Resource Manager şablonları oluşturmak için JSON kullanın. Bkz. JSON şablonu söz dizimi.
Yapılandırma ayrıntılarını sağlamak için daha basit söz dizimini kullanan Bicep'i kullanın. Şablonu dağıttığınızda, Bicep dosyaları Azure Resource Manager şablon dosyalarına dönüştürülür. Bicep belgelerine bakın.

Seçenekleriniz hakkında daha fazla bilgi edinmek için bkz. Şablonlar için JSON ve Bicep karşılaştırması.

Dosya sistemi türünü ve boyutunu seçme

Şablon yazmadan önce Azure Yönetilen Lustre dosya sisteminiz hakkında bazı kararlar almalısınız. Yapılandırma seçenekleri hakkında daha fazla bilgi edinmek için Azure Yönetilen Lustre dosya sistemi İçerik Oluşturucu kurulum ayrıntılarına bakın.

Şablon kullanırken, oluşturulacak temel Azure Yönetilen Lustre sistemi türünü tanımlamak için bir SKU adı belirtin. Azure Yönetilen Lustre'ınızı oluşturmak için Azure portal kullanırsanız, özelliklerini seçerek sistem türünü dolaylı olarak belirtirsiniz.

Azure'da SKU terimi, oluşturulan kaynak için bir dizi özellik tanımlar. Azure Yönetilen Lustre dosya sistemi için SKU, kullanılan disklerin türü, desteklenen depolama alanı miktarı ve maksimum aktarım hızı kapasitesi gibi sistem niteliklerini ayarlar.

Şu anda aşağıdaki SKU'lar desteklenmektedir:

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

Bu SKU'lar dayanıklı SSD depolama kullanan bir dosya sistemi oluşturur. Aşağıdaki tabloda her SKU için aktarım hızı ve depolama boyutu değerleri gösterilmektedir:

SKU	TiB depolama başına aktarım hızı	Depolama Dk	Depolama En Fazla¹	Artış
AMLFS-Durable-Premium-40	40 MB/saniye	48 TB	768 TB	48 TB
AMLFS-Durable-Premium-125	125 MB/saniye	16 TB	128 TB	16 TB
AMLFS-Durable-Premium-250	250 MB/saniye	8 TB	128 TB	8 TB
AMLFS-Durable-Premium-500	500 MB/saniye	4 TB	128 TB	4 TB

¹ Listelenen maksimum değerden daha büyük depolama değerlerine ihtiyacınız varsa, seçenekleri keşfetmek için bir destek bileti açabilirsiniz .

SKU özelliklerini denetlemek için Azure portal'de iş akışı oluşturma özelliğini kullanabilirsiniz. SKU'ya özgü ayarlar, Dosya sistemi ayrıntıları altındaki Temel Bilgiler sekmesindedir.

İpucu

Kullanılabilir SKU adlarını denetlemek için kullanabileceğiniz bir komut için gerekli bilgiler bölümüne bakın.

Şablon dosyası İçerik Oluşturucu

Yapılandırma seçeneklerine karar verdikten sonra bir şablon dosyası oluşturabilirsiniz. Şablon dosyası, Azure Yönetilen Lustre dosya sisteminizin yapılandırma ayrıntılarını içeren bir JSON veya Bicep dosyasıdır. Bu bölümde, şablon dosyanıza eklemek için gerekli ve isteğe bağlı bilgiler açıklanmaktadır.

Tüm olası yapılandırma seçeneklerini içeren dosyalar için bkz . Örnek JSON dosyaları ve Örnek Bicep dosyası.

Gerekli bilgiler

Bu bölümde, Azure Yönetilen Lustre dosya sistemi oluşturmak için Azure Resource Manager şablon dosyalarınıza eklemeniz gereken bilgiler açıklanmaktadır. Tam söz dizimi Bicep ile JSON arasında farklıdır, bu nedenle değişmez değerler için her dil türüne ilişkin örneklere bakın.

Oluşturulacak kaynak türü - Bu değer, Azure Resource Manager değerinin Microsoft.StorageCache/amlFileSystems ve API sürümünün bir bileşimini geçirerek Azure Yönetilen Lustre dosya sistemi oluşturduğunuzu bildirir.

Kaynak türünü oluşturmanın birkaç yolu vardır:
- Bu makalenin JSON örneğinde, kaynak türü değeri tam olarak template.json dosyasına geçirilir, ancak API sürüm değeri parameters.json dosyasından okunur.
- Bicep örneğinde, kaynak türü ve API sürümü şablon dosyasının başında birlikte geçirilir.

API sürümü - Oluşturulacak Azure Yönetilen Lustre sürümü.

Geçerli API sürümünü bulmak için:

az provider show --namespace Microsoft.StorageCache --query "resourceTypes[?resourceType=='amlFilesystems'].apiVersions" --out table

SKU adı - Veya dosya sisteminin AMLFS-Durable-Premium-125AMLFS-Durable-Premium-250performans modeli.

Kullanılabilir SKU'ları bulmak için aşağıdaki komutu kullanın (geçerli API sürümünü kullanın):
```
az rest --url https://management.azure.com/subscriptions/<subscription_id>/providers/Microsoft.StorageCache/skus/?api-version=<version> | jq '.value[].name' | grep AMLFS| uniq
```
Konum - Dosya sisteminin oluşturulduğu Azure bölgesinin adı.

Azure Yönetilen Lustre'ın desteklendiği bölgeleri ve kullanılabilirlik alanlarını bulmak için:
```
az provider show --namespace Microsoft.StorageCache --query "resourceTypes[?resourceType=='amlFilesystems'].zoneMappings[].{location: location, zones: to_string(zones)}" --out table
```
Not

Bu komut, Azure bölgelerinin görünen adlarını verir; daha kısa name bir değer kullanmanız gerekir (örneğin, "Doğu ABD" yerine "eastus" kullanın).

Bu komut görünen addan kısa adı döndürür. Batı ABD bir örnektir; bu komut döndürür westus:
```
az account list-locations --query "[?displayName=='West US'].name" --output tsv
```
Kullanılabilirlik alanı - Azure bölgesinde kullanılacak kullanılabilirlik alanı.

Kullanılabilirlik alanlarını bulmak için Konum'da önceki komutu kullanın. Sisteminiz için tek bir kullanılabilirlik alanı belirtin.
Dosya sistemi adı - Bu Azure Yönetilen Lustre dosya sisteminin kullanıcı tarafından görünen adı.
Dosya sistemi alt ağı - Dosya sisteminin kullandığı alt ağ. Alt ağ URI'sini sağlayın; örneğin, /subscriptions/<SubscriptionID>/resourceGroups/<VnetResourceGroupName>/providers/Microsoft.Network/virtualNetworks/<VnetName>/subnets/<SubnetName>.
Depolama kapasitesi - Azure Yönetilen Lustre kümenizin TiB'deki boyutu. Değerler SKU'ya bağlıdır. Daha fazla bilgi için bkz. Dosya sistemi türünü ve boyutunu seçme.
Bakım süresi - Bakım süresini ayarlayan iki değer gerektirir. Bu değerler, sistem güncelleştirmelerinin yapılabilmesi için haftalık 30 dakikalık bir süre tanımlar.
- Haftanın günü (örneğin, Sunday)
- Günün saati (UTC) (örneğin, 22:00)

İsteğe bağlı bilgiler

Bu bölümdeki parametreler isteğe bağlıdır veya yalnızca belirli özellikleri kullanıyorsanız gereklidir.

Etiketler - Azure kaynak meta veri etiketlerini ayarlamak istiyorsanız bu seçeneği kullanın.
Blob tümleştirme ayarları - Bu dosya sistemiyle tümleşik bir Blob Depolama kapsayıcısı kullanmak için bu değerleri sağlayın. Daha fazla bilgi için bkz . Blob tümleştirmesi.
- Kapsayıcı - Lustre hiyerarşik depolama yönetimi (HSM) için kullanılacak blob kapsayıcısının kaynak kimliği.
- Günlük kapsayıcısı - İçeri ve dışarı aktarma günlüklerini tutmak için ayrı bir kapsayıcının kaynak kimliği. Günlük kapsayıcısı, veri kapsayıcısı ile aynı depolama hesabında olmalıdır.
- İçeri aktarma ön eki (isteğe bağlı) - Bu değer sağlanmışsa yalnızca içeri aktarma ön eki dizesiyle başlayan bloblar Azure Yönetilen Lustre Dosya Sistemi'ne aktarılır. Sağlamazsanız, kapsayıcıdaki tüm blobların içeri aktarılacağını belirten varsayılan değer olur /.
Müşteri tarafından yönetilen anahtar ayarları - Azure Yönetilen Lustre sisteminde verilerinizi şifrelemek için kullanılan şifreleme anahtarlarını denetlemek için bir Azure Key Vault kullanmak istiyorsanız bu değerleri sağlayın. Varsayılan olarak veriler Microsoft tarafından yönetilen şifreleme anahtarları kullanılarak şifrelenir.
- Kimlik türü - Müşteri tarafından yönetilen anahtarları açmak için bunu UserAssigned olarak ayarlayın.
- Şifreleme Key Vault - Şifreleme anahtarlarını depolayan Azure Key Vault kaynak kimliği.
- Şifreleme anahtarı URL'si - Verilerinizi şifrelemek için kullanılacak anahtarın tanımlayıcısı.
- Yönetilen kimlik - Azure Yönetilen Lustre dosya sisteminin Azure Key Vault erişmek için kullandığı kullanıcı tarafından atanan yönetilen kimlik. Daha fazla bilgi için bkz. Müşteri tarafından yönetilen şifreleme anahtarlarını kullanma.

Şablonu kullanarak dosya sistemini dağıtma

Bu örnek adımlarda, yeni bir kaynak grubu oluşturmak ve içinde bir Azure Yönetilen Lustre dosya sistemi oluşturmak için Azure CLI komutları kullanılır.

Dağıtmadan önce aşağıdaki adımları tamamladığınızdan emin olun:

Bir dosya sistemi türü ve boyutu seçin
Şablon dosyası İçerik Oluşturucu
Tüm önkoşulların karşılandığından emin olun.

Şablon kullanarak dosya sistemini dağıtmak için şu adımları izleyin:

Varsayılan aboneliğinizi ayarlayın:

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

İsteğe bağlı olarak, Azure Yönetilen Lustre dosya sisteminiz için yeni bir kaynak grubu oluşturun. Var olan bir kaynak grubunu kullanmak istiyorsanız, bu adımı atlayın ve şablon komutunu yürütürken mevcut kaynak grubunun adını belirtin.
```
az group create --name <ResourceGroupName> --location <RegionShortname>
```
Dosya sisteminiz, aynı abonelikte oldukları sürece kendi kaynak grubunun dışındaki kaynakları kullanabilir.
Şablonu kullanarak Azure Yönetilen Lustre dosya sistemini dağıtın. Söz dizimi, JSON veya Bicep dosyalarını kullanmanıza ve kullandığınız dosya sayısına bağlı olarak farklılık gösterir.

Hem Bicep hem de JSON şablonlarını tek dosya veya birden çok dosya olarak dağıtabilirsiniz. Daha fazla bilgi edinmek ve her seçeneğin tam söz dizimini görmek için Azure Resource Manager şablonları belgelerine bakın.

Örnek JSON komutu:
```
az deployment group create \
  --name <ExampleDeployment> \
  --resource-group <ResourceGroupName> \
  --template-file azlustre-template.json \
  --parameters @azlustre-parameters.json
```
Örnek Bicep komutu:
```
az deployment group create \
 --resource-group <ResourceGroupName> \
 --template-file azlustre.bicep
```

Örnek JSON dosyaları

Bu bölümde, bir şablon dosyası ve ayrı bir parametre dosyası için örnek içerik gösterilmektedir. Bu dosyalar tüm olası yapılandırma seçeneklerini içerir. Kendi Azure Resource Manager şablonunuzu oluştururken isteğe bağlı parametreleri kaldırabilirsiniz.

Şablon dosyası

Bu bölümde şablon dosyasının örnek içeriği gösterilir:

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

Parametre dosyası

Bu bölümde parametre dosyasının örnek içeriği gösterilir:

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

Örnek Bicep dosyası

Bu örnek, Azure Yönetilen Lustre şablonundaki tüm olası değerleri içerir. Şablonunuzu oluştururken, istemediğiniz isteğe bağlı değerleri kaldırın.

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

Sonraki adımlar

Azure Yönetilen Lustre Dosya Sistemine genel bakış

Aracılığıyla paylaş