junipernetworks.junos.junos_package модуль — Установка пакетов на удалённые устройства с Junos

Примечание

Этот модуль является частью коллекции junipernetworks.junos (версия 8.0.0).

У вас, возможно, уже установлена эта коллекция, если вы используете пакет ansible. Она не входит в ansible-core. Чтобы проверить установку, выполните ansible-galaxy collection list.

Для установки используйте: ansible-galaxy collection install junipernetworks.junos. Для использования этого модуля необходимы дополнительные требования. Подробности см. в разделе Требования.

Для использования в плейбуке укажите: junipernetworks.junos.junos_package.

Добавлена в junipernetworks.junos 1.0.0

Описание
Требования
Параметры
Примечания
Примеры

Описание

Этот модуль может устанавливать новые и обновлять пакеты на удалённых устройствах с Junos. Модуль сравнит указанный пакет с установленным на удалённом устройстве и установит указанную версию, если они не совпадают.

Псевдонимы: package

Требования

Ниже перечислены требования к хосту, на котором выполняется этот модуль.

junos-eznc
ncclient (>=v0.5.2)

Параметры

Параметр	Комментарии
force boolean	Аргумент force указывает модулю пропустить проверку версии пакета и установить пакет, идентифицированный в src, на удалённом устройстве. Варианты: `false` ← (по умолчанию) `true`
force_host boolean	Аргумент force_host управляет способом добавления программного пакета или пакета на удалённый хост JUNOS и применим для устройства JUNOS QFX5100. Если значение установлено в `True`, будут проигнорированы любые предупреждения при добавлении программного пакета или пакета на хост. Варианты: `false` ← (по умолчанию) `true`
issu boolean	Аргумент issu — булевый флаг. При установке в значение `True`, он позволяет использовать функцию единого обновления программного обеспечения во время работы (ISSU), что позволяет обновляться между различными выпусками Junos OS без прерывания управления и с минимальным прерыванием трафика. Варианты: `false` ← (по умолчанию) `true`
no_copy boolean	Аргумент no_copy отвечает за указание удалённому устройству источника установки пакета. При включении пакет передаётся на удалённое устройство перед установкой. Варианты: `false` ← (по умолчанию) `true`
provider dictionary	Устарело Начиная с Ansible 2.5, рекомендуется использовать `connection: network_cli` или `connection: netconf`. Для получения дополнительной информации см. руководство Junos OS Platform Options. <hr> Объект типа dict, содержащий данные подключения.
host string	Указывает имя хоста DNS или адрес для подключения к удалённому устройству через указанный транспорт. Значение host используется в качестве адреса назначения для транспорта.
password string	Указывает пароль для аутентификации подключения к удалённому устройству. Это значение используется для аутентификации сеанса SSH. Если значение не указано в задаче, используется значение переменной окружения `ANSIBLE_NET_PASSWORD`.
port integer	Указывает порт для подключения к удалённому устройству. Значение порта по умолчанию — 22 (для `transport=cli`) или 830 (для `transport=netconf`) устройства.
ssh_keyfile path	Указывает SSH-ключ для аутентификации подключения к удалённому устройству. Это путь к ключу, используемому для аутентификации сеанса SSH. Если значение не указано в задаче, используется значение переменной окружения `ANSIBLE_NET_SSH_KEYFILE`.
timeout integer	Устанавливает таймаут в секундах для связи с сетевым устройством при подключении или отправке команд. Если таймаут истечёт до завершения операции, модуль вернёт ошибку.
transport string	Настраивает транспортное соединение для подключения к удалённому устройству. Варианты: `"cli"` `"netconf"` ← (по умолчанию)
username string	Настраивает имя пользователя для аутентификации подключения к удалённому устройству. Это значение используется для аутентификации сеанса SSH. Если значение не указано в задаче, используется значение переменной окружения `ANSIBLE_NET_USERNAME`.
reboot boolean	Для того чтобы пакет вступил в силу, удалённое устройство должно быть перезагружено. При включении этого аргумента модуль перезагрузит устройство после установки обновлённого пакета. Если параметр отключён или удалённый пакет не требуется менять, перезагрузка устройства не произойдёт. Варианты: `false` `true` ← (по умолчанию)
src aliases: package path / обязательно	Аргумент src указывает путь к исходному пакету, который будет установлен на удалённое устройство в случае несоответствия версий. Аргумент src может быть либо локальным путём, либо полным путём к файлу пакета для установки.
ssh_config path	Аргумент `ssh_config` — путь к файлу конфигурации SSH. Он может использоваться для загрузки информации SSH из файла конфигурации. Если этот параметр не задан, по умолчанию проверяется ~/.ssh/config.
ssh_private_key_file path	Аргумент `ssh_private_key_file` — путь к файлу закрытого SSH-ключа. Он может использоваться, если требуется предоставить закрытый ключ вместо загрузки ключа в ssh-key-ring/среду.

END_OF_DOCUMENT_MARKER

unlink boolean	Аргумент unlink отвечает за указание удаленному устройству удалить установленные пакеты после их установки. Варианты: `false` ← (по умолчанию) `true`
validate boolean	Аргумент validate отвечает за указание удаленному устройству пропустить проверку совместимости текущей конфигурации устройства с устанавливаемым пакетом. При установке в значение false, проверка не выполняется. Варианты: `false` `true` ← (по умолчанию)
version string	Аргумент version может быть использован для явного указания версии пакета, который должен быть установлен на удаленном устройстве. Если аргумент version не указан, тогда версия извлекается из имени файла src.

Примечания

Примечание

Для этого модуля требуется, чтобы служба netconf была включена на управляемом удаленном устройстве.
Проверено на vSRX JUNOS версии 15.1X49-D15.4, vqfx-10000 JUNOS версии 15.1X53-D60.4.
Работает только с local подключениями.
Поскольку этот модуль использует junos-eznc для установления соединения с устройством junos, параметры конфигурации netconf необходимо передавать с помощью параметров модуля, например, ssh_config, в отличие от других модулей junos, использующих netconf тип подключения.
Сведения о работе с CLI и netconf см. в руководстве :ref:`Junos OS Platform Options <junos_platform_options>`
Дополнительную информацию об использовании Ansible для управления сетевыми устройствами см. в руководстве :ref:`Ansible Network Guide <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
  junipernetworks.junos.junos_package:
    src: junos-vsrx-12.1X46-D10.2-domestic.tgz

- name: install local package on remote device without rebooting
  junipernetworks.junos.junos_package:
    src: junos-vsrx-12.1X46-D10.2-domestic.tgz
    reboot: false

- name: install local package on remote device with jumpost
  junipernetworks.junos.junos_package:
    src: junos-vsrx-12.1X46-D10.2-domestic.tgz
    ssh_config: /home/user/customsshconfig

Авторы

Peter Sprygada (@privateip)

Ссылки на сборки

© 2012–2018 Michael DeHaan
© 2018–2024 Red Hat, Inc.
Licensed under the GNU General Public License version 3.
https://docs.ansible.com/ansible/latest/collections/junipernetworks/junos/junos_package_module.html