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

Примечание

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

Для его установки используйте: 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 строка		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 строка	Варианты: отсутствует наличие ←	Состояние ресурса, настраиваемого модулем на узле NetScaler. При наличии ресурс будет создан при необходимости и настроен в соответствии с параметрами модуля. При отсутствии ресурс будет удален с узла 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–2019 Red Hat, Inc.
Licensed under the GNU General Public License version 3.
https://docs.ansible.com/ansible/2.10/collections/community/network/netscaler_server_module.html