Share via

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

  • Artikel

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 "East US"

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, eus2euap eastus True String
Resource-Name Der Ressourcenname ist der Name des Fabric. nfcname XYZnfcname True String
NFC-IP-Adressblock Dieser Block ist das NFC-IP-Subnetz. Der Standard-Subnetzblock ist 10.0.0.0/19, und er darf sich auch nicht mit einer der ExpressRoute-IP-Adressen überschneiden. 10.0.0.0/19 10.0.0.0/19 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. --workload-er-connections '[{"expressRouteCircuitId": "xxxxxx-xxxxxx-xxxx-xxxx-xxxxxx", "expressRouteAuthorizationKey": "xxxxxx-xxxxxx-xxxx-xxxx-xxxxxx"}]'

--infra-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

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 "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>"}]'
  --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: 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": "eastus",
  "managedResourceGroupConfiguration": {},
  "name": "NFCName",
  "nfcSku": "Standard",
  "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 Sie den Netzwerkfabriccontroller 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>'}]"

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": "eastus",
  "managedResourceGroupConfiguration": {},
  "name": "NFCName",
  "nfcSku": "Standard",
  "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 "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>"}]' 
  --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.

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.