junos_package – Установка пакетов на удалённые устройства с Junos
Новое в версии 2.1.
Обзор
- Этот модуль может устанавливать новые и обновлённые пакеты на удалённые устройства с Junos. Модуль сравнит указанный пакет с установленным на удалённом устройстве и установит указанную версию, если они не совпадают.
Требования
Ниже перечислены требования, необходимые на хосте, на котором выполняется этот модуль.
- junos-eznc
- ncclient (>=v0.5.2)
Параметры
| Параметр | Варианты/Значения по умолчанию | Комментарии | |
|---|---|---|---|
| force логический / обязательно |
| Аргумент force указывает модулю пропустить проверку версии пакета и установить пакет, указанный в src, на удалённом устройстве. | |
| no_copy логический |
| Аргумент no_copy отвечает за указание удалённому устройству, откуда установить пакет. При включении пакет передаётся на удалённое устройство до установки. | |
| provider - | Устаревший Начиная с Ansible 2.5, рекомендуется использовать connection: network_cli или connection: netconf. Для получения дополнительной информации см. руководство Junos OS Platform Options. Объект словаря, содержащий сведения о подключении. | ||
| 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 может быть либо локальным, либо полным путём к файлу пакета для установки. алиасы: пакет | ||
| validate логический добавлено в 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 Team. [сеть]
Поддержка Red Hat
Дополнительную информацию о поддержке Red Hat этого модуля можно найти в этой статье базы знаний Red Hat.
Авторы
- 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.7/modules/junos_package_module.html
