Avvio rapido: configurare Azure NetApp Files e creare un volume NFS

Per la procedura di registrazione tramite il portale, aprire una sessione Cloud Shell come indicato in precedenza e seguire questi passaggi dell'interfaccia della riga di comando di Azure:

1. Specificare la sottoscrizione che è stata approvata per Azure NetApp Files:

   az account set --subscription <subscriptionId>
   

2. Registrare il provider di risorse di Azure:

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

Questa procedura richiede il modulo Azure PowerShell Az 2.6.0 o versioni successive. Eseguire Get-Module -ListAvailable Az per trovare la versione corrente. Se è necessario eseguire l'installazione o l'aggiornamento, vedere come installare il modulo Azure PowerShell. Se si preferisce, è possibile usare la console di Cloud Shell in una sessione di PowerShell.

1. In un prompt dei comandi di PowerShell (o in una sessione di Cloud Shell di PowerShell) specificare la sottoscrizione che è stata approvata per Azure NetApp Files:

   Select-AzSubscription -Subscription <subscriptionId>
   

2. Registrare il provider di risorse di Azure:

   Register-AzResourceProvider -ProviderNamespace Microsoft.NetApp
   

Preparare l'ambiente per l'interfaccia della riga di comando di Azure.

• Usare l'ambiente Bash in Azure Cloud Shell. Per altre informazioni, vedere Avvio rapido su Bash in Azure Cloud Shell.

  

• Se si preferisce eseguire i comandi di riferimento dell'interfaccia della riga di comando in locale, installare l'interfaccia della riga di comando di Azure. Per l'esecuzione in Windows o macOS, è consigliabile eseguire l'interfaccia della riga di comando di Azure in un contenitore Docker. Per altre informazioni, vedere Come eseguire l'interfaccia della riga di comando di Azure in un contenitore Docker.

  • Se si usa un'installazione locale, accedere all'interfaccia della riga di comando di Azure con il comando az login. Per completare il processo di autenticazione, seguire la procedura visualizzata nel terminale. Per altre opzioni di accesso, vedere Accedere tramite l'interfaccia della riga di comando di Azure.

  • Quando richiesto, al primo utilizzo installare l'estensione dell'interfaccia della riga di comando di Azure. Per altre informazioni sulle estensioni, vedere Usare le estensioni con l'interfaccia della riga di comando di Azure.

  • Eseguire az version per trovare la versione e le librerie dipendenti installate. Per eseguire l'aggiornamento alla versione più recente, eseguire az upgrade.

1. Specificare la sottoscrizione che è stata approvata per Azure NetApp Files:

   az account set --subscription <subscriptionId>
   

2. Registrare il provider di risorse di Azure:

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

Nessuno.

Usare il portale di Azure, PowerShell o l'interfaccia della riga di comando di Azure per registrarsi per il provider di risorse NetApp.

1. Nella casella di ricerca del portale di Azure immettere Azure NetApp Files e quindi selezionare Azure NetApp Files dall'elenco visualizzato.

   

2. Selezionare + Crea per creare un nuovo account NetApp.

3. Nella finestra New NetApp Account (Nuovo account NetApp) specificare le informazioni seguenti:

   1. Immettere myaccount1 nel campo relativo al nome dell'account.

   2. Selezionare la propria sottoscrizione.

   3. Selezionare Crea nuovo per creare un nuovo gruppo di risorse. Immettere myRG1 nel campo relativo al nome del gruppo di risorse. Seleziona OK.

   4. Selezionare la località dell'account.

      

      

4. Selezionare Crea per creare il nuovo account NetApp.

1. Definire alcune variabili in modo che sia possibile farvi riferimento nei restanti esempi:

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

   Nota

   Per un elenco delle aree supportate, vedere Prodotti disponibili in base all'area. Per ottenere il nome dell'area supportato dagli strumenti da riga di comando, usare Get-AzLocation | select Location

2. Creare un nuovo gruppo di risorse con il comando New-AzResourceGroup:

   New-AzResourceGroup -Name $resourceGroup -Location $location
   

3. Creare l'account Azure NetApp Files con il comando New-AzNetAppFilesAccount:

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

1. Definire alcune variabili in modo che sia possibile farvi riferimento nei restanti esempi:

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

   Nota

   Per un elenco delle aree supportate, vedere Prodotti disponibili in base all'area. Per ottenere il nome dell'area supportato dagli strumenti da riga di comando, usare az account list-locations --query "[].{Region:name}" --out table

2. Creare un nuovo gruppo di risorse con il comando az group create:

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

3. Creare l'account Azure NetApp Files con il comando az netappfiles account create:

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

Un modello di Azure Resource Manager è un file JSON (JavaScript Object Notation) che definisce l'infrastruttura e la configurazione del progetto. Il modello utilizza la sintassi dichiarativa. Si descrive la distribuzione prevista senza scrivere la sequenza di comandi di programmazione necessari per creare la distribuzione.

Il frammento di codice seguente mostra come creare un account NetApp in un modello di Azure Resource Manager (modello ARM), usando la risorsa Microsoft.NetApp/netAppAccounts. Per eseguire il codice, scaricare il modello di Azure Resource Manager completo dal repository GitHub.

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

1. Nel pannello di gestione di Azure NetApp Files selezionare l'account di NetApp appena creato (myaccount1).

   

2. Nel pannello di gestione di Azure NetApp Files dell'account NetApp selezionare Pool di capacità.

   

3. Selezionare + Aggiungi pool.

   

4. Specificare le informazioni relative al pool di capacità:

   • Immettere mypool1 come nome del pool.
   • Selezionare Premium come livello di servizio.
   • Specificare 4 (TiB) come dimensione del pool.
   • Usare il tipo QoS Automatico.

5. Seleziona Crea.

1. Definizione di alcune nuove variabili per riferimento futuro

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

2. Creare un nuovo pool di capacità usando il comando New-AzNetAppFilesPool

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

1. Definizione di alcune nuove variabili per riferimento futuro

   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. Creare un nuovo pool di capacità usando il 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
   

Il frammento di codice seguente mostra come creare un pool di capacità in un modello di Azure Resource Manager (modello ARM), usando la risorsa Microsoft.NetApp/netAppAccounts/capacityPools. Per eseguire il codice, scaricare il modello di Azure Resource Manager completo dal repository 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. Nel pannello di gestione di Azure NetApp Files dell'account NetApp selezionare Volumi.

   

2. Selezionare + Aggiungi volume.

   

3. Nella finestra Crea un volume specificare le informazioni relative al volume:

   1. Immettere myvol1 come nome del volume.

   2. Selezionare il pool di capacità appena creato (mypool1).

   3. Usare il valore predefinito per la quota.

   4. In Rete virtuale selezionare Crea nuovo per creare una nuova rete virtuale di Azure. Specificare quindi le informazioni seguenti:

      • Immettere myvnet1 come nome della rete virtuale.
      • Specificare uno spazio indirizzi per la configurazione, ad esempio 10.7.0.0/16
      • Immettere myANFsubnet come nome della subnet.
      • Specificare l'intervallo di indirizzi della subnet, ad esempio 10.7.0.0/24. Non è possibile condividere una subnet dedicata con altre risorse.
      • Selezionare Microsoft.NetApp/volumes come delega per la subnet.
      • Selezionare OK per creare la rete virtuale.

   5. Nella subnet selezionare la rete virtuale appena creata (myvnet1) come subnet di delega.

      

      

4. Selezionare Protocollo e quindi completare le azioni seguenti:

   • Selezionare NFS come tipo di protocollo per il volume.
   • Immettere myfilepath1 per il percorso del file usato per creare il percorso di esportazione per il volume.
   • Selezionare la versione di NFS (NFSv3 o NFSv4.1) per il volume. Vedere le considerazioni e le procedure consigliate per le versioni di NFS.

   

5. Selezionare Rivedi e crea per visualizzare le informazioni per il volume che si sta creando.

6. Selezionare Crea per creare il volume. Il volume creato viene visualizzato nel pannello Volumi.

   

1. Creare una delega della subnet a "Microsoft. NetApp/volumes" con il comando New-AzDelegation.

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

2. Creare una configurazione della subnet usando il comando New-AzVirtualNetworkSubnetConfig.

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

3. Creare la rete virtuale usando il comando New-AzVirtualNetwork.

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

4. Creare il volume con il 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. Definizione di alcune variabili per un uso successivo.

   VNET_NAME="myvnet1"
   SUBNET_NAME="myANFSubnet"
   

2. Creare una rete virtuale senza subnet con il 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. Creare una subnet delegata con il 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. Creare il volume con il 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"
   

Il frammento di codice seguente mostra come configurare una rete virtuale e creare un volume Azure NetApp Files in un modello di Azure Resource Manager (modello ARM). Per la configurazione della rete virtuale viene usata la risorsa Microsoft.Network/virtualNetworks. Per la creazione del volume viene usata la risorsa Microsoft.NetApp/netAppAccounts/capacityPools/volumes. Per eseguire il codice, scaricare il modello di Azure Resource Manager completo dal repository 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')]"
  }
}

Al termine e, se si vuole, è possibile eliminare il gruppo di risorse. L'azione di eliminazione di un gruppo di risorse è irreversibile.

1. Nella casella di ricerca del portale di Azure immettere Azure NetApp Files e quindi selezionare Azure NetApp Files dall'elenco visualizzato.

2. Nell'elenco delle sottoscrizioni selezionare il gruppo di risorse (myRG1) da eliminare.

   

3. Nella pagina del gruppo di risorse selezionare Elimina gruppo di risorse.

   

   Viene aperta una finestra e viene visualizzato un avviso relativo alle risorse da eliminare con il gruppo di risorse.

4. Immettere il nome del gruppo di risorse (myRG1) per confermare che si vuole eliminare definitivamente il gruppo di risorse e tutte le risorse in esso contenute e quindi selezionare Elimina.

   

Al termine e, se si vuole, è possibile eliminare il gruppo di risorse. L'azione di eliminazione di un gruppo di risorse è irreversibile.

1. Eliminare il gruppo di risorse usando il comando Remove-AzResourceGroup.

   Remove-AzResourceGroup -Name $resourceGroup
   

Al termine e, se si vuole, è possibile eliminare il gruppo di risorse. L'azione di eliminazione di un gruppo di risorse è irreversibile.

1. Eliminare il gruppo di risorse usando il comando az group delete.

   az group delete \
       --name $RESOURCE_GROUP
   

Nessuno.

Usare il portale di Azure, PowerShell o l'interfaccia della riga di comando di Azure per eliminare il gruppo di risorse.