junos_package – Установка пакетов на удалённые устройства, работающие под Junos
Описание
- Этот модуль может устанавливать новые и обновлённые пакеты на удалённые устройства, работающие под Junos. Модуль сравнит указанный пакет с тем, что установлен на удалённом устройстве, и установит указанную версию, если они не совпадают
Требования
Ниже перечислены требования к хосту, на котором выполняется этот модуль.
- junos-eznc
- ncclient (>=v0.5.2)
Параметры
| Параметр | Варианты/Значения по умолчанию | Комментарии | |
|---|---|---|---|
| force boolean |
| Аргумент force указывает модулю пропустить проверку версии пакета и установить пакет, указанный в src, на удалённом устройстве. | |
| force_host boolean добавлен в 2.8 |
| Аргумент force_host контролирует способ добавления программного пакета или пакета на удалённом хосте JUNOS и применим для устройства JUNOS QFX5100. Если значение установлено в True, оно проигнорирует все предупреждения при добавлении программного пакета или пакета на хост. | |
| issu boolean добавлен в 2.8 |
| Аргумент issu — это флаг boolean, при установке в True, он разрешает функцию унифицированного обновления программного обеспечения в работе (ISSU), что позволяет обновлять версии Junos OS между двумя различными выпусками без прерывания управления и с минимальными прерываниями трафика. | |
| no_copy boolean |
| Аргумент 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 | Указывает порт для подключения к удалённому устройству. Значение порта по умолчанию — 22 (для transport=cli) или 830 (для transport=netconf). | |
| ssh_keyfile путь | Указывает SSH-ключ для проверки подлинности подключения к удалённому устройству. Это путь к ключу, используемому для аутентификации сессии SSH. Если значение не указано в задаче, вместо него используется значение переменной среды ANSIBLE_NET_SSH_KEYFILE. | ||
| timeout целое число | Значение по умолчанию: 10 | Указывает время ожидания в секундах для связи с сетевым устройством при подключении или отправке команд. Если время ожидания превышено до завершения операции, модуль выдаст ошибку. | |
| username строка | Указывает имя пользователя для проверки подлинности подключения к удалённому устройству. Это значение используется для аутентификации сессии SSH. Если значение не указано в задаче, вместо него используется значение переменной среды ANSIBLE_NET_USERNAME. | ||
| reboot boolean |
| Для того, чтобы пакет вступил в силу, необходимо перезапустить удалённое устройство. При включении этот аргумент укажет модулю перезапустить устройство после установки обновлённого пакета. При отключении или если удалённый пакет не нуждается в изменении, устройство не будет перезапущено. | |
| src - / обязательно | Аргумент src указывает путь к исходному пакету, который должен быть установлен на удалённом устройстве в случае несовпадения версий. Аргумент src может быть либо локальным, либо полным путем к файлу пакета для установки. псевдонимы: пакет | ||
| validate boolean добавлен в 2.5 |
| Аргумент validate отвечает за указание удалённому устройству пропустить проверку совместимости текущей конфигурации устройства с устанавливаемым пакетом. При установке в false проверка не выполняется. | |
| 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
- Дополнительную информацию об использовании 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
Статус
- Гарантия обратной совместимости интерфейса этого модуля отсутствует. [превью]
- Этот модуль поддерживается командой Ansible Network. [сетевой]
Поддержка Red Hat
Дополнительную информацию о поддержке этого модуля Red Hat см. в этой статье базы знаний Red Hat 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.9/modules/junos_package_module.html
