Spec-Zone.ru › Ansible

Модуль kubevirt.core.kubevirt_vmi_info — описание VirtualMachineInstances KubeVirt

Примечание

Этот модуль входит в коллекцию kubevirt.core (версия 2.2.4).

Возможно, эта коллекция уже установлена, если вы используете пакет ansible. Она не входит в состав ansible-core. Чтобы проверить, установлена ли она, выполните ansible-galaxy collection list.

Для установки используйте: ansible-galaxy collection install kubevirt.core. Для работы с этим модулем требуются дополнительные компоненты; подробности см. в разделе Требования.

Чтобы использовать модуль в сценарии, укажите: kubevirt.core.kubevirt_vmi_info.

  • Краткое описание
  • Требования
  • Параметры
  • Примечания
  • Примеры
  • Возвращаемые значения

Краткое описание

  • Использует клиент Kubernetes для Python для выполнения операций чтения с объектами KubeVirt VirtualMachineInstances.
  • Параметры поиска VirtualMachineInstances передаются в качестве аргументов модуля.
  • Поддерживает аутентификацию с помощью файла конфигурации, сертификатов, пароля или токена.
  • Поддерживает режим проверки.

Требования

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

  • python >= 3.9
  • kubernetes >= 28.1.0
  • PyYAML >= 3.11

Параметры

Параметр

Комментарии

api_key

string

Токен для аутентификации в API.

Также можно указать с помощью переменной среды K8S_AUTH_API_KEY.

api_version

string

Используйте этот параметр, чтобы задать версию API KubeVirt.

По умолчанию: "kubevirt.io/v1"

ca_cert

псевдонимы: ssl_ca_cert

path

Путь к сертификату CA, используемому для аутентификации в API. Во избежание ошибок проверки сертификата необходимо предоставить полную цепочку сертификатов.

Также можно указать с помощью переменной среды K8S_AUTH_SSL_CA_CERT.

client_cert

псевдонимы: cert_file

path

Путь к сертификату, используемому для аутентификации в API.

Также можно указать с помощью переменной среды K8S_AUTH_CERT_FILE.

client_key

псевдонимы: key_file

path

Путь к файлу ключа, используемому для аутентификации в API.

Также можно указать с помощью переменной среды K8S_AUTH_KEY_FILE.

context

string

Имя контекста из файла конфигурации.

Также можно указать с помощью переменной среды K8S_AUTH_CONTEXT.

field_selectors

list / элементы=string

Список селекторов полей для фильтрации результатов.

По умолчанию: []

hidden_fields

list / элементы=string

добавлен в kubevirt.core 2.2.0

Скрывает в результатах поля, соответствующие этому параметру.

Например, это могут быть hidden_fields=[metadata.managedFields] или hidden_fields=[metadata.annotations[kubemacpool.io/transaction-timestamp]].

По умолчанию: ["metadata.annotations[kubemacpool.io/transaction-timestamp]", "metadata.managedFields"]

host

string

Укажите URL для доступа к API.

Также можно указать с помощью переменной среды K8S_AUTH_HOST.

impersonate_groups

list / элементы=string

Группа или группы, от имени которых выполняется операция.

Также можно указать с помощью переменной среды K8S_AUTH_IMPERSONATE_GROUPS, например Group1,Group2.

impersonate_user

string

Имя пользователя, от имени которого выполняется операция.

Также можно указать с помощью переменной среды K8S_AUTH_IMPERSONATE_USER.

kubeconfig

any

Путь к существующему файлу конфигурации Kubernetes. Если путь не указан и не заданы другие параметры подключения, клиент Kubernetes попытается загрузить файл конфигурации по умолчанию из ~/.kube/config.

Также можно указать с помощью переменной среды K8S_AUTH_KUBECONFIG.

Можно указать несколько файлов конфигурации Kubernetes, используя в качестве разделителя ; в Windows или : на других платформах.

Конфигурацию Kubernetes можно передать в виде словаря. Для этой возможности требуется версия клиента Kubernetes для Python не ниже 17.17.0.

label_selectors

list / элементы=string

Список селекторов меток для фильтрации результатов.

По умолчанию: []

name

string

Укажите имя объекта VirtualMachineInstance.

namespace

string

Укажите пространство имён объекта VirtualMachineInstances.

no_proxy

string

Список узлов, доменов, IP-адресов и сетей в формате CIDR, разделённых запятыми, для которых не следует использовать прокси.

Также можно указать с помощью переменной среды K8S_AUTH_NO_PROXY.

Обратите внимание: модуль не использует типичные настройки прокси из среды (например, NO_PROXY).

Для этой возможности требуется kubernetes>=19.15.0. Если версия библиотеки kubernetes ниже 19.15.0, возникает ошибка, даже если значение no_proxy задано правильно.

Пример значения: localhost,.local,.example.com,127.0.0.1,127.0.0.0/8,10.0.0.0/8,172.16.0.0/12,192.168.0.0/16.

password

string

Укажите пароль для аутентификации в API.

Также можно указать с помощью переменной среды K8S_AUTH_PASSWORD.

О том, когда применим этот параметр, см. описание параметра username.

persist_config

boolean

Определяет, нужно ли сохранять токены обновления конфигурации kube.

Также можно указать с помощью переменной среды K8S_AUTH_PERSIST_CONFIG.

Если в контексте k8s используются учётные данные пользователя с токенами обновления (например, oidc или аутентификация gke/gcloud), библиотека клиента k8s для Python обновляет токен, но по умолчанию не сохраняет его. Поэтому срок действия старого токена обновления может истечь, и следующая аутентификация завершится ошибкой. Если установить этот параметр в true, клиент k8s для Python сохранит новый токен обновления в файл конфигурации kube.

По умолчанию отключено.

Варианты:

  • false
  • true

proxy

string

URL HTTP-прокси для подключения.

Также можно указать с помощью переменной среды K8S_AUTH_PROXY.

Обратите внимание: модуль не использует типичные настройки прокси из среды (например, HTTP_PROXY).

proxy_headers

dictionary

Заголовок для HTTP-прокси.

Документация доступна по адресу https://urllib3.readthedocs.io/en/latest/reference/urllib3.util.html?highlight=proxy_headers#urllib3.util.make_headers.

basic_auth

string

Имя пользователя и пароль, разделённые двоеточием, для заголовка базовой аутентификации.

Также можно указать с помощью переменной среды K8S_AUTH_PROXY_HEADERS_BASIC_AUTH.

proxy_basic_auth

string

Имя пользователя и пароль, разделённые двоеточием, для заголовка базовой аутентификации прокси.

Также можно указать с помощью переменной среды K8S_AUTH_PROXY_HEADERS_PROXY_BASIC_AUTH.

user_agent

string

Строка, задающая user-agent, например foo/1.0.

Также можно указать с помощью переменной среды K8S_AUTH_PROXY_HEADERS_USER_AGENT.

username

string

Укажите имя пользователя для аутентификации в API.

Также можно указать с помощью переменной среды K8S_AUTH_USERNAME.

validate_certs

псевдонимы: verify_ssl

boolean

Определяет, нужно ли проверять SSL-сертификаты API-сервера.

Также можно указать с помощью переменной среды K8S_AUTH_VERIFY_SSL.

Варианты:

  • false
  • true

wait

boolean

Определяет, нужно ли ждать, пока VirtualMachineInstance перейдёт в состояние готовности.

По умолчанию модуль ждёт, пока VirtualMachineInstance будет запущен и готов к работе.

Варианты:

  • false
  • true

wait_sleep

integer

Количество секунд ожидания между проверками.

Игнорируется, если параметр wait не задан.

По умолчанию: 5

wait_timeout

integer

Время ожидания в секундах, пока ресурс перейдёт в состояние готовности.

Игнорируется, если параметр wait не задан.

По умолчанию: 120

Примечания

Примечание

  • Во избежание ошибок проверки SSL-сертификата при validate_certs=yes необходимо предоставить полную цепочку сертификатов API-сервера через ca_cert или в файле kubeconfig.

Примеры

- name: Get an existing VirtualMachineInstance
  kubevirt.core.kubevirt_vmi_info:
    name: testvmi
    namespace: default
  register: default_testvmi

- name: Get a list of all VirtualMachinesInstances
  kubevirt.core.kubevirt_vmi_info:
    namespace: default
  register: vmi_list

- name: Get a list of all VirtualMachineInstances from any namespace
  kubevirt.core.kubevirt_vmi_info:
  register: vmi_list

- name: Search for all VirtualMachineInstances labelled app=test
  kubevirt.core.kubevirt_vmi_info:
    label_selectors:
      - app=test

- name: Wait until the VirtualMachineInstace is ready
  kubevirt.core.kubevirt_vm_info:
    name: testvm
    namespace: default
    wait: true

Возвращаемые значения

Общие возвращаемые значения описаны здесь; ниже перечислены поля, уникальные для этого модуля:

Ключ

Описание

api_found

boolean

Указывает, удалось ли сопоставить заданные api_version и VirtualMachineInstance Kind с существующим API в целевом кластере.

Возвращается: всегда

resources

complex

Существующие объекты VirtualMachineInstances.

Возвращается: при успешном выполнении

api_version

string

Версионированная схема этого представления объекта.

Возвращается: при успешном выполнении

kind

string

Представляет тип ресурса REST, соответствующий этому объекту.

Возвращается: при успешном выполнении

metadata

dictionary

Стандартные метаданные объекта. Включают имя, пространство имён, аннотации, метки и т. д.

Возвращается: при успешном выполнении

spec

dictionary

Атрибуты объекта VirtualMachineInstance. Могут различаться в зависимости от api_version.

Возвращается: при успешном выполнении

status

dictionary

Сведения о текущем состоянии объекта VirtualMachineInstance.

Возвращается: при успешном выполнении

Авторы

  • Проект KubeVirt.io

Ссылки на коллекцию

  • Отслеживание проблем
  • Главная страница
  • Репозиторий (исходный код)
  • Сообщить о проблеме
  • Связь

© 2012–2018 Michael DeHaan
© 2018–2025 Red Hat, Inc.
Licensed under the GNU General Public License version 3.
https://docs.ansible.com/projects/ansible/latest/collections/kubevirt/core/kubevirt_vmi_info_module.html

Spec-Zone.ru

Настройки Оффлайн Что нового Помощь О нас
Spec-Zone .ru
спецификации, руководства, описания, API