az k8s-extension

Note

This reference is part of the k8s-extension extension for the Azure CLI (version 2.24.0 or higher). The extension will automatically install the first time you run an az k8s-extension command. Learn more about extensions.

Commands to manage Kubernetes Extensions.

Commands

az k8s-extension create	Create a Kubernetes Cluster Extension, including purchasing an extension Offer from Azure Marketplace (AKS only). Please refer to the example at the end to see how to create an extension or purchase an extension offer.
az k8s-extension delete	Delete a Kubernetes Extension.
az k8s-extension extension-types	Commands to discover Kubernetes Extension Types.
az k8s-extension extension-types list	List Kubernetes Extension Types.
az k8s-extension extension-types list-by-location	List available Kubernetes Extension Types in a specified region.
az k8s-extension extension-types list-versions	List available versions for a Kubernetes Extension Type.
az k8s-extension extension-types show	Show properties for a Kubernetes Extension Type.
az k8s-extension list	List Kubernetes Extensions.
az k8s-extension show	Show a Kubernetes Extension.
az k8s-extension update	Update mutable properties of a Kubernetes Extension.

az k8s-extension create

Create a Kubernetes Cluster Extension, including purchasing an extension Offer from Azure Marketplace (AKS only). Please refer to the example at the end to see how to create an extension or purchase an extension offer.

az k8s-extension create --cluster-name
                        --cluster-type {appliances, connectedClusters, managedClusters, provisionedClusters}
                        --extension-type
                        --name
                        --resource-group
                        [--auto-upgrade {false, true}]
                        [--cluster-resource-provider]
                        [--config]
                        [--config-file]
                        [--config-protected]
                        [--config-protected-file]
                        [--config-settings]
                        [--configuration-protected-settings]
                        [--configuration-protected-settings-file]
                        [--configuration-settings-file]
                        [--no-wait]
                        [--plan-name]
                        [--plan-product]
                        [--plan-publisher]
                        [--release-namespace]
                        [--release-train]
                        [--scope {cluster, namespace}]
                        [--target-namespace]
                        [--version]

Examples

Create a Kubernetes Extension

az k8s-extension create --resource-group my-resource-group --cluster-name mycluster --cluster-type connectedClusters --name myextension --extension-type microsoft.openservicemesh --scope cluster --release-train stable

Create a Kubernetes Marketplace Extension

az k8s-extension create --resource-group my-resource-group --cluster-name mycluster --cluster-type managedClusters --name myextension --extension-type Contoso.AzureVoteKubernetesAppTest --scope cluster --release-train stable --plan-name testplan --plan-product kubernetest_apps_demo_offer --plan-publisher test_test_mix3pptest0011614206850774

Required Parameters

--cluster-name -c

Name of the Kubernetes cluster.

--cluster-type -t

Specify Arc clusters or AKS managed clusters or Arc appliances or provisionedClusters.

accepted values: appliances, connectedClusters, managedClusters, provisionedClusters

--extension-type

Name of the extension type.

--name -n

Name of the extension instance.

--resource-group -g

Name of resource group. You can configure the default group using az configure --defaults group=<name>.

Optional Parameters

--auto-upgrade --auto-upgrade-minor-version

Automatically upgrade minor version of the extension instance.

accepted values: false, true

--cluster-resource-provider --cluster-rp

Cluster Resource Provider name for this clusterType (Required for provisionedClusters).

--config --configuration-settings

Configuration Settings as key=value pair. Repeat parameter for each setting.

--config-file --config-settings-file

JSON file path for configuration-settings.

--config-protected --config-protected-settings

Configuration Protected Settings as key=value pair. Repeat parameter for each setting.

--config-protected-file --config-protected-settings-file

JSON file path for configuration-protected-settings.

--config-settings

Configuration Settings as key=value pair. Repeat parameter for each setting.

--configuration-protected-settings

Configuration Protected Settings as key=value pair. Repeat parameter for each setting.

--configuration-protected-settings-file

JSON file path for configuration-protected-settings.

--configuration-settings-file

JSON file path for configuration-settings.

--no-wait

Do not wait for the long-running operation to finish.

default value: False

--plan-name

The plan name is referring to the Plan ID of the extension that is being taken from Marketplace portal under Usage Information + Support.

--plan-product

The plan product is referring to the Product ID of the extension that is being taken from Marketplace portal under Usage Information + Support. An example of this is the name of the ISV offering used.

--plan-publisher

The plan publisher is referring to the Publisher ID of the extension that is being taken from Marketplace portal under Usage Information + Support.

--release-namespace

Specify the namespace to install the extension release.

--release-train

Specify the release train for the extension type.

--scope

Specify the extension scope.

accepted values: cluster, namespace

--target-namespace

Specify the target namespace to install to for the extension instance. This parameter is required if extension scope is set to 'namespace'.

--version

Specify the version to install for the extension instance if --auto-upgrade-minor-version is not enabled.

Global Parameters

--debug

Increase logging verbosity to show all debug logs.

--help -h

Show this help message and exit.

--only-show-errors

Only show errors, suppressing warnings.

--output -o

Output format.

--query

JMESPath query string. See http://jmespath.org/ for more information and examples.

--subscription

Name or ID of subscription. You can configure the default subscription using az account set -s NAME_OR_ID.

--verbose

Increase logging verbosity. Use --debug for full debug logs.

az k8s-extension delete

Delete a Kubernetes Extension.

az k8s-extension delete --cluster-name
                        --cluster-type {appliances, connectedClusters, managedClusters, provisionedClusters}
                        --name
                        --resource-group
                        [--cluster-resource-provider]
                        [--force]
                        [--no-wait]
                        [--yes]

Examples

Delete an existing Kubernetes Extension

az k8s-extension delete --resource-group my-resource-group --cluster-name mycluster --cluster-type connectedClusters --name myextension

Required Parameters

--cluster-name -c

Name of the Kubernetes cluster.

--cluster-type -t

Specify Arc clusters or AKS managed clusters or Arc appliances or provisionedClusters.

accepted values: appliances, connectedClusters, managedClusters, provisionedClusters

--name -n

Name of the extension instance.

--resource-group -g

Name of resource group. You can configure the default group using az configure --defaults group=<name>.

Optional Parameters

--cluster-resource-provider --cluster-rp

Cluster Resource Provider name for this clusterType (Required for provisionedClusters).

--force

Specify whether to force delete the extension from the cluster.

default value: False

--no-wait

Do not wait for the long-running operation to finish.

default value: False

--yes -y

Ignore confirmation prompts.

default value: False

Global Parameters

--debug

Increase logging verbosity to show all debug logs.

--help -h

Show this help message and exit.

--only-show-errors

Only show errors, suppressing warnings.

--output -o

Output format.

--query

JMESPath query string. See http://jmespath.org/ for more information and examples.

--subscription

Name or ID of subscription. You can configure the default subscription using az account set -s NAME_OR_ID.

--verbose

Increase logging verbosity. Use --debug for full debug logs.

az k8s-extension list

List Kubernetes Extensions.

az k8s-extension list --cluster-name
                      --cluster-type {appliances, connectedClusters, managedClusters, provisionedClusters}
                      --resource-group
                      [--cluster-resource-provider]

Examples

List all Kubernetes Extensions on a cluster

az k8s-extension list --resource-group my-resource-group --cluster-name mycluster --cluster-type connectedClusters

Required Parameters

--cluster-name -c

Name of the Kubernetes cluster.

--cluster-type -t

Specify Arc clusters or AKS managed clusters or Arc appliances or provisionedClusters.

accepted values: appliances, connectedClusters, managedClusters, provisionedClusters

--resource-group -g

Name of resource group. You can configure the default group using az configure --defaults group=<name>.

Optional Parameters

--cluster-resource-provider --cluster-rp

Cluster Resource Provider name for this clusterType (Required for provisionedClusters).

Global Parameters

--debug

Increase logging verbosity to show all debug logs.

--help -h

Show this help message and exit.

--only-show-errors

Only show errors, suppressing warnings.

--output -o

Output format.

--query

JMESPath query string. See http://jmespath.org/ for more information and examples.

--subscription

Name or ID of subscription. You can configure the default subscription using az account set -s NAME_OR_ID.

--verbose

Increase logging verbosity. Use --debug for full debug logs.

az k8s-extension show

Show a Kubernetes Extension.

az k8s-extension show --cluster-name
                      --cluster-type {appliances, connectedClusters, managedClusters, provisionedClusters}
                      --name
                      --resource-group
                      [--cluster-resource-provider]

Examples

Show details of a Kubernetes Extension

az k8s-extension show --resource-group my-resource-group --cluster-name mycluster --cluster-type connectedClusters --name myextension

Required Parameters

--cluster-name -c

Name of the Kubernetes cluster.

--cluster-type -t

Specify Arc clusters or AKS managed clusters or Arc appliances or provisionedClusters.

accepted values: appliances, connectedClusters, managedClusters, provisionedClusters

--name -n

Name of the extension instance.

--resource-group -g

Name of resource group. You can configure the default group using az configure --defaults group=<name>.

Optional Parameters

--cluster-resource-provider --cluster-rp

Cluster Resource Provider name for this clusterType (Required for provisionedClusters).

Global Parameters

--debug

Increase logging verbosity to show all debug logs.

--help -h

Show this help message and exit.

--only-show-errors

Only show errors, suppressing warnings.

--output -o

Output format.

--query

JMESPath query string. See http://jmespath.org/ for more information and examples.

--subscription

Name or ID of subscription. You can configure the default subscription using az account set -s NAME_OR_ID.

--verbose

Increase logging verbosity. Use --debug for full debug logs.

az k8s-extension update

Update mutable properties of a Kubernetes Extension.

For update to ConfigSettings and ConfigProtectedSettings, please refer to documentation of the cluster extension service to check update to these properties is supported before updating these properties.

az k8s-extension update --cluster-name
                        --cluster-type {appliances, connectedClusters, managedClusters, provisionedClusters}
                        --name
                        --resource-group
                        [--auto-upgrade {false, true}]
                        [--cluster-resource-provider]
                        [--config]
                        [--config-file]
                        [--config-protected]
                        [--config-protected-file]
                        [--config-settings]
                        [--configuration-protected-settings]
                        [--configuration-protected-settings-file]
                        [--configuration-settings-file]
                        [--no-wait]
                        [--release-train]
                        [--version]
                        [--yes]

Examples

Update a Kubernetes Extension

az k8s-extension update --resource-group my-resource-group --cluster-name mycluster --cluster-type connectedClusters --name myextension --auto-upgrade true/false --version extension-version --release-train stable --configuration-settings settings-key=settings-value --config-protected-settings protected-settings-key=protected-value --config-settings-file=config-settings-file --config-protected-file=protected-settings-file

Required Parameters

--cluster-name -c

Name of the Kubernetes cluster.

--cluster-type -t

Specify Arc clusters or AKS managed clusters or Arc appliances or provisionedClusters.

accepted values: appliances, connectedClusters, managedClusters, provisionedClusters

--name -n

Name of the extension instance.

--resource-group -g

Name of resource group. You can configure the default group using az configure --defaults group=<name>.

Optional Parameters

--auto-upgrade --auto-upgrade-minor-version

Automatically upgrade minor version of the extension instance.

accepted values: false, true

--cluster-resource-provider --cluster-rp

Cluster Resource Provider name for this clusterType (Required for provisionedClusters).

--config --configuration-settings

Configuration Settings as key=value pair. Repeat parameter for each setting.

--config-file --config-settings-file

JSON file path for configuration-settings.

--config-protected --config-protected-settings

Configuration Protected Settings as key=value pair. Repeat parameter for each setting.

--config-protected-file --config-protected-settings-file

JSON file path for configuration-protected-settings.

--config-settings

Configuration Settings as key=value pair. Repeat parameter for each setting.

--configuration-protected-settings

Configuration Protected Settings as key=value pair. Repeat parameter for each setting.

--configuration-protected-settings-file

JSON file path for configuration-protected-settings.

--configuration-settings-file

JSON file path for configuration-settings.

--no-wait

Do not wait for the long-running operation to finish.

default value: False

--release-train

Specify the release train for the extension type.

--version

Specify the version to install for the extension instance if --auto-upgrade-minor-version is not enabled.

--yes -y

Ignore confirmation prompts.

default value: False

Global Parameters

--debug

Increase logging verbosity to show all debug logs.

--help -h

Show this help message and exit.

--only-show-errors

Only show errors, suppressing warnings.

--output -o

Output format.

--query

JMESPath query string. See http://jmespath.org/ for more information and examples.

--subscription

Name or ID of subscription. You can configure the default subscription using az account set -s NAME_OR_ID.

--verbose

Increase logging verbosity. Use --debug for full debug logs.