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 - | Имя сервера. Должно начинаться с буквы или символа подчеркивания, а также содержать только алфавитно-цифровые символы, символ подчеркивания, символ решетки, точку, пробел, двоеточие, символ «@», символ «=», и дефис. Можно изменить после создания имени. Минимальная длина = 1 | |
| nitro_pass string / обязательно | Пароль для аутентификации на узле NetScaler. | |
| nitro_protocol string |
| Протокол для доступа к объектам API nitro. |
| nitro_timeout float | По умолчанию: 310 | Время в секундах до истечения срока ожидания при установлении нового сеанса с NetScaler. |
| nitro_user string / обязательно | Имя пользователя для аутентификации на узле NetScaler. | |
| nsip string / обязательно | IP-адрес устройства NetScaler, на котором будут выполняться вызовы API nitro. Порт можно указать с двоеточием (:). Например, 192.168.1.1:555. | |
| save_config boolean |
| Если yes, модуль сохранит конфигурацию на узле NetScaler, если внесет изменения.Модуль не сохранит конфигурацию на узле NetScaler, если изменений не было. |
| state string |
| Состояние ресурса, настраиваемого модулем на узле NetScaler. При present ресурс будет создан, если необходимо, и настроен в соответствии с параметрами модуля. При absent ресурс будет удален с узла NetScaler. |
| td - | Целочисленное значение, уникально идентифицирующее домен трафика, в котором вы хотите настроить сущность. Если вы не укажете идентификатор, сущность станет частью стандартного домена трафика, у которого идентификатор 0. Минимальное значение = 0
Максимальное значение = 4094
| |
| translationip - | IP-адрес, используемый для преобразования IP-адреса сервера, разрешенного DNS. | |
| translationmask - | Маска сети IP-адреса преобразования. | |
| validate_certs boolean |
| Если 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 dictionary | ошибка | Список различий между фактическим настроенным объектом и конфигурацией, указанной в модуле Пример: {'targetlbvserver': 'difference. ours: (str) server1 other: (str) server2'} |
| loglines list | всегда | Список сообщений, записанных модулем Пример: ['сообщение 1', 'сообщение 2'] |
| msg string | ошибка | Сообщение, описывающее причину ошибки Пример: Действие не существует |
Статус
- Модуль не гарантирует обратную совместимость интерфейса. [preview]
- Этот модуль поддерживается сообществом Ansible. [community]
Авторы
- 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.9/modules/netscaler_server_module.html
