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 - | IPv4 или IPv6 адрес сервера. Если вы создаёте сервер на основе IP-адреса, вы можете указать имя сервера, вместо его IP-адреса, при создании службы. Примечание: если вы не создаёте запись сервера, IP-адрес сервера, который вы введёте при создании службы, станет именем сервера. | |
| ipv6address boolean |
| Поддержка режима адресации IPv6. Если вы настраиваете сервер в режиме адресации IPv6, вы не можете использовать сервер в режиме адресации IPv4. |
| name - | Имя сервера. Должно начинаться с ASCII буквенного или символа подчеркивания _, и должно содержать только ASCII буквенно-цифровые символы, символ подчеркивания _, символ решётки #, точку ., пробел, двоеточие :, символ @ @, знак равно =, и дефис -.Может быть изменено после создания имени. Минимальная длина = 1 | |
| nitro_pass строка / обязательно | Пароль для аутентификации на узле NetScaler. | |
| nitro_protocol строка |
| Какой протокол использовать при доступе к объектам API nitro. |
| nitro_timeout число с плавающей запятой | По умолчанию: 310 | Время в секундах до ошибки таймаута при установке нового сеанса с NetScaler. |
| nitro_user строка / обязательно | Имя пользователя для аутентификации на узле NetScaler. | |
| nsip строка / обязательно | IP-адрес устройства NetScaler, где будут выполняться вызовы API nitro. Порт можно указать с помощью двоеточия (:). Например, 192.168.1.1:555. | |
| save_config boolean |
| Если yes, модуль сохранит конфигурацию на узле NetScaler, если внесёт какие-либо изменения.Модуль не сохранит конфигурацию на узле NetScaler, если не внесёт никаких изменений. |
| state строка |
| Состояние ресурса, настраиваемого модулем на узле NetScaler. При present ресурс будет создан, если необходимо, и настроен в соответствии с параметрами модуля. При absent ресурс будет удален с узла NetScaler. |
| td - | Целочисленное значение, однозначно идентифицирующее домен трафика, в котором вы хотите настроить сущность. Если вы не укажете ID, сущность станет частью стандартного домена трафика, который имеет ID 0. Минимальное значение = 0.
Максимальное значение = 4094.
| |
| translationip - | IP-адрес, используемый для преобразования DNS-разрешенного IP-адреса сервера. | |
| translationmask - | Маска подсети IP-адреса преобразования. | |
| validate_certs boolean |
| Если no, сертификаты SSL не будут проверены. Это следует использовать только на сайтах, контролируемых лично, которые используют самоподписанные сертификаты. |
Примечания
Примечание
- Дополнительную информацию об использовании Ansible для управления устройствами Citrix NetScaler см. в 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': 'различие. наше: (строка) сервер1 другое: (строка) сервер2'} |
| 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.8/modules/netscaler_server_module.html
