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

Новая в версии 2.4.0.

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

Обзор

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

Требования

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

nitro python sdk

Параметры

Параметр	Варианты/Значения по умолчанию	Комментарии
comment -		Любая информация о сервере.
delay - добавлен в 2.5		Время в секундах, по истечении которого все сервисы, настроенные на сервере, будут отключены. Этот параметр имеет смысл только при установке параметра disabled в `true`.
disabled boolean	Варианты: нет ← да	При установке в `true` состояние сервера будет установлено в `disabled`. При установке в `false` состояние сервера будет установлено в `enabled`. Обратите внимание, что из-за ограничений подлежащего API NITRO изменение состояния `disabled` не приводит к тому, что модуль сообщает об изменении статуса.
domain -		Имя домена сервера. Для конфигурации на основе домена, необходимо сначала создать сервер. Минимальная длина = 1
domainresolveretry -	По умолчанию: 5	Время в секундах, в течение которого устройство NetScaler должно ждать, после того как произошел сбой в разрешении DNS, прежде чем отправить следующий запрос DNS для разрешения имени домена. Минимальное значение = `5` Максимальное значение = `20939`
graceful boolean добавлен в 2.5	Варианты: нет да	Плавно завершить работу, без приема новых подключений и отключить каждый сервис, когда все его подключения будут закрыты. Этот параметр имеет смысл только при установке параметра disabled в `true`
ipaddress -		IP-адрес сервера (IPv4 или IPv6). Если вы создаёте сервер на основе IP-адреса, вы можете указать имя сервера вместо его IP-адреса при создании сервиса. Примечание: если вы не создаёте запись сервера, IP-адрес сервера, который вы вводите при создании сервиса, становится именем сервера.
ipv6address boolean	Варианты: нет ← да	Поддержка режима адресации 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 boolean	Варианты: нет да ←	Если true, модуль сохранит конфигурацию на узле NetScaler, если были внесены изменения. Модуль не сохранит конфигурацию на узле NetScaler, если изменений не было.
state -	Варианты: present ← absent	Состояние ресурса, настраиваемого модулем на узле NetScaler. При значении present ресурс будет создан при необходимости и настроен в соответствии с параметрами модуля. При значении absent ресурс будет удален с узла NetScaler.
td -		Целочисленное значение, которое однозначно идентифицирует домен трафика, в котором необходимо настроить сущность. Если вы не укажете идентификатор, сущность станет частью стандартного домена трафика, который имеет идентификатор 0. Минимальное значение = `0` Максимальное значение = `4094`
translationip -		IP-адрес, используемый для преобразования IP-адреса сервера, разрешенного DNS.
translationmask -		Маска сети IP-адреса преобразования.
validate_certs -	По умолчанию: "да"	Если `no`, сертификаты SSL не будут проверены. Это следует использовать только на сайтах, контролируемых лично, использующих самозаверяющие сертификаты.

Примечания

Примечание

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

Примеры

- name: Setup server
  delegate_to: localhost
  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 строка	ошибка	Сообщение, описывающее причину ошибки. Пример: Действия не существует

Статус

Данный модуль не гарантирует обратную совместимость интерфейса. [превью]
Этот модуль поддерживается сообществом Ansible. [сообщество]

Авторы

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.7/modules/netscaler_server_module.html