Quickstart: Azure NetApp Files instellen en een NFS-volume maken

Voor registratiestappen met behulp van Portal opent u een Cloud Shell-sessie zoals hierboven aangegeven en volgt u deze Azure CLI-stappen:

1. Geef het abonnement op dat is goedgekeurd voor Azure NetApp Files:

   az account set --subscription <subscriptionId>
   

2. Registreer de Azure-resourceprovider:

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

Voor dit artikel is de Azure PowerShell-module Az versie 2.6.0 of hoger vereist. Voer Get-Module -ListAvailable Az uit om uw huidige versie te vinden. Als u PowerShell wilt installeren of upgraden, raadpleegt u De Azure PowerShell-module installeren. Als u wilt, kunt u in plaats daarvan de Cloud Shell-console gebruiken in een PowerShell-sessie.

1. Geef in een PowerShell-opdrachtprompt (of PowerShell Cloud Shell-sessie) het abonnement op dat is goedgekeurd voor Azure NetApp Files:

   Select-AzSubscription -Subscription <subscriptionId>
   

2. Registreer de Azure-resourceprovider:

   Register-AzResourceProvider -ProviderNamespace Microsoft.NetApp
   

Bereid uw omgeving voor op de Azure CLI.

• Gebruik de Bash-omgeving in Azure Cloud Shell. Zie Aan de slag met Azure Cloud Shell voor meer informatie.

  

• Als je de voorkeur geeft aan het lokaal uitvoeren van CLI-referentiecommando's, installeer dan de Azure CLI. Als je op Windows of macOS werkt, overweeg dan om Azure CLI in een Docker-container te draaien. Voor meer informatie, zie Hoe u de Azure CLI in een Docker-container kunt uitvoeren.

  • Als u een lokale installatie gebruikt, meldt u zich aan bij Azure CLI met de opdracht az login. Om het authenticatieproces te voltooien, volgt u de stappen die op uw terminal worden weergegeven. Zie Verifiëren bij Azure met behulp van Azure CLI voor andere aanmeldingsopties.

  • Wanneer u daarom wordt gevraagd, installeer de Azure CLI-extensie bij het eerste gebruik. Zie Extensies gebruiken en beheren met de Azure CLIvoor meer informatie over extensies.

  • Voer az version uit om de geïnstalleerde versie en de afhankelijke bibliotheken te vinden. Voer az upgrade uit om naar de nieuwste versie te upgraden.

1. Geef het abonnement op dat is goedgekeurd voor Azure NetApp Files:

   az account set --subscription <subscriptionId>
   

2. Registreer de Azure-resourceprovider:

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

Geen.

Gebruik de Azure Portal, PowerShell of de Azure CLI om u te registreren voor NetApp Resource Provider.

Terraform maakt de definitie, preview en implementatie van de cloudinfrastructuur mogelijk. Met Terraform maakt u configuratiebestanden met behulp van HCL-syntaxis. Met de HCL-syntaxis kunt u de cloudprovider opgeven, zoals Azure, en de elementen waaruit uw cloudinfrastructuur bestaat. Nadat u uw configuratiebestanden hebt gemaakt, maakt u een uitvoeringsplan waarmee u een voorbeeld van uw infrastructuurwijzigingen kunt bekijken voordat ze worden geïmplementeerd. Zodra u de wijzigingen hebt gecontroleerd, past u het uitvoeringsplan toe om de infrastructuur te implementeren.

Gebruik de Azure Portal, Azure PowerShell of de Azure CLI om u te registreren voor NetApp Resource Provider.

1. Voer in het zoekvak van Azure Portal Azure NetApp Files in en selecteer vervolgens Azure NetApp Files in de lijst die wordt weergegeven.

   

2. Selecteer + Maken om een nieuw NetApp-account te maken.

3. Geef in het venster Nieuwe NetApp-account de volgende informatie op:

   1. Voer mijnaccount1 in voor de accountnaam.

   2. Selecteer uw abonnement.

   3. Selecteer Nieuwe maken om een nieuwe resourcegroep te maken. Voer myRG1 in voor de naam van de resourcegroep. Kies OK.

   4. Selecteer de locatie van uw account.

      

      

4. Selecteer Maken om uw nieuwe NetApp-account te maken.

1. Definieer enkele variabelen, zodat we ernaar kunnen verwijzen in de rest van de voorbeelden:

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

   Opmerking

   Raadpleeg Producten die beschikbaar zijn per regio voor een lijst met ondersteunde regio's. Om de regionaam te verkrijgen die wordt ondersteund door onze opdrachtregelprogramma's, gebruikt u Get-AzLocation | select Location

2. Maak een nieuwe resourcegroep met behulp van de opdracht New-AzResourceGroup :

   New-AzResourceGroup -Name $resourceGroup -Location $location
   

3. Maak een Azure NetApp Files-account met de opdracht New-AzNetAppFilesAccount :

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

1. Definieer enkele variabelen, zodat we ernaar kunnen verwijzen in de rest van de voorbeelden:

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

   Opmerking

   Raadpleeg Producten die beschikbaar zijn per regio voor een lijst met ondersteunde regio's. Om de regionaam te verkrijgen die wordt ondersteund door onze opdrachtregelprogramma's, gebruikt u az account list-locations --query "[].{Region:name}" --out table

2. Maak een nieuwe resourcegroep met behulp van de opdracht az group create :

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

3. Maak een Azure NetApp Files-account met de opdracht az netappfiles-account maken :

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

Een Azure Resource Manager-sjabloon is een JSON-bestand (JavaScript Object Notation) dat de infrastructuur en configuratie voor uw project definieert. De sjabloon maakt gebruik van declaratieve syntaxis. U beschrijft de beoogde implementatie zonder de reeks programmeeropdrachten te schrijven om de implementatie te maken.

In het volgende codefragment ziet u hoe u een NetApp-account maakt in een Azure Resource Manager-sjabloon (ARM-sjabloon) met behulp van de resourcebron Microsoft.NetApp/netAppAccounts . Om de code uit te voeren, downloadt u de volledige ARM-sjabloon van onze GitHub-repo.

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

In het volgende codefragment ziet u hoe u een NetApp-account maakt met Terraform. De voorbeeldcode voor dit artikel bevindt zich in de Azure Terraform GitHub-opslagplaats. U kunt het logboekbestand met de testresultaten van de huidige en vorige versies van Terraform bekijken.

# 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. Selecteer op de Azure NetApp Files-beheerblade uw NetApp-account (myaccount1).

   

2. Selecteer op de Azure NetApp Files-beheerblade van uw NetApp-account de optie Capaciteitspools.

   

3. Selecteer + Pools toevoegen.

   

4. Geef informatie op voor de capaciteitspool:

   • Voer mypool1 in als de naam van de pool.
   • Selecteer Premium voor het serviceniveau.
   • Geef 4 (TiB) op als de grootte van de pool.
   • Gebruik het type Auto QoS.

5. Klik op Creëren.

1. Definiëren van enkele nieuwe variabelen voor toekomstig gebruik

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

2. Maak een nieuwe capaciteitspool met behulp van de New-AzNetAppFilesPool

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

1. Definiëren van enkele nieuwe variabelen voor toekomstig gebruik

   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. Maak een nieuwe capaciteitspool met behulp van de 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
   

In het volgende codefragment ziet u hoe u een capaciteitsgroep maakt in een Azure Resource Manager-sjabloon (ARM-sjabloon) met behulp van de resource Microsoft.NetApp/netAppAccounts/capacityPools . Om de code uit te voeren, downloadt u de volledige ARM-sjabloon van onze GitHub-repo.

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

In het volgende codefragment ziet u hoe u een NetApp-capaciteitspool maakt met Terraform. De voorbeeldcode voor dit artikel bevindt zich in de Azure Terraform GitHub-opslagplaats. U kunt het logboekbestand met de testresultaten van de huidige en vorige versies van Terraform bekijken.

# 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. Selecteer op de Azure NetApp Files-beheerblade van uw NetApp-account de optie Volumes.

   

2. Selecteer + Volume toevoegen.

   

3. Geef in het venster Een volume maken informatie op voor het volume:

   1. Voer myvol1 in als de volumenaam.

   2. Selecteer uw capaciteitspool (mypool1).

   3. Gebruik de standaardwaarde voor quotum.

   4. Selecteer onder virtueel netwerk de optie Nieuw maken om een nieuw virtueel Azure-netwerk (VNet) te maken. Vul dan de volgende gegevens in:

      • Voer myvnet1 in als de naam van Vnet.
      • Geef een adresruimte op voor uw instelling, bijvoorbeeld 10.7.0.0/16
      • Voer myANFsubnet in als de naam van het subnet.
      • Geef het adresbereik van het subnet op, bijvoorbeeld 10.7.0.0/24. U kunt het toegewezen subnet niet delen met andere bronnen.
      • Selecteer Microsoft.NetApp/volumes voor subnetdelegatie.
      • Selecteer OK om de VNet te maken.

   5. Selecteer in het subnet het nieuw gemaakte Vnet (myvnet1) als het gedelegeerde subnet.

      

      

4. Selecteer Protocol en voer de volgende acties uit:

   • Selecteer NFS als protocoltype voor het volume.
   • Voer myfilepath1 in voor het bestandspad dat is gebruikt om het exportpad voor het volume te maken.
   • Selecteer de NFS-versie (NFSv3 of NFSv4.1) voor het volume. Bekijk overwegingen en best practices over NFS-versies.

   

5. Selecteer Controleren + maken om informatie weer te geven voor het volume dat u maakt.

6. Klik op Maken om het volume aan te maken. Het gemaakte volume wordt weergegeven op de blade Volumes.

   

1. Maak een subnetdelegatie naar 'Microsoft.NetApp/volumes' met de opdracht New-AzDelegation .

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

2. Maak een subnetconfiguratie met behulp van de opdracht New-AzVirtualNetworkSubnetConfig .

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

3. Maak het virtuele netwerk met behulp van de opdracht New-AzVirtualNetwork .

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

4. Maak het volume met behulp van de opdracht 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. Het definiëren van enkele variabelen voor later gebruik.

   VNET_NAME="myvnet1"
   SUBNET_NAME="myANFSubnet"
   

2. Maak een virtueel netwerk zonder subnet met behulp van de opdracht 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. Maak een gedelegeerd subnet met behulp van de opdracht 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. Maak het volume met behulp van de opdracht 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"
   

In de volgende codefragmenten ziet u hoe u een VNet instelt en een Azure NetApp Files-volume maakt in een Azure Resource Manager-sjabloon (ARM-sjabloon). De installatie van VNet maakt gebruik van de resourcebron Microsoft.Network/virtualNetworks . Voor het maken van volumes wordt gebruikgemaakt van de resourcebron Microsoft.NetApp/netAppAccounts/capacityPools/volumes . Om de code uit te voeren, downloadt u de volledige ARM-sjabloon van onze GitHub-repo.

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

In de volgende codefragmenten ziet u hoe u een VNet instelt en een Azure NetApp Files-volume maakt met behulp van Terraform. De voorbeeldcode voor dit artikel bevindt zich in de Azure Terraform GitHub-opslagplaats. U kunt het logboekbestand met de testresultaten van de huidige en vorige versies van Terraform bekijken.

# 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
  }
}

Als u klaar bent en als u dat wilt, kunt u de resourcegroep verwijderen. Het verwijderen van een resourcegroep is onomkeerbaar.

1. Voer in het zoekvak van Azure Portal Azure NetApp Files in en selecteer vervolgens Azure NetApp Files in de lijst die wordt weergegeven.

2. Selecteer in de lijst met abonnementen de resourcegroep (myRG1) die u wilt verwijderen.

   

3. Selecteer op de pagina van de resourcegroep de optie Resourcegroep verwijderen.

   

   Er wordt een venster geopend waarin een waarschuwing wordt weergegeven over de resources die moeten worden verwijderd met de resourcegroep.

4. Voer de naam van de resourcegroep (myRG1) in om te bevestigen dat u de resourcegroep en alle resources erin permanent wilt verwijderen en selecteer vervolgens Verwijderen.

   

Als u klaar bent en als u dat wilt, kunt u de resourcegroep verwijderen. Het verwijderen van een resourcegroep is onomkeerbaar.

1. Verwijder de resourcegroep met behulp van de opdracht Remove-AzResourceGroup .

   Remove-AzResourceGroup -Name $resourceGroup
   

Als u klaar bent en als u dat wilt, kunt u de resourcegroep verwijderen. Het verwijderen van een resourcegroep is onomkeerbaar.

1. Verwijder resourcegroep met behulp van de opdracht az group delete .

   az group delete \
       --name $RESOURCE_GROUP
   

Geen.

Gebruik de Azure Portal, PowerShell of de Azure CLI om de resourcegroep te verwijderen.

Voer de volgende stappen uit wanneer u de resources die zijn gemaakt via Terraform niet meer nodig hebt:

1. Voer terraform-plan uit en geef de destroy vlag op.

   terraform plan -destroy -out main.destroy.tfplan
   

   Belangrijkste punten:

   • De terraform plan opdracht maakt een uitvoeringsplan, maar voert het niet uit. In plaats daarvan wordt bepaald welke acties nodig zijn om de configuratie te maken die is opgegeven in uw configuratiebestanden. Met dit patroon kunt u controleren of het uitvoeringsplan aan uw verwachtingen voldoet voordat u wijzigingen aanbrengt in de werkelijke resources.
   • Met de optionele -out parameter kunt u een uitvoerbestand voor het plan opgeven. Door de -out parameter te gebruiken, zorgt u ervoor dat het plan dat u hebt gecontroleerd precies wordt toegepast.

2. Voer terraform apply uit om het uitvoeringsplan toe te passen.

   terraform apply main.destroy.tfplan