Início Rápido: Configurar o Azure NetApp Files e criar um volume do NFS

Para obter as etapas de registro usando o Portal, abra uma sessão do Cloud Shell conforme indicado acima e siga estas etapas da CLI do Azure:

1. Especifique a assinatura que foi aprovada para o Azure NetApp Files:

   az account set --subscription <subscriptionId>
   

2. Registre o provedor de recursos do Azure:

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

Este artigo de instruções requer o módulo do Azure PowerShell, versão Az 2.6.0 ou posterior. Execute Get-Module -ListAvailable Az para localizar a versão atual. Se você precisar instalá-lo ou atualizá-lo, confira Instalar o módulo do Azure PowerShell. Se preferir, poderá usar o console do Cloud Shell em uma sessão do PowerShell.

1. Em um prompt de comando do PowerShell (ou em uma sessão do Cloud Shell do PowerShell), especifique a assinatura que foi aprovada para o Azure NetApp Files:

   Select-AzSubscription -Subscription <subscriptionId>
   

2. Registre o provedor de recursos do Azure:

   Register-AzResourceProvider -ProviderNamespace Microsoft.NetApp
   

Prepare seu ambiente para a CLI do Azure.

• Use o ambiente Bash no Azure Cloud Shell. Para obter mais informações, confira Início Rápido para Bash no Azure Cloud Shell.

  

• Se preferir executar os comandos de referência da CLI localmente, instale a CLI do Azure. Para execuções no Windows ou no macOS, considere executar a CLI do Azure em um contêiner do Docker. Para obter mais informações, confira Como executar a CLI do Azure em um contêiner do Docker.

  • Se estiver usando uma instalação local, entre com a CLI do Azure usando o comando az login. Para concluir o processo de autenticação, siga as etapas exibidas no terminal. Para ver outras opções de entrada, confira Conectar-se com a CLI do Azure.

  • Quando solicitado, instale a extensão da CLI do Azure no primeiro uso. Para obter mais informações sobre extensões, confira Usar extensões com a CLI do Azure.

  • Execute az version para localizar a versão e as bibliotecas dependentes que estão instaladas. Para fazer a atualização para a versão mais recente, execute az upgrade.

1. Especifique a assinatura que foi aprovada para o Azure NetApp Files:

   az account set --subscription <subscriptionId>
   

2. Registre o provedor de recursos do Azure:

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

Nenhum.

Use o portal do Azure, o PowerShell ou a CLI do Azure para se registrar no Provedor de Recursos do NetApp.

1. Na caixa de pesquisa do portal do Azure, insira Azure NetApp Files e, em seguida, selecione Azure NetApp Files na lista exibida.

   

2. Selecione + Criar para criar uma conta do NetApp.

3. Na janela Nova Conta do NetApp, forneça as seguintes informações:

   1. Insira myaccount1 para o nome da conta.

   2. Selecione sua assinatura.

   3. Selecione Criar novo para criar o grupo de recursos. Insira myRG1 para o nome do grupo de recursos. Selecione OK.

   4. Selecione a localização da conta.

      

      

4. Selecione Criar para criar sua conta do NetApp.

1. Defina algumas variáveis para podermos consultá-las durante o restante dos exemplos:

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

   Observação

   Veja os Produtos disponíveis por região para obter uma lista de regiões compatíveis. Para obter o nome da região compatível com nossas ferramentas de linha de comando, use Get-AzLocation | select Location

2. Crie um grupo de recursos usando o comando New-AzResourceGroup:

   New-AzResourceGroup -Name $resourceGroup -Location $location
   

3. Crie uma conta do Azure NetApp Files com o comando New-AzNetAppFilesAccount:

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

1. Defina algumas variáveis para podermos consultá-las durante o restante dos exemplos:

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

   Observação

   Veja os Produtos disponíveis por região para obter uma lista de regiões compatíveis. Para obter o nome da região compatível com nossas ferramentas de linha de comando, use az account list-locations --query "[].{Region:name}" --out table

2. Crie um grupo de recursos usando o comando az group create:

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

3. Crie uma conta do Azure NetApp Files com o comando az netappfiles account create:

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

Um Modelo do Azure Resource Manager é um arquivo JSON (JavaScript Object Notation) que define a infraestrutura e a configuração do seu projeto. O modelo usa a sintaxe declarativa. Você descreve a implantação pretendida sem escrever a sequência de comandos de programação para criar a implantação.

O snippet de código a seguir mostrará como criar uma conta do NetApp em um modelo ARM (modelo do Azure Resource Manager) usando o recurso Microsoft.NetApp/netAppAccounts. Para executar o código, baixe o modelo ARM completo de nosso repositório GitHub.

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

1. Na folha de gerenciamento do Azure NetApp Files, selecione sua conta do NetApp (myaccount1).

   

2. Na folha de gerenciamento do Azure NetApp Files de sua conta do NetApp, selecione Pools de capacidade.

   

3. Selecione + Adicionar pools.

   

4. Forneça informações para o pool de capacidade:

   • Insira mypool1 como o nome do pool.
   • Selecione Premium para o nível de serviço.
   • Especifique 4 (TiB) como o tamanho do pool.
   • Use o tipo QoS Automático.

5. Selecione Criar.

1. Definir algumas novas variáveis para referência futura

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

2. Crie um pool de capacidade usando o New-AzNetAppFilesPool

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

1. Definir algumas novas variáveis para referência futura

   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. Crie um pool de capacidade usando o 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
   

O snippet de código a seguir mostrará como criar um pool de capacidade em um modelo ARM (modelo do Azure Resource Manager) usando o recurso Microsoft.NetApp/netAppAccounts/capacityPools. Para executar o código, baixe o modelo ARM completo de nosso repositório 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')]"
  }
},

1. Na folha de gerenciamento do Azure NetApp Files de sua conta do NetApp, selecione Volumes.

   

2. Selecione + Adicionar volume.

   

3. Na janela Criar um Volume, forneça informações para o volume:

   1. Insira myvol1 como o nome do volume.

   2. Selecione o pool de capacidade (mypool1).

   3. Use o valor padrão para a cota.

   4. Na rede virtual, selecione Criar nova para criar uma VNet (rede virtual) do Azure. Em seguida, preencha as seguintes informações:

      • Insira myvnet1 como o nome da VNET.
      • Especifique um espaço de endereço para a configuração, por exemplo, 10.7.0.0/16
      • Insira myANFsubnet como o nome da sub-rede.
      • Especifique o intervalo de endereços da sub-rede, por exemplo, 10.7.0.0/24. Não é possível compartilhar a sub-rede dedicada com outros recursos.
      • Selecione Microsoft.NetApp/volumes para a delegação da sub-rede.
      • Selecione OK para criar a VNet.

   5. Na sub-rede, selecione a VNET recém-criada (myvnet1) como a sub-rede delegada.

      

      

4. Selecione Protocolo e, em seguida, conclua as seguintes ações:

   • Selecione NFS como o tipo de protocolo para o volume.
   • Insira myfilepath1 para o caminho do arquivo usado para criar o caminho de exportação para o volume.
   • Selecione a versão do NFS (NFSv3 ou NFSv4.1) para o volume. Confira considerações e melhor prática sobre versões de NFS.

   

5. Selecione Examinar + criar para exibir informações para o volume que está sendo criado.

6. Selecione Criar para criar o volume. O volume criado será exibido na folha Volumes.

   

1. Crie uma delegação de sub-rede para “Microsoft.NetApp/volumes” com o comando New-AzDelegation.

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

2. Crie uma configuração de sub-rede usando o comando New-AzVirtualNetworkSubnetConfig.

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

3. Crie a rede virtual usando o comando New-AzVirtualNetwork.

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

4. Crie o volume usando o comando 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. Definir algumas variáveis para uso futuro.

   VNET_NAME="myvnet1"
   SUBNET_NAME="myANFSubnet"
   

2. Crie uma rede virtual sem sub-rede usando o comando 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. Crie uma sub-rede delegada usando o comando 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. Crie o volume usando o comando 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"
   

Os snippets de código a seguir mostrarão como configurar uma VNet e criar um volume do Azure NetApp Files em um modelo ARM (modelo do Azure Resource Manager). A configuração da VNet usará o recurso Microsoft.Network/virtualNetworks. A criação de volume usará o recurso Microsoft.NetApp/netAppAccounts/capacityPools/volumes. Para executar o código, baixe o modelo ARM completo de nosso repositório 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')]"
  }
}

Quando terminar e quiser, você poderá excluir o grupo de recursos. A ação de exclusão de um grupo de recursos é irreversível.

1. Na caixa de pesquisa do portal do Azure, insira Azure NetApp Files e, em seguida, selecione Azure NetApp Files na lista exibida.

2. Na lista de assinaturas, selecione o grupo de recursos (myRG1) que você quer excluir.

   

3. Na página Grupo de recursos, selecione Excluir grupo de recursos.

   

   Uma janela é aberta e exibe um aviso sobre os recursos a serem excluídos com o grupo de recursos.

4. Insira o nome do grupo de recursos (myRG1) para confirmar que você deseja excluir permanentemente o grupo de recursos e todos os recursos contidos nele e, em seguida, selecione Excluir.

   

Quando terminar e quiser, você poderá excluir o grupo de recursos. A ação de exclusão de um grupo de recursos é irreversível.

1. Exclua o grupo de recursos usando o comando Remove-AzResourceGroup.

   Remove-AzResourceGroup -Name $resourceGroup
   

Quando terminar e quiser, você poderá excluir o grupo de recursos. A ação de exclusão de um grupo de recursos é irreversível.

1. Exclua o grupo de recursos usando o comando az group delete.

   az group delete \
       --name $RESOURCE_GROUP
   

Nenhum.

Use o portal do Azure, o PowerShell ou a CLI do Azure para excluir o grupo de recursos.