Spec-Zone.ru › Ansible 2.6

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
обязательно
Сохранение состояния.
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
bool
    Варианты:
  • no
  • yes ←
Ожидание состояния 'running' экземпляра перед возвратом
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
dict
всегда
Информация о балансировщике нагрузки, который был обработан

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


Статус

Этот модуль помечен как preview, что означает, что его интерфейс не гарантируется как обратный.

Техническое обслуживание

Этот модуль помечен как community, что означает, что он поддерживается сообществом Ansible. Подробнее см. Техническое обслуживание модулей и поддержка.

Список других модулей, также поддерживаемых сообществом Ansible, см. здесь.

Автор

  • 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.6/modules/oneandone_load_balancer_module.html

Spec-Zone.ru

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