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

az aks extension

Note

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

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

Команды

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

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

 Extension GA
az aks extension delete

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

 Extension GA
az aks extension list

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

 Extension GA
az aks extension show

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

 Extension GA
az aks extension type

Управление типами расширений в службе Azure Kubernetes.

 Extension GA
az aks extension type list

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

 Extension GA
az aks extension type show

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

 Extension GA
az aks extension type version

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

 Extension GA
az aks extension type version list

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

 Extension GA
az aks extension type version show

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

 Extension GA
az aks extension update

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

 Extension GA

az aks extension create

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

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

az aks extension create --cluster-name
                        --extension-type
                        --name
                        --resource-group
                        [--config --configuration-settings]
                        [--config-file --config-settings-file]
                        [--config-protected --config-protected-settings]
                        [--config-protected-file --config-protected-settings-file]
                        [--no-wait]
                        [--release-namespace]
                        [--scope {cluster, namespace}]
                        [--target-namespace]

Примеры

Установка расширения кластера в кластере AKS с необходимыми параметрами

az aks extension create --resource-group my-resource-group --cluster-name mycluster --name myextension --extension-type microsoft.flux

Установка расширения кластера с необязательными параметрами конфигурации параметров

az aks extension create --resource-group abc --cluster-name test --name flux --extension-type microsoft.flux --config useKubeletIdentity=true

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

--cluster-name -c

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

--extension-type -t

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

--name -n

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

--resource-group -g

Имя группы ресурсов.

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

Следующие параметры являются необязательными, но в зависимости от контекста один или несколько могут потребоваться для успешного выполнения команды.

--config --configuration-settings

Параметры конфигурации в качестве пары key=value.

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

Свойство Значение
Группа параметров: Configuration Arguments
--config-file --config-settings-file

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

Путь к файлу JSON для параметров конфигурации. Если значение по умолчанию не указано, значение по умолчанию — None.

Свойство Значение
Группа параметров: Configuration Arguments
--config-protected --config-protected-settings

Защищенные параметры конфигурации в качестве пары key=value.

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

Свойство Значение
Группа параметров: Configuration Arguments
--config-protected-file --config-protected-settings-file

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

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

Свойство Значение
Группа параметров: Configuration Arguments
--no-wait

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

Свойство Значение
Default value: False
--release-namespace

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

--scope

Укажите область типа расширения, которая принимает пространство имен или кластер в качестве области.

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

Свойство Значение
Допустимые значения: cluster, namespace
--target-namespace

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

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

Увеличьте детализацию ведения журнала, чтобы отобразить все журналы отладки.

Свойство Значение
Default value: False
--help -h

Показать это сообщение справки и выйти.

--only-show-errors

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

Свойство Значение
Default value: False
--output -o

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

Свойство Значение
Default value: json
Допустимые значения: json, jsonc, none, table, tsv, yaml, yamlc
--query

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

--subscription

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

--verbose

Увеличьте уровень детализации ведения журнала. Используйте --debug для полных журналов отладки.

Свойство Значение
Default value: False

az aks extension delete

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

az aks extension delete --cluster-name
                        --name
                        --resource-group
                        [--force]
                        [--no-wait]
                        [--yes]

Примеры

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

az aks extension delete --resource-group resource-group --cluster-name cluster --name ext

Удаление существующего расширения кластера в кластере AKS с дополнительными параметрами

az aks extension delete --resource-group resource-group --cluster-name cluster --name ext --yes --force

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

--cluster-name -c

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

--name -n

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

--resource-group -g

Имя группы ресурсов.

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

Следующие параметры являются необязательными, но в зависимости от контекста один или несколько могут потребоваться для успешного выполнения команды.

--force

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

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

Свойство Значение
Default value: False
--no-wait

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

Свойство Значение
Default value: False
--yes -y

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

Игнорирует запрос подтверждения. Если значение не указано, значение по умолчанию равно false.

Свойство Значение
Default value: False
Глобальные параметры
--debug

Увеличьте детализацию ведения журнала, чтобы отобразить все журналы отладки.

Свойство Значение
Default value: False
--help -h

Показать это сообщение справки и выйти.

--only-show-errors

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

Свойство Значение
Default value: False
--output -o

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

Свойство Значение
Default value: json
Допустимые значения: json, jsonc, none, table, tsv, yaml, yamlc
--query

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

--subscription

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

--verbose

Увеличьте уровень детализации ведения журнала. Используйте --debug для полных журналов отладки.

Свойство Значение
Default value: False

az aks extension list

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

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

az aks extension list --cluster-name
                      --resource-group

Примеры

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

az aks extension list --resource-group <group> --cluster-name <name>

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

--cluster-name -c

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

--resource-group -g

Имя группы ресурсов.

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

Увеличьте детализацию ведения журнала, чтобы отобразить все журналы отладки.

Свойство Значение
Default value: False
--help -h

Показать это сообщение справки и выйти.

--only-show-errors

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

Свойство Значение
Default value: False
--output -o

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

Свойство Значение
Default value: json
Допустимые значения: json, jsonc, none, table, tsv, yaml, yamlc
--query

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

--subscription

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

--verbose

Увеличьте уровень детализации ведения журнала. Используйте --debug для полных журналов отладки.

Свойство Значение
Default value: False

az aks extension show

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

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

az aks extension show --cluster-name
                      --name
                      --resource-group

Примеры

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

az aks extension show --resource-group my-resource-group --cluster-name mycluster --name myextension

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

--cluster-name -c

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

--name -n

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

--resource-group -g

Имя группы ресурсов.

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

Увеличьте детализацию ведения журнала, чтобы отобразить все журналы отладки.

Свойство Значение
Default value: False
--help -h

Показать это сообщение справки и выйти.

--only-show-errors

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

Свойство Значение
Default value: False
--output -o

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

Свойство Значение
Default value: json
Допустимые значения: json, jsonc, none, table, tsv, yaml, yamlc
--query

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

--subscription

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

--verbose

Увеличьте уровень детализации ведения журнала. Используйте --debug для полных журналов отладки.

Свойство Значение
Default value: False

az aks extension update

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

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

az aks extension update --cluster-name
                        --name
                        --resource-group
                        [--config --configuration-settings]
                        [--config-file --config-settings-file]
                        [--config-protected --config-protected-settings]
                        [--config-protected-file --config-protected-settings-file]
                        [--no-wait]
                        [--yes]

Примеры

Обновление расширения кластера в кластере AKS

az aks extension update --resource-group my-resource-group --cluster-name mycluster --name myextension

Обновление расширения кластера в кластере AKS с дополнительными параметрами

az aks extension update --resource-group my-resource-group --cluster-name mycluster --name myextension --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

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

--name -n

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

--resource-group -g

Имя группы ресурсов.

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

Следующие параметры являются необязательными, но в зависимости от контекста один или несколько могут потребоваться для успешного выполнения команды.

--config --configuration-settings

Параметры конфигурации в качестве пары key=value.

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

Свойство Значение
Группа параметров: Configuration Arguments
--config-file --config-settings-file

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

Путь к файлу JSON для параметров конфигурации. Если значение по умолчанию не указано, значение по умолчанию — None.

Свойство Значение
Группа параметров: Configuration Arguments
--config-protected --config-protected-settings

Защищенные параметры конфигурации в качестве пары key=value.

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

Свойство Значение
Группа параметров: Configuration Arguments
--config-protected-file --config-protected-settings-file

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

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

Свойство Значение
Группа параметров: Configuration Arguments
--no-wait

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

Свойство Значение
Default value: False
--yes -y

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

Игнорирует запрос подтверждения. Если значение не указано, значение по умолчанию равно false.

Свойство Значение
Default value: False
Глобальные параметры
--debug

Увеличьте детализацию ведения журнала, чтобы отобразить все журналы отладки.

Свойство Значение
Default value: False
--help -h

Показать это сообщение справки и выйти.

--only-show-errors

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

Свойство Значение
Default value: False
--output -o

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

Свойство Значение
Default value: json
Допустимые значения: json, jsonc, none, table, tsv, yaml, yamlc
--query

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

--subscription

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

--verbose

Увеличьте уровень детализации ведения журнала. Используйте --debug для полных журналов отладки.

Свойство Значение
Default value: False