junos_package - Установка пакетов на удалённые устройства с Junos
Новая версия с 2.1.
Обзор
- Этот модуль позволяет устанавливать новые и обновлённые пакеты на удалённые устройства с Junos. Модуль сравнит указанный пакет с установленным на удалённом устройстве и установит указанную версию, если обнаружено несовпадение.
Требования
Ниже перечислены требования, необходимые на хосте, на котором выполняется этот модуль.
- junos-eznc
- ncclient (>=v0.5.2)
Параметры
| Параметр | Варианты/Значения по умолчанию | Комментарии | |
|---|---|---|---|
| force bool обязательно |
| Аргумент force указывает модулю пропустить проверку версии пакета и установить пакет, указанный в src, на удалённом устройстве. | |
| no_copy bool |
| Аргумент no_copy отвечает за указание удалённому устройству, откуда установить пакет. При включении пакет передаётся на удалённое устройство перед установкой. | |
| provider | Устаревший Начиная с Ansible 2.5, рекомендуется использовать connection: network_cli или connection: netconf. Дополнительную информацию см. в руководстве Junos OS Platform Options. Объект типа dict, содержащий данные подключения. | ||
| host обязательно | Указывает имя или адрес хоста DNS для подключения к удалённому устройству по указанному каналу передачи. Значение host используется в качестве целевого адреса для канала передачи. | ||
| port | Значение по умолчанию: 22 | Указывает порт для подключения к удалённому устройству. Значение порта по умолчанию — стандартный SSH-порт 22 (для transport=cli) или 830 (для transport=netconf) устройства. | |
| username | Устанавливает имя пользователя для аутентификации подключения к удалённому устройству. Это значение используется для аутентификации SSH-сессии. Если значение не указано в задаче, используется значение переменной окружения ANSIBLE_NET_USERNAME. | ||
| password | Указывает пароль для аутентификации подключения к удалённому устройству. Это значение используется для аутентификации SSH-сессии. Если значение не указано в задаче, используется значение переменной окружения ANSIBLE_NET_PASSWORD. | ||
| timeout | Значение по умолчанию: 10 | Указывает тайм-аут в секундах для связи с сетевым устройством при подключении или отправке команд. Если тайм-аут истекает до завершения операции, модуль выдаст ошибку. | |
| ssh_keyfile | Указывает SSH-ключ для аутентификации подключения к удалённому устройству. Это путь к ключу, используемому для аутентификации SSH-сессии. Если значение не указано в задаче, используется значение переменной окружения ANSIBLE_NET_SSH_KEYFILE. | ||
| reboot bool обязательно |
| Для того, чтобы пакет вступил в силу, необходимо перезапустить удалённое устройство. При включении этого аргумента модуль перезагрузит устройство после установки обновлённого пакета. Если параметр отключён или удалённый пакет не требует изменения, устройство не будет перезапущено. | |
| src обязательно | Аргумент src указывает путь к исходному пакету, который необходимо установить на удалённом устройстве в случае несовпадения версий. Аргумент src может быть либо локальным путём, либо полным путём к файлу пакета для установки. псевдонимы: package | ||
| validate bool (добавлено в 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 guide
- Дополнительную информацию об использовании 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, что означает, что его интерфейс не гарантируется как обратной совместимости.
Техническое обслуживание
Этот модуль помечен как сетевой, что означает, что его поддерживает команда Ansible Network Team. См. Техническое обслуживание и поддержка модулей для получения дополнительной информации.
Список других модулей, которые также поддерживаются командой Ansible Network Team, см. здесь.
Поддержка
Дополнительную информацию о поддержке этого модуля компанией 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.6/modules/junos_package_module.html
