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 você precisar instalar ou atualizar, consulte Instalar o módulo do Azure PowerShell. Se preferir, você pode usar o console do Cloud Shell em uma sessão do PowerShell.

1. Num prompt de comando do PowerShell (ou numa sessão do PowerShell Cloud Shell), indique a subscrição que foi aprovada para os 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 Introdução ao 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 você estiver usando uma instalação local, entre na CLI do Azure usando 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 Autenticar no Azure usando a CLI do Azure.

  • Quando solicitado, instale a extensão da CLI do Azure na primeira utilização. Para obter mais informações sobre extensões, consulte Usar e gerenciar extensões com a CLI do Azure.

  • Execute az version para localizar a versão e as bibliotecas dependentes que estão instaladas. Para atualizar para a versão mais recente, execute 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.

Terraform permite a definição, visualização e implantação de infraestrutura em nuvem. Usando Terraform, você cria arquivos de configuração usando a sintaxe HCL. A sintaxe HCL permite especificar o provedor de nuvem - como o Azure - e os elementos que compõem sua infraestrutura de nuvem. Depois de criar os arquivos de configuração, você cria um plano de execução que permite visualizar as alterações na infraestrutura antes que elas sejam implantadas. Depois de verificar as alterações, você aplica o plano de execução para implantar a infraestrutura.

Use o portal do Azure, o Azure 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": {}
},

O trecho de código a seguir mostra como criar uma conta NetApp usando o Terraform. O código de exemplo para este artigo está localizado no repositório GitHub do Azure Terraform. Você pode visualizar o arquivo de log que contém os resultados do teste das versões atual e anterior do 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. Na barra lateral de gestão de ficheiros NetApp do Azure, selecione a sua conta NetApp (myaccount1).

   

2. Na barra lateral de gestão de ficheiros do Azure NetApp, selecione Pools de capacidade.

   

3. Selecione + Adicionar conjuntos.

   

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. Crie um novo pool de capacidade utilizando o comando 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')]"
  }
},

O trecho de código a seguir mostra como criar um pool de capacidade NetApp usando o Terraform. O código de exemplo para este artigo está localizado no repositório GitHub do Azure Terraform. Você pode visualizar o arquivo de log que contém os resultados do teste das versões atual e anterior do 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. Na barra lateral Azure NetApp Files 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:

      • Introduza myvnet1 como nome da 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 podes partilhar 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. Na sub-rede, selecione o VNet recém-criado (myvnet1) como sub-rede de delegados.

      

      

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.
   • Seleciona Desativado para Kerberos e LDAP (para o início rápido).
   • Opcionalmente, configure permissões Unix. Para mais informações, consulte Configurar permissões UNIX.
   • Deixe Azure VMware Solution DataStore desmarcado.

   

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

6. Selecione Criar para criar o volume. O volume criado aparece no menu 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 az network vnet create comando.

   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 az network vnet subnet create comandos.

   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 az netappfiles volume create comando.

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

Os trechos de código a seguir mostram como configurar uma VNet e criar um volume de Arquivos NetApp do Azure usando o Terraform. O código de exemplo para este artigo está localizado no repositório GitHub do Azure Terraform. Você pode visualizar o arquivo de log que contém os resultados do teste das versões atual e anterior do 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
  }
}

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.

Quando você não precisar mais dos recursos criados via Terraform, execute as seguintes etapas:

1. Execute terraform plan e especifique o destroy flag.

   terraform plan -destroy -out main.destroy.tfplan
   

   Pontos principais:

   • O comando terraform plan cria um plano de execução, mas não o executa. Em vez disso, ele determina quais ações são necessárias para criar a configuração especificada em seus arquivos de configuração. Esse padrão permite que você verifique se o plano de execução corresponde às suas expectativas antes de fazer quaisquer alterações nos recursos reais.
   • O parâmetro opcional -out permite especificar um arquivo de saída para o plano. O uso do -out parâmetro garante que o plano revisado seja exatamente o que é aplicado.

2. Execute terraform apply para aplicar o plano de execução.

   terraform apply main.destroy.tfplan