az k8sconfiguration

  • Preview
  • Deprecated
  • Reference

Note

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

This command group is in preview and under development. Reference and support levels: https://aka.ms/CLI_refstatus

This command group has been deprecated and will be removed in a future release. Use 'k8s-configuration' instead.

Commands to manage Kubernetes configuration.

Commands

Name Description Type Status
az k8sconfiguration create

Create a Kubernetes configuration.

 Extension Preview and Deprecated
az k8sconfiguration delete

Delete a Kubernetes configuration.

 Extension Preview and Deprecated
az k8sconfiguration list

List Kubernetes configurations.

 Extension Preview and Deprecated
az k8sconfiguration show

Show details of a Kubernetes configuration.

 Extension Preview and Deprecated
az k8sconfiguration update

Update a Kubernetes configuration.

 Extension Preview and Deprecated

az k8sconfiguration create

Preview Deprecated

Command group 'k8sconfiguration' is in preview and under development. Reference and support levels: https://aka.ms/CLI_refstatus

This command is implicitly deprecated because command group 'k8sconfiguration' is deprecated and will be removed in a future release. Use 'k8s-configuration' instead.

Create a Kubernetes configuration.

az k8sconfiguration create --cluster-name
                           --cluster-type {connectedClusters, managedClusters}
                           --name
                           --repository-url
                           --resource-group
                           --scope {cluster, namespace}
                           [--enable-helm-operator {false, true}]
                           [--helm-operator-params]
                           [--helm-operator-version]
                           [--https-key]
                           [--https-user]
                           [--operator-instance-name]
                           [--operator-namespace]
                           [--operator-params]
                           [--operator-type]
                           [--ssh-known-hosts]
                           [--ssh-known-hosts-file]
                           [--ssh-private-key]
                           [--ssh-private-key-file]

Examples

Create a Kubernetes configuration

az k8sconfiguration create --resource-group MyResourceGroup --cluster-name MyClusterName \
--cluster-type connectedClusters --name MyGitConfig --operator-instance-name OperatorInst01 \
--operator-namespace OperatorNamespace01 --operator-type flux --operator-params "'--git-readonly'" \
--repository-url git://github.com/fluxHowTo/flux-get-started --enable-helm-operator  \
--helm-operator-version 1.2.0 --scope namespace --helm-operator-params '--set helm.versions=v3' \
--ssh-private-key '' --ssh-private-key-file '' --https-user '' --https-key '' \
--ssh-known-hosts '' --ssh-known-hosts-file ''

Required Parameters

--cluster-name -c

Name of the Kubernetes cluster.

--cluster-type

Specify Arc clusters or AKS managed clusters.

accepted values: connectedClusters, managedClusters
--name -n

Name of the Kubernetes Configuration.

--repository-url -u

Url of the source control repository.

--resource-group -g

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

--scope

Specify scope of the operator to be 'namespace' or 'cluster'.

accepted values: cluster, namespace

Optional Parameters

--enable-helm-operator

Enable support for Helm chart deployments.

accepted values: false, true
--helm-operator-params

Chart values for the Helm Operator (if enabled).

--helm-operator-version

Chart version of the Helm Operator (if enabled).

default value: 1.2.0
--https-key

Specify HTTPS token/password for private repository sync.

--https-user

Specify HTTPS username for private repository sync.

--operator-instance-name

Instance name of the Operator.

--operator-namespace

Namespace in which to install the Operator.

default value: default
--operator-params

Parameters for the Operator.

--operator-type

Type of the operator. Valid value is 'flux'.

default value: flux
--ssh-known-hosts

Specify Base64-encoded known_hosts contents containing public SSH keys required to access private Git instances.

--ssh-known-hosts-file

Specify filepath to known_hosts contents containing public SSH keys required to access private Git instances.

--ssh-private-key

Specify Base64-encoded private ssh key for private repository sync.

--ssh-private-key-file

Specify filepath to private ssh key for private repository sync.

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.

accepted values: json, jsonc, none, table, tsv, yaml, yamlc
default value: json
--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 k8sconfiguration delete

Preview Deprecated

Command group 'k8sconfiguration' is in preview and under development. Reference and support levels: https://aka.ms/CLI_refstatus

This command is implicitly deprecated because command group 'k8sconfiguration' is deprecated and will be removed in a future release. Use 'k8s-configuration' instead.

Delete a Kubernetes configuration.

az k8sconfiguration delete --cluster-name
                           --cluster-type {connectedClusters, managedClusters}
                           --name
                           --resource-group
                           [--yes]

Examples

Delete a Kubernetes configuration

az k8sconfiguration delete --resource-group MyResourceGroup --cluster-name MyClusterName \
--cluster-type connectedClusters --name MyConfigurationName

Required Parameters

--cluster-name -c

Name of the Kubernetes cluster.

--cluster-type

Specify Arc clusters or AKS managed clusters.

accepted values: connectedClusters, managedClusters
--name -n

Name of the Kubernetes Configuration.

--resource-group -g

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

Optional Parameters

--yes -y

Do not prompt for confirmation.

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.

accepted values: json, jsonc, none, table, tsv, yaml, yamlc
default value: json
--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 k8sconfiguration list

Preview Deprecated

Command group 'k8sconfiguration' is in preview and under development. Reference and support levels: https://aka.ms/CLI_refstatus

This command is implicitly deprecated because command group 'k8sconfiguration' is deprecated and will be removed in a future release. Use 'k8s-configuration' instead.

List Kubernetes configurations.

az k8sconfiguration list --cluster-name
                         --cluster-type {connectedClusters, managedClusters}
                         --resource-group

Examples

List all Kubernetes configurations of a cluster

az k8sconfiguration list --resource-group MyResourceGroup --cluster-name MyClusterName \
--cluster-type connectedClusters

Required Parameters

--cluster-name -c

Name of the Kubernetes cluster.

--cluster-type

Specify Arc clusters or AKS managed clusters.

accepted values: connectedClusters, managedClusters
--resource-group -g

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

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.

accepted values: json, jsonc, none, table, tsv, yaml, yamlc
default value: json
--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 k8sconfiguration show

Preview Deprecated

Command group 'k8sconfiguration' is in preview and under development. Reference and support levels: https://aka.ms/CLI_refstatus

This command is implicitly deprecated because command group 'k8sconfiguration' is deprecated and will be removed in a future release. Use 'k8s-configuration' instead.

Show details of a Kubernetes configuration.

az k8sconfiguration show --cluster-name
                         --cluster-type {connectedClusters, managedClusters}
                         --name
                         --resource-group

Examples

Show a Kubernetes configuration

az k8sconfiguration show --resource-group MyResourceGroup --cluster-name MyClusterName \
--cluster-type connectedClusters --name MyConfigurationName

Required Parameters

--cluster-name -c

Name of the Kubernetes cluster.

--cluster-type

Specify Arc clusters or AKS managed clusters.

accepted values: connectedClusters, managedClusters
--name -n

Name of the Kubernetes Configuration.

--resource-group -g

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

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.

accepted values: json, jsonc, none, table, tsv, yaml, yamlc
default value: json
--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 k8sconfiguration update

Preview Deprecated

Command group 'k8sconfiguration' is in preview and under development. Reference and support levels: https://aka.ms/CLI_refstatus

This command is implicitly deprecated because command group 'k8sconfiguration' is deprecated and will be removed in a future release. Use 'k8s-configuration' instead.

Update a Kubernetes configuration.

az k8sconfiguration update --cluster-name
                           --cluster-type {connectedClusters, managedClusters}
                           --name
                           --resource-group
                           [--enable-helm-operator {false, true}]
                           [--helm-operator-params]
                           [--helm-operator-version]
                           [--operator-params]
                           [--repository-url]
                           [--ssh-known-hosts]
                           [--ssh-known-hosts-file]

Examples

Update an existing Kubernetes configuration

az k8sconfiguration update --resource-group MyResourceGroup --cluster-name MyClusterName \
--cluster-type connectedClusters --name MyConfigurationName --enable-helm-operator \
--repository-url git://github.com/fluxHowTo/flux-get-started --operator-params "'--git-readonly'" \
--helm-operator-version 1.2.0 --helm-operator-params '--set helm.versions=v3'

Required Parameters

--cluster-name -c

Name of the Kubernetes cluster.

--cluster-type

Specify Arc clusters or AKS managed clusters.

accepted values: connectedClusters, managedClusters
--name -n

Name of the Kubernetes Configuration.

--resource-group -g

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

Optional Parameters

--enable-helm-operator

Enable support for Helm chart deployments.

accepted values: false, true
--helm-operator-params

Chart values for the Helm Operator (if enabled).

--helm-operator-version

Chart version of the Helm Operator (if enabled).

--operator-params

Parameters for the Operator.

--repository-url -u

Url of the source control repository.

--ssh-known-hosts

Specify Base64-encoded known_hosts contents containing public SSH keys required to access private Git instances.

--ssh-known-hosts-file

Specify filepath to known_hosts contents containing public SSH keys required to access private Git instances.

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.

accepted values: json, jsonc, none, table, tsv, yaml, yamlc
default value: json
--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.