Edit

Share via

Install Azure CLI extensions for multi-rack deployments of Azure Local (preview)

Applies to: Multi-rack deployments of Azure Local 2511 and later

This article explains how to install the required Azure CLI extensions for multi-rack deployments of Azure Local.

Important

This feature is currently in PREVIEW. See the Supplemental Terms of Use for Microsoft Azure Previews for legal terms that apply to Azure features that are in beta, preview, or otherwise not yet released into general availability.

Install Azure CLI

Ensure Azure CLI is installed before installing the extensions. Follow Install Azure CLI instructions to install it.

Install required Azure CLI extensions

See the following sections to install the required Azure CLI extensions:

  • networkcloud for Microsoft.NetworkCloud APIs
  • managednetworkfabric for Microsoft.ManagedNetworkFabric APIs
  • stack-hci-vm for Microsoft.AzureStackHCI APIs

Note

Any upgrade of the Azure CLI downloads the latest stable version of the installed extension. To install the preview version of the extensions, you must explicitly set the --allow-preview=True parameter.

Install the networkcloud CLI extension

For the list of available versions, see the extension release history.

  • Upgrade any previously installed version of the extension:

    az extension add --yes --upgrade --name networkcloud

  • Install and test the latest version of the networkcloud CLI extension:

    az extension add --name networkcloud
az networkcloud --help

Install the managednetworkfabric CLI extension

For the list of available versions, see the extension release history.

  • Upgrade any previously installed version of the extension:

    az extension add --yes --upgrade --name managednetworkfabric

  • Install and test the latest version of the managednetworkfabric CLI extension:

    az extension add --name managednetworkfabric
az networkfabric --help

Install the stack-hci-vm CLI extension

  • Upgrade any previously installed version of the extension.

    az extension add --yes --upgrade --name stack-hci-vm

  • Install and test the latest version of the stack-hci-vm CLI extension.

    az extension add --name stack-hci-vm 
az stack-hci-vm --help

Install other Azure extensions

Install other Azure CLI extensions that multi-rack deployment makes use of:

az extension add --yes --upgrade --name customlocation
az extension add --yes --upgrade --name k8s-extension
az extension add --yes --upgrade --name k8s-configuration
az extension add --yes --upgrade --name connectedmachine
az extension add --yes --upgrade --name monitor-control-service
az extension add --yes --upgrade --name ssh
az extension add --yes --upgrade --name connectedk8s

List installed CLI extensions and versions

List the extension version running:

az extension list --query "[].{Name:name,Version:version}" -o table

Example output:

Name                     Version
-----------------------  -------------
monitor-control-service  0.4.1
connectedmachine         1.0.0
connectedk8s             1.10.6
k8s-extension            1.6.4
networkcloud             2.0.0
k8s-configuration        2.2.0
managednetworkfabric     8.0.0
stack-hci-vm             0.1.18
customlocation           0.1.3
ssh                      2.0.6
  • Last updated on