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