junos_package - Установка пакетов на удалённые устройства, работающие под управлением Junos
Новая версия с 2.1.
Обзор
- Этот модуль может устанавливать новые и обновлённые пакеты на удалённые устройства, работающие под управлением Junos. Модуль сравнит указанный пакет с тем, который установлен на удалённом устройстве, и установит указанную версию в случае несовпадения.
Требования
Ниже перечислены требования, которые должны быть выполнены на хосте, на котором выполняется этот модуль.
- junos-eznc
- ncclient (>=v0.5.2)
Параметры
| Параметр | Варианты/Значения по умолчанию | Комментарии | |
|---|---|---|---|
| force обязательно |
no | Аргумент force инструктирует модуль пропустить проверку версии пакета и установить пакет, указанный в src, на удалённое устройство. | |
| no_copy |
no | Аргумент no_copy отвечает за указание удалённому устройству, откуда устанавливать пакет. При включении пакет передаётся на удалённое устройство перед установкой. | |
| provider | Значение по умолчанию: None | Устарело Начиная с Ansible 2.5, рекомендуется использовать connection: network_cli или connection: netconf. Дополнительную информацию можно найти в руководстве Junos OS Platform Options. Объект словаря, содержащий сведения о подключении. | |
| username | Настраивает имя пользователя для аутентификации подключения к удалённому устройству. Это значение используется для аутентификации сеанса SSH. Если значение не указано в задаче, используется значение переменной среды ANSIBLE_NET_USERNAME. | ||
| host обязательно | Указывает имя хоста DNS или адрес для подключения к удалённому устройству по указанному транспорту. Значение хоста используется в качестве целевого адреса для транспорта. | ||
| ssh_keyfile | Указывает SSH-ключ для аутентификации подключения к удалённому устройству. Это значение — путь к ключу, используемому для аутентификации сеанса SSH. Если значение не указано в задаче, используется значение переменной среды ANSIBLE_NET_SSH_KEYFILE. | ||
| timeout | Значение по умолчанию: 10 | Указывает время ожидания в секундах для связи с сетевым устройством при подключении или отправке команд. Если время ожидания истекает до завершения операции, модуль выдаст ошибку. | |
| password | Значение по умолчанию: None | Указывает пароль для аутентификации подключения к удалённому устройству. Это значение используется для аутентификации сеанса SSH. Если значение не указано в задаче, используется значение переменной среды ANSIBLE_NET_PASSWORD. | |
| port | Значение по умолчанию: 22 | Указывает порт для подключения к удалённому устройству. Значение порта по умолчанию — 22 (стандартный SSH-порт для transport=cli) или 830 (для устройств transport=netconf). | |
| reboot обязательно |
yes | Для того, чтобы пакет вступил в силу, удалённое устройство необходимо перезапустить. При включении этого аргумента модуль перезапустит устройство после установки обновлённого пакета. Если параметр отключён или удалённый пакет не требует изменения, устройство не будет перезапущено. | |
| src обязательно | Значение по умолчанию: None | Аргумент src указывает путь к исходному пакету, который должен быть установлен на удалённое устройство в случае несовпадения версий. Аргумент src может быть либо локальным путем, либо полным путем к файлу пакета для установки. псевдонимы: package | |
| validate (добавлен в 2.5) |
yes | Аргумент validate отвечает за указание удалённому устройству пропустить проверку совместимости текущей конфигурации устройства с устанавливаемым пакетом. При установке в значение false проверка не выполняется. | |
| version | Значение по умолчанию: None | Аргумент version можно использовать для явного указания версии пакета, который должен быть установлен на удалённом устройстве. Если аргумент version не указан, версия извлекается из имени файла src. | |
Примечания
Примечание
- Для работы этого модуля на управляемом удалённом устройстве должна быть включена сетевая служба netconf.
- Проверено на vSRX JUNOS версии 15.1X49-D15.4, vqfx-10000 JUNOS версии 15.1X53-D60.4.
- Работает только с подключениями
local. - Дополнительную информацию об использовании CLI и netconf см. в руководстве Junos OS Platform Options
- Дополнительную информацию об использовании Ansible для управления сетевыми устройствами см. в руководстве Ansible Network Guide
- Дополнительную информацию об использовании 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
Статус
Этот модуль помечен как preview, что означает, что гарантии обратной совместимости интерфейса нет.
Поддержка
Дополнительную информацию о поддержке этого модуля компанией Red Hat см. в этой статье базы знаний Knowledge Base article
Автор
- Peter Sprygada (@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.5/modules/junos_package_module.html
