Schnellstart: Einrichten von Azure NetApp Files und Erstellen eines NFS-Volumes

Artikel
05/08/2024

In diesem Artikel erfahren Sie, wie Sie auf schnelle Weise Azure NetApp Files einrichten und ein NFS-Volume erstellen.

In dieser Schnellstartanleitung wird Folgendes eingerichtet:

Registrierung für NetApp-Ressourcenanbieter
NetApp-Konto
Kapazitätspool
NFS-Volume für Azure NetApp Files

Wenn Sie kein Azure-Abonnement besitzen, können Sie ein kostenloses Konto erstellen, bevor Sie beginnen.

Alle Features, die Sie für ein NFS-Volume aktivieren können, sowie relevante Überlegungen finden Sie unter Erstellen eines NFS-Volumes für Azure NetApp Files.

Registrieren für NetApp-Ressourcenanbieter

Hinweis

Der Registrierungsvorgang kann einige Zeit in Anspruch nehmen.

Öffnen Sie für die Registrierungsschritte mit dem Portal wie oben gezeigt eine Cloud Shell-Sitzung, und führen Sie diese Azure CLI-Schritte aus:

Geben Sie das Abonnement an, das für Azure NetApp Files in die genehmigt wurde:
```
az account set --subscription <subscriptionId>
```

Registrieren des Azure-Ressourcenanbieters:

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

Für diesen Gewusst-wie-Artikel wird Az-Version 2.6.0 (oder höher) des Azure PowerShell-Moduls benötigt. Führen Sie Get-Module -ListAvailable Az aus, um Ihre aktuelle Version zu ermitteln. Wenn Sie eine Installation oder ein Upgrade ausführen müssen, finden Sie unter Install and configure Azure PowerShell (Installieren des Azure PowerShell-Moduls) Informationen dazu. Wenn Sie möchten, können Sie stattdessen die Cloud Shell-Konsole in einer PowerShell-Sitzung verwenden.

Geben Sie an einer PowerShell-Eingabeaufforderung (oder PowerShell Cloud Shell-Sitzung) das Abonnement an, das für Azure NetApp Files genehmigt wurde:
```
Select-AzSubscription -Subscription <subscriptionId>
```

Registrieren des Azure-Ressourcenanbieters:

Register-AzResourceProvider -ProviderNamespace Microsoft.NetApp

Bereiten Sie die Umgebung für die Azure CLI vor.

Verwenden Sie die Bash-Umgebung in Azure Cloud Shell. Weitere Informationen finden Sie unter Schnellstart für Bash in Azure Cloud Shell.
Wenn Sie CLI-Referenzbefehle lieber lokal ausführen, installieren Sie die Azure CLI. Wenn Sie Windows oder macOS ausführen, sollten Sie die Azure CLI in einem Docker-Container ausführen. Weitere Informationen finden Sie unter Ausführen der Azure CLI in einem Docker-Container.
- Wenn Sie eine lokale Installation verwenden, melden Sie sich mithilfe des Befehls az login bei der Azure CLI an. Führen Sie die in Ihrem Terminal angezeigten Schritte aus, um den Authentifizierungsprozess abzuschließen. Informationen zu anderen Anmeldeoptionen finden Sie unter Anmelden mit der Azure CLI.
- Installieren Sie die Azure CLI-Erweiterung beim ersten Einsatz, wenn Sie dazu aufgefordert werden. Weitere Informationen zu Erweiterungen finden Sie unter Verwenden von Erweiterungen mit der Azure CLI.
- Führen Sie az version aus, um die installierte Version und die abhängigen Bibliotheken zu ermitteln. Führen Sie az upgrade aus, um das Upgrade auf die aktuelle Version durchzuführen.

Geben Sie das Abonnement an, das für Azure NetApp Files in die genehmigt wurde:
```
az account set --subscription <subscriptionId>
```

Registrieren des Azure-Ressourcenanbieters:

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

Erstellen eines NetApp-Kontos

Geben Sie im Suchfeld des Azure-Portals Azure NetApp Files ein, und wählen Sie in der daraufhin angezeigten Liste die Option Azure NetApp Files aus.
Wählen Sie + Erstellen aus, um ein neues NetApp-Konto zu erstellen.
Geben Sie im Fenster für das neue NetApp-Konto folgende Informationen an:
1. Geben Sie myaccount1 als Kontoname ein.
2. Wählen Sie Ihr Abonnement aus.
3. Wählen Sie Neu erstellen aus, um eine neue Ressourcengruppe zu erstellen. Geben Sie myRG1 als Ressourcengruppenname ein. Klicken Sie auf OK.
4. Wählen Sie den Standort Ihres Kontos aus.
Wählen Sie Erstellen aus, um Ihr neues NetApp-Konto zu erstellen.

Definieren Sie einige Variablen, damit in den restlichen Beispielen darauf verwiesen werden kann:
```
$resourceGroup = "myRG1"
$location = "eastus"
$anfAccountName = "myaccount1"
```
Hinweis

Eine Liste mit den unterstützten Regionen finden Sie unter Verfügbare Produkte nach Region. Verwenden Sie Get-AzLocation | select Location, um den Regionsnamen abzurufen, der von unseren Befehlszeilentools unterstützt wird.
Erstellen Sie mit dem Befehl New-AzResourceGroup eine neue Ressourcengruppe:
```
New-AzResourceGroup -Name $resourceGroup -Location $location
```

Erstellen Sie mit dem Befehl New-AzNetAppFilesAccount ein Azure NetApp Files-Konto:

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

Definieren Sie einige Variablen, damit in den restlichen Beispielen darauf verwiesen werden kann:
```
RESOURCE_GROUP="myRG1"
LOCATION="eastus"
ANF_ACCOUNT_NAME="myaccount1"
```
Hinweis

Eine Liste mit den unterstützten Regionen finden Sie unter Verfügbare Produkte nach Region. Verwenden Sie az account list-locations --query "[].{Region:name}" --out table, um den Regionsnamen abzurufen, der von unseren Befehlszeilentools unterstützt wird.

Erstellen Sie mit dem Befehl az group create eine neue Ressourcengruppe:

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

Erstellen Sie mit dem Befehl az netappfiles account create ein Azure NetApp Files-Konto:

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

Eine Azure Resource Manager-Vorlage ist eine JSON (JavaScript Object Notation)-Datei, welche die Infrastruktur und die Konfiguration für Ihr Projekt definiert. Die Vorlage verwendet eine deklarative Syntax. Sie beschreiben Ihre geplante Bereitstellung, ohne die Abfolge der Programmierbefehle zum Erstellen der Bereitstellung zu schreiben.

Der folgende Codeausschnitt zeigt, wie Sie ein NetApp-Konto in einer Azure Resource Manager-Vorlage (ARM-Vorlage) erstellen, indem Sie die Ressource Microsoft.NetApp/netAppAccounts verwenden. Um den Code auszuführen, laden Sie die vollständige ARM-Vorlage aus unserem GitHub-Repository herunter.

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

Einrichten eines Kapazitätspools

Wählen Sie auf dem Azure NetApp Files-Verwaltungsblatt Ihr NetApp-Konto (myaccount1) aus.
Wählen Sie auf dem Azure NetApp Files-Verwaltungsblatt Ihres NetApp-Kontos die Option Kapazitätspools aus.
Wählen Sie + Pools hinzufügen aus.
Geben Sie Informationen für den Kapazitätspool an:
- Geben Sie mypool1 als Poolname ein.
- Wählen Sie für den Servicelevel die Option Premium aus.
- Geben Sie eine Poolgröße von 4 (TiB) an.
- Verwenden Sie den QoS-Typ Auto (Automatisch).
Klicken Sie auf Erstellen.

Definieren einiger neuer Variablen, auf die verwiesen werden kann

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

Erstellen Sie mit New-AzNetAppFilesPool einen neuen Kapazitätspool.

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

Definieren einiger neuer Variablen, auf die verwiesen werden kann

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

Erstellen Sie mit az netappfiles pool create einen neuen Kapazitätspool.

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

Der folgende Codeausschnitt zeigt, wie Sie einen Kapazitätspool in einer Azure Resource Manager-Vorlage (ARM-Vorlage) erstellen, indem Sie die Ressource Microsoft.NetApp/netAppAccounts/capacityPools verwenden. Um den Code auszuführen, laden Sie die vollständige ARM-Vorlage aus unserem GitHub-Repository herunter.

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

Erstellen eines NFS-Volumes für Azure NetApp Files

Wählen Sie auf dem Azure NetApp Files-Verwaltungsblatt Ihres NetApp-Kontos die Option Volumes aus.
Wählen Sie + Volume hinzufügen aus.
Geben Sie im Fenster „Volume erstellen“ Informationen für das Volume an:
1. Geben Sie myvol1 als Volumename ein.
2. Wählen Sie Ihren Kapazitätspool (mypool1) aus.
3. Übernehmen Sie für das Kontingent den Standardwert.
4. Wählen Sie unter „Virtuelles Netzwerk“ Neu erstellen aus, um ein neues virtuelles Azure-Netzwerk (VNet) zu erstellen. Geben Sie anschließend folgende Informationen an:
  - Geben Sie myvnet1 als VNET-Name ein.
  - Geben Sie einen Adressraum für Ihre Einstellung an (beispielsweise 10.7.0.0/16).
  - Geben Sie myANFsubnet als Subnetzname ein.
  - Geben Sie den Subnetzadressbereich an (beispielsweise 10.7.0.0/24). Sie können das dedizierte Subnetz nicht für andere Ressourcen freigeben.
  - Wählen Sie für die Subnetzdelegierung die Option Microsoft.NetApp/volumes aus.
  - Wählen Sie OK aus, um das VNet zu erstellen.
5. Wählen Sie unter „Subnetz“ das neu erstellte VNET (myvnet1) als Delegatsubnetz aus.
Wählen Sie Protokoll aus, und führen Sie anschließend die folgenden Aktionen aus:
- Wählen Sie NFS als Protokolltyp für das Volume aus.
- Geben Sie myfilepath1 für den Dateipfad ein, der zum Erstellen des Exportpfads für das Volume verwendet wird.
- Wählen Sie die NFS-Version (NFSv3 oder NFSv4.1) für das Volume aus. Lesen Sie sich die Überlegungen und bewährten Methoden zu NFS-Versionen durch.
Wählen Sie Überprüfen + erstellen aus, um Informationen für das Volume anzuzeigen, das Sie erstellen.
Wählen Sie Erstellen aus, um das Volume zu erstellen. Das erstellte Volume wird auf dem Blatt „Volumes“ angezeigt.

Erstellen Sie mit dem Befehl New-AzDelegation eine Subnetzdelegierung für „Microsoft.NetApp/volumes“.

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

Erstellen Sie mit dem Befehl New-AzVirtualNetworkSubnetConfig eine Subnetzkonfiguration.

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

Erstellen Sie mit dem Befehl New-AzVirtualNetwork das virtuelle Netzwerk.

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

Erstellen Sie das Volume mit dem Befehl 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

Definieren Sie einige Variablen zur späteren Verwendung.
```
VNET_NAME="myvnet1"
SUBNET_NAME="myANFSubnet"
```

Erstellen Sie mit dem Befehl az network vnet create ein virtuelles Netzwerk ohne Subnetz.

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

Erstellen Sie mit dem Befehl az network vnet subnet create ein delegiertes Subnetz.

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"

Erstellen Sie das Volume mit dem Befehl 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"

Die folgenden Codeausschnitte zeigen, wie Sie ein VNet einrichten und ein Azure NetApp Files-Volume in einer Azure Resource Manager-Vorlage (ARM-Vorlage) erstellen. Das VNet-Setup verwendet die Ressource Microsoft.Network/virtualNetworks. Die Volumeerstellung verwendet die Ressource Microsoft.NetApp/netAppAccounts/capacityPools/volumes. Um den Code auszuführen, laden Sie die vollständige ARM-Vorlage aus unserem GitHub-Repository herunter.

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

Bereinigen von Ressourcen

Wenn Sie damit fertig sind und wenn Sie möchten, können Sie die Ressourcengruppe löschen. Das Löschen einer Ressourcengruppe kann nicht rückgängig gemacht werden.

Wichtig

Beim Löschen einer Ressourcengruppe werden auch alle darin enthaltenen Ressourcen gelöscht. Diese Aktion kann nicht rückgängig gemacht werden.

Wichtig

Bevor Sie eine Ressourcengruppe löschen, müssen Sie zuerst die Sicherungen löschen. Die Sicherungen werden durch das Löschen einer Ressourcengruppe nicht gelöscht. Sie können Sicherungen auf Volumes vorab löschen, indem Sie die Sicherungen manuell löschen. Wenn Sie die Ressourcengruppe löschen, ohne alle Sicherungen zu löschen, sind Sie nicht mehr in der Lage, die Sicherungen anzuzeigen. Die Sicherungen können jedoch weiterhin Kosten verursachen. Wenn Ihnen einige Sicherungen fälschlicherweise in Rechnung gestellt werden, öffnen Sie ein Supportticket, um dieses Problem zu beheben.

Geben Sie im Suchfeld des Azure-Portals Azure NetApp Files ein, und wählen Sie in der daraufhin angezeigten Liste die Option Azure NetApp Files aus.
Wählen Sie in der Liste der Abonnements die Ressourcengruppe (myRG1) aus, die Sie löschen möchten.
Wählen Sie auf der Seite „Ressourcengruppe“ die Option Ressourcengruppe löschen aus.

Es wird ein Fenster mit der Warnung, dass die Ressourcen mit der Ressourcengruppe gelöscht werden, geöffnet.
Geben Sie den Namen der Ressourcengruppe (myRG1) ein, um zu bestätigen, dass Sie die Ressourcengruppe und alle darin enthaltenen Ressourcen permanent löschen möchten, und wählen Sie dann Löschen aus.

Wenn Sie damit fertig sind und wenn Sie möchten, können Sie die Ressourcengruppe löschen. Das Löschen einer Ressourcengruppe kann nicht rückgängig gemacht werden.

Wichtig

Beim Löschen einer Ressourcengruppe werden auch alle darin enthaltenen Ressourcen gelöscht. Diese Aktion kann nicht rückgängig gemacht werden.

Löschen Sie die Ressourcengruppe mit dem Befehl Remove-AzResourceGroup.
```
Remove-AzResourceGroup -Name $resourceGroup
```

Wenn Sie damit fertig sind und wenn Sie möchten, können Sie die Ressourcengruppe löschen. Das Löschen einer Ressourcengruppe kann nicht rückgängig gemacht werden.

Wichtig

Beim Löschen einer Ressourcengruppe werden auch alle darin enthaltenen Ressourcen gelöscht. Diese Aktion kann nicht rückgängig gemacht werden.