Spec-Zone.ru › Ansible 2.5

bigip_device_sshd - Управление настройками SSHD устройства BIG-IP

Новое в версии 2.2.

  • Обзор
    • Требования
  • Параметры
  • Примечания
  • Примеры
  • Возвращаемые значения
  • Статус
    • Автор

Обзор

  • Управление настройками SSHD устройства BIG-IP.

Требования

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

  • f5-sdk >= 3.0.9

Параметры

Параметр Варианты/Значения по умолчанию Комментарии
allow
    Варианты:
  • all
  • IP-адрес, например 172.27.1.10
  • Диапазон IP-адресов, например 172.27.*.* или 172.27.0.0/255.255.0.0
Указывает, если доступ SSH включен, IP-адрес или диапазон адресов других систем, которые могут использовать SSH для связи с этой системой.
banner
    Варианты:
  • enabled
  • disabled
Включить или выключить баннер.
banner_text
Указывает текст, который будет отображаться в баннере перед входом в систему при попытке входа в систему с использованием SSH.
inactivity_timeout
Указывает количество секунд до завершения сеанса SSH из-за бездействия.
log_level
    Варианты:
  • debug
  • debug1
  • debug2
  • debug3
  • error
  • fatal
  • info
  • quiet
  • verbose
Указывает минимальный уровень сообщений SSHD, которые будут включены в системный журнал.
login
    Варианты:
  • enabled
  • disabled
Указывает, когда проверено enabled, что система принимает SSH-соединения.
password
обязательно
Пароль учетной записи пользователя для подключения к BIG-IP. Вы можете опустить этот параметр, если переменная среды F5_PASSWORD установлена.

псевдонимы: pass, pwd
port
Порт, на котором будет работать SSH-демон.
provider
(добавлено в 2.5)
По умолчанию:
None
Объект словаря, содержащий данные подключения.
ssh_keyfile
Указывает SSH-ключевой файл для аутентификации подключения к удаленному устройству. Этот аргумент используется только для cli-транспортов. Если значение не указано в задаче, вместо него будет использоваться значение переменной среды ANSIBLE_NET_SSH_KEYFILE.
timeout По умолчанию:
10
Указывает время ожидания в секундах для связи с сетевым устройством для подключения или отправки команд. Если время ожидания истечет до завершения операции, модуль вернет ошибку.
server
обязательно
Хост BIG-IP. Вы можете опустить этот параметр, если переменная среды F5_SERVER установлена.
user
обязательно
Имя пользователя для подключения к BIG-IP. Этот пользователь должен иметь административные привилегии на устройстве. Вы можете опустить этот параметр, если переменная среды F5_USER установлена.
server_port По умолчанию:
443
Порт сервера BIG-IP. Вы можете опустить этот параметр, если переменная среды F5_SERVER_PORT установлена.
password
обязательно
Пароль учетной записи пользователя для подключения к BIG-IP. Вы можете опустить этот параметр, если переменная среды F5_PASSWORD установлена.

псевдонимы: pass, pwd
validate_certs
    Варианты:
  • no
  • yes ←
Если no, сертификаты SSL не будут проверены. Используйте только на сайтах, контролируемых лично, с самозаверяющимися сертификатами. Вы можете опустить этот параметр, если переменная среды F5_VALIDATE_CERTS установлена.
transport
обязательно
    Варианты:
  • rest
  • cli ←
Настраивает транспортное соединение для подключения к удаленному устройству.
server
обязательно
Хост BIG-IP. Вы можете опустить этот параметр, если переменная среды F5_SERVER установлена.
server_port
(добавлено в 2.2)
По умолчанию:
443
Порт сервера BIG-IP. Вы можете опустить этот параметр, если переменная среды F5_SERVER_PORT установлена.
user
обязательно
Имя пользователя для подключения к BIG-IP. Этот пользователь должен иметь административные привилегии на устройстве. Вы можете опустить этот параметр, если переменная среды F5_USER установлена.
validate_certs
(добавлено в 2.0)
    Варианты:
  • no
  • yes ←
Если no, сертификаты SSL не будут проверены. Используйте только на сайтах, контролируемых лично, с самозаверяющимися сертификатами. Вы можете опустить этот параметр, если переменная среды F5_VALIDATE_CERTS установлена.

Примечания

Примечание

  • Требуется BIG-IP версии 12.0.0 или выше
  • Дополнительную информацию об использовании Ansible для управления устройствами F5 Networks см. на сайте https://www.ansible.com/integrations/networks/f5.
  • Требуется пакет f5-sdk Python на хосте. Это так же просто, как pip install f5-sdk.

Примеры

- name: Set the banner for the SSHD service from a string
  bigip_device_sshd:
    banner: enabled
    banner_text: banner text goes here
    password: secret
    server: lb.mydomain.com
    user: admin
  delegate_to: localhost

- name: Set the banner for the SSHD service from a file
  bigip_device_sshd:
    banner: enabled
    banner_text: "{{ lookup('file', '/path/to/file') }}"
    password: secret
    server: lb.mydomain.com
    user: admin
  delegate_to: localhost

- name: Set the SSHD service to run on port 2222
  bigip_device_sshd:
    password: secret
    port: 2222
    server: lb.mydomain.com
    user: admin
  delegate_to: localhost

Возвращаемые значения

Общие возвращаемые значения описаны здесь, следующие поля уникальны для этого модуля:

Ключ Возвращаемое значение Описание
allow
строка
изменено
Указывает, если доступ SSH включен, IP-адрес или диапазон адресов других систем, которые могут использовать SSH для связи с этой системой.

Пример:
192.0.2.*
banner
строка
изменено
Включен или выключен баннер.

Пример:
True
banner_text
строка
изменено и успешно
Указывает текст, отображаемый в баннере перед входом в систему при попытке входа с помощью SSH.

Пример:
Это корпоративное устройство. Подключение к нему без...
inactivity_timeout
целое число
изменено
Количество секунд до завершения сеанса SSH из-за бездействия.

Пример:
10
log_level
строка
изменено
Минимальный уровень сообщений SSHD, включаемых в системный журнал.

Пример:
debug
login
логическое значение
изменено
Указывает, принимает ли система SSH-соединения или нет.

Пример:
True
port
целое число
изменено
Порт, на котором будет работать SSH-демон.

Пример:
22


Статус

Этот модуль помечен как предварительный просмотр, что означает, что его интерфейс не гарантируется как обратная совместимость.

Автор

  • Tim Rupp (@caphrim007)

Подсказка

Если вы заметили какие-либо проблемы в этом руководстве, вы можете отредактировать этот документ, чтобы улучшить его.

© 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/bigip_device_sshd_module.html

Spec-Zone.ru

Настройки Оффлайн Что нового Помощь О нас
Spec-Zone .ru
спецификации, руководства, описания, API