Spec-Zone.ru › Ansible

community.network.netscaler_server модуль — Управление конфигурацией сервера

Примечание

Этот модуль входит в коллекцию community.network (версия 5.0.3).

Возможно, эта коллекция уже установлена, если вы используете пакет ansible. Она не включена в ansible-core. Чтобы проверить установку, выполните ansible-galaxy collection list.

Для установки используйте: ansible-galaxy collection install community.network. Для использования этого модуля потребуются дополнительные требования, см. Требования для подробностей.

Для использования в книге задач укажите: community.network.netscaler_server.

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

Описание

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

Псевдонимы: network.netscaler.netscaler_server

Требования

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

  • nitro python sdk

Параметры

Параметр

Комментарии

comment

string

Любая информация о сервере.

delay

string

Время, в секундах, по истечении которого все службы, настроенные на сервере, будут отключены.

Этот параметр имеет значение только при установке параметра disabled в true

disabled

boolean

При установке в true состояние сервера будет установлено в disabled.

При установке в false состояние сервера будет установлено в enabled.

Обратите внимание, что из-за ограничений базового API NITRO изменение состояния disabled само по себе не приводит к тому, что результат модуля сообщает об изменении состояния.

Варианты:

  • false ← (по умолчанию)
  • true

domain

string

Доменное имя сервера. Для конфигурации на основе домена необходимо сначала создать сервер.

Минимальная длина = 1

domainresolveretry

string

Время, в секундах, в течение которого устройство NetScaler должно ожидать после сбоя разрешения DNS, прежде чем отправлять следующий запрос DNS для разрешения доменного имени.

Минимальное значение = 5

Максимальное значение = 20939

По умолчанию: 5

graceful

boolean

Выполнить плановое завершение работы, не принимая новых подключений и отключая каждую службу, когда все ее соединения закрыты.

Этот параметр имеет значение только при установке параметра disabled в true

Варианты:

  • false
  • true

ipaddress

string

IPv4 или IPv6-адрес сервера. Если вы создаете сервер на основе IP-адреса, вы можете указать имя сервера вместо его IP-адреса при создании службы. Примечание. Если вы не создаете запись сервера, IP-адрес сервера, который вы вводите при создании службы, становится именем сервера.

ipv6address

boolean

Поддержка режима адресации IPv6. Если вы настраиваете сервер в режиме адресации IPv6, вы не можете использовать сервер в режиме адресации IPv4.

Варианты:

  • false ← (по умолчанию)
  • true

name

string

Имя для сервера.

Должно начинаться с символа ASCII, являющегося буквой или символом подчеркивания _, и должно содержать только символы ASCII (буквы, цифры), символ подчеркивания _, символ решетки #, точку ., пробел, двоеточие :, символ @ @, знак равенства = и дефис -.

Может быть изменено после создания имени.

Минимальная длина = 1

nitro_pass

string / required

Пароль для аутентификации на узле NetScaler.

nitro_protocol

string

Протокол, используемый при доступе к объектам API Nitro.

Варианты:

  • "http" ← (по умолчанию)
  • "https"

nitro_timeout

float

Время в секундах до возникновения ошибки времени ожидания при установлении нового сеанса с NetScaler

По умолчанию: 310.0

nitro_user

string / required

Имя пользователя для аутентификации на узле NetScaler.

nsip

string / required

IP-адрес устройства NetScaler, куда будут отправляться вызовы API Nitro.

Порт можно указать с помощью двоеточия (:). Например, 192.168.1.1:555.

save_config

boolean

Если yes, модуль сохранит конфигурацию на узле NetScaler, если он внесет какие-либо изменения.

Модуль не будет сохранять конфигурацию на узле NetScaler, если он не внес никаких изменений.

Варианты:

  • false
  • true ← (по умолчанию)

state

string

Состояние ресурса, настраиваемого модулем на узле NetScaler.

При наличии ресурс будет создан, если необходимо, и настроен в соответствии с параметрами модуля.

При отсутствии ресурс будет удален с узла NetScaler.

Варианты:

  • "absent"
  • "present" ← (по умолчанию)

td

string

Целочисленное значение, однозначно идентифицирующее трафиковый домен, в котором вы хотите настроить сущность. Если вы не укажете ID, сущность станет частью домена трафика по умолчанию, который имеет ID 0.

Минимальное значение = 0

Максимальное значение = 4094

translationip

string

IP-адрес, используемый для преобразования IP-адреса сервера, определённого по DNS.

translationmask

string

Маска сети для ip-адреса преобразования.

validate_certs

boolean

Если no, сертификаты SSL не будут проверены. Это следует использовать только на сайтах, контролируемых лично, с использованием самозаверенных сертификатов.

Варианты:

  • false
  • true ← (по умолчанию)

Примечания

Примечание

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

Примеры

- name: Setup server
  delegate_to: localhost
  community.network.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": "difference. ours: (str) server1 other: (str) server2"}

loglines

список / элементы=строка

список сообщений, записанных модулем

Возвращается: всегда

Пример: ["message 1", "message 2"]

msg

строка

Сообщение, содержащее причину ошибки

Возвращается: при ошибке

Пример: "Action does not exist"

Авторы

  • Георгий Николопулос (@giorgos-nikolopoulos)

Ссылки на коллекцию

  • Система отслеживания ошибок
  • Репозиторий (источники)

© 2012–2018 Michael DeHaan
© 2018–2024 Red Hat, Inc.
Licensed under the GNU General Public License version 3.
https://docs.ansible.com/ansible/latest/collections/community/network/netscaler_server_module.html

Spec-Zone.ru

Настройки Оффлайн Что нового Помощь О нас
Spec-Zone .ru
спецификации, руководства, описания, API