junos_package – Установка пакетов на удалённые устройства, работающие под управлением Junos
Новая версия с 2.1.
Описание
- Этот модуль позволяет устанавливать новые и обновленные пакеты на удалённые устройства, работающие под управлением Junos. Модуль сравнит указанный пакет с установленным на удалённом устройстве и установит указанную версию, если они не совпадают.
Требования
Ниже перечислены требования, необходимые на хосте, на котором выполняется этот модуль.
- junos-eznc
- ncclient (>=v0.5.2)
Параметры
| Параметр | Варианты/Значения по умолчанию | Комментарии | |
|---|---|---|---|
| force логический |
| Аргумент force указывает модулю пропустить проверку версии пакета и установить пакет, идентифицированный в src, на удалённом устройстве. | |
| force_host логический добавлен в 2.8 |
| Аргумент force_host управляет способом добавления программного пакета или сборки на удалённом хосте JUNOS и применим к устройствам JUNOS QFX5100. Если значение установлено в True, будут проигнорированы любые предупреждения при добавлении пакета программного обеспечения или сборки на хост. | |
| issu логический добавлен в 2.8 |
| Аргумент issu — логический флаг. При установке в True, активируется функция унифицированного обновления программного обеспечения в режиме работы (ISSU), позволяющая обновлять между двумя разными выпусками Junos OS без прерывания контрольной плоскости и с минимальным прерыванием трафика. | |
| no_copy логический |
| Аргумент no_copy отвечает за указание удалённому устройству источника установки пакета. При включении пакет передается на удалённое устройство перед установкой. | |
| provider словарь | Устарело Начиная с Ansible 2.5, рекомендуется использовать connection: network_cli или connection: netconf. Для получения дополнительной информации, пожалуйста, обратитесь к руководству по параметрам платформы Junos OS Junos OS Platform Options guide. Объект словаря, содержащий данные соединения. | ||
| host строка / обязательно | Указывает имя хоста DNS или адрес для подключения к удалённому устройству по указанному транспорту. Значение host используется в качестве адреса назначения для транспорта. | ||
| password строка | Указывает пароль для аутентификации подключения к удалённому устройству. Это значение используется для аутентификации сеанса SSH. Если значение не указано в задаче, будет использовано значение переменной среды ANSIBLE_NET_PASSWORD. | ||
| port целое число | По умолчанию: 22 | Указывает порт для подключения к удалённому устройству. Значение порта по умолчанию — известный SSH порт 22 (для transport=cli) или порт 830 (для transport=netconf) устройства. | |
| ssh_keyfile путь | Указывает SSH-ключ для аутентификации подключения к удалённому устройству. Это значение — путь к ключу, используемому для аутентификации сеанса SSH. Если значение не указано в задаче, будет использовано значение переменной среды ANSIBLE_NET_SSH_KEYFILE. | ||
| timeout целое число | По умолчанию: 10 | Указывает таймаут в секундах для связи с сетевым устройством при подключении или отправке команд. Если таймаут истечёт до завершения операции, модуль вернет ошибку. | |
| username строка | Указывает имя пользователя для аутентификации подключения к удалённому устройству. Это значение используется для аутентификации сеанса SSH. Если значение не указано в задаче, будет использовано значение переменной среды ANSIBLE_NET_USERNAME. | ||
| reboot логический |
| Для того, чтобы пакет вступил в силу, нужно перезагрузить удалённое устройство. При включении этого аргумента модуль перезагрузит устройство после установки обновленного пакета. Если отключено или удалённый пакет не требует изменения, устройство не будет перезапущено. | |
| src - / обязательно | Аргумент src указывает путь к исходному пакету, который будет установлен на удалённом устройстве в случае несовпадения версий. Аргумент src может быть локальным путем или полным путем к файлу пакета для установки. псевдонимы: package | ||
| validate логический добавлен в 2.5 |
| Аргумент validate отвечает за указание удалённому устройству пропустить проверку совместимости текущей конфигурации устройства с устанавливаемым пакетом. При установке в ложь, проверка не выполняется. | |
| version - | Аргумент version может использоваться для явного указания версии пакета, который должен быть установлен на удалённом устройстве. Если аргумент version не указан, версия извлекается из имени файла src. | ||
Примечания
Примечание
- Для этого модуля требуется, чтобы служба netconf была включена на управляемом удалённом устройстве.
- Проверено на vSRX JUNOS версии 15.1X49-D15.4, vqfx-10000 JUNOS версии 15.1X53-D60.4.
- Работает только с
localподключениями. - Дополнительную информацию о использовании CLI и netconf см. в руководстве Junos OS Platform Options guide
- Для получения дополнительной информации об использовании Ansible для управления сетевыми устройствами, см. Руководство по сетям Ansible
- Дополнительную информацию об использовании Ansible для управления устройствами Juniper, см. https://www.ansible.com/ansible-juniper.
Примеры
# the required set of connection arguments have been purposely left off
# the examples for brevity
- name: install local package on remote device
junos_package:
src: junos-vsrx-12.1X46-D10.2-domestic.tgz
- name: install local package on remote device without rebooting
junos_package:
src: junos-vsrx-12.1X46-D10.2-domestic.tgz
reboot: no
Статус
- Гарантия обратной совместимости этого модуля не предоставляется. [превью]
- Этот модуль поддерживается командой Ansible Network. [сетевой]
Поддержка Red Hat
Дополнительная информация о поддержке этого модуля Red Hat доступна в этой статье базы знаний Red Hat.
Авторы
- Пётр Спрыгада (@privateip)
Подсказка
Если вы заметили какие-либо проблемы в этой документации, вы можете отредактировать этот документ, чтобы улучшить его.
© 2012–2018 Michael DeHaan
© 2018–2019 Red Hat, Inc.
Licensed under the GNU General Public License version 3.
https://docs.ansible.com/ansible/2.8/modules/junos_package_module.html
