Créer et modifier un contrôleur de structure réseau à l’aide d’Azure CLI

Article
06/05/2024

Cet article explique comment créer un contrôleur d’infrastructure réseau (NFC) à l’aide de l’interface de ligne de commande Azure (AzCLI). Ce document vous montre également comment vérifier l’état d’un contrôleur d’infrastructure réseau, le mettre à jour ou le supprimer.

Prérequis

Vous devez implémenter toutes les conditions préalables avant de créer un NFC.

Les noms, tels que les ressources, ne doivent pas contenir le caractère de soulignement (_).

Valider un circuit ExpressRoute

Validez le ou les circuits ExpressRoute pour une connectivité correcte (CircuitID)(AuthID) ; l’approvisionnement NFC échoue si la connectivité est incorrecte.

Étape 1 : créer un contrôleur d’infrastructure réseau

Vous devez créer un groupe de ressources avant de créer votre NFC.

Remarque : vous devez créer un groupe de ressources distinct pour chaque NFC.

Vous créez des groupes de ressources en exécutant les commandes suivantes :

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

Attributs pour la création NFC

Paramètre	Description	.	Exemple	Requis	Type
Groupe de ressources	Un groupe de ressources est un conteneur réunissant les ressources associées d’une solution Azure.	NFCResourceGroupName	XYZNFCResourceGroupName	True	Chaîne
Emplacement	La région Azure est obligatoire pour approvisionner votre déploiement.	eastus, westus3, southcentralus, eastus2euap	eastus	True	Chaîne
Nom de la ressource	Resource-name sera le nom don contrôleur de structure Network Fabric	nfcname	XYZnfcname	True	Chaîne
ipv4-address-space	Espace d’adressage IPv4 du contrôleur de structure Network Fabric : le bloc de sous-réseau par défaut est 10.0.0.0/19, et il ne doit pas non plus chevaucher les adresses IP ExpressRoute	10.0.0.0/19	10.0.0.0/19	Facultatif	Chaîne
ipv6-address-space	Espace d’adressage IPv6 du contrôleur NFS (Network Fabric Controller) : ce paramètre est défini par défaut sur FC00::/59, la plage autorisée étant /59	"FC00::/59"	"FC00::/59"	Facultatif	Chaîne
Circuits Express Route	Le circuit ExpressRoute est un lien 10G dédié qui connecte Azure et localement. Vous devez connaître l’ID du circuit ExpressRoute et la clé d’authentification pour qu’un NFC soit correctement approvisionné. Il existe deux circuits Express Route, un pour les services d’infrastructure et un autre pour les services de charge de travail (locataire)	--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	string
Managed-Resource-Group	Propriétés de configuration du groupe de ressources managées.	NFCManagedResourceGroupName	XYZNFCManagedResourceGroupName	True	Chaîne

Voici un exemple de création d’un NFC à l’aide d’Azure CLI. Pour plus d’informations, voir : Attributs de la section.

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

Remarque : la création NFC prend entre 30 et 45 minutes. Utilisez la commande show pour surveiller la progression de la création d’un NFC. Vous verrez différents états d’approvisionnement tels que Accepté, Mise à jour et Échec de la mise à jour. Supprimez et recréez le NFC en cas d’échec de la création (Failed). La sortie attendue affiche uniquement l’exécution dès que vous l’exécutez via AzureCLI

Sortie attendue :

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

Obtenir le contrôleur de structure réseau

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

Sortie attendue :

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

Mettre à jour le contrôleur de structure réseau

La fonctionnalité PATCH du contrôleur NFS (Network Fabric Controller) permet aux utilisateurs d’ajouter ou de remplacer facilement des circuits Express Routes supplémentaires. Cette fonctionnalité est particulièrement utile pendant les périodes d’échec ou d’événements de migration potentiels. Dans ce cas, l’opérateur réseau a la possibilité de modifier un contrôleur de structure réseau actif en ajoutant ou supprimant des itinéraires et des clés Express, tout en garantissant que l’opération n’est pas affectée.

Remarque

Lors du lancement d’une commande de mise à jour, il est essentiel de fournir tous les paramètres fournis pendant le processus de création. Cela est dû au fait que la commande de mise à jour remplace le contenu existant, ce qui nécessite l’inclusion de tous les paramètres pertinents pour garantir des modifications complètes et précises.

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

Remarque

Exécutez az networkfabric controller show pour en savoir plus sur un contrôleur de structure réseau

Mettez à jour le contrôleur de structure réseau avec plusieurs circuits `ExpressRoute`.

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

Interface	Description
`az networkfabric controller update`	Commande pour mettre à jour un contrôleur de structure réseau existant dans Azure

Paramètre	Description	Exemple de valeur
`--resource-group`	Spécifie le groupe de ressources dans lequel se trouve le contrôleur de structure réseau.	`"NFCResourceGroupName"`
`--location`	Spécifie la région Azure dans laquelle le contrôleur de structure réseau est déployé.	`"eastus"`
`--resource-name`	Le nom de la ressource de contrôleur de structure réseau que vous souhaitez mettre à jour.	`"nfcname"`
`--ipv4-address-space`	Définit l’espace d'adressage IPv4 pour le contrôleur de structure réseau.	`"10.0.0.0/19"`
`--infra-er-connections`	Spécifie les connexions ExpressRoute d’infrastructure dans un format de tableau JSON.	"[{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`	Spécifie les connexions ExpressRoute de charge de travail dans un format de tableau JSON.	"[{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>'}]"

Remarque

Remplacez les espaces réservés "NFCResourceGroupName", "nfcname" et "<auth-key>" avec des valeurs réelles qui s’appliquent à votre configuration.

Supprimer le contrôleur de structure réseau

Vous devez supprimer un NFC uniquement après avoir supprimé toutes les infrastructures réseau associées.

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

Sortie attendue :

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

Remarque

La suppression du NFC prend 30 minutes. Dans le portail Azure, vérifiez que les ressources hébergées ont été supprimées.

Étapes suivantes

Une fois que vous avez créé un NFC, l’étape suivante consiste à créer un gestionnaire de cluster.

Partager via

Créer et modifier un contrôleur de structure réseau à l’aide d’Azure CLI

Prérequis

Valider un circuit ExpressRoute

Étape 1 : créer un contrôleur d’infrastructure réseau

Attributs pour la création NFC

Obtenir le contrôleur de structure réseau

Mettre à jour le contrôleur de structure réseau

Mettez à jour le contrôleur de structure réseau avec plusieurs circuits `ExpressRoute`.

Supprimer le contrôleur de structure réseau

Étapes suivantes

Ressources supplémentaires

Partager via

Créer et modifier un contrôleur de structure réseau à l’aide d’Azure CLI

Prérequis

Valider un circuit ExpressRoute

Étape 1 : créer un contrôleur d’infrastructure réseau

Attributs pour la création NFC

Obtenir le contrôleur de structure réseau

Mettre à jour le contrôleur de structure réseau

Mettez à jour le contrôleur de structure réseau avec plusieurs circuits ExpressRoute.

Supprimer le contrôleur de structure réseau

Étapes suivantes

Ressources supplémentaires

Mettez à jour le contrôleur de structure réseau avec plusieurs circuits `ExpressRoute`.