Dela via

Skapa och ändra en Network Fabric-styrenhet med Hjälp av Azure CLI

  • Artikel

Den här artikeln beskriver hur du skapar en Network Fabric Controller (NFC) med hjälp av Azure Command Line Interface (AzureCLI). Det här dokumentet visar också hur du kontrollerar statusen eller tar bort en nätverksinfrastrukturkontrollant.

Förutsättningar

Du måste implementera alla förutsättningar innan du skapar en NFC.

Namn, till exempel för resurser, får inte innehålla understrecket (_).

Verifiera ExpressRoute-krets

Verifiera ExpressRoute-kretsarna för rätt anslutning (CircuitID)(AuthID); NFC-etableringen misslyckas om anslutningen är felaktig.

Skapa en nätverksinfrastrukturkontrollant

Du måste skapa en resursgrupp innan du skapar din NFC.

Obs! Du bör skapa en separat resursgrupp för varje NFC.

Du skapar resursgrupper genom att köra följande kommandon:

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

Attribut för att skapa NFC

Parameter Description values Exempel Obligatoriskt Typ
Resursgrupp En resursgrupp är en container som innehåller relaterade resurser för en Azure-lösning. NFCResourceGroupName XYZNFCResourceGroupName Sant String
Plats Azure-regionen är obligatorisk för att etablera distributionen. eastus, westus3, southcentralus, eastus2euap eastus Sant String
Resursnamn Resursnamnet är namnet på nätverksinfrastrukturkontrollanten nfcname XYZnfcname Sant String
ipv4-address-space IPv4 Network Fabric Controller-adressutrymme, standardblocket för undernätet är 10.0.0.0/19, och det bör inte heller överlappa med någon av ExpressRoute-IP-adresserna 10.0.0.0/19 10.0.0.0/19 Krävs inte String
ipv6-address-space IPv6 Network Fabric Controller Address Space är den här parametern standardinställningen FC00::/59, där det tillåtna intervallet är /59 "FC00::/59" "FC00::/59" Krävs inte String
ExpressRoute-kretsar ExpressRoute-kretsen är en dedikerad 10G-länk som ansluter Azure och lokalt. Du måste känna till ExpressRoute-krets-ID och autentiseringsnyckel för att en NFC ska kunna etableras. Det finns två Express Route-kretsar, en för infrastrukturtjänsterna och en annan för arbetsbelastningstjänster (klientorganisation) --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"}] Sant sträng
Hanterad resursgrupp Konfigurationsegenskaper för hanterad resursgrupp. NFCManagedResourceGroupName XYZNFCManagedResourceGroupName Sant String

Här är ett exempel på hur du kan skapa en NFC med hjälp av Azure CLI. Mer information finns i avsnittet attribut.

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

Obs! NFC-skapandet tar mellan 30 och 45 minuter. show Använd kommandot för att övervaka förloppet för att skapa NFC. Du ser olika etableringstillstånd, till exempel Accepterad, uppdatering och Lyckades/Misslyckades. Ta bort och återskapa NFC om det inte går att skapa (Failed). Förväntade utdata visas bara när du kör via AzureCLI

Förväntad utdata:

 {
  "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": []
  }
}

Hämta Nätverksinfrastrukturkontrollant

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

Förväntad utdata:

{
  "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": []
  }
}

Uppdatera Network Fabric Controller

Patch-funktionen i Network Fabric Controller ger användarna möjlighet att enkelt lägga till eller ersätta ytterligare Express Routes-kretsar. Den här funktionen är särskilt användbar under perioder av fel eller potentiella migreringshändelser. I sådana fall har nätverksoperatören flexibiliteten att ändra en aktiv network fabric-styrenhet genom att lägga till eller ta bort Express-vägar och -nycklar, samtidigt som åtgärden förblir opåverkad.

Kommentar

När du initierar ett uppdateringskommando är det viktigt att ange alla parametrar som angavs under skapandeprocessen. Det beror på att uppdateringskommandot skriver över det befintliga innehållet, vilket kräver att alla relevanta parametrar inkluderas för att säkerställa omfattande och korrekta ändringar.

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

Kommentar

Kör az networkfabric controller show för att hämta information om en nätverksinfrastrukturkontrollant.

Uppdatera Network Fabric Controller med flera ExpressRoute kretsar.

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>'}]"
Kommando Beskrivning
az networkfabric controller update Kommando för att uppdatera en befintlig nätverksinfrastrukturkontrollant i Azure
Parameter Beskrivning Exempelvärde
--resource-group Anger resursgruppen där nätverksinfrastrukturstyrenheten finns. "NFCResourceGroupName"
--location Anger den Azure-region där nätverksinfrastrukturstyrenheten distribueras. "eastus"
--resource-name Namnet på den nätverksinfrastrukturstyrenhetsresurs som du vill uppdatera. "nfcname"
--ipv4-address-space Definierar IPv4-adressutrymmet för nätverksinfrastrukturkontrollanten. "10.0.0.0/19"
--infra-er-connections Anger infrastrukturens ExpressRoute-anslutningar i ett JSON-matrisformat. "[{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 Anger arbetsbelastningens ExpressRoute-anslutningar i JSON-matrisformat. "[{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>'}]"

Kommentar

Ersätt platshållarna som "NFCResourceGroupName", "nfcname"och "<auth-key>" med faktiska värden som är relevanta för konfigurationen.

Ta bort nätverksinfrastrukturkontrollant

Du bör ta bort en NFC först när du har tagit bort alla associerade nätverksinfrastrukturer.

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

Förväntad utdata:

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

Kommentar

Det tar 30 minuter att ta bort NFC. I Azure Portal kontrollerar du att de värdbaserade resurserna har tagits bort.

Nästa steg

När du har skapat en NFC är nästa steg att skapa en klusterhanterare.