Spec-Zone.ru › Ansible 2.9

oneandone_load_balancer – Настройка балансировщика нагрузки 1&1

Новая в версии 2.5.

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

Обзор

  • Создание, удаление, обновление балансировщиков нагрузки. Данный модуль имеет зависимость от 1and1 >= 1.0

Требования

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

  • 1and1
  • python >= 2.6

Параметры

Параметр Варианты/Значения по умолчанию Комментарии
add_rules
-
Список правил, которые будут добавлены к существующему балансировщику нагрузки. Синтаксис такой же, как и для параметра rules. Используется в сочетании с состоянием update.
add_server_ips
-
Список идентификаторов серверов (id или имя), которые будут назначены балансировщику нагрузки. Используется в сочетании с состоянием update.
api_url
-
Пользовательский URL API. Переопределяет переменную окружения ONEANDONE_API_URL.
auth_token
- / обязательно
Аутентификационный токен API, предоставленный 1&1.
datacenter
-
    Варианты:
  • US ←
  • ES
  • DE
  • GB
Идентификатор или код страны дата-центра, где будет создан балансировщик нагрузки.
description
-
Описание балансировщика нагрузки. maxLength=256
health_check_interval
- / обязательно
Период проверки состояния в секундах. minimum=5, maximum=300, multipleOf=1
health_check_parse
-
Регулярное выражение для проверки. Требуется для проверки состояния HTTP. maxLength=64
health_check_path
-
URL для вызова проверки. Требуется для проверки состояния HTTP. maxLength=1000
health_check_test
- / обязательно
    Варианты:
  • NONE
  • TCP
  • HTTP
  • ICMP
Тип проверки состояния. В настоящий момент HTTP не разрешен.
load_balancer
- / обязательно
Идентификатор (id или имя) балансировщика нагрузки, используемый с состоянием update.
method
- / обязательно
    Варианты:
  • ROUND_ROBIN
  • LEAST_CONNECTIONS
Процедура балансировки.
name
- / обязательно
Имя балансировщика нагрузки, используемое с текущим состоянием. Используется в качестве идентификатора (id или имя) при использовании состояния absent. maxLength=128
persistence
boolean / обязательно
    Варианты:
  • нет
  • да
Сохранение состояния.
persistence_time
- / обязательно
Время сохранения состояния в секундах. Требуется, если сохранение состояния включено. minimum=30, maximum=1200, multipleOf=1
remove_rules
-
Список идентификаторов правил, которые будут удалены из существующего балансировщика нагрузки. Используется в сочетании с состоянием update.
remove_server_ips
-
Список идентификаторов IP-адресов серверов, которые будут отвязаны от балансировщика нагрузки. Используется в сочетании с состоянием update.
rules
- / обязательно
Список объектов правил, которые будут установлены для балансировщика нагрузки. Каждое правило должно содержать параметры protocol, port_balancer и port_server, а также параметр source, который является необязательным.
state
-
    Варианты:
  • present ←
  • absent
  • update
Определите состояние балансировщика нагрузки для создания, удаления или обновления.
wait
boolean
    Варианты:
  • нет
  • да ←
ожидание состояния экземпляра «работает» перед возвратом
wait_interval
-
Значение по умолчанию:
5
Определяет количество секунд ожидания при использовании методов _wait_for
wait_timeout
-
Значение по умолчанию:
600
время ожидания до отказа, в секундах

Примеры

# Provisioning example. Create and destroy a load balancer.

- oneandone_load_balancer:
    auth_token: oneandone_private_api_key
    name: ansible load balancer
    description: Testing creation of load balancer with ansible
    health_check_test: TCP
    health_check_interval: 40
    persistence: true
    persistence_time: 1200
    method: ROUND_ROBIN
    datacenter: US
    rules:
     -
       protocol: TCP
       port_balancer: 80
       port_server: 80
       source: 0.0.0.0
    wait: true
    wait_timeout: 500

- oneandone_load_balancer:
    auth_token: oneandone_private_api_key
    name: ansible load balancer
    wait: true
    wait_timeout: 500
    state: absent

# Update a load balancer.

- oneandone_load_balancer:
    auth_token: oneandone_private_api_key
    load_balancer: ansible load balancer
    name: ansible load balancer updated
    description: Testing the update of a load balancer with ansible
    wait: true
    wait_timeout: 500
    state: update

# Add server to a load balancer.

- oneandone_load_balancer:
    auth_token: oneandone_private_api_key
    load_balancer: ansible load balancer updated
    description: Adding server to a load balancer with ansible
    add_server_ips:
     - server identifier (id or name)
    wait: true
    wait_timeout: 500
    state: update

# Remove server from a load balancer.

- oneandone_load_balancer:
    auth_token: oneandone_private_api_key
    load_balancer: ansible load balancer updated
    description: Removing server from a load balancer with ansible
    remove_server_ips:
     - B2504878540DBC5F7634EB00A07C1EBD (server's ip id)
    wait: true
    wait_timeout: 500
    state: update

# Add rules to a load balancer.

- oneandone_load_balancer:
    auth_token: oneandone_private_api_key
    load_balancer: ansible load balancer updated
    description: Adding rules to a load balancer with ansible
    add_rules:
     -
       protocol: TCP
       port_balancer: 70
       port_server: 70
       source: 0.0.0.0
     -
       protocol: TCP
       port_balancer: 60
       port_server: 60
       source: 0.0.0.0
    wait: true
    wait_timeout: 500
    state: update

# Remove rules from a load balancer.

- oneandone_load_balancer:
    auth_token: oneandone_private_api_key
    load_balancer: ansible load balancer updated
    description: Adding rules to a load balancer with ansible
    remove_rules:
     - rule_id #1
     - rule_id #2
     - ...
    wait: true
    wait_timeout: 500
    state: update

Возвращаемые значения

Общие возвращаемые значения описаны здесь, следующие поля уникальны для данного модуля:

Ключ Возвращаемое значение Описание
load_balancer
словарь
всегда
Информация о балансировщике нагрузки, который был обработан

Пример:
{"id": "92B74394A397ECC3359825C1656D67A6", "name": "Балансировщик по умолчанию"}


Статус

  • Гарантия обратной совместимости интерфейса этого модуля не предоставляется. [превью]
  • Этот модуль поддерживается сообществом Ansible. [community]

Авторы

  • Amel Ajdinovic (@aajdinov)
  • Ethan Devenport (@edevenport)

Подсказка

Если вы обнаружите какие-либо проблемы в этой документации, вы можете отредактировать этот документ для его улучшения.

© 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/oneandone_load_balancer_module.html

Spec-Zone.ru

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