Freigeben über


Erstellen und Ändern eines Netzwerk-Fabric Controllers mithilfe der Azure CLI

In diesem Artikel erfahren Sie, wie Sie einen Netzwerk-Fabric Controller (NFC) über die Azure-Befehlszeilenschnittstelle (Azure CLI) erstellen. Außerdem erfahren Sie in diesem Dokument, wie Sie den Status überprüfen oder ein Netzwerk-Fabric Controller löschen.

Voraussetzungen

Vor der Erstellung eines NFC müssen alle erforderlichen Komponenten implementiert werden.

Namen (z. B. für Ressourcen) dürfen keinen Unterstrich (_) enthalten.

Überprüfen der ExpressRoute-Leitung

Überprüfen Sie die ExpressRoute-Leitungen auf korrekte Konnektivität (CircuitID)(AuthID). Bei nicht korrekter Konnektivität ist die NFC-Bereitstellung nicht erfolgreich.

Erstellen eines Netzwerk-Fabric Controllers

Vor dem Erstellen Ihres NFC muss eine Ressourcengruppe erstellt werden.

Hinweis: Es empfiehlt sich, für jeden NFC eine separate Ressourcengruppe zu erstellen.

Sie erstellen Ressourcengruppen, indem Sie die folgenden Befehle ausführen:

az group create -n NFCResourceGroupName -l "<Location>"

Attribute für die NFC-Erstellung

Parameter BESCHREIBUNG values Beispiel Erforderlich type
Resource-Group Eine Ressourcengruppe ist ein Container, der verwandte Ressourcen für eine Azure-Lösung enthält. NFCResourceGroupName XYZNFCResourceGroupName True String
Location Die Azure-Region ist für Ihre Bereitstellung obligatorisch. eastus, westus3, southcentralus, eastus2euap eastus True String
Resource-Name Der Ressourcenname ist der Name des Netzwerk-Fabric-Controllers. nfcname XYZnfcname True String
ipv4-address-space IPv4 Network Fabric Controller Address Space, der Standardsubnetzblock ist 10.0.0.0/19, und er sollte auch nicht mit einem der ExpressRoute-IPs überlappen 10.0.0.0/19 10.0.0.0/19 Nicht erforderlich String
ipv6-address-space IPv6 Network Fabric Controller Address Space, dieser Parameter ist standardmäßig FC00::/59, wobei der zulässige Bereich /59 "FC00::/59" "FC00::/59" Nicht erforderlich String
ExpressRoute-Leitungen Die ExpressRoute-Leitung ist eine dedizierte 10G-Verknüpfung, die Azure und die lokale Umgebung verbindet. Sie müssen die ID der ExpressRoute-Leitung sowie den Authentifizierungsschlüssel kennen, damit ein NFC erfolgreich bereitgestellt werden kann. Es gibt zwei ExpressRoute-Leitungen: eine für die Infrastrukturdienste und eine für Workload- bzw. Mandantendienste. --infra-er-connections '[{"expressRouteCircuitId": "xxxxxx-xxxxxx-xxxx-xxxx-xxxxxx", "expressRouteAuthorizationKey": "xxxxxx-xxxxxx-xxxx-xxxx-xxxxxx"}]'

--workload-er-connections '[{"expressRouteCircuitId": "xxxxxx-xxxxxx-xxxx-xxxx-xxxxxx", "expressRouteAuthorizationKey": "xxxxxx-xxxxxx-xxxx-xxxx-xxxxxx"}]'
subscriptions/xxxxxx-xxxxxx-xxxx-xxxx-xxxxxx/resourceGroups/ER-Dedicated-WUS2-AFO-Circuits/providers/Microsoft.Network/expressRouteCircuits/MSFT-ER-Dedicated-PvtPeering-WestUS2-AFO-Ckt-01", "expressRouteAuthorizationKey": "xxxxxx-xxxxxx-xxxx-xxxx-xxxxxx"}] True Zeichenfolge
Verwaltete Ressourcengruppe Konfigurationseigenschaften der verwalteten Ressourcengruppe. NFCManagedResourceGroupName XYZNFCManagedResourceGroupName True String

Hier ist ein Beispiel für die Erstellung eines NFC mithilfe der Azure CLI. Weitere Informationen finden Sie im Abschnitt „Attribute“.

az networkfabric controller create \
  --resource-group "NFCResourceGroupName" \
  --location "<Location>"  \
  --resource-name "nfcname" \
  --ipv4-address-space "10.0.0.0/19" \
  --ipv6-address-space "FC00::/59" \
  --infra-er-connections '[{"expressRouteCircuitId": "/subscriptions/xxxxxx-xxxxxx-xxxx-xxxx-xxxxxx/resourceGroups/ER-Dedicated-WUS2-AFO-Circuits/providers/Microsoft.Network/expressRouteCircuits/MSFT-ER-Dedicated-PvtPeering-WestUS2-AFO-Ckt-01", "expressRouteAuthorizationKey": "<auth-key>"}]'
  --workload-er-connections '[{"expressRouteCircuitId": "/subscriptions/xxxxxx-xxxxxx-xxxx-xxxx-xxxxxx/resourceGroups/ER-Dedicated-WUS2-AFO-Circuits/providers/Microsoft.Network/expressRouteCircuits/MSFT-ER-Dedicated-PvtPeering-WestUS2-AFO-Ckt-01"", "expressRouteAuthorizationKey": "<auth-key>"}]' \
--debug --no-wait

Hinweis: Die NFC-Erstellung dauert zwischen 30 und 45 Minuten. Verwenden Sie den Befehl show, um den Fortschritt der NFC-Erstellung zu überwachen. Es werden verschiedene Bereitstellungszustände angezeigt (z. B. „Angenommen“, „Wird aktualisiert“, „Erfolgreich“ oder „Fehler“). Sollte die Erstellung nicht erfolgreich sein (Failed), löschen Sie den NFC, und erstellen Sie ihn neu. Die erwartete Ausgabe zeigt nur die Ausführung an, sobald Sie die Ausführung über die Azure CLI starten.

Erwartete Ausgabe:

 {
  "id": "/subscriptions/xxxxxx-xxxxxx-xxxx-xxxx-xxxxxx/resourceGroups/NFCResourceGroupName/providers/Microsoft.ManagedNetworkFabric/networkFabricControllers/nfcname",
  "infrastructureExpressRouteConnections": [
    {
      "expressRouteCircuitId": "/subscriptions/xxxxxx-xxxxxx-xxxx-xxxx-xxxxxx/resourceGroups/ER-Dedicated-WUS2-AFO-Circuits/providers/Microsoft.Network/expressRouteCircuits/MSFT-ER-Dedicated-PvtPeering-WestUS2-AFO-Ckt-02"
    }
  ],
  "infrastructureServices": {
    "ipv4AddressSpaces": [
      "10.0.0.0/21"
    ],
    "ipv6AddressSpaces": []
  },
  "ipv4AddressSpace": "10.0.0.0/19",
  "ipv6AddressSpace": "FC00::/59",
  "isWorkloadManagementNetworkEnabled": "True",
  "location": "<Location>",
  "managedResourceGroupConfiguration": {},
  "name": "NFCName",
  "provisioningState": "Succeeded",
  "resourceGroup": "NFCResourceGroupName",
  "systemData": {
    "createdAt": "2023XX-XXT18:59:41.7805324Z",
    "createdBy": "email@address.com",
    "createdByType": "User",
    "lastModifiedAt": "2023-XX-XXT09:50:27.4598499Z",
    "lastModifiedBy": "d1bd24c7-b27f-477e-86dd-939e107873d7",
    "lastModifiedByType": "Application"
  },
  "type": "microsoft.managednetworkfabric/networkfabriccontrollers",
  "workloadExpressRouteConnections": [
    {
      "expressRouteCircuitId": "/subscriptions/xxxxxx-xxxxxx-xxxx-xxxx-xxxxxx//resourceGroups/ER-Dedicated-WUS2-AFO-Circuits/providers/Microsoft.Network/expressRouteCircuits/MSFT-ER-Dedicated-PvtPeering-WestUS2-AFO-Ckt-03"
    }
  ],
  "workloadManagementNetwork": true,
  "workloadServices": {
    "ipv4AddressSpaces": [
      "10.0.28.0/22"
    ],
    "ipv6AddressSpaces": []
  }
}

Abrufen des Netzwerk-Fabric Controllers

  az networkfabric controller show --resource-group "NFCResourceGroupName" --resource-name "nfcname"

Erwartete Ausgabe:

{
  "id": "/subscriptions/xxxxxx-xxxxxx-xxxx-xxxx-xxxxxx/resourceGroups/NFCResourceGroupName/providers/Microsoft.ManagedNetworkFabric/networkFabricControllers/nfcname",
  "infrastructureExpressRouteConnections": [
    {
      "expressRouteCircuitId": "/subscriptions/xxxxxx-xxxxxx-xxxx-xxxx-xxxxxx/resourceGroups/ER-Dedicated-WUS2-AFO-Circuits/providers/Microsoft.Network/expressRouteCircuits/MSFT-ER-Dedicated-PvtPeering-WestUS2-AFO-Ckt-02"
    }
  ],
  "infrastructureServices": {
    "ipv4AddressSpaces": [
      "10.0.0.0/21"
    ],
    "ipv6AddressSpaces": []
  },
  "ipv4AddressSpace": "10.0.0.0/19",
  "ipv6AddressSpace": "FC00::/59",
  "isWorkloadManagementNetworkEnabled": "True",
  "location": "<Location>",
  "managedResourceGroupConfiguration": {},
  "name": "NFCName",
  "provisioningState": "Succeeded",
  "resourceGroup": "NFCResourceGroupName",
  "systemData": {
    "createdAt": "2023XX-XXT18:59:41.7805324Z",
    "createdBy": "email@address.com",
    "createdByType": "User",
    "lastModifiedAt": "2023-XX-XXT09:50:27.4598499Z",
    "lastModifiedBy": "d1bd24c7-b27f-477e-86dd-939e107873d7",
    "lastModifiedByType": "Application"
  },
  "type": "microsoft.managednetworkfabric/networkfabriccontrollers",
  "workloadExpressRouteConnections": [
    {
      "expressRouteCircuitId": "/subscriptions/xxxxxx-xxxxxx-xxxx-xxxx-xxxxxx//resourceGroups/ER-Dedicated-WUS2-AFO-Circuits/providers/Microsoft.Network/expressRouteCircuits/MSFT-ER-Dedicated-PvtPeering-WestUS2-AFO-Ckt-03"
    }
  ],
  "workloadManagementNetwork": true,
  "workloadServices": {
    "ipv4AddressSpaces": [
      "10.0.28.0/22"
    ],
    "ipv6AddressSpaces": []
  }
}

Aktualisieren des Netzwerk-Fabric Controllers

Mithilfe des PATCH-Features im Netzwerk-Fabric Controller können Benutzer mühelos zusätzliche ExpressRoute-Leitungen hinzufügen oder ersetzen. Diese Funktion ist besonders während Ausfallzeiten oder potenziellen Migrationsereignissen hilfreich. In solchen Fällen haben Netzwerkbetreiber die Flexibilität, einen aktiven Netzwerk-Fabric Controller zu ändern, indem sie ExpressRoute-Leitungen und Schlüssel hinzufügen oder entfernen, während gleichzeitig sichergestellt wird, dass der Betrieb nicht beeinträchtigt wird.

Hinweis

Beim Initiieren eines Aktualisierungsbefehls ist es wichtig, alle Parameter bereitzustellen, die während des Erstellungsprozesses angegeben wurden. Der Grund: Der Aktualisierungsbefehl überschreibt den vorhandenen Inhalt, weshalb alle relevanten Parameter erforderlich sind, um umfassende und korrekte Änderungen sicherzustellen.

az networkfabric controller update \ 
  --resource-group "NFCResourceGroupName" \ 
  --location "<Location>"  \ 
  --resource-name "nfcname" \ 
  --ipv4-address-space "10.0.0.0/19" \ 
  --infra-er-connections '[{"expressRouteCircuitId":"/subscriptions/xxxxxx-xxxxxx-xxxx-xxxx-xxxxxx/resourceGroups/ER-Dedicated-WUS2-AFO-Circuits/providers/Microsoft.Network/expressRouteCircuits/MSFT-ER-Dedicated-PvtPeering-WestUS2-AFO-Ckt-01", "expressRouteAuthorizationKey": "<auth-key>"}]' 
  --workload-er-connections '[{"expressRouteCircuitId":"/subscriptions/xxxxxx-xxxxxx-xxxx-xxxx-xxxxxx/resourceGroups/ER-Dedicated-WUS2-AFO-Circuits/providers/Microsoft.Network/expressRouteCircuits/MSFT-ER-Dedicated-PvtPeering-WestUS2-AFO-Ckt-01"", "expressRouteAuthorizationKey": "<auth-key>"}]' 

Hinweis

Führen Sie „az networkfabric controller show“ aus, um Informationen zu einem Netzwerk-Fabric Controller abzurufen.

Aktualisieren Sie Network Fabric Controller mit mehreren ExpressRoute-Verbindungen.

az networkfabric controller update \ 
 --resource-group "NFCResourceGroupName" \ 
 --location "eastus"  \ 
 --resource-name "nfcname" \ 
 --ipv4-address-space "10.0.0.0/19" \ 
--infra-er-connections "[{expressRouteCircuitId:'/subscriptions/xxxxxx-xxxxxx-xxxx-xxxx-xxxxxx/resourceGroups/ER-Dedicated-WUS2-AFO-Circuits/providers/Microsoft.Network/expressRouteCircuits/MSFT-ER-Dedicated-PvtPeering-WestUS2-AFO-Ckt-01',expressRouteAuthorizationKey:'<auth-key>'},{expressRouteCircuitId:'/subscriptions/xxxxxx-xxxxxx-xxxx-xxxx-xxxxxx/resourceGroups/ER-Dedicated-WUS2-AFO-Circuits/providers/Microsoft.Network/expressRouteCircuits/MSFT-ER-Dedicated-PvtPeering-WestUS2-AFO-Ckt-02',expressRouteAuthorizationKey:'<auth-key>'}]"
--workload-er-connections "[{expressRouteCircuitId:'/subscriptions/xxxxxx-xxxxxx-xxxx-xxxx-xxxxxx/resourceGroups/ER-Dedicated-WUS2-AFO-Circuits/providers/Microsoft.Network/expressRouteCircuits/MSFT-ER-Dedicated-PvtPeering-WestUS2-AFO-Ckt-03',expressRouteAuthorizationKey:'<auth-key>'},{expressRouteCircuitId:'/subscriptions/xxxxxx-xxxxxx-xxxx-xxxx-xxxxxx/resourceGroups/ER-Dedicated-WUS2-AFO-Circuits/providers/Microsoft.Network/expressRouteCircuits/MSFT-ER-Dedicated-PvtPeering-WestUS2-AFO-Ckt-04',expressRouteAuthorizationKey:'<auth-key>'}]"
Befehl Beschreibung
az networkfabric controller update Befehl zum Aktualisieren eines vorhandenen Network Fabric Controller in Azure
Parameter Beschreibung Beispielwert
--resource-group Gibt die Ressourcengruppe an, in der sich der Network Fabric Controller befindet. "NFCResourceGroupName"
--location Gibt die Azure-Region an, in der der Network Fabric Controller bereitgestellt wird. "eastus"
--resource-name Der Name der Network Fabric Controller-Ressource, die Sie aktualisieren möchten. "nfcname"
--ipv4-address-space Definiert den IPv4-Adressraum für den Network Fabric Controller. "10.0.0.0/19"
--infra-er-connections Gibt die ExpressRoute-Infrastrukturverbindungen in einem JSON-Arrayformat an. "[{expressRouteCircuitId:'/subscriptions/xxxxxx-xxxxxx-xxxx-xxxx-xxxxxx/resourceGroups/ER-Dedicated-WUS2-AFO-Circuits/providers/Microsoft.Network/expressRouteCircuits/MSFT-ER-Dedicated-PvtPeering-WestUS2-AFO-Ckt-11',expressRouteAuthorizationKey:'<auth-key>'},{expressRouteCircuitId:'/subscriptions/xxxxxx-xxxxxx-xxxx-xxxx-xxxxxx/resourceGroups/ER-Dedicated-WUS2-AFO-Circuits/providers/Microsoft.Network/expressRouteCircuits/MSFT-ER-Dedicated-PvtPeering-WestUS2-AFO-Ckt-13',expressRouteAuthorizationKey:'<auth-key>'}]"
--workload-er-connections Gibt die ExpressRoute-Workloadverbindungen in einem JSON-Arrayformat an. "[{expressRouteCircuitId:'/subscriptions/xxxxxx-xxxxxx-xxxx-xxxx-xxxxxx/resourceGroups/ER-Dedicated-WUS2-AFO-Circuits/providers/Microsoft.Network/expressRouteCircuits/MSFT-ER-Dedicated-PvtPeering-WestUS2-AFO-Ckt-11',expressRouteAuthorizationKey:'<auth-key>'},{expressRouteCircuitId:'/subscriptions/xxxxxx-xxxxxx-xxxx-xxxx-xxxxxx/resourceGroups/ER-Dedicated-WUS2-AFO-Circuits/providers/Microsoft.Network/expressRouteCircuits/MSFT-ER-Dedicated-PvtPeering-WestUS2-AFO-Ckt-12',expressRouteAuthorizationKey:'<auth-key>'}]"

Hinweis

Ersetzen Sie Platzhalter wie "NFCResourceGroupName", "nfcname" und "<auth-key>" mit tatsächlichen Werten, die für Ihr Setup relevant sind.

Löschen des Netzwerk-Fabric Controllers

Ein NFC sollte erst nach dem Löschen aller zugeordneten Netzwerk-Fabrics gelöscht werden.

  az networkfabric controller delete --resource-group "NFCResourceGroupName" --resource-name "nfcname"

Erwartete Ausgabe:

"name": "nfcname",
    "networkFabricIds": [],
    "operationalState": null,
    "provisioningState": "succeeded",
    "resourceGroup": "NFCResourceGroupName",
    "systemData": {
      "createdAt": "2022-10-31T10:47:08.072025+00:00",

Hinweis

Das Löschen des NFC dauert 30 Minuten. Vergewissern Sie sich im Azure-Portal, dass die gehosteten Ressourcen gelöscht wurden.

Nächste Schritte

Nach erfolgreicher Erstellung eines NFC besteht der nächste Schritt darin, einen Cluster-Manager zu erstellen.