Démarrage rapide : Configurer Azure NetApp Files et créer un volume NFS

Article
05/07/2024

Cet article explique comment rapidement configurer Azure NetApp Files et créer un volume NFS.

Ce démarrage rapide configure les éléments suivants :

Inscription auprès du fournisseur de ressources NetApp
Un compte NetApp
Un pool de capacités
Un volume NFS pour Azure NetApp Files

Si vous n’avez pas d’abonnement Azure, créez un compte gratuit avant de commencer.

Si vous souhaitez voir toutes les fonctionnalités qu’il est possible d’activer pour un volume NFS, et les considérations à prendre en compte, consultez Créer un volume NFS.

S’inscrire au fournisseur de ressources NetApp

Notes

Le processus d’inscription peut prendre du temps.

Pour connaître les étapes à suivre pour l’inscription à l’aide du portail, ouvrez une session Cloud Shell comme indiqué ci-dessus, puis effectuez les étapes Azure CLI suivantes :

Spécifiez l’abonnement qui a été approuvé pour Azure NetApp Files :
```
az account set --subscription <subscriptionId>
```

Inscrivez le fournisseur de ressources Azure :

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

Cet article de guide pratique nécessite le module Azure PowerShell Az version 2.6.0 ou ultérieure. Exécutez Get-Module -ListAvailable Az pour rechercher votre version actuelle. Si vous devez installer ou mettre à niveau, consultez Installer le module Azure PowerShell. Si vous préférez, vous pouvez utiliser la console Azure Cloud Shell dans une session PowerShell à la place.

Dans une invite de commandes PowerShell (ou une session PowerShell Cloud Shell), spécifiez l’abonnement qui a été approuvé pour Azure NetApp Files :
```
Select-AzSubscription -Subscription <subscriptionId>
```

Inscrivez le fournisseur de ressources Azure :

Register-AzResourceProvider -ProviderNamespace Microsoft.NetApp

Préparez votre environnement pour l’interface Azure CLI.

Utilisez l’environnement Bash dans Azure Cloud Shell. Pour plus d’informations, consultez Démarrage rapide pour Bash dans Azure Cloud Shell.
Si vous préférez exécuter les commandes de référence de l’interface de ligne de commande localement, installez l’interface Azure CLI. Si vous exécutez sur Windows ou macOS, envisagez d’exécuter Azure CLI dans un conteneur Docker. Pour plus d’informations, consultez Guide pratique pour exécuter Azure CLI dans un conteneur Docker.
- Si vous utilisez une installation locale, connectez-vous à Azure CLI à l’aide de la commande az login. Pour finir le processus d’authentification, suivez les étapes affichées dans votre terminal. Pour connaître les autres options de connexion, consultez Se connecter avec Azure CLI.
- Lorsque vous y êtes invité, installez l’extension Azure CLI lors de la première utilisation. Pour plus d’informations sur les extensions, consultez Utiliser des extensions avec Azure CLI.
- Exécutez az version pour rechercher la version et les bibliothèques dépendantes installées. Pour effectuer une mise à niveau vers la dernière version, exécutez az upgrade.

Spécifiez l’abonnement qui a été approuvé pour Azure NetApp Files :
```
az account set --subscription <subscriptionId>
```

Inscrivez le fournisseur de ressources Azure :

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

Créer un compte NetApp

Dans la zone de recherche du portail Azure, entrez Azure NetApp Files, puis sélectionnez Azure NetApp Files dans la liste qui s’affiche.
Sélectionnez + Créer pour créer un nouveau compte NetApp.
Dans la fenêtre Nouveau compte NetApp, entrez les informations suivantes :
1. Entrez myaccount1 comme nom de compte.
2. Sélectionnez votre abonnement.
3. Sélectionnez Créer pour créer un groupe de ressources. Entrez myRG1 comme nom du groupe de ressources. Sélectionnez OK.
4. Sélectionnez l’emplacement de votre compte.
Sélectionnez Créer pour créer votre nouveau compte NetApp.

Définissez des variables afin que nous puissions y faire référence dans le reste des exemples :
```
$resourceGroup = "myRG1"
$location = "eastus"
$anfAccountName = "myaccount1"
```
Notes

Pour obtenir la liste des régions prises en charge, reportez-vous à Disponibilité des produits par région. Pour obtenir le nom de région qui est pris en charge par nos outils en ligne de commande, utilisez Get-AzLocation | select Location
Créez un groupe de ressources à l’aide de la commande New-AzResourceGroup :
```
New-AzResourceGroup -Name $resourceGroup -Location $location
```

Créez un compte Azure NetApp Files avec la commande New-AzNetAppFilesAccount :

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

Définissez des variables afin que nous puissions y faire référence dans le reste des exemples :
```
RESOURCE_GROUP="myRG1"
LOCATION="eastus"
ANF_ACCOUNT_NAME="myaccount1"
```
Notes

Pour obtenir la liste des régions prises en charge, reportez-vous à Disponibilité des produits par région. Pour obtenir le nom de région qui est pris en charge par nos outils en ligne de commande, utilisez az account list-locations --query "[].{Region:name}" --out table
Créez un groupe de ressources à l’aide de la commande az group create :
```
az group create \
    --name $RESOURCE_GROUP \
    --location $LOCATION
```

Créez un compte Azure NetApp Files avec la commande az netappfiles account create :

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

Un modèle Azure Resource Manager est un fichier JSON (JavaScript Object Notation) qui définit l’infrastructure et la configuration de votre projet. Le modèle utilise la syntaxe déclarative. Vous décrivez votre déploiement prévu sans écrire la séquence de commandes de programmation pour créer le déploiement.

L’extrait de code suivant montre comment créer un compte NetApp dans un modèle Azure Resource Manager (modèle ARM), avec la ressource Microsoft.NetApp/netAppAccounts. Pour exécuter le code, téléchargez le modèle ARM complet à partir de notre dépôt GitHub.

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

Créer un pool de capacités

Dans le panneau de gestion Azure NetApp Files, sélectionnez votre compte NetApp (myaccount1).
Dans le panneau de gestion Azure NetApp Files de votre compte NetApp, sélectionnez Pools de capacités.
Sélectionnez + Ajouter des Pools.
Fournissez des informations pour le pool de capacités :
- Entrez mypool1 comme nom du pool.
- Sélectionnez Premium pour le niveau de service.
- Spécifiez 4 (Tio) pour la taille du pool.
- Utilisez le type QoS Auto.
Sélectionnez Create (Créer).

Définition de nouvelles variables pour référence ultérieure

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

Créer un pool de capacités à l’aide de la commande New-AzNetAppFilesPool

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

Définition de nouvelles variables pour référence ultérieure

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

Créer un pool de capacités à l’aide de la commande 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

L’extrait de code suivant montre comment créer un pool de capacités dans un modèle Azure Resource Manager (modèle ARM), avec la ressource Microsoft.NetApp/netAppAccounts/capacityPools. Pour exécuter le code, téléchargez le modèle ARM complet à partir de notre dépôt 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')]"
  }
},

Créer un volume NFS pour Azure NetApp Files

Dans le panneau de gestion Azure NetApp Files de votre compte NetApp, sélectionnez Volumes.
Sélectionnez + Ajouter un volume.
Dans la fenêtre Créer un volume, spécifiez les informations concernant le nouveau volume :
1. Entrez myvol1 comme nom du volume.
2. Sélectionnez votre pool de capacités (mypool1).
3. Utilisez la valeur par défaut du quota.
4. Sous Réseau virtuel, sélectionnez Créer pour créer un nouveau réseau virtuel Azure (VNet). Ensuite, renseignez les informations suivantes :
  - Entrez myvnet1 comme nom du réseau virtuel.
  - Spécifiez un espace d’adressage pour votre paramètre, par exemple, 10.7.0.0/16
  - Entrez myANFsubnet comme nom du sous-réseau.
  - Spécifiez la plage d’adresses du sous-réseau, par exemple, 10.7.0.0/24. Vous ne pouvez pas partager le sous-réseau dédié avec d’autres ressources.
  - Sélectionnez Microsoft.NetApp/volumes pour la délégation de sous-réseau.
  - Sélectionnez OK pour créer le réseau virtuel.
5. Dans le sous-réseau, sélectionnez le réseau virtuel qui vient d’être créé (myvnet1) comme sous-réseau délégué.
Sélectionnez Protocole, puis effectuez les actions suivantes :
- Sélectionnez NFS comme type de protocole pour le volume.
- Entrez myfilepath1 pour le chemin d’accès au fichier utilisé pour créer le chemin d’exportation du volume.
- Sélectionnez la version de NFS (NFSv3 ou NFSv4.1) du volume. Consultez les Considérations et les Bonnes pratiques relatives aux versions NFS.
Sélectionnez Vérifier + créer pour afficher des informations sur le volume que vous créez.
Sélectionnez Créer pour créer le volume. Le volume créé s’affiche dans le panneau Volumes.

Créez une délégation de sous-réseau sur « Microsoft.NetApp/volumes » avec la commande New-AzDelegation.
```
$anfDelegation = New-AzDelegation -Name ([guid]::NewGuid().Guid) -ServiceName "Microsoft.NetApp/volumes"
```

Créez une configuration de sous-réseau à l’aide de la commande New-AzVirtualNetworkSubnetConfig.

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

Créez le réseau virtuel à l’aide de la commande New-AzVirtualNetwork.

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

Créez le volume à l’aide de la commande 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

Définition de certaines variables pour une utilisation ultérieure.
```
VNET_NAME="myvnet1"
SUBNET_NAME="myANFSubnet"
```

Créez un réseau virtuel sans sous-réseau à l’aide de la commande az network vnet create.

az network vnet create \
    --resource-group $RESOURCE_GROUP \
    --name $VNET_NAME \
    --location $LOCATION \
    --address-prefix "10.7.0.0/16"

Créez un sous-réseau délégué à l’aide de la commande 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"

Créez le volume à l’aide de la commande 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"

Les extraits de code suivants montrent comment configurer un réseau virtuel et créer un volume Azure NetApp Files dans un modèle Azure Resource Manager (modèle ARM). La configuration du réseau virtuel utilise la ressource Microsoft.Network/virtualNetworks. La création du volume utilise la ressource Microsoft.NetApp/netAppAccounts/capacityPools/volumes. Pour exécuter le code, téléchargez le modèle ARM complet à partir de notre dépôt 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')]"
  }
}

Nettoyer les ressources

Lorsque vous avez terminé et si vous le souhaitez, vous pouvez supprimer le groupe de ressources. La suppression d’un groupe de ressources est irréversible.

Important

La suppression d’un groupe de ressources a pour effet de supprimer toutes les ressources qu’il contient. Cette action ne peut pas être annulée.

Important

Avant de supprimer un groupe de ressources, vous devez d’abord supprimer les sauvegardes. La suppression d’un groupe de ressources ne supprime pas les sauvegardes. Vous pouvez préemptivement supprimer des sauvegardes sur des volumes en supprimant manuellement les sauvegardes. Si vous supprimez le groupe de ressources sans supprimer toutes les sauvegardes, vous perdez la possibilité de voir les sauvegardes. Toutefois, les sauvegardes peuvent continuer à engendrer des coûts. Si certaines sauvegardes vous sont facturées à tort, ouvrez un ticket de support pour résoudre ce problème.

Dans la zone de recherche du portail Azure, entrez Azure NetApp Files, puis sélectionnez Azure NetApp Files dans la liste qui s’affiche.
Dans la liste des abonnements, sélectionnez le groupe de ressources (myRG1) que vous souhaitez supprimer.
Sur la page Groupe de ressources, sélectionnez Supprimer un groupe de ressources.

Une fenêtre s’ouvre et affiche un avertissement concernant les ressources qui seront supprimées avec le groupe de ressources.
Entrez le nom du groupe de ressources (myRG1) pour confirmer que vous souhaitez supprimer définitivement le groupe de ressources et toutes les ressources qu’il contient, puis sélectionnez Supprimer.

Lorsque vous avez terminé et si vous le souhaitez, vous pouvez supprimer le groupe de ressources. La suppression d’un groupe de ressources est irréversible.

Important

La suppression d’un groupe de ressources a pour effet de supprimer toutes les ressources qu’il contient. Cette action ne peut pas être annulée.

Supprimez le groupe de ressources à l’aide de la commande Remove-AzResourceGroup.
```
Remove-AzResourceGroup -Name $resourceGroup
```

Lorsque vous avez terminé et si vous le souhaitez, vous pouvez supprimer le groupe de ressources. La suppression d’un groupe de ressources est irréversible.

Important

La suppression d’un groupe de ressources a pour effet de supprimer toutes les ressources qu’il contient. Cette action ne peut pas être annulée.