community.network.netscaler_server – Управление конфигурацией сервера

Примечание

Этот плагин входит в коллекцию community.network (версия 2.0.1).

Для его установки используйте: ansible-galaxy collection install community.network.

Для использования в книге задач укажите: community.network.netscaler_server.

Обзор
Требования
Параметры
Примечания
Примеры
Возвращаемые значения

Обзор

Управление конфигурацией сущностей сервера.
Этот модуль предназначен для выполнения как на узле управления Ansible, так и на бастионе (шлюзе) с доступом к фактической инстанции Netscaler.

Требования

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

nitro python sdk

Параметры

Параметр	Варианты/Значения по умолчанию	Комментарии
comment строка		Любая информация о сервере.
delay строка		Время в секундах, по истечении которого все сервисы, настроенные на сервере, будут отключены. Этот параметр имеет смысл только при установке параметра disabled в `true`.
disabled булево	Варианты: нет ← да	При установке в `true` состояние сервера будет установлено в `disabled`. При установке в `false` состояние сервера будет установлено в `enabled`. Обратите внимание, что из-за ограничений базового API NITRO изменение состояния `disabled` не приводит к тому, что модуль сообщает о произошедших изменениях.
domain строка		Имя домена сервера. Для конфигурации на основе домена вы должны сначала создать сервер. Минимальная длина = 1
domainresolveretry строка	По умолчанию: 5	Время в секундах, в течение которого устройство NetScaler должно ждать, после того как произошел сбой разрешения DNS, прежде чем отправить следующий запрос DNS для разрешения имени домена. Минимальное значение = `5`. Максимальное значение = `20939`.
graceful булево	Варианты: нет да	Плавно завершить работу, не принимая новых соединений и отключая каждый сервис при закрытии всех его соединений. Этот параметр имеет смысл только при установке параметра disabled в `true`.
ipaddress строка		IP-адрес сервера IPv4 или IPv6. Если вы создаете сервер на основе IP-адреса, вы можете указать имя сервера вместо его IP-адреса при создании службы. Примечание: если вы не создаете запись сервера, IP-адрес сервера, который вы вводите при создании службы, становится именем сервера.
ipv6address булево	Варианты: нет ← да	Поддержка IPv6 режима адресации. Если вы настраиваете сервер с режимом адресации IPv6, вы не можете использовать сервер в режиме адресации IPv4.
name строка		Имя сервера. Должно начинаться с ASCII буквенного или символа подчеркивания `_`, и должно содержать только ASCII буквенно-цифровые, символы подчеркивания `_`, решетки `#`, точки `.`, пробелы, двоеточия `:`, знаки @ `@`, знаки равно `=`, и тире `-`. Можно изменить после создания имени. Минимальная длина = 1
nitro_pass строка / обязательно		Пароль для аутентификации на узле netscaler.
nitro_protocol строка	Варианты: http ← https	Какой протокол использовать при доступе к объектам API nitro.
nitro_timeout вещественное число	По умолчанию: 310	Время в секундах до возникновения ошибки тайм-аута при установлении нового сеанса с Netscaler
nitro_user строка / обязательно		Имя пользователя для аутентификации на узле netscaler.
nsip строка / обязательно		IP-адрес устройства netscaler, на котором будут выполняться вызовы API nitro. Порт может быть указан с двоеточием (:). Например, 192.168.1.1:555.
save_config булево	Варианты: нет да ←	Если `yes`, модуль сохранит конфигурацию на узле netscaler, если он внес какие-либо изменения. Модуль не сохранит конфигурацию на узле netscaler, если он не внес никаких изменений.
state строка	Варианты: absent present ←	Состояние ресурса, настраиваемого модулем на узле netscaler. При present ресурс будет создан при необходимости и настроен в соответствии с параметрами модуля. При absent ресурс будет удален с узла netscaler.
td строка		Целочисленное значение, которое однозначно идентифицирует домен трафика, в котором вы хотите настроить сущность. Если вы не укажете идентификатор, сущность станет частью стандартного домена трафика, который имеет идентификатор 0. Минимальное значение = `0`. Максимальное значение = `4094`.
translationip строка		IP-адрес, используемый для преобразования DNS-разрешенного IP-адреса сервера.
translationmask строка		Маска сети IP-адреса преобразования.
validate_certs булево	Варианты: нет да ←	Если `no`, сертификаты SSL не будут проверены. Это следует использовать только на контролируемых вами сайтах с использованием самозаверяемых сертификатов.

Примечания

Примечание

Дополнительную информацию об использовании Ansible для управления устройствами сети Citrix NetScaler см. на странице https://www.ansible.com/ansible-netscaler.

Примеры

- name: Setup server
  delegate_to: localhost
  community.network.netscaler_server:
      nsip: 172.18.0.2
      nitro_user: nsroot
      nitro_pass: nsroot

      state: present

      name: server-1
      ipaddress: 192.168.1.1

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

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

Ключ	Возвращаемое значение	Описание
diff словарь	ошибка	Список различий между фактическим настроенным объектом и конфигурацией, указанной в модуле Пример: {'targetlbvserver': 'различие. наше: (строка) server1 другое: (строка) server2'}
loglines список / элементы=строка	всегда	список зарегистрированных сообщений модуля Пример: ['сообщение 1', 'сообщение 2']
msg строка	ошибка	Сообщение, подробно описывающее причину ошибки Пример: Действия не существует

Авторы

George Nikolopoulos (@giorgos-nikolopoulos)

© 2012–2018 Michael DeHaan
© 2018–2021 Red Hat, Inc.
Licensed under the GNU General Public License version 3.
https://docs.ansible.com/ansible/2.11/collections/community/network/netscaler_server_module.html