Быстрый старт: настройка Azure NetApp Files и создание тома NFS

Чтобы выполнить регистрацию с помощью портала, откройте сеанс Cloud Shell, как указано выше, и выполните следующие действия на интерфейсе командной строки Azure:

1. Укажите подписку, которая была утверждена для Azure NetApp Files.

   az account set --subscription <subscriptionId>
   

2. Зарегистрируйте поставщик ресурсов Azure.

   az provider register --namespace Microsoft.NetApp --wait  
   

Для работы с этой статьей требуется модуль Azure PowerShell Az 2.6.0 или более поздней версии. Чтобы узнать, какая версия используется сейчас, выполните команду Get-Module -ListAvailable Az. Если вам нужно установить или обновить, см. раздел "Установка модуля Azure PowerShell". При желании вместо сеанса PowerShell можно использовать консоль Cloud Shell.

1. В командной строке PowerShell (или сеансе Cloud Shell PowerShell) укажите подписку, которая была утверждена для Azure NetApp Files:

   Select-AzSubscription -Subscription <subscriptionId>
   

2. Зарегистрируйте поставщик ресурсов Azure.

   Register-AzResourceProvider -ProviderNamespace Microsoft.NetApp
   

Подготовьте среду к работе с Azure CLI.

• Используйте среду Bash в Azure Cloud Shell. Дополнительные сведения см. в статье "Начало работы с Azure Cloud Shell".

  

• Если вы предпочитаете локально запускать справочные команды CLI, установите Azure CLI. Если вы работаете в Windows или macOS, Azure CLI можно запустить в контейнере Docker. Дополнительные сведения см. в статье о запуске Azure CLI в контейнере Docker.

  • Если вы используете локальную установку, войдите в Azure CLI с помощью команды az login . Чтобы выполнить аутентификацию, следуйте инструкциям в окне терминала. Сведения о других параметрах входа см. в статье "Проверка подлинности в Azure с помощью Azure CLI".

  • Установите расширение Azure CLI при первом использовании, когда появится соответствующий запрос. Дополнительные сведения о расширениях см. в статье "Использование расширений и управление ими" с помощью Azure CLI.

  • Запустите az version , чтобы найти установленные версии и зависимые библиотеки. Чтобы обновить до последней версии, выполните az upgrade.

1. Укажите подписку, которая была утверждена для Azure NetApp Files.

   az account set --subscription <subscriptionId>
   

2. Зарегистрируйте поставщик ресурсов Azure.

   az provider register --namespace Microsoft.NetApp --wait  
   

Нет.

Используйте портал Azure, PowerShell или Azure CLI для регистрации для поставщика ресурсов NetApp.

Terraform включает определение, предварительную версию и развертывание облачной инфраструктуры. С помощью Terraform вы создаете файлы конфигурации с помощью синтаксиса HCL. Синтаксис HCL позволяет указать поставщика облачных служб, таких как Azure, и элементы, составляющие облачную инфраструктуру. После создания файлов конфигурации вы создадите план выполнения , который позволяет предварительно просмотреть изменения инфраструктуры перед развертыванием. После проверки изменений примените план выполнения для развертывания инфраструктуры.

Используйте портал Azure, Azure PowerShell или Azure CLI для регистрации для поставщика ресурсов NetApp.

1. В поле поиска портала Azure введите Azure NetApp Files и выберите Azure NetApp Files в появившемся списке.

   

2. Нажмите кнопку +Создать , чтобы создать новую учетную запись NetApp.

3. В окне "New NetApp Account" (Новая учетная запись NetApp) укажите следующую информацию.

   1. Введите myaccount1 для имени учетной записи.

   2. Выберите свою подписку.

   3. Нажмите кнопку "Создать" , чтобы создать новую группу ресурсов. Введите myRG1 для имени группы ресурсов. Нажмите кнопку "ОК".

   4. Выберите расположение учетной записи.

      

      

4. Выберите "Создать", чтобы создать новую учетную запись NetApp.

1. Определите некоторые переменные, чтобы мы могли ссылаться на них во всех остальных примерах:

   $resourceGroup = "myRG1"
   $location = "eastus"
   $anfAccountName = "myaccount1"
   

   Примечание.

   Ознакомьтесь со сведениями о продуктах, доступных по регионам , чтобы получить список поддерживаемых регионов. Чтобы получить имя региона, которое поддерживается нашими средствами командной строки, используйте Get-AzLocation | select Location

2. Создайте новую группу ресурсов с помощью команды New-AzResourceGroup :

   New-AzResourceGroup -Name $resourceGroup -Location $location
   

3. Создайте учетную запись Azure NetApp Files с помощью команды New-AzNetAppFilesAccount :

   New-AzNetAppFilesAccount -ResourceGroupName $resourceGroup -Location $location -Name $anfAccountName
   

1. Определите некоторые переменные, чтобы мы могли ссылаться на них во всех остальных примерах:

   RESOURCE_GROUP="myRG1"
   LOCATION="eastus"
   ANF_ACCOUNT_NAME="myaccount1"
   

   Примечание.

   Ознакомьтесь со сведениями о продуктах, доступных по регионам , чтобы получить список поддерживаемых регионов. Чтобы получить имя региона, которое поддерживается нашими средствами командной строки, используйте az account list-locations --query "[].{Region:name}" --out table

2. Создайте новую группу ресурсов с помощью команды az group create :

   az group create \
       --name $RESOURCE_GROUP \
       --location $LOCATION
   

3. Создайте учетную запись Azure NetApp Files с помощью команды az netappfiles account create:

   az netappfiles account create \
       --resource-group $RESOURCE_GROUP \
       --location $LOCATION \
       --account-name $ANF_ACCOUNT_NAME
   

Шаблон Azure Resource Manager — это файл нотации объектов JavaScript (JSON), который определяет инфраструктуру и конфигурацию проекта. В шаблоне используется декларативный синтаксис. Вы описываете предполагаемое развертывание без написания последовательности команд программирования для создания развертывания.

В следующем фрагменте кода показано, как создать учетную запись NetApp в шаблоне Azure Resource Manager (шаблон ARM) с помощью ресурса Microsoft.NetApp/netAppAccounts . Чтобы запустить код, скачайте полный шаблон ARM из репозитория GitHub.

{
  "type": "Microsoft.NetApp/netAppAccounts",
  "apiVersion": "2020-06-01",
  "name": "[parameters('netAppAccountName')]",
  "location": "[parameters('location')]",
  "properties": {}
},

В следующем фрагменте кода показано, как создать учетную запись NetApp с помощью Terraform. Пример кода для этой статьи находится в репозитории Azure Terraform GitHub. Вы можете просмотреть файл журнала, содержащий результаты теста из текущих и предыдущих версий Terraform.

# Create NetApp Account
resource "azurerm_netapp_account" "account" {
  name                = "account-${random_string.name.result}"
  resource_group_name = azurerm_resource_group.rg.name
  location            = azurerm_resource_group.rg.location
}

1. В колонке управления Azure NetApp Files выберите учетную запись NetApp (myaccount1).

   

2. На панели управления Azure NetApp Files в вашем аккаунте NetApp выберите пулы емкости.

   

3. Выберите + Добавить пулы.

   

4. Укажите сведения о пуле емкости.

   • Введите mypool1 в качестве имени пула.
   • Выберите "Премиум" для уровня обслуживания.
   • Укажите 4 (TiB) в качестве размера пула.
   • Используйте тип auto QoS.

5. Нажмите кнопку "Создать".

1. Определение новых переменных для дальнейшего использования

   $poolName = "mypool1"
   $poolSizeBytes = 4398046511104 # 4TiB
   $serviceLevel = "Premium" # Valid values are Standard, Premium and Ultra
   

2. Создайте новый пул емкости с помощью New-AzNetAppFilesPool

   New-AzNetAppFilesPool -ResourceGroupName $resourceGroup -Location $location -AccountName $anfAccountName -Name $poolName -PoolSize $poolSizeBytes -ServiceLevel $serviceLevel
   

1. Определение новых переменных для дальнейшего использования

   POOL_NAME="mypool1"
   POOL_SIZE_TiB=4 # Size in Azure CLI needs to be in TiB unit (minimum 4 TiB)
   SERVICE_LEVEL="Premium" # Valid values are Standard, Premium and Ultra
   

2. Создайте новый пул емкости с помощью az netappfiles pool create

   az netappfiles pool create \
       --resource-group $RESOURCE_GROUP \
       --location $LOCATION \
       --account-name $ANF_ACCOUNT_NAME \
       --pool-name $POOL_NAME \
       --size $POOL_SIZE_TiB \
       --service-level $SERVICE_LEVEL
   

В следующем фрагменте кода показано, как создать пул емкости в шаблоне Azure Resource Manager (шаблон ARM) с помощью ресурса Microsoft.NetApp/netAppAccounts/capacityPools . Чтобы запустить код, скачайте полный шаблон ARM из репозитория GitHub.

{
  "type": "Microsoft.NetApp/netAppAccounts/capacityPools",
  "apiVersion": "2020-06-01",
  "name": "[variables('capacityPoolName')]",
  "location": "[parameters('location')]",
  "dependsOn": [
    "[resourceId('Microsoft.NetApp/netAppAccounts', parameters('netAppAccountName'))]"
  ],
  "properties": {
    "serviceLevel": "[parameters('serviceLevel')]",
    "size": "[parameters('poolSizeBytes')]"
  }
},

В следующем фрагменте кода показано, как создать пул емкости NetApp с помощью Terraform. Пример кода для этой статьи находится в репозитории Azure Terraform GitHub. Вы можете просмотреть файл журнала, содержащий результаты теста из текущих и предыдущих версий Terraform.

# Create NetApp Pool
resource "azurerm_netapp_pool" "pool" {
  name                = "pool-${random_string.name.result}"
  resource_group_name = azurerm_resource_group.rg.name
  account_name        = azurerm_netapp_account.account.name
  location            = azurerm_resource_group.rg.location
  service_level       = "Premium"
  size_in_tb          = 4
}

1. В панели управления Azure NetApp Files учетной записи NetApp выберите тома.

   

2. Выберите +Добавить объем.

   

3. В окне "Создать том" укажите сведения о томе.

   1. Введите myvol1 в качестве имени тома.

   2. Выберите пул емкости (mypool1).

   3. Используйте значение квоты по умолчанию.

   4. В виртуальной сети выберите "Создать" , чтобы создать виртуальную сеть Azure. Затем укажите следующие сведения.

      • Введите myvnet1 в качестве имени виртуальной сети.
      • Укажите диапазон адресов для параметра, например 10.7.0.0/16.
      • Введите myANFsubnet в качестве имени подсети.
      • Укажите диапазон адресов подсети, например 10.7.0.0/24. Невозможно использовать выделенную подсеть совместно с другими ресурсами.
      • Выберите Microsoft.NetApp/volumes для делегирования подсети .
      • Нажмите кнопку "ОК ", чтобы создать виртуальную сеть.

   5. В подсети выберите только что созданную виртуальную сеть (myvnet1) в качестве подсети делегата.

      

      

4. Выберите протокол и выполните следующие действия:

   • Выберите NFS в качестве типа протокола для тома.
   • Введите myfilepath1 для пути к файлу, используемому для создания пути экспорта тома.
   • Выберите версию NFS (NFSv3 или NFSv4.1) для тома. Ознакомьтесь с соображениями и наилучшей практикой по версиям NFS.

   

5. Выберите "Рецензирование" и "Создать ", чтобы отобразить сведения о создаваемом томе.

6. Выберите Создать, чтобы создать том. Созданный том появится во вкладке "Тома".

   

1. Создайте делегирование подсети для "Microsoft.NetApp/volumes" с помощью команды New-AzDelegation.

   $anfDelegation = New-AzDelegation -Name ([guid]::NewGuid().Guid) -ServiceName "Microsoft.NetApp/volumes"
   

2. Создайте конфигурацию подсети с помощью команды New-AzVirtualNetworkSubnetConfig .

   $subnet = New-AzVirtualNetworkSubnetConfig -Name "myANFSubnet" -AddressPrefix "10.7.0.0/24" -Delegation $anfDelegation
   

3. Создайте виртуальную сеть с помощью команды New-AzVirtualNetwork .

   $vnet = New-AzVirtualNetwork -Name "myvnet1" -ResourceGroupName $resourceGroup -Location $location -AddressPrefix "10.7.0.0/16" -Subnet $subnet
   

4. Создайте том с помощью команды New-AzNetAppFilesVolume.

   $volumeSizeBytes = 1099511627776 # 100GiB
   $subnetId = $vnet.Subnets[0].Id
   
   New-AzNetAppFilesVolume -ResourceGroupName $resourceGroup `
       -Location $location `
       -AccountName $anfAccountName `
       -PoolName $poolName `
       -Name "myvol1" `
       -UsageThreshold $volumeSizeBytes `
       -SubnetId $subnetId `
       -CreationToken "myfilepath1" `
       -ServiceLevel $serviceLevel `
       -ProtocolType NFSv3
   

1. Определение некоторых переменных для последующего использования.

   VNET_NAME="myvnet1"
   SUBNET_NAME="myANFSubnet"
   

2. Создайте виртуальную сеть без подсети с помощью команды az network vnet create .

   az network vnet create \
       --resource-group $RESOURCE_GROUP \
       --name $VNET_NAME \
       --location $LOCATION \
       --address-prefix "10.7.0.0/16"
   
   

3. Создайте делегированную подсеть с помощью команды az network vnet subnet create .

   az network vnet subnet create \
       --resource-group $RESOURCE_GROUP \
       --vnet-name $VNET_NAME \
       --name $SUBNET_NAME \
       --address-prefixes "10.7.0.0/24" \
       --delegations "Microsoft.NetApp/volumes"
   

4. Создайте том с помощью команды az netappfiles volume create .

   VNET_ID=$(az network vnet show --resource-group $RESOURCE_GROUP --name $VNET_NAME --query "id" -o tsv)
   SUBNET_ID=$(az network vnet subnet show --resource-group $RESOURCE_GROUP --vnet-name $VNET_NAME --name $SUBNET_NAME --query "id" -o tsv)
   VOLUME_SIZE_GiB=100 # 100 GiB
   UNIQUE_FILE_PATH="myfilepath2" # Please note that creation token needs to be unique within subscription and region
   
   az netappfiles volume create \
       --resource-group $RESOURCE_GROUP \
       --location $LOCATION \
       --account-name $ANF_ACCOUNT_NAME \
       --pool-name $POOL_NAME \
       --name "myvol1" \
       --service-level $SERVICE_LEVEL \
       --vnet $VNET_ID \
       --subnet $SUBNET_ID \
       --usage-threshold $VOLUME_SIZE_GiB \
       --file-path $UNIQUE_FILE_PATH \
       --protocol-types "NFSv3"
   

В следующих фрагментах кода показано, как настроить виртуальную сеть и создать том Azure NetApp Files в шаблоне Azure Resource Manager (ARM). Программа установки виртуальной сети использует ресурс Microsoft.Network/virtualNetworks . Создание тома использует ресурс Microsoft.NetApp/netAppAccounts/capacityPools/volumes. Чтобы запустить код, скачайте полный шаблон ARM из репозитория GitHub.

{
  "type": "Microsoft.Network/virtualNetworks",
  "apiVersion": "2020-06-01",
  "name": "[parameters('virtualNetworkName')]",
  "location": "[parameters('location')]",
  "properties": {
    "addressSpace": {
      "addressPrefixes": [
        "[parameters('vnetAddressPrefix')]"
      ]
    },
    "subnets": [
      {
        "name": "[parameters('subnetName')]",
        "properties": {
          "addressPrefix": "[parameters('subnetAddressPrefix')]",
          "delegations": [
            {
              "name": "NetAppDelegation",
              "properties": {
                "serviceName": "Microsoft.NetApp/volumes"
              }
            }
          ]
        }
      }
    ]
  }
},

{
  "type": "Microsoft.NetApp/netAppAccounts/capacityPools/volumes",
  "apiVersion": "2020-06-01",
  "name": "[variables('volumeName')]",
  "location": "[parameters('location')]",
  "dependsOn": [
    "[resourceId('Microsoft.NetApp/netAppAccounts/capacityPools', parameters('netAppAccountName'), parameters('netAppPoolName'))]",
    "[resourceId('Microsoft.Network/virtualNetworks', parameters('virtualNetworkName'))]"
  ],
  "properties": {
    "serviceLevel": "[parameters('serviceLevel')]",
    "creationToken": "[parameters('netAppVolumeName')]",
    "usageThreshold": "[parameters('volSizeBytes')]",
    "exportPolicy": {
      "rules": [
        {
          "ruleIndex": 1,
          "unixReadOnly": "[parameters('unixReadOnly')]",
          "unixReadWrite": "[parameters('unixReadWrite')]",
          "cifs": false,
          "nfsv3": "[if(equals( parameters('protocolTypes'), 'NFSv3'),bool('true'),bool('false'))]",
          "nfsv41": "[if(equals(parameters('protocolTypes'), 'NFSv4.1'),bool('true'),bool('false'))]",
          "allowedClients": "[parameters('allowedClients')]"
        }
      ]
    },
    "protocolTypes": [
      "[parameters('protocolTypes')]"
    ],
    "subnetId": "[resourceId('Microsoft.Network/virtualNetworks/subnets', parameters('virtualNetworkName'), parameters('subnetName'))]",
    "snapshotDirectoryVisible": "[parameters('snapshotDirectoryVisible')]"
  }
}

В следующих фрагментах кода показано, как настроить виртуальную сеть и создать том Azure NetApp Files с помощью Terraform. Пример кода для этой статьи находится в репозитории Azure Terraform GitHub. Вы можете просмотреть файл журнала, содержащий результаты теста из текущих и предыдущих версий Terraform.

# Create Virtual Network
resource "azurerm_virtual_network" "vnet" {
  name                = "vnet-${random_string.name.result}"
  address_space       = ["10.0.0.0/16"]
  location            = azurerm_resource_group.rg.location
  resource_group_name = azurerm_resource_group.rg.name
}

# Create Subnet for NetApp
resource "azurerm_subnet" "subnet" {
  name                 = "subnet-${random_string.name.result}"
  resource_group_name  = azurerm_resource_group.rg.name
  virtual_network_name = azurerm_virtual_network.vnet.name
  address_prefixes     = ["10.0.0.0/24"]
  delegation {
    name = "delegation"

    service_delegation {
      name = "Microsoft.Netapp/volumes"
      actions = [
        "Microsoft.Network/networkinterfaces/*",
        "Microsoft.Network/virtualNetworks/subnets/join/action"
      ]
    }
  }
}

# Create NetApp Volume
resource "azurerm_netapp_volume" "volume" {
  name                = "volume-${random_string.name.result}"
  resource_group_name = azurerm_resource_group.rg.name
  account_name        = azurerm_netapp_account.account.name
  pool_name           = azurerm_netapp_pool.pool.name
  location            = azurerm_resource_group.rg.location
  volume_path         = "volume-${random_string.name.result}"
  protocols           = ["NFSv4.1"]
  service_level       = "Premium"
  subnet_id           = azurerm_subnet.subnet.id
  storage_quota_in_gb = 100
  export_policy_rule {
    rule_index        = 1
    allowed_clients   = ["0.0.0.0/0"]
    protocols_enabled = ["NFSv4.1"]
    unix_read_only    = false
    unix_read_write   = true
  }
}

Когда вы закончите и хотите, можно удалить группу ресурсов. Удаление группы ресурсов — необратимая операция.

1. В поле поиска портала Azure введите Azure NetApp Files и выберите Azure NetApp Files в появившемся списке.

2. В списке подписок выберите группу ресурсов (myRG1), которую вы хотите удалить.

   

3. На странице группы ресурсов выберите "Удалить группу ресурсов".

   

   Откроется окно и отобразится предупреждение о ресурсах, которые необходимо удалить с помощью группы ресурсов.

4. Введите имя группы ресурсов (myRG1), чтобы убедиться, что вы хотите окончательно удалить группу ресурсов и все ресурсы в ней, а затем нажмите кнопку "Удалить".

   

Когда вы закончите и хотите, можно удалить группу ресурсов. Удаление группы ресурсов — необратимая операция.

1. Удалите группу ресурсов с помощью команды Remove-AzResourceGroup .

   Remove-AzResourceGroup -Name $resourceGroup
   

Когда вы закончите и хотите, можно удалить группу ресурсов. Удаление группы ресурсов — необратимая операция.

1. Удалите группу ресурсов с помощью команды az group delete .

   az group delete \
       --name $RESOURCE_GROUP
   

Нет.

Чтобы удалить группу ресурсов, используйте портал Azure, PowerShell или Azure CLI.

Если вам больше не нужны ресурсы, созданные через Terraform, выполните следующие действия:

1. Запустите terraform plan и укажите флаг в destroy.

   terraform plan -destroy -out main.destroy.tfplan
   

   Ключевые моменты:

   • Команда terraform plan создает план выполнения, но не выполняет его. Вместо этого он определяет, какие действия необходимы для создания конфигурации, указанной в ваших конфигурационных файлах. Данный шаблон позволяет вам убедиться, что план выполнения соответствует вашим ожиданиям, прежде чем вносить какие-либо изменения в реальные ресурсы.
   • Необязательный параметр -out позволяет указать выходной файл для плана. Использование параметра -out обеспечивает, что план, который вы просмотрели, будет применен точно в таком виде.

2. Чтобы применить план выполнения, запустите terraform apply.

   terraform apply main.destroy.tfplan