Поделиться через

az k8s-extension

  • Ссылка

Примечание.

Эта ссылка является частью расширения k8s-extension для Azure CLI (версия 2.51.0 или более поздней). Расширение будет автоматически устанавливаться при первом запуске команды az k8s-extension . Подробнее о расширениях.

Команды для управления расширениями Kubernetes.

Команды

Имя Описание Тип Состояние
az k8s-extension create

Создайте расширение кластера Kubernetes, включая приобретение предложения расширения из Azure Marketplace (только AKS). Ознакомьтесь с примером в конце, чтобы узнать, как создать расширение или приобрести предложение расширения.

 Расширение Общедоступная версия
az k8s-extension delete

Удаление расширения Kubernetes.

 Расширение Общедоступная версия
az k8s-extension extension-types

Команды для обнаружения типов расширений Kubernetes.

 Расширение "Предварительная версия"
az k8s-extension extension-types list

Список доступных типов расширений кластера для существующего кластера.

 Расширение Предварительная версия и не рекомендуется
az k8s-extension extension-types list-by-cluster

Список доступных типов расширений кластера для существующего кластера. Свойства, используемые для фильтрации, включают тип кластера (управляемый, подключенный и т. д.), версию kubernetes, расположение кластера.

 Расширение "Предварительная версия"
az k8s-extension extension-types list-by-location

Список доступных типов расширений кластера в регионе.

 Расширение "Предварительная версия"
az k8s-extension extension-types list-versions

Список доступных версий для типа расширения кластера для данного кластера.

 Расширение Предварительная версия и не рекомендуется
az k8s-extension extension-types list-versions-by-cluster

Список доступных версий для типа расширения кластера для данного кластера. Свойства, используемые для фильтрации, включают тип кластера (управляемый, подключенный и т. д.), версию kubernetes, расположение кластера.

 Расширение "Предварительная версия"
az k8s-extension extension-types list-versions-by-location

Список доступных версий для версий типа расширения кластера в регионе.

 Расширение "Предварительная версия"
az k8s-extension extension-types show

Получение свойств для типа расширения кластера в регионе.

 Расширение Предварительная версия и не рекомендуется
az k8s-extension extension-types show-by-cluster

Отображение свойств для типа расширения кластера для существующего кластера. Свойства, используемые для фильтрации, включают тип кластера (управляемый, подключенный и т. д.), версию kubernetes, расположение кластера.

 Расширение "Предварительная версия"
az k8s-extension extension-types show-by-location

Отображение свойств типа расширения кластера в регионе.

 Расширение "Предварительная версия"
az k8s-extension extension-types show-version-by-cluster

Отображение свойств, связанных с версией типа расширения кластера для существующего кластера. Свойства, используемые для фильтрации, включают тип кластера (управляемый, подключенный и т. д.), версию kubernetes, расположение кластера.

 Расширение "Предварительная версия"
az k8s-extension extension-types show-version-by-location

Отображение свойств, связанных с версией типа расширения кластера в регионе.

 Расширение "Предварительная версия"
az k8s-extension list

Перечисление расширений Kubernetes.

 Расширение Общедоступная версия
az k8s-extension show

Показать расширение Kubernetes.

 Расширение Общедоступная версия
az k8s-extension update

Обновите изменяемые свойства расширения Kubernetes.

 Расширение Общедоступная версия

az k8s-extension create

Создайте расширение кластера Kubernetes, включая приобретение предложения расширения из Azure Marketplace (только AKS). Ознакомьтесь с примером в конце, чтобы узнать, как создать расширение или приобрести предложение расширения.

Создайте расширение Kubernetes. Выходные данные включают секреты, которые необходимо защитить. Убедитесь, что эти секреты не включены в систему управления версиями. Кроме того, убедитесь, что секреты отсутствуют в журналах команды или скрипта. Дополнительные сведения см. в статье http://aka.ms/clisecrets.

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]

Примеры

Создание расширения Kubernetes

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

Создание расширения Kubernetes Marketplace

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

Обязательные параметры

--cluster-name -c

Имя кластера Kubernetes.

--cluster-type -t

Укажите кластеры Arc или управляемые кластеры AKS или (модуль) Arc или подготовленныеclusters.

допустимые значения: appliances, connectedClusters, managedClusters, provisionedClusters
--extension-type

Имя типа расширения.

--name -n

Имя экземпляра расширения.

--resource-group -g

Имя группы ресурсов. Вы можете настроить расположение по умолчанию с помощью az configure --defaults group=<name>.

Необязательные параметры

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

Автоматическое обновление дополнительной версии экземпляра расширения.

допустимые значения: false, true
--cluster-resource-provider --cluster-rp

Имя поставщика ресурсов кластера для этого clusterType (требуется для подготовкиclusters).

--config --configuration-settings

Конфигурация Параметры в качестве пары key=value. Повторите параметр для каждого параметра. Не используйте это для секретов, так как это значение возвращается в ответ.

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

Путь к файлу JSON для параметров конфигурации.

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

Защита конфигурации Параметры в виде пары key=value. Повторите параметр для каждого параметра. Только ключ возвращается в ответ, значение не является.

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

Путь к JSON-файлу для параметров, защищенных конфигурацией.

--config-settings
Не рекомендуется

Параметр "--config-settings" устарел и будет удален в будущем выпуске. Вместо этого используйте "--configuration-settings".

Конфигурация Параметры в качестве пары key=value. Повторите параметр для каждого параметра. Не используйте это для секретов, так как это значение возвращается в ответ.

--configuration-protected-settings
Не рекомендуется

Параметр "--configuration-protected-settings" устарел и будет удален в будущем выпуске. Вместо этого используйте "--config-protected-settings".

Защита конфигурации Параметры в виде пары key=value. Повторите параметр для каждого параметра. Только ключ возвращается в ответ, значение не является.

--configuration-protected-settings-file
Не рекомендуется

Параметр "--configuration-protected-settings-file" устарел и будет удален в будущем выпуске. Вместо этого используйте "--config-protected-file".

Путь к JSON-файлу для параметров, защищенных конфигурацией.

--configuration-settings-file
Не рекомендуется

Параметр "-configuration-settings-file" устарел и будет удален в будущем выпуске. Вместо этого используйте "--config-settings-file".

Путь к файлу JSON для параметров конфигурации.

--no-wait

Не ожидать завершения длительной операции.

значение по умолчанию: False
--plan-name

Имя плана ссылается на идентификатор плана расширения, которое берется с портала Marketplace в разделе "Сведения об использовании и поддержка".

--plan-product

Продукт плана ссылается на идентификатор продукта расширения, взятого с портала Marketplace в разделе "Сведения об использовании и поддержка". Примером этого является имя используемого предложения ISV.

--plan-publisher

Издатель плана ссылается на идентификатор издателя расширения, взятого с портала Marketplace в разделе "Сведения об использовании и поддержка".

--release-namespace

Укажите пространство имен для установки выпуска расширения.

--release-train

Укажите обучение выпуска для типа расширения.

--scope

Укажите расширение область.

допустимые значения: cluster, namespace
--target-namespace

Укажите целевое пространство имен для экземпляра расширения. Этот параметр требуется, если для расширения область задано значение "пространство имен".

--version

Укажите версию для экземпляра расширения, если не включена версия --auto-upgrade-minor-version.

Глобальные параметры
--debug

Повышение уровня детализации журнала для включения всех журналов отладки.

--help -h

Отображение этого справочного сообщения и выход.

--only-show-errors

Показывать только ошибки, блокируя предупреждения.

--output -o

Формат вывода.

допустимые значения: json, jsonc, none, table, tsv, yaml, yamlc
значение по умолчанию: json
--query

Строка запроса JMESPath. Дополнительные сведения и примеры см. в разделе http://jmespath.org/.

--subscription

Имя или идентификатор подписки Подписку по умолчанию можно настроить с помощью az account set -s NAME_OR_ID.

--verbose

Повышение уровня детализации журнала. Чтобы включить полные журналы отладки, используйте параметр --debug.

az k8s-extension delete

Удаление расширения Kubernetes.

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

Примеры

Удаление существующего расширения Kubernetes

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

Обязательные параметры

--cluster-name -c

Имя кластера Kubernetes.

--cluster-type -t

Укажите кластеры Arc или управляемые кластеры AKS или (модуль) Arc или подготовленныеclusters.

допустимые значения: appliances, connectedClusters, managedClusters, provisionedClusters
--name -n

Имя экземпляра расширения.

--resource-group -g

Имя группы ресурсов. Вы можете настроить расположение по умолчанию с помощью az configure --defaults group=<name>.

Необязательные параметры

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

Имя поставщика ресурсов кластера для этого clusterType (требуется для подготовкиclusters).

--force

Укажите, следует ли принудительно удалить расширение из кластера.

значение по умолчанию: False
--no-wait

Не ожидать завершения длительной операции.

значение по умолчанию: False
--yes -y

Игнорировать запросы подтверждения.

значение по умолчанию: False
Глобальные параметры
--debug

Повышение уровня детализации журнала для включения всех журналов отладки.

--help -h

Отображение этого справочного сообщения и выход.

--only-show-errors

Показывать только ошибки, блокируя предупреждения.

--output -o

Формат вывода.

допустимые значения: json, jsonc, none, table, tsv, yaml, yamlc
значение по умолчанию: json
--query

Строка запроса JMESPath. Дополнительные сведения и примеры см. в разделе http://jmespath.org/.

--subscription

Имя или идентификатор подписки Подписку по умолчанию можно настроить с помощью az account set -s NAME_OR_ID.

--verbose

Повышение уровня детализации журнала. Чтобы включить полные журналы отладки, используйте параметр --debug.

az k8s-extension list

Перечисление расширений Kubernetes.

Список всех расширений Kubernetes в кластере, включая их свойства. Выходные данные включают секреты, которые необходимо защитить. Убедитесь, что эти секреты не включены в систему управления версиями. Кроме того, убедитесь, что секреты отсутствуют в журналах команды или скрипта. Дополнительные сведения см. в статье http://aka.ms/clisecrets.

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

Примеры

Вывод списка всех расширений Kubernetes в кластере

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

Обязательные параметры

--cluster-name -c

Имя кластера Kubernetes.

--cluster-type -t

Укажите кластеры Arc или управляемые кластеры AKS или (модуль) Arc или подготовленныеclusters.

допустимые значения: appliances, connectedClusters, managedClusters, provisionedClusters
--resource-group -g

Имя группы ресурсов. Вы можете настроить расположение по умолчанию с помощью az configure --defaults group=<name>.

Необязательные параметры

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

Имя поставщика ресурсов кластера для этого clusterType (требуется для подготовкиclusters).

Глобальные параметры
--debug

Повышение уровня детализации журнала для включения всех журналов отладки.

--help -h

Отображение этого справочного сообщения и выход.

--only-show-errors

Показывать только ошибки, блокируя предупреждения.

--output -o

Формат вывода.

допустимые значения: json, jsonc, none, table, tsv, yaml, yamlc
значение по умолчанию: json
--query

Строка запроса JMESPath. Дополнительные сведения и примеры см. в разделе http://jmespath.org/.

--subscription

Имя или идентификатор подписки Подписку по умолчанию можно настроить с помощью az account set -s NAME_OR_ID.

--verbose

Повышение уровня детализации журнала. Чтобы включить полные журналы отладки, используйте параметр --debug.

az k8s-extension show

Показать расширение Kubernetes.

Отображение расширения Kubernetes, включая его свойства. Выходные данные включают секреты, которые необходимо защитить. Убедитесь, что эти секреты не включены в систему управления версиями. Кроме того, убедитесь, что секреты отсутствуют в журналах команды или скрипта. Дополнительные сведения см. в статье http://aka.ms/clisecrets.

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

Примеры

Отображение сведений о расширении Kubernetes

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

Обязательные параметры

--cluster-name -c

Имя кластера Kubernetes.

--cluster-type -t

Укажите кластеры Arc или управляемые кластеры AKS или (модуль) Arc или подготовленныеclusters.

допустимые значения: appliances, connectedClusters, managedClusters, provisionedClusters
--name -n

Имя экземпляра расширения.

--resource-group -g

Имя группы ресурсов. Вы можете настроить расположение по умолчанию с помощью az configure --defaults group=<name>.

Необязательные параметры

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

Имя поставщика ресурсов кластера для этого clusterType (требуется для подготовкиclusters).

Глобальные параметры
--debug

Повышение уровня детализации журнала для включения всех журналов отладки.

--help -h

Отображение этого справочного сообщения и выход.

--only-show-errors

Показывать только ошибки, блокируя предупреждения.

--output -o

Формат вывода.

допустимые значения: json, jsonc, none, table, tsv, yaml, yamlc
значение по умолчанию: json
--query

Строка запроса JMESPath. Дополнительные сведения и примеры см. в разделе http://jmespath.org/.

--subscription

Имя или идентификатор подписки Подписку по умолчанию можно настроить с помощью az account set -s NAME_OR_ID.

--verbose

Повышение уровня детализации журнала. Чтобы включить полные журналы отладки, используйте параметр --debug.

az k8s-extension update

Обновите изменяемые свойства расширения Kubernetes.

Сведения об обновлении Config Параметры и ConfigProtected Параметры см. в документации службы расширений кластера, чтобы проверка обновление этих свойств поддерживается перед обновлением этих свойств. Выходные данные включают секреты, которые необходимо защитить. Убедитесь, что эти секреты не включены в систему управления версиями. Кроме того, убедитесь, что секреты отсутствуют в журналах команды или скрипта. Дополнительные сведения см. в статье http://aka.ms/clisecrets.

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]

Примеры

Обновление расширения Kubernetes

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

Обязательные параметры

--cluster-name -c

Имя кластера Kubernetes.

--cluster-type -t

Укажите кластеры Arc или управляемые кластеры AKS или (модуль) Arc или подготовленныеclusters.

допустимые значения: appliances, connectedClusters, managedClusters, provisionedClusters
--name -n

Имя экземпляра расширения.

--resource-group -g

Имя группы ресурсов. Вы можете настроить расположение по умолчанию с помощью az configure --defaults group=<name>.

Необязательные параметры

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

Автоматическое обновление дополнительной версии экземпляра расширения.

допустимые значения: false, true
--cluster-resource-provider --cluster-rp

Имя поставщика ресурсов кластера для этого clusterType (требуется для подготовкиclusters).

--config --configuration-settings

Конфигурация Параметры в качестве пары key=value. Повторите параметр для каждого параметра. Не используйте это для секретов, так как это значение возвращается в ответ.

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

Путь к файлу JSON для параметров конфигурации.

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

Защита конфигурации Параметры в виде пары key=value. Повторите параметр для каждого параметра. Только ключ возвращается в ответ, значение не является.

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

Путь к JSON-файлу для параметров, защищенных конфигурацией.

--config-settings
Не рекомендуется

Параметр "--config-settings" устарел и будет удален в будущем выпуске. Вместо этого используйте "--configuration-settings".

Конфигурация Параметры в качестве пары key=value. Повторите параметр для каждого параметра. Не используйте это для секретов, так как это значение возвращается в ответ.

--configuration-protected-settings
Не рекомендуется

Параметр "--configuration-protected-settings" устарел и будет удален в будущем выпуске. Вместо этого используйте "--config-protected-settings".

Защита конфигурации Параметры в виде пары key=value. Повторите параметр для каждого параметра. Только ключ возвращается в ответ, значение не является.

--configuration-protected-settings-file
Не рекомендуется

Параметр "--configuration-protected-settings-file" устарел и будет удален в будущем выпуске. Вместо этого используйте "--config-protected-file".

Путь к JSON-файлу для параметров, защищенных конфигурацией.

--configuration-settings-file
Не рекомендуется

Параметр "-configuration-settings-file" устарел и будет удален в будущем выпуске. Вместо этого используйте "--config-settings-file".

Путь к файлу JSON для параметров конфигурации.

--no-wait

Не ожидать завершения длительной операции.

значение по умолчанию: False
--release-train

Укажите обучение выпуска для типа расширения.

--version

Укажите версию для экземпляра расширения, если не включена версия --auto-upgrade-minor-version.

--yes -y

Игнорировать запросы подтверждения.

значение по умолчанию: False
Глобальные параметры
--debug

Повышение уровня детализации журнала для включения всех журналов отладки.

--help -h

Отображение этого справочного сообщения и выход.

--only-show-errors

Показывать только ошибки, блокируя предупреждения.

--output -o

Формат вывода.

допустимые значения: json, jsonc, none, table, tsv, yaml, yamlc
значение по умолчанию: json
--query

Строка запроса JMESPath. Дополнительные сведения и примеры см. в разделе http://jmespath.org/.

--subscription

Имя или идентификатор подписки Подписку по умолчанию можно настроить с помощью az account set -s NAME_OR_ID.

--verbose

Повышение уровня детализации журнала. Чтобы включить полные журналы отладки, используйте параметр --debug.