Guia de início rápido: configurar arquivos NetApp do Azure e criar um volume NFS

Para 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 Arquivos NetApp do Azure:

   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 Az do Azure PowerShell versão 2.6.0 ou posterior. Execute Get-Module -ListAvailable Az para encontrar a versão atual. Se precisar de instalar ou atualizar, veja Install Azure PowerShell module(Instalar o módulo do Azure PowerShell). Se preferir, você pode usar o console do Cloud Shell em uma sessão do PowerShell.

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

   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, consulte Guia de início rápido para Bash no Azure Cloud Shell.

  

• Se preferir executar comandos de referência da CLI localmente, instale a CLI do Azure. Se estiver a utilizar o Windows ou macOS, considere executar a CLI do Azure num contentor Docker. Para obter mais informações, consulte Como executar a CLI do Azure em um contêiner do Docker.

  • Se estiver a utilizar uma instalação local, inicie sessão no CLI do Azure ao utilizar o comando az login. Para concluir o processo de autenticação, siga os passos apresentados no seu terminal. Para outras opções de entrada, consulte Entrar com a CLI do Azure.

  • Quando solicitado, instale a extensão da CLI do Azure na primeira utilização. Para obter mais informações sobre as extensões, veja Utilizar extensões com o CLI do Azure.

  • Execute o comando az version para localizar a versão e as bibliotecas dependentes instaladas. Para atualizar para a versão mais recente, execute o comando az upgrade.

1. Especifique a assinatura que foi aprovada para Arquivos NetApp do Azure:

   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 NetApp Resource Provider.

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

   

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

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

   1. Digite myaccount1 para o nome da conta.

   2. Selecione a sua subscrição.

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

   4. Selecione a localização da sua conta.

      

      

4. Selecione Criar para criar sua nova conta NetApp.

1. Defina algumas variáveis para que possamos nos referir a elas ao longo do resto dos exemplos:

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

   Nota

   Consulte Produtos disponíveis por região para obter uma lista das regiões suportadas. Para obter o nome da região que é suportado pelas nossas ferramentas de linha de comando, utilize Get-AzLocation | select Location

2. Crie um novo 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 que possamos nos referir a elas ao longo do resto dos exemplos:

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

   Nota

   Consulte Produtos disponíveis por região para obter uma lista das regiões suportadas. Para obter o nome da região que é suportado pelas nossas ferramentas de linha de comando, utilize az account list-locations --query "[].{Region:name}" --out table

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

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

3. Criar conta do Azure NetApp Files com az netappfiles account create command:

   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 utiliza sintaxe declarativa. Você descreve a implantação pretendida sem escrever a sequência de comandos de programação para criar a implantação.

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

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

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

   

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

   

3. Selecione + Adicionar pools.

   

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

   • Digite 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 de QoS automático .

5. Selecione Criar.

1. Definição de algumas novas variáveis para referência futura

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

2. Criar um novo pool de capacidade usando o New-AzNetAppFilesPool

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

1. Definição de 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. Criar um novo pool de capacidade usando 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 trecho de código a seguir mostra como criar um pool de capacidade em um modelo do Azure Resource Manager (modelo ARM), usando o recurso Microsoft.NetApp/netAppAccounts/capacityPools . Para executar o código, baixe o modelo ARM completo do 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 de Arquivos NetApp do Azure da sua conta NetApp, selecione Volumes.

   

2. Selecione + Adicionar volume.

   

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

   1. Digite myvol1 como o nome do volume.

   2. Selecione o seu pool de capacidade (mypool1).

   3. Use o valor padrão para quota.

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

      • Digite myvnet1 como o nome Vnet.
      • Especifique um espaço de endereço para sua configuração, por exemplo, 10.7.0.0/16
      • Digite 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 delegação de sub-rede.
      • Selecione OK para criar a rede virtual.

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

      

      

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

   • Selecione NFS como o tipo de protocolo para o volume.
   • Digite myfilepath1 para o caminho de arquivo usado para criar o caminho de exportação para o volume.
   • Selecione a versão NFS (NFSv3 ou NFSv4.1) para o volume. Consulte as considerações e as práticas recomendadas sobre as versões do NFS.

   

5. Selecione Rever + criar para apresentar informações sobre o volume que está a criar.

6. Selecione Criar para criar o volume. O volume criado aparece 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. Definição de algumas variáveis para uso posterior.

   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 trechos de código a seguir mostram como configurar uma VNet e criar um volume de Arquivos NetApp do Azure em um modelo do Azure Resource Manager (modelo ARM). A instalação da VNet usa o recurso Microsoft.Network/virtualNetworks . A criação de volumes usa o recurso Microsoft.NetApp/netAppAccounts/capacityPools/volumes . Para executar o código, baixe o modelo ARM completo do 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 se quiser, pode eliminar o grupo de recursos. A ação de excluir um grupo de recursos é irreversível.

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

2. Na lista de subscrições, selecione o grupo de recursos (myRG1) que pretende eliminar.

   

3. Na página do 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. Introduza o nome do grupo de recursos (myRG1) para confirmar que pretende eliminar permanentemente o grupo de recursos e todos os recursos nele contidos e, em seguida, selecione Eliminar.

   

Quando terminar e se quiser, pode eliminar o grupo de recursos. A ação de excluir um grupo de recursos é irreversível.

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

   Remove-AzResourceGroup -Name $resourceGroup
   

Quando terminar e se quiser, pode eliminar o grupo de recursos. A ação de excluir 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.