community.kubevirt.kubevirt_cdi_upload – Загрузка локальных образов ВМ в прокси-сервер CDI Upload.

Примечание

Этот плагин входит в коллекцию community.kubevirt (версия 1.0.0).

Для его установки используйте: ansible-galaxy collection install community.kubevirt.

Для использования в книге задач укажите: community.kubevirt.kubevirt_cdi_upload.

Обзор
Требования
Параметры
Примечания
Примеры

Обзор

Используйте Openshift Python SDK для создания объектов UploadTokenRequest.
Передавайте содержимое локальных файлов на прокси-сервер CDI Upload.

Требования

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

python >= 2.7
openshift >= 0.8.2
requests >= 2.0.0

Параметры

Параметр	Варианты/Значения по умолчанию	Комментарии
api_key строка		Токен, используемый для аутентификации с API. Также можно указать через переменную окружения K8S_AUTH_API_KEY.
ca_cert путь		Путь к сертификату CA, используемому для аутентификации с API. Для предотвращения ошибок проверки сертификатов необходимо предоставить полную цепочку сертификатов. Также можно указать через переменную окружения K8S_AUTH_SSL_CA_CERT. псевдонимы: ssl_ca_cert
client_cert путь		Путь к сертификату, используемому для аутентификации с API. Также можно указать через переменную окружения K8S_AUTH_CERT_FILE. псевдонимы: cert_file
client_key путь		Путь к файлу ключа, используемому для аутентификации с API. Также можно указать через переменную окружения K8S_AUTH_KEY_FILE. псевдонимы: key_file
context строка		Имя контекста, найденного в файле конфигурации. Также можно указать через переменную окружения K8S_AUTH_CONTEXT.
host строка		Укажите URL для доступа к API. Также можно указать через переменную окружения K8S_AUTH_HOST.
kubeconfig путь		Путь к существующему файлу конфигурации Kubernetes. Если не указан и не заданы другие параметры подключения, клиент openshift попытается загрузить файл конфигурации по умолчанию из ~/.kube/config.json. Также можно указать через переменную окружения K8S_AUTH_KUBECONFIG.
merge_type список / элементы=строка	Варианты: json merge strategic-merge	Указывает, нужно ли переопределить стандартный способ слияния патчей на определённый тип. По умолчанию обычно используется стратегическое слияние.
password строка		Введите пароль для аутентификации с API. Также можно указать через переменную окружения K8S_AUTH_PASSWORD. Обратите внимание на описание параметра `username`, для понимания когда необходимо использовать этот параметр.
path строка		Путь к локальному файлу образа для передачи.
persist_config булево	Варианты: no yes	Сохранять ли токен обновления конфигурации kube. Также можно указать через переменную окружения K8S_AUTH_PERSIST_CONFIG. Когда контекст k8s использует учетные данные пользователя с токенами обновления (например, oidc или gke/gcloud auth), токен обновляется библиотекой python клиента k8s, но по умолчанию не сохраняется. Таким образом, старый токен обновления может истечь, и следующая аутентификация может не удаться. Установка этого флага в значение true сообщит клиенту python k8s о сохранении нового токена обновления в файл конфигурации kube. Значение по умолчанию - false. Обратите внимание, что текущая версия библиотеки python клиента k8s еще не поддерживает установку этого флага в значение True. Исправление для этой библиотеки python k8s находится здесь: https://github.com/kubernetes-client/python-base/pull/169
proxy строка		URL HTTP-прокси, который необходимо использовать для подключения. Также можно указать через переменную окружения K8S_AUTH_PROXY. Обратите внимание, что этот модуль не использует типичные настройки прокси из среды (например, HTTP_PROXY).
pvc_name строка / обязательно		Используется для указания имени целевого PersistentVolumeClaim.
pvc_namespace строка / обязательно		Используется для указания пространства имён целевого PersistentVolumeClaim.
upload_host строка		URL, содержащий хост и порт, на котором доступен прокси-сервер CDI Upload. Дополнительная информация: https://github.com/kubevirt/containerized-data-importer/blob/master/doc/upload.md#expose-cdi-uploadproxy-service
upload_host_validate_certs булево	Варианты: no yes ←	Проверять ли SSL-сертификаты прокси-сервера CDI Upload на соответствие хранилищу доверенных сертификатов системы. псевдонимы: upload_host_verify_ssl
username строка		Введите имя пользователя для аутентификации с API. Также можно указать через переменную окружения K8S_AUTH_USERNAME. Обратите внимание, что это работает только с кластерами, настроенными на использование HTTP Basic Auth. Если ваш кластер имеет другой тип аутентификации (например, OAuth2 в OpenShift), этот параметр не будет работать должным образом, и вам следует рассмотреть модуль `k8s_auth`, так как он может выполнять необходимые действия.
validate_certs булево	Варианты: no yes	Проверять ли SSL-сертификаты сервера API. Также можно указать через переменную окружения K8S_AUTH_VERIFY_SSL. псевдонимы: verify_ssl

Примечания

Примечание

Клиент Openshift Python оборачивает клиент K8s Python, предоставляя полный доступ ко всем API и моделям, доступным на обеих платформах. Подробную информацию о версиях API и дополнительную информацию см. на странице https://github.com/openshift/openshift-restclient-python
Чтобы избежать ошибок проверки SSL-сертификатов, когда validate_certs имеет значение True, необходимо предоставить полную цепочку сертификатов сервера API с помощью ca_cert или в файле kubeconfig.

Примеры

- name: Upload local image to pvc-vm1
  community.kubevirt.kubevirt_cdi_upload:
    pvc_namespace: default
    pvc_name: pvc-vm1
    upload_host: https://localhost:8443
    upload_host_validate_certs: false
    path: /tmp/cirros-0.4.0-x86_64-disk.img

Авторы

Команда KubeVirt (@kubevirt)

© 2012–2018 Michael DeHaan
© 2018–2019 Red Hat, Inc.
Licensed under the GNU General Public License version 3.
https://docs.ansible.com/ansible/2.10/collections/community/kubevirt/kubevirt_cdi_upload_module.html