クイックスタート:Azure NetApp Files を設定し、NFS ボリュームを作成する

[アーティクル]
03/09/2023

この記事では、簡単に Azure NetApp Files を設定し、NFS ボリュームを作成する方法について説明します。

このクイックスタートでは、次の項目を設定します。

NetApp リソースプロバイダーの登録
NetApp アカウント
容量プール
Azure NetApp Files の NFS ボリューム

Azure サブスクリプションをお持ちでない場合は、開始する前に無料アカウントを作成してください。

NFS ボリュームで有効にできるすべての機能と関連する考慮事項については、[NFS ボリュームの作成]に関する記事を参照してください。

NetApp リソースプロバイダーを登録する

Note

登録プロセスは、完了するまでに時間がかかることがあります。

ポータルを使用して登録手順を行う場合は、前述のように Cloud Shell セッションを開き、次の Azure CLI の手順を実行します。

Azure NetApp Files に対して承認されているサブスクリプションを指定します。
```
az account set --subscription <subscriptionId>
```

Azure リソースプロバイダーを登録します。

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

このハウツー記事には、Azure PowerShell モジュール Az バージョン 2.6.0 以降が必要です。現在のバージョンを調べるには、Get-Module -ListAvailable Az を実行します。インストールまたはアップグレードする必要がある場合は、Azure PowerShell モジュールのインストールに関するページを参照してください。必要に応じて、PowerShell セッションで Cloud Shell コンソールを使用することもできます。

PowerShell コマンドプロンプト (または PowerShell Cloud Shell セッション) で、Azure NetApp Files に対して承認されているサブスクリプションを指定します。
```
Select-AzSubscription -Subscription <subscriptionId>
```

Azure リソースプロバイダーを登録します。

Register-AzResourceProvider -ProviderNamespace Microsoft.NetApp

Azure CLI の環境を準備します。

Azure Cloud Shell で Bash 環境を使用します。詳細については、「Azure Cloud Shell の Bash のクイックスタート」を参照してください。
CLI リファレンスコマンドをローカルで実行する場合、Azure CLI をインストールします。 Windows または macOS で実行している場合は、Docker コンテナーで Azure CLI を実行することを検討してください。詳細については、「Docker コンテナーで Azure CLI を実行する方法」を参照してください。
- ローカルインストールを使用する場合は、az login コマンドを使用して Azure CLI にサインインします。認証プロセスを完了するには、ターミナルに表示される手順に従います。その他のサインインオプションについては、Azure CLI でのサインインに関するページを参照してください。
- 初回使用時にインストールを求められたら、Azure CLI 拡張機能をインストールします。拡張機能の詳細については、Azure CLI で拡張機能を使用する方法に関するページを参照してください。
- az version を実行し、インストールされているバージョンおよび依存ライブラリを検索します。最新バージョンにアップグレードするには、az upgrade を実行します。

Azure NetApp Files に対して承認されているサブスクリプションを指定します。
```
az account set --subscription <subscriptionId>
```

Azure リソースプロバイダーを登録します。

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

NetApp アカウントを作成する

Azure portal の [検索] ボックスに「**Azure NetApp Files**」と入力し、表示された一覧から **[Azure NetApp Files]** を選択します。
[+ 作成] を選択し、新しい NetApp アカウントを作成します。
[新しい NetApp アカウント] ウィンドウで、次の情報を指定します。
1. アカウント名に「**myaccount1**」と入力します。
2. サブスクリプションを選択します。
3. **[新規作成]** を選択し、新しいリソースグループを作成します。リソースグループ名に「**myRG1**」と入力します。 [OK] を選択します。
4. アカウントの場所を選択します。
[作成] を選択し、新しい NetApp アカウントを作成します。

他の例でも参照できるように、いくつかの変数を定義します。
```
$resourceGroup = "myRG1"
$location = "eastus"
$anfAccountName = "myaccount1"
```
Note

サポートされているリージョンの一覧については、[リージョン別の利用可能な製品]を参照してください。コマンドラインツールでサポートされているリージョン名を取得するには、`Get-AzLocation | select Location` を使用してください。
[New-AzResourceGroup] コマンドを使用して、新しいリソースグループを作成します。
```
New-AzResourceGroup -Name $resourceGroup -Location $location
```
[New-AzNetAppFilesAccount] コマンドを使用して Azure NetApp Files アカウントを作成します。
```
New-AzNetAppFilesAccount -ResourceGroupName $resourceGroup -Location $location -Name $anfAccountName
```

他の例でも参照できるように、いくつかの変数を定義します。
```
RESOURCE_GROUP="myRG1"
LOCATION="eastus"
ANF_ACCOUNT_NAME="myaccount1"
```
Note

サポートされているリージョンの一覧については、[リージョン別の利用可能な製品]を参照してください。コマンドラインツールでサポートされているリージョン名を取得するには、`az account list-locations --query "[].{Region:name}" --out table` を使用してください。
[az group create] コマンドを使って新しいリソースグループを作成します。
```
az group create \
    --name $RESOURCE_GROUP \
    --location $LOCATION
```

[az netappfiles account create] コマンドを使用して Azure NetApp Files アカウントを作成します。

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

Azure Resource Manager テンプレートは JavaScript Object Notation (JSON) ファイルであり、プロジェクトのインフラストラクチャと構成が定義されています。このテンプレートでは、宣言型の構文が使用されています。デプロイしようとしているものを、デプロイを作成する一連のプログラミングコマンドを記述しなくても記述できます。

次のコードスニペットでは、[Microsoft.NetApp/netAppAccounts] リソースを使用して Azure Resource Manager テンプレート (ARM テンプレート) で NetApp アカウントを作成する方法を示しています。コードを実行するには、GitHub のリポジトリから[完全な ARM テンプレート]をダウンロードしてください。

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

容量プールの作成

Azure NetApp Files 管理ブレードで、自分の NetApp アカウント (**myaccount1**) を選択します。
NetApp アカウントの Azure NetApp Files 管理ブレードで、[容量プール] を選択します。
[+ プールの追加] を選択します。
容量プールの情報を指定します。
- プール名として「**mypool1**」と入力します。
- サービスレベルに **[Premium]** を選択します。
- プールサイズとして **4 (TiB)** を選択します。
- **[自動]** QoS タイプを使用します。
［作成］ を選択します

今後の参照用に新しい変数を定義する

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

[New-AzNetAppFilesPool](/powershell/module/az.netappfiles/new-aznetappfilespool) を使用して新しい容量プールを作成する

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

今後の参照用に新しい変数を定義する

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

[az netappfiles pool create](/cli/azure/netappfiles/pool#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

次のコードスニペットでは、[Microsoft.NetApp/netAppAccounts/capacityPools] リソースを使用して Azure Resource Manager テンプレート (ARM テンプレート) で容量プールを作成する方法を示しています。コードを実行するには、GitHub のリポジトリから[完全な ARM テンプレート]をダウンロードしてください。

{
  "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')]"
  }
},

Azure NetApp Files の NFS ボリュームを作成する

NetApp アカウントの Azure NetApp Files 管理ブレードで、[ボリューム] を選択します。
[+ ボリュームの追加] を選択します。
[ボリュームの作成] ウィンドウで、ボリュームの情報を指定します。
1. ボリューム名として「**myvol1**」と入力します。
2. 容量プールを選択します (**mypool1**)。
3. クォータの既定値を使用します。
4. 仮想ネットワークで [新規作成] を選択し、新しい Azure 仮想ネットワーク (VNet) を作成します。次の情報を入力します。
  - Vnet 名として「**myvnet1**」と入力します。
  - 10.7.0.0/16 など、自分の設定用のアドレス空間を指定します。
  - サブネット名として「**myANFsubnet**」と入力します。
  - 10.7.0.0/24 など、サブネットアドレス範囲を指定します。専用サブネットは他のリソースと共有できません。
  - サブネットの委任に **[Microsoft.NetApp/volumes]** を選択します。
  - [OK] を選択して、VNet を作成します。
5. サブネットで、新しく作成した Vnet (**myvnet1**) を委任サブネットとして選択します。
[プロトコル] を選択し、次のアクションを実行します。
- ボリュームのプロトコルの種類として [NFS] を選択します。
- ボリュームのエクスポートパスを作成する際に使用するファイルパスとして「**myfilepath1**」と入力します。
- ボリュームの NFS バージョン ( **[NFSv3]** または **[NFSv4.1]** ) を選択します。 NFS のバージョンについては、「[考慮事項](azure-netapp-files-create-volumes.md#considerations)」および「[ベストプラクティス](azure-netapp-files-create-volumes.md#best-practice)」を参照してください。
[確認および作成] を選択し、作成するボリュームの情報を表示します。
[作成] を選択してボリュームを作成します。作成されたボリュームが [ボリューム] ブレードに表示されます。

[New-AzDelegation](/powershell/module/az.network/new-azdelegation) コマンドを使用して、"Microsoft.NetApp/volumes" へのサブネットの委任を作成します。
```
$anfDelegation = New-AzDelegation -Name ([guid]::NewGuid().Guid) -ServiceName "Microsoft.NetApp/volumes"
```
[New-AzVirtualNetworkSubnetConfig](/powershell/module/az.network/new-azvirtualnetworksubnetconfig) コマンドを使用して、サブネットの構成を作成します。
```
$subnet = New-AzVirtualNetworkSubnetConfig -Name "myANFSubnet" -AddressPrefix "10.7.0.0/24" -Delegation $anfDelegation
```
[New-AzVirtualNetwork](/powershell/module/az.network/new-azvirtualnetwork) コマンドを使用して、仮想ネットワークを作成します。
```
$vnet = New-AzVirtualNetwork -Name "myvnet1" -ResourceGroupName $resourceGroup -Location $location -AddressPrefix "10.7.0.0/16" -Subnet $subnet
```

[New-AzNetAppFilesVolume](/powershell/module/az.netappfiles/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

後で使用するために、いくつかの変数を定義します。
```
VNET_NAME="myvnet1"
SUBNET_NAME="myANFSubnet"
```
[az network vnet create](/cli/azure/network/vnet#az_network_vnet_create) コマンドを使用して、サブネットがない仮想ネットワークを作成します。
```
az network vnet create \
    --resource-group $RESOURCE_GROUP \
    --name $VNET_NAME \
    --location $LOCATION \
    --address-prefix "10.7.0.0/16"
```

[az network vnet subnet create](/cli/azure/network/vnet/subnet#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"

[az netappfiles volume create](/cli/azure/netappfiles/volume#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 Resource Manager テンプレート (ARM テンプレート) で VNet を設定し、Azure NetApp Files ボリュームを作成する方法を示しています。 VNet の設定では、[Microsoft.Network/virtualNetworks] リソースを使用します。ボリュームの作成では、[Microsoft.NetApp/netAppAccounts/capacityPools/volumes] リソースを使用します。コードを実行するには、GitHub のリポジトリからコードを実行するには、GitHub のリポジトリから[完全な ARM テンプレート]をダウンロードしてください。

{
  "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 portal の [検索] ボックスに「**Azure NetApp Files**」と入力し、表示された一覧から **[Azure NetApp Files]** を選択します。
サブスクリプションの一覧で、削除するリソースグループ (myRG1) を選択します。
[リソースグループ] ページで、[リソースグループの削除] を選択します。

ウィンドウが開き、リソースグループと共に削除されるリソースに関する警告が表示されます。
リソースグループの名前 (myRG1) を入力して、リソースグループとその中のすべてのリソースを完全に削除することを確認してから、[削除] を選択します。

手順が終了していて必要な場合、リソースグループを削除することができます。リソースグループの削除操作は、元に戻すことができません。

重要

リソースグループ内のすべてのリソースが完全に削除され、元に戻すことはできません。

[Remove-AzResourceGroup](/powershell/module/az.resources/remove-azresourcegroup) コマンドを使用して、リソースグループを削除します。
```
Remove-AzResourceGroup -Name $resourceGroup
```

手順が終了していて必要な場合、リソースグループを削除することができます。リソースグループの削除操作は、元に戻すことができません。

重要

リソースグループ内のすべてのリソースが完全に削除され、元に戻すことはできません。