Delen via

Een Netwerkinfrastructuurcontroller maken en wijzigen met behulp van Azure CLI

  • Artikel

In dit artikel wordt beschreven hoe u een Network Fabric Controller (NFC) maakt met behulp van de Azure-opdrachtregelinterface (AzureCLI). In dit document ziet u ook hoe u de status controleert of een netwerkinfrastructuurcontroller verwijdert.

Vereisten

U moet alle vereisten implementeren voordat u een NFC maakt.

Namen, zoals voor resources, mogen het onderstrepingsteken (_) niet bevatten.

ExpressRoute-circuit valideren

Valideer de ExpressRoute-circuit(s) voor de juiste connectiviteit (CircuitID)(AuthID); NFC-inrichting mislukt als de verbinding onjuist is.

Een Netwerkinfrastructuurcontroller maken

U moet een resourcegroep maken voordat u uw NFC maakt.

Opmerking: U moet voor elke NFC een afzonderlijke resourcegroep maken.

U maakt resourcegroepen door de volgende opdrachten uit te voeren:

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

Kenmerken voor het maken van NFC

Parameter Description waarden Opmerking Vereist Type
Resourcegroep Een resourcegroep is een container met gerelateerde resources voor een Azure-oplossing. NFCResourceGroupName XYZNFCResourceGroupName Waar String
Locatie De Azure-regio is verplicht om uw implementatie in te richten. eastus, westus3, southcentralus, eastus2euap eastus Waar String
Resourcenaam De resourcenaam is de naam van de netwerkinfrastructuurcontroller nfcname XYZnfcname Waar String
ipv4-adresruimte De adresruimte van de IPv4-netwerkinfrastructuurcontroller, het standaardsubnetblok is 10.0.0.0/19 en mag ook niet overlappen met een van de ExpressRoute-IP's 10.0.0.0/19 10.0.0.0/19 Niet vereist String
ipv6-adresruimte De adresruimte van de IPv6-netwerkinfrastructuurcontroller is standaard ingesteld op FC00::/59, waarbij het toegestane bereik wordt /59 "FC00::/59" "FC00::/59" Niet vereist String
Express Route-circuits Het ExpressRoute-circuit is een toegewezen 10G-koppeling waarmee Azure en on-premises worden verbonden. U moet de ExpressRoute-circuit-id en de verificatiesleutel voor een NFC kennen om succesvol in te richten. Er zijn twee Express Route-circuits, een voor de infrastructuurservices en een voor workloadservices (tenantservices) --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"}] Waar tekenreeks
Beheerde resourcegroep Configuratie-eigenschappen van beheerde resourcegroep. NFCManagedResourceGroupName XYZNFCManagedResourceGroupName Waar String

Hier volgt een voorbeeld van hoe u een NFC kunt maken met behulp van de Azure CLI. Zie de sectie kenmerken voor meer informatie.

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

Opmerking: de NFC-creatie duurt tussen de 30-45 minuten. Gebruik de opdracht om de show voortgang van het maken van NFC te controleren. U ziet verschillende inrichtingsstatussen, zoals Geaccepteerd, Bijwerken en Geslaagd/Mislukt. Verwijder de NFC en maak deze opnieuw als het maken mislukt (Failed). De verwachte uitvoer wordt alleen uitgevoerd zodra u deze uitvoert via AzureCLI

Verwachte uitvoer:

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

Netwerkinfrastructuurcontroller ophalen

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

Verwachte uitvoer:

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

Network Fabric Controller bijwerken

De PATCH-functie in de Network Fabric Controller biedt gebruikers de mogelijkheid om moeiteloos extra Express Routes-circuits toe te voegen of te vervangen. Deze functionaliteit is met name nuttig tijdens perioden van fouten of potentiële migratie-gebeurtenissen. In dergelijke gevallen heeft de netwerkoperator de flexibiliteit om een actieve netwerkinfrastructuurcontroller te wijzigen door Express Routes en sleutels toe te voegen of te verwijderen, allemaal terwijl de bewerking ongewijzigd blijft.

Notitie

Bij het initiëren van een updateopdracht is het van cruciaal belang om alle parameters op te geven die tijdens het aanmaakproces zijn opgegeven. Dit komt doordat de updateopdracht de bestaande inhoud overschrijft, waardoor alle relevante parameters moeten worden opgenomen om uitgebreide en nauwkeurige wijzigingen te garanderen.

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

Notitie

Voer az networkfabric controller show uit om informatie over een netwerkinfrastructuurcontroller op te halen.

Werk Network Fabrc Controller bij met meerdere ExpressRoute circuits.

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>'}]"
Command Beschrijving
az networkfabric controller update Opdracht voor het bijwerken van een bestaande netwerkinfrastructuurcontroller in Azure
Parameter Beschrijving Voorbeeldwaarde
--resource-group Hiermee geeft u de resourcegroep op waar de netwerkinfrastructuurcontroller zich bevindt. "NFCResourceGroupName"
--location Hiermee geeft u de Azure-regio op waar de netwerkinfrastructuurcontroller wordt geïmplementeerd. "eastus"
--resource-name De naam van de netwerkinfrastructuurcontrollerresource die u wilt bijwerken. "nfcname"
--ipv4-address-space Definieert de IPv4-adresruimte voor de netwerkinfrastructuurcontroller. "10.0.0.0/19"
--infra-er-connections Hiermee geeft u de ExpressRoute-infrastructuurverbindingen in een JSON-matrixindeling op. "[{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 Hiermee geeft u de ExpressRoute-verbindingen van de werkbelasting in een JSON-matrixindeling op. "[{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>'}]"

Notitie

Vervang de tijdelijke aanduidingen zoals "NFCResourceGroupName", "nfcname"en "<auth-key>" door werkelijke waarden die relevant zijn voor uw installatie.

Netwerkinfrastructuurcontroller verwijderen

U moet een NFC alleen verwijderen nadat u alle gekoppelde netwerkinfrastructuur hebt verwijderd.

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

Verwachte uitvoer:

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

Notitie

Het duurt 30 minuten om de NFC te verwijderen. Controleer in Azure Portal of de gehoste resources zijn verwijderd.

Volgende stappen

Nadat u een NFC hebt gemaakt, is de volgende stap het maken van een clusterbeheerder.