netscaler_server - Управление конфигурацией сервера
Новая версия 2.4.0.
Обзор
- Управление конфигурацией сущностей сервера.
- Этот модуль предназначен для работы как на узле управления Ansible, так и на бастионе (шлюзе) с доступом к фактической инстанции NetScaler.
Требования
Ниже приведены требования, необходимые на хосте, на котором выполняется этот модуль.
- nitro python sdk
Параметры
| Параметр | Варианты/Значения по умолчанию | Комментарии |
|---|---|---|
| comment | Любая информация о сервере. | |
| delay (добавлено в 2.5) | Время в секундах, после которого все службы, настроенные на сервере, будут отключены. Этот параметр имеет смысл только при установке параметра disabled в true
| |
| disabled |
| При установке в true состояние сервера будет установлено в disabled.При установке в false состояние сервера будет установлено в enabled.Обратите внимание, что из-за ограничений базового API NITRO изменение состояния disabled не приводит к тому, что модуль указывает на изменение статуса. |
| domain | Имя домена сервера. Для конфигурации на основе домена сначала необходимо создать сервер. Минимальная длина = 1 | |
| domainresolveretry | По умолчанию: 5 | Время в секундах, которое NetScaler-приложение должно ждать после неудачного разрешения DNS, прежде чем отправить следующий запрос DNS для разрешения имени домена. Минимальное значение = 5
Максимальное значение = 20939
|
| graceful (добавлено в 2.5) |
| Выключить плавно, не принимая новых подключений и отключая каждую службу, когда все её подключения закрыты. Этот параметр имеет смысл только при установке параметра disabled в true
|
| ipaddress | IPv4 или IPv6 адрес сервера. Если вы создаёте сервер на основе IP-адреса, вместо IP-адреса можно указать имя сервера при создании службы. Примечание: Если вы не создаёте запись сервера, IP-адрес сервера, который вы вводите при создании службы, станет именем сервера. | |
| ipv6address |
| Поддержка режима адресации IPv6. Если вы настраиваете сервер в режиме адресации IPv6, вы не можете использовать сервер в режиме адресации IPv4. |
| name | Имя сервера. Должно начинаться с символа латинского алфавита или символа подчеркивания _, и должно содержать только символы латинского алфавита, цифры, символ подчеркивания _, знак решётки #, точку ., пробел, двоеточие :, символ @ @, знак равенства =, и дефис -.Можно изменить после создания имени. Минимальная длина = 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 |
| Если значение true, модуль сохранит конфигурацию на узле NetScaler, если будут внесены изменения. Модуль не будет сохранять конфигурацию на узле NetScaler, если изменений не было. |
| state |
| Состояние ресурса, настраиваемого модулем на узле NetScaler. При значении present ресурс будет создан при необходимости и настроен в соответствии с параметрами модуля. При значении absent ресурс будет удален с узла NetScaler. |
| td | Целочисленное значение, уникально идентифицирующее домен трафика, в котором вы хотите настроить сущность. Если вы не укажете идентификатор, сущность станет частью стандартного домена трафика с идентификатором 0. Минимальное значение = 0
Максимальное значение = 4094
| |
| translationip | IP-адрес, используемый для преобразования DNS-разрешенного IP-адреса сервера. | |
| 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 строка | ошибка | Сообщение, подробно описывающее причину ошибки Пример: Действие не существует |
Статус
Этот модуль помечен как превью, что означает, что его интерфейс не гарантированно будет обратной совместимостью.
Автор
- Георгий Николопулос (@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.5/modules/netscaler_server_module.html
