Spec-Zone.ru › Ansible 2.4

bigip_virtual_server - Управление виртуальными серверами F5 BIG-IP LTM

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

  • Обзор
  • Требования (к хосту, на котором выполняется модуль)
  • Параметры
  • Примеры
  • Возвращаемые значения
  • Примечания
    • Статус

Обзор

  • Управляет виртуальными серверами F5 BIG-IP LTM через iControl SOAP API

Требования (к хосту, на котором выполняется модуль)

  • bigsuds

Параметры

параметр обязательно значение по умолчанию выбор комментарии
all_policies
(добавлен в 2.3)
нет None
Список всех политик, включенных для виртуального сервера.
all_profiles
нет None
Список всех профилей (HTTP, ClientSSL, ServerSSL и т.д.), которые должны использоваться виртуальным сервером
all_rules
(добавлен в 2.2)
нет None
Список правил, которые должны применяться в порядке приоритета
default_persistence_profile
нет None
Профиль по умолчанию, управляющий сохранением сеансов
description
нет None
Описание виртуального сервера
destination
да
IP-адрес назначения виртуального сервера (в настоящее время поддерживается только хост). Требуется, когда state=present и VS не существует.
псевдонимы: адрес, ip
enabled_vlans
(добавлен в 2.2)
нет None
Список VLAN, которые необходимо включить. При использовании VLAN с именем ALL, все VLAN будут разрешены.
fallback_persistence_profile
(добавлен в 2.3)
нет None
Указывает профиль сохранения, который система должна использовать, если не может использовать указанный профиль сохранения по умолчанию.
name
да
Имя виртуального сервера
псевдонимы: vs
partition
нет Common
Раздел
password
да
Пароль для учетной записи пользователя, используемой для подключения к BIG-IP. Этот параметр можно опустить, если переменная среды F5_PASSWORD установлена.
pool
нет None
Пул по умолчанию для виртуального сервера
port
нет None
Порт виртуального сервера. Требуется, когда state=present и VS не существует. Если вы укажете значение для этого поля, оно должно быть числом от 0 до 65535.
route_advertisement_state
(добавлен в 2.3)
нет disabled
Включить объявление маршрута для назначения
server
да
Хост BIG-IP. Этот параметр можно опустить, если переменная среды F5_SERVER установлена.
server_port
(добавлен в 2.2)
нет 443
Порт сервера BIG-IP. Этот параметр можно опустить, если переменная среды F5_SERVER_PORT установлена.
snat
нет None
  • None
  • Automap
  • Имя пула SNAT (например, "/Common/snat_pool_name") для включения SNAT со специфическим пулом
Политика адресов исходной сети
state
нет present
  • present
  • absent
  • enabled
  • disabled
Состояние виртуального сервера
Absent, удалит VS, если он есть
present (и его синоним enabled), создаст VS при необходимости и установит состояние в enabled
disabled, создаст VS при необходимости и установит состояние в disabled
user
да
Имя пользователя для подключения к BIG-IP. Этот пользователь должен иметь административные привилегии на устройстве. Этот параметр можно опустить, если переменная среды F5_USER установлена.
validate_certs
(добавлен в 2.0)
нет True
  • True
  • False
Если no, сертификаты SSL не будут проверены. Это следует использовать только на сайтах, контролируемых лично, с использованием самозаверяемых сертификатов. Этот параметр можно опустить, если переменная среды F5_VALIDATE_CERTS установлена.

Примеры

- name: Add virtual server
  bigip_virtual_server:
      server: lb.mydomain.net
      user: admin
      password: secret
      state: present
      partition: MyPartition
      name: myvirtualserver
      destination: "{{ ansible_default_ipv4['address'] }}"
      port: 443
      pool: "{{ mypool }}"
      snat: Automap
      description: Test Virtual Server
      all_profiles:
          - http
          - clientssl
      enabled_vlans:
          - /Common/vlan2
  delegate_to: localhost

- name: Modify Port of the Virtual Server
  bigip_virtual_server:
      server: lb.mydomain.net
      user: admin
      password: secret
      state: present
      partition: MyPartition
      name: myvirtualserver
      port: 8080
  delegate_to: localhost

- name: Delete virtual server
  bigip_virtual_server:
      server: lb.mydomain.net
      user: admin
      password: secret
      state: absent
      partition: MyPartition
      name: myvirtualserver
  delegate_to: localhost

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

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

имя описание возвращено тип пример
deleted
Имя виртуального сервера, который был удален
изменено строка my-virtual-server

Примечания

Примечание

  • Требуется версия ПО BIG-IP >= 11
  • Требуется модуль «bigsuds», разработанный F5 (см. http://devcentral.f5.com)
  • Лучше всего запускать как local_action в вашем playbook

Статус

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

Для получения помощи в разработке модулей, если у вас есть желание, пожалуйста, ознакомьтесь с Справочная информация по сообществу и сотрудничеству, Тестирование 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_virtual_server_module.html

Spec-Zone.ru

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