bigip_config - Управление разделами конфигурации BIG-IP.
Новая версия с 2.4.
- Обзор
- Требования (к хосту, на котором выполняется модуль)
- Параметры
- Примеры
- Возвращаемые значения
- Примечания
Обзор
- Управляет конфигурацией BIG-IP, позволяя команды TMSH, которые изменяют текущую конфигурацию или объединяют файлы в формате SCF в текущую конфигурацию. Кроме того, этот модуль имеет важное значение, поскольку позволяет сохранять текущую конфигурацию на диск. Поскольку модуль F5 манипулирует только текущей конфигурацией, важно использовать этот модуль для сохранения текущей конфигурации.
Требования (к хосту, на котором выполняется модуль)
- f5-sdk >= 2.2.3
Параметры
| параметр | обязательно | по умолчанию | выбор | примечания |
|---|---|---|---|---|
| merge_content | нет | Загружает указанную конфигурацию, которую нужно объединить с текущей конфигурацией. Это эквивалентно использованию команды tmsh load sys config from-terminal merge. Если вам нужно читать конфигурацию из файла или шаблона, используйте плагины поиска file или template Ansible соответственно. | ||
| password | да | Пароль для учетной записи пользователя, используемой для подключения к BIG-IP. Этот параметр можно опустить, если переменная среды F5_PASSWORD задана. | ||
| reset | нет |
| Загружает стандартную конфигурацию на устройстве. Если этот параметр указан, стандартная конфигурация будет загружена перед выполнением любых команд или другой предоставленной конфигурации. | |
| save | нет |
| Аргумент save указывает модулю сохранить текущую конфигурацию в конфигурацию по умолчанию. Эта операция выполняется после внесения любых изменений в текущую конфигурацию. Если изменений не внесено, конфигурация все равно сохраняется в конфигурацию по умолчанию. Этот параметр всегда заставит модуль вернуть измененный статус. | |
| server | да | Хост BIG-IP. Этот параметр можно опустить, если переменная среды F5_SERVER задана. | ||
| server_port (добавлен в 2.2)
| нет | 443 | Порт сервера BIG-IP. Этот параметр можно опустить, если переменная среды F5_SERVER_PORT задана. | |
| user | да | Имя пользователя для подключения к BIG-IP. Этот пользователь должен иметь административные права на устройстве. Этот параметр можно опустить, если переменная среды F5_USER задана. | ||
| validate_certs (добавлен в 2.0)
| нет | True |
| Если no, сертификаты SSL не будут проверены. Это следует использовать только на контролируемых вами сайтах с самозаверяющими сертификатами. Этот параметр можно опустить, если переменная среды F5_VALIDATE_CERTS задана. |
| verify | нет | True |
| Проверяет указанную конфигурацию, чтобы определить, являются ли они действительными для замены текущей конфигурации. Текущая конфигурация не будет изменена. |
Примеры
- name: Save the running configuration of the BIG-IP
bigip_config:
save: yes
server: "lb.mydomain.com"
password: "secret"
user: "admin"
validate_certs: "no"
delegate_to: localhost
- name: Reset the BIG-IP configuration, for example, to RMA the device
bigip_config:
reset: yes
save: yes
server: "lb.mydomain.com"
password: "secret"
user: "admin"
validate_certs: "no"
delegate_to: localhost
- name: Load an SCF configuration
bigip_config:
merge_content: "{{ lookup('file', '/path/to/config.scf') }}"
server: "lb.mydomain.com"
password: "secret"
user: "admin"
validate_certs: "no"
delegate_to: localhost
Возвращаемые значения
Общие возвращаемые значения документированы здесь Возвращаемые значения, следующие поля уникальны для этого модуля:
| название | описание | возвращается | тип | пример |
|---|---|---|---|---|
| stdout | Набор ответов от параметров | всегда | список | ['...', '...'] |
| stdout_lines | Значение stdout, разделенное на список | всегда | список | [['...', '...'], ['...'], ['...']] |
Примечания
Примечание
- Требуется пакет f5-sdk Python на хосте. Это так же просто, как pip install f5-sdk.
Статус
Этот модуль помечен как предварительный просмотр, что означает, что он не гарантирует обратную совместимость интерфейса.
Для помощи в разработке модулей, если вам это нужно, пожалуйста, прочитайте Информацию о сообществе и участие в разработке, Тестирование Ansible и Разработка модулей.
© 2012–2018 Michael DeHaan
© 2018–2019 Red Hat, Inc.
Licensed under the GNU General Public License version 3.
https://docs.ansible.com/ansible/2.4/bigip_config_module.html