Справочник on PIG.CENTER

YAML Параметры конфигурации

Mon, 01 Jan 0001 00:00:00 +0000

Глобальный/Всемирный

thread_pool_size: размер пула потоков, используемый Patroni для выполнения асинхронных задач и обмена данными по REST API с другими участниками во время выбора лидера или проверок в аварийном режиме. Минимальное значение — 5, значение по умолчанию — 5.
thread_stack_size: указывает размер стека, используемый для потоков, запускаемых Patroni. Значение должно быть выровнено по 64kB. Минимальное значение — 64kB, значение по умолчанию (устанавливается Patroni) — 512kB.
name: имя хоста. Должно быть уникальным для кластера. Значение __patroni_strict_sync_replica_placeholder__ зарезервировано для внутреннего использования Patroni и не может использоваться в качестве имени узла.
namespace: путь внутри хранилища конфигурации, где Patroni будет хранить информацию о кластере. Значение по умолчанию: “/service”
scope: имя кластера

Настройки динамической конфигурации

Mon, 01 Jan 0001 00:00:00 +0000

Динамическая конфигурация хранится в DCS (распределённое хранилище конфигурации) и применяется ко всем узлам кластера.

Чтобы изменить динамическую конфигурацию, можно использовать либо инструмент patronictl_edit_config , либо Patroni REST API .

loop_wait: количество секунд, в течение которых цикл будет спать. Значение по умолчанию: 10, минимально возможное значение: 1
ttl: TTL для получения блокировки лидера (в секундах). Представьте это как продолжительность времени до начала процесса автоматического переключения при отказе. Значение по умолчанию: 30, минимально возможное значение: 20
retry_timeout: тайм-аут повторных попыток операций DCS и PostgreSQL (в секундах). DCS или сетевые проблемы, короче этого времени, не приведут к демотированию лидера. Значение по умолчанию: 10, минимально возможное значение: 3

Предупреждение

при изменении значений loop_wait, retry_timeout или ttl необходимо соблюдать следующее правило:

Конфигурация: pgbouncer.ini

Mon, 01 Jan 0001 00:00:00 +0000

Описание

Файл конфигурации имеет формат «ini». Имена секций заключаются между [ и ]. Строки, начинающиеся с ; или #, считаются комментариями и игнорируются. Символы ; и # не имеют специального значения в других позициях строки.

Общие параметры

logfile

Задаёт файл журнала. Для демонизации (-d) обязательно задать этот параметр или syslog.

Файл журнала остаётся открытым, поэтому после ротации следует выполнить kill -HUP или RELOAD; в консоли. В Windows службу необходимо остановить и запустить.

Patroni конфигурация

Mon, 01 Jan 0001 00:00:00 +0000

Существует 3 типов конфигурации Patroni:

Глобальная динамическая конфигурация .
Эти параметры хранятся в DCS (распределённое хранилище конфигурации) и применяются ко всем узлам кластера. Динамическая конфигурация может быть установлена в любой момент с помощью инструмента patronictl_edit_config или Patroni REST API . Если изменённые параметры не входят в начальную конфигурацию, они применяются асинхронно (при следующем цикле пробуждения) на каждом узле, после чего узел перезагружается. Если узлу требуется перезапуск для применения конфигурации (для параметров PostgreSQL с контекстом postmaster, если их значения изменились), в members.data JSON устанавливается специальный флаг pending_restart. Кроме того, состояние узла указывает на это, отображая "restart_pending": true.

Настройки конфигурации среды

Mon, 01 Jan 0001 00:00:00 +0000

Возможно переопределить некоторые параметры конфигурации, определённые в файле конфигурации Patroni, с помощью переменных среды системы. В данном документе перечислены все переменные среды, обрабатываемые Patroni. Значения, установленные с помощью этих переменных, всегда имеют приоритет перед значениями, заданными в файле конфигурации Patroni.

Глобальный/Всемирный

PATRONI_CONFIGURATION: конфигурацию Patroni целиком можно задать с помощью переменной среды PATRONI_CONFIGURATION . В этом случае никакие другие переменные среды не будут учитываться!
PATRONI_THREAD_POOL_SIZE: размер пула потоков, используемый Patroni для выполнения асинхронных задач и обмена данными по REST API с другими участниками во время выбора лидера или проверок в аварийном режиме. Минимальное значение — 5, значение по умолчанию — 5.
PATRONI_THREAD_STACK_SIZE: указывает размер стека, используемый для потоков, запускаемых Patroni. Значение должно быть выровнено по 64kB. Минимальное значение — 64kB, значение по умолчанию (устанавливается Patroni) — 512kB.
PATRONI_NAME: имя узла, на котором выполняется текущая инстанция Patroni. Должно быть уникальным для кластера. Значение __patroni_strict_sync_replica_placeholder__ зарезервировано для внутреннего использования Patroni и не может использоваться в качестве имени узла.
PATRONI_NAMESPACE: путь в хранилище конфигурации, где Patroni будет хранить информацию о кластере. Значение по умолчанию: “/service”
PATRONI_SCOPE: имя кластера
PG_MALLOC_ARENA_MAX: пользовательское значение переменной среды MALLOC_ARENA_MAX для процесса postmaster. Если не задано, postmaster унаследует значение MALLOC_ARENA_MAX.

Журнал

PATRONI_LOG_TYPE: задаёт формат логов. Может быть либо plain, либо json. Для использования формата json необходимо установить jsonlogger . Значение по умолчанию — plain.
PATRONI_LOG_LEVEL: задаёт уровень ведения журнала. Значение по умолчанию — INFO (см. документацию по ведению журнала в Python )
PATRONI_LOG_TRACEBACK_LEVEL: задаёт уровень, на котором будут видны трассировки. Значение по умолчанию — ERROR. Установите значение DEBUG, если хотите видеть трассировки только при включении PATRONI_LOG_LEVEL=DEBUG.
PATRONI_LOG_FORMAT: задаёт строку форматирования журнала. Если тип журнала — plain, формат журнала должен быть строкой. См. атрибуты LogRecord для получения списка доступных атрибутов. Если тип журнала — json, формат журнала может быть списком, помимо строки. Каждый элемент списка должен соответствовать атрибуту LogRecord. Будьте осторожны: требуется только имя поля, а символы %( и ) опускаются. Если необходимо вывести поле журнала с другим именем ключа, используйте словарь, где ключ словаря — это поле журнала, а значение — имя поля, которое должно быть выведено в журнале. Значение по умолчанию: %(asctime)s %(levelname)s: %(message)s
PATRONI_LOG_DATEFORMAT: задаёт строку форматирования даты и времени. (см. документацию formatTime() )
PATRONI_LOG_STATIC_FIELDS: добавить дополнительные поля в лог. Этот параметр доступен только при установке типа лога в json. Пример PATRONI_LOG_STATIC_FIELDS="{app: patroni}"
PATRONI_LOG_MAX_QUEUE_SIZE: Patroni использует двухэтапное ведение журнала. Записи журнала записываются в очереди в оперативной памяти, а отдельный поток извлекает их из очереди и записывает в stderr или файл. Максимальный размер внутренней очереди по умолчанию ограничен 1000 записями, что достаточно для хранения журналов за последние 1 час 20 минут.
PATRONI_LOG_DIR: Каталог для записи журналов приложения. Каталог должен существовать и быть доступен для записи пользователем, запускающим Patroni. Если задан этот параметр среды, приложение по умолчанию сохраняет журналы 4 25MB. Значения хранения можно настроить с помощью PATRONI_LOG_FILE_NUM и PATRONI_LOG_FILE_SIZE (см. ниже).
PATRONI_LOG_MODE: Разрешения для файлов журнала (например, 0644). Если не указано, разрешения будут установлены на основе текущего значения umask.
PATRONI_LOG_FILE_NUM: Количество журналов приложений, которые необходимо сохранить.
PATRONI_LOG_FILE_SIZE: Размер файла patroni.log (в байтах), при достижении которого происходит смена лог-файла.
PATRONI_LOG_LOGGERS: Переопределение уровня ведения журнала для каждого модуля Python. Пример PATRONI_LOG_LOGGERS="{patroni.postmaster: WARNING, urllib3: DEBUG}"
PATRONI_LOG_DEDUPLICATE_HEARTBEAT_LOGS: Если установлено в true, последовательные журналы heartbeat, одинаковые по содержанию, не будут выводиться. Значение по умолчанию — false.

Предупреждение

Время выполнения цикла высокой доступности может быть очень полезной информацией при диагностике переключений при отказе из-за нехватки ресурсов и подобных проблем. Когда PATRONI_LOG_DEDUPLICATE_HEARTBEAT_LOGS установлен в true, журналы не будут содержать записи о выполнении цикла высокой доступности (если только не произойдёт смена лидера), и, таким образом, эта потенциально полезная информация станет недоступной в журналах.

Patroni REST API

Mon, 01 Jan 0001 00:00:00 +0000

Patroni предоставляет обширный REST API. Сам Patroni использует его во время выбора лидера, инструмент patronictl — для аварийных и плановых переключений, повторной инициализации, перезапусков и перезагрузки конфигурации, а HAProxy и другие балансировщики — для проверок работоспособности HTTP. API также можно применять для мониторинга. Ниже перечислены конечные точки REST API Patroni.

Конечные точки проверки работоспособности

На все запросы проверки GET Patroni возвращает документ JSON с состоянием узла и код состояния HTTP. Если документ JSON не нужен, вместо GET можно использовать метод HEAD или OPTIONS.

Справочник команд

Mon, 01 Jan 0001 00:00:00 +0000

Введение

Команды используются для выполнения различных функций pgBackRest. Здесь перечислены исчерпывающе все параметры команд, то есть каждый параметр, применимый к команде, указан вместе с этой командой, даже если он применим к одной или нескольким другим командам. Это включает все параметры, которые также могут быть настроены в pgbackrest.conf.

Опции, не являющиеся логическими, настроенные в pgbackrest.conf, могут быть сброшены на значения по умолчанию на командной строке с использованием префикса reset-. Эта функция может использоваться для восстановления резервной копии непосредственно на сервере репозитория. Обычно pgBackRest выдает ошибку, поскольку видит, что хост базы данных удалённый, и восстановление не может выполняться удалённо. Добавив --reset-pg1-host на командной строке, pgBackRest проигнорирует удалённый хост базы данных и выполнит восстановление локально. Возможно, потребуется передать новый --pg1-path, чтобы заставить восстановление произойти в определённом пути, i.e, а не в пути, использованном на хосте базы данных.

Документация HAProxy 3.4.4

Mon, 01 Jan 0001 00:00:00 +0000

HAProxy — свободный, быстрый и надёжный обратный прокси для обеспечения высокой доступности, балансировки нагрузки TCP и HTTP и управления трафиком приложений. Английское издание содержит полный текст трёх основных руководств HAProxy 3.4, организованных в единую плоскую последовательность страниц Markdown для чтения в OINK. Русское издание публикует готовые переводы; ссылки на ещё не переведённые страницы открывают английскую версию.

Выберите руководство

Руководство для начинающих — 9 тем о принципах балансировки нагрузки, архитектуре HAProxy, возможностях, выборе ресурсов, выпусках и экосистеме.
Руководство по конфигурации — 12 глав о прокси, ACL, образцах, ведении журнала, фильтрах и всех семействах параметров.
Руководство по управлению — 13 глав о запуске, перезагрузке конфигурации, ресурсах, ведении журнала, статистике, CLI времени выполнения, отладке и безопасности.

Охват издания

Руководство	Исходный материал проекта	Локальная организация
Руководство для начинающих	1,695 строк	9 страниц тем без вложенности
Руководство по конфигурации	33,148 строк	12 страниц глав без вложенности
Руководство по управлению	5,285 строк	13 страниц глав без вложенности

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

patronictl

Mon, 01 Jan 0001 00:00:00 +0000

Patroni предоставляет интерфейс командной строки patronictl , предназначенный главным образом для взаимодействия с REST API Patroni и DCS. Он упрощает операции с кластером и удобен как людям, так и сценариям.

Конфигурация

patronictl использует 3 раздела конфигурации:

ctl: способ аутентификации в REST API Patroni и проверки подлинности сервера. Подробнее см. параметры ctl ;
restapi: способ аутентификации в REST API Patroni и проверки подлинности сервера. Используется, только если конфигурации ctl недостаточно. patronictl в основном использует раздел restapi.authentication, если отсутствует ctl.authentication, и параметр restapi.cafile, если отсутствует ctl.cacert. Подробнее см. параметры REST API ;
DCS, например etcd: способ подключения и аутентификации в DCS, используемом Patroni.

Эти параметры можно получить из переменных окружения или файла конфигурации. Способы их задания описаны в соответствующих разделах Параметров конфигурации окружения и Параметров конфигурации YAML .

Загрузка исходных выпусков

Mon, 01 Jan 0001 00:00:00 +0000

PgBouncer 1.25

Файл	Дата	Размер	SHA256
pgbouncer-1.25.2.tar.gz	2026-05-08	865371 bytes	sha256
pgbouncer-1.25.1.tar.gz	2025-12-03	864801 bytes	sha256
pgbouncer-1.25.0.tar.gz	2025-11-09	863322 bytes	sha256

PgBouncer 1.24

Файл	Дата	Размер	SHA256
pgbouncer-1.24.1.tar.gz	2025-04-16	717796 bytes	sha256
pgbouncer-1.24.0.tar.gz	2025-01-10	706573 bytes	sha256

PgBouncer 1.23

Файл	Дата	Размер	SHA256
pgbouncer-1.23.1.tar.gz	2024-08-02	700025 bytes	sha256
pgbouncer-1.23.0.tar.gz	2024-07-03	694845 bytes	sha256

PgBouncer 1.22

Файл	Дата	Размер	SHA256
pgbouncer-1.22.1.tar.gz	2024-03-04	677351 bytes	sha256
pgbouncer-1.22.0.tar.gz	2024-01-31	670589 bytes	sha256

PgBouncer 1.21

Файл	Дата	Размер	SHA256
pgbouncer-1.21.0.tar.gz	2023-10-16	668211 bytes	sha256

PgBouncer 1.20

Файл	Дата	Размер	SHA256
pgbouncer-1.20.1.tar.gz	2023-08-09	638844 bytes	sha256
pgbouncer-1.20.0.tar.gz	2023-07-20	638020 bytes	sha256

PgBouncer 1.19

Файл	Дата	Размер	SHA256
pgbouncer-1.19.1.tar.gz	2023-05-31	623569 bytes	sha256
pgbouncer-1.19.0.tar.gz	2023-05-04	616947 bytes	sha256

PgBouncer 1.18

Файл	Дата	Размер	SHA256
pgbouncer-1.18.0.tar.gz	2022-12-12	600825 bytes	sha256

PgBouncer 1.17

Файл	Дата	Размер	SHA256
pgbouncer-1.17.0.tar.gz	2022-03-23	598294 bytes	sha256

PgBouncer 1.16

Файл	Дата	Размер	SHA256
pgbouncer-1.16.1.tar.gz	2021-11-11	591450 bytes	sha256
pgbouncer-1.16.0.tar.gz	2021-08-09	592136 bytes	sha256

PgBouncer 1.15

Файл	Дата	Размер	SHA256
pgbouncer-1.15.0.tar.gz	2020-11-19	588042 bytes	sha256

PgBouncer 1.14

Файл	Дата	Размер	SHA256
pgbouncer-1.14.0.tar.gz	2020-06-11	578955 bytes	sha256

PgBouncer 1.13

Файл	Дата	Размер	SHA256
pgbouncer-1.13.0.tar.gz	2020-04-27	574955 bytes	sha256

PgBouncer 1.12

Файл	Дата	Размер	SHA256
pgbouncer-1.12.0.tar.gz	2019-10-17	567465 bytes	sha256

PgBouncer 1.11

Файл	Дата	Размер	SHA256
pgbouncer-1.11.0.tar.gz	2019-08-27	571414 bytes	sha256

PgBouncer 1.10

Файл	Дата	Размер	SHA256
pgbouncer-1.10.0.tar.gz	2019-07-01	480571 bytes	sha256

PgBouncer 1.9

Файл	Дата	Размер	SHA256
pgbouncer-1.9.0.tar.gz	2018-08-13	469300 bytes	sha256

PgBouncer 1.8

Файл	Дата	Размер	SHA256
pgbouncer-1.8.1.tar.gz	2017-12-20	465930 bytes	sha256
pgbouncer-1.8.tar.gz	2017-12-19	465612 bytes	sha256

PgBouncer 1.7

Файл	Дата	Размер	SHA256
pgbouncer-1.7.2.tar.gz	2016-02-26	462374 bytes	sha256
pgbouncer-1.7.1.tar.gz	2016-02-18	461903 bytes	sha256
pgbouncer-1.7.tar.gz	2015-12-18	459080 bytes	sha256

PgBouncer 1.6

Файл	Дата	Размер	SHA256
pgbouncer-1.6.1.tar.gz	2015-09-03	431076 bytes	sha256
pgbouncer-1.6.tar.gz	2015-08-01	412700 bytes	sha256

PgBouncer 1.5

Файл	Дата	Размер	SHA256
pgbouncer-1.5.5.tar.gz	2015-04-09	336145 bytes	sha256
pgbouncer-1.5.4.tar.gz	2012-11-28	339610 bytes	sha256
pgbouncer-1.5.3.tar.gz	2012-09-12	339013 bytes	sha256
pgbouncer-1.5.2.tar.gz	2012-05-29	335338 bytes	sha256
pgbouncer-1.5.1.tar.gz	2012-04-17	334413 bytes	sha256
pgbouncer-1.5.tar.gz	2012-01-05	411488 bytes	sha256

PgBouncer 1.4

Файл	Дата	Размер	SHA256
pgbouncer-1.4.2.tgz	2011-06-16	283204 bytes	sha256
pgbouncer-1.4.1.tgz	2011-04-01	282728 bytes	sha256
pgbouncer-1.4.tgz	2011-01-11	231691 bytes	sha256

PgBouncer 1.3

Файл	Дата	Размер	SHA256
pgbouncer-1.3.4.tgz	2010-09-09	167957 bytes	sha256
pgbouncer-1.3.3.tgz	2010-05-10	167476 bytes	sha256
pgbouncer-1.3.2.tgz	2010-03-15	166756 bytes	sha256
pgbouncer-1.3.1.tgz	2009-07-06	161518 bytes	sha256
pgbouncer-1.3.tgz	2009-02-18	160154 bytes	sha256

PgBouncer 1.2

Файл	Дата	Размер	SHA256
pgbouncer-1.2.3.tgz	2008-08-08	145372 bytes	sha256
pgbouncer-1.2.2.tgz	2008-08-06	145017 bytes	sha256
pgbouncer-1.2.1.tgz	2008-08-04	144903 bytes	sha256
pgbouncer-1.2.tgz	2008-07-29	143915 bytes	sha256

PgBouncer 1.1

Файл	Дата	Размер	SHA256
pgbouncer-1.1.2.tgz	2007-12-10	122054 bytes	sha256
pgbouncer-1.1.1.tgz	2007-10-26	121042 bytes	sha256
pgbouncer-1.1.tgz	2007-10-09	120462 bytes	sha256

PgBouncer 1.0

Файл	Дата	Размер	SHA256
pgbouncer-1.0.8.tgz	2007-06-18	93636 bytes	sha256
pgbouncer-1.0.7.tgz	2007-04-19	93086 bytes	sha256
pgbouncer-1.0.6.tgz	2007-04-12	92244 bytes	sha256
pgbouncer-1.0.5.tgz	2007-04-11	91934 bytes	sha256
pgbouncer-1.0.4.tgz	2007-04-11	91889 bytes	sha256
pgbouncer-1.0.3.tgz	2007-04-11	91489 bytes	sha256
pgbouncer-1.0.2.tgz	2007-03-28	90555 bytes	sha256
pgbouncer-1.0.1.tgz	2007-03-15	89609 bytes	sha256
pgbouncer-1.0.tgz	2007-03-13	88587 bytes	sha256

Двоичные пакеты

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

Команда справки (help)

Mon, 01 Jan 0001 00:00:00 +0000

Предоставляется три уровня справки. Если команда не указана, будет отображена общая справка. Если указана команда (e.g. pgbackrest help backup), будет отображено полное описание команды вместе со списком допустимых параметров. Если указать параметр вместе с командой (e.g. pgbackrest help backup type), будет отображено полное описание параметра применительно к команде.

Опции команды

Показать сведения о параметре помощи (`--help`)

Показать справку.

Отображает справку даже если команда help не указана и переопределяет опцию --version.

Журнал изменений

Mon, 01 Jan 0001 00:00:00 +0000

PgBouncer 1.25.x

2026-05-08 - PgBouncer 1.25.2 - «Человеческое прикосновение и новый поворот в полной неопределённости борьбе за титул»

Безопасность
- Исправлена CVE-2026-6664: целочисленное переполнение в коде разбора сетевых пакетов в PgBouncer до 1.25.2 позволяло обойти проверку границ и могло привести к аварийному завершению. Неаутентифицированный удалённый злоумышленник мог вывести PgBouncer из строя некорректным пакетом аутентификации SCRAM.
- Исправлена CVE-2026-6665: код SCRAM в PgBouncer до 1.25.2 неверно проверял возвращаемое значение strlcat() при построении содержимого SCRAM client-final-message. Злонамеренный бэкенд, отправивший SCRAM server-final-message с длинным nonce, мог вызвать переполнение стека.
- Исправлена CVE-2026-6666: возможное обращение по нулевому указателю в PgBouncer до 1.25.2 могло привести к аварийному завершению, если сервер отправлял ответ об ошибке без поля SQLSTATE.
- Исправлена CVE-2026-6667: PgBouncer до 1.25.2 не выполнял надлежащую проверку авторизации для административной команды KILL_CLIENT. Её могли выполнять все пользователи с доступом к административной консоли, хотя сама консоль требует авторизации. Команда должна быть разрешена только пользователям, перечисленным в параметре admin_users.
Исправления

Расчёт ресурсов и производительность

Mon, 01 Jan 0001 00:00:00 +0000

Типичные показатели использования CPU: в режиме TCP или HTTP с закрытием соединений на HAProxy приходится 15% времени обработки, а на ядро — 85%; в режиме постоянных соединений HTTP на HAProxy приходится около 30%, а на ядро — 70%. Это означает, что операционная система и её настройка сильно влияют на общую производительность.

Сценарии использования сильно различаются: одни пользователи ориентируются на пропускную способность, другие — на интенсивность запросов, число одновременных соединений или производительность SSL. В этом разделе приведены некоторые сведения, помогающие оценить необходимые ресурсы.

Часто задаваемые вопросы

Mon, 01 Jan 0001 00:00:00 +0000

Как подключиться к PgBouncer?

PgBouncer работает как сервер Postgres, поэтому достаточно направить клиент на порт PgBouncer.

Как распределять запросы между несколькими серверами?

PgBouncer не имеет встроенной конфигурации для нескольких узлов. Распределение можно реализовать внешними средствами:

Циклический перебор DNS. Укажите несколько IP-адресов для одного имени DNS. PgBouncer не выполняет поиск DNS при каждом новом соединении: он кэширует все IP-адреса и перебирает их циклически. Обратите внимание: если с одним именем связано более 8 IP-адресов, бэкенд DNS должен поддерживать протокол EDNS0. Подробности приведены в README.

Документация и сообщество

Mon, 01 Jan 0001 00:00:00 +0000

1. Доступная документация

Полная документация HAProxy содержится в перечисленных ниже документах. Обращайтесь к соответствующей документации, чтобы сэкономить время и получить наиболее точный ответ на свой вопрос. Также воздержитесь от отправки в список рассылки вопросов, ответы на которые уже есть в этих документах.

intro.txt (этот документ): здесь представлены основы балансировки нагрузки, HAProxy как продукт, его возможности и ограничения, известные подводные камни, которых следует избегать, некоторые ограничения конкретных ОС, способы получения, развитие проекта, способы убедиться, что используются все известные исправления, обновление, дополнения и альтернативы.

Команда сервера (server)

Mon, 01 Jan 0001 00:00:00 +0000

Сервер pgBackRest позволяет осуществлять доступ с удалённых хостов без использования протокола SSH.

Опции команды

TLS Параметр адреса сервера (`--tls-server-address`)

Адрес сервера TLS.

IP-адрес, на котором сервер будет слушать запросы клиентов.

default: localhost
example: --tls-server-address=*

TLS Параметр авторизованных клиентов сервера (`--tls-server-auth`)

TLS сервер авторизованных клиентов.

Клиенты авторизуются на сервере путём проверки их сертификата и проверки соответствия имени субъекта (CN) сертификата списку на сервере, настроенного с помощью опции tls-server-auth.

2. Настройка HAProxy

Mon, 01 Jan 0001 00:00:00 +0000

2.1. Формат файла конфигурации

Процесс конфигурации HAProxy включает 3 основных источников параметров:

аргументы из командной строки, которые всегда имеют приоритет
конфигурационный файл, формат которого описан здесь
окружение запущенного процесса, в случае если явно указаны переменные среды

Конфигурационный файл следует довольно простому иерархическому формату, который соблюдает несколько базовых правил:

1. a configuration file is an ordered sequence of statements

2. a statement is a single non-empty line before any unprotected "#" (hash)

3. a line is a series of tokens or "words" delimited by unprotected spaces or
 tab characters

4. the first word or sequence of words of a line is one of the keywords or
 keyword sequences listed in this document

5. all other words are all arguments of the first one, some being well-known
 keywords listed in this document, others being values, references to other
 parts of the configuration, or expressions

6. certain keywords delimit a section inside which only a subset of keywords
 are supported

7. a section ends at the end of a file or on a special keyword starting a new
 section

Это всё, что нужно знать, чтобы написать простой, но надёжный генератор конфигурации, но это недостаточно для надёжного парсинга любой конфигурации и для определения того, как обрабатывать определённые крайние случаи.

Команда проверки доступности сервера (server-ping)

Mon, 01 Jan 0001 00:00:00 +0000

Проверьте доступность сервера pgBackRest TLS с помощью ping, чтобы убедиться, что он принимает соединения. Это служит проверкой работоспособности, так как аутентификация не выполняется.

Если на командной строке не указан хост, будет использован параметр tls-server-host.

Опции команды

TLS Параметр адреса сервера (`--tls-server-address`)

Адрес сервера TLS.

IP-адрес, на котором сервер будет слушать запросы клиентов.

default: localhost
example: --tls-server-address=*

Параметр порта сервера TLS (`--tls-server-port`)

Порт сервера TLS.

5. Параметры bind и server

Mon, 01 Jan 0001 00:00:00 +0000

Ключи “bind”, “server” и “default-server” поддерживают ряд настроек, зависящих от некоторых опций сборки и от системы, на которой был собран HAProxy. Эти настройки в целом состоят из одного слова, иногда сопровождаемого значением, записанным на той же строке, что и строка “bind” или “server”. Все эти опции описаны в этой секции.

5.1. Параметры bind

Ключ “bind” поддерживает определённое количество настроек, которые передаются как аргументы на той же строке. Порядок, в котором эти аргументы приводятся, не имеет значения, при условии, что они находятся после адреса привязки. Все эти параметры являются необязательными. Некоторые из них состоят из одного слова (логические значения), в то время как другие ожидает значение после них. В этом случае значение должно быть указано немедленно после имени настройки.

6. Кеш

Mon, 01 Jan 0001 00:00:00 +0000

HAProxy предоставляет кеш, предназначенный для небольших объектов (favicon, css и т. п.). Это минималистичный кеш в оперативной памяти, не требующий сложного обслуживания.

Кеш использует общую для всех потоков область памяти, разделённую на блоки по 1kB.

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

Часто задаваемые вопросы

Mon, 01 Jan 0001 00:00:00 +0000

В этом разделе приведены ответы на самые частые вопросы о Patroni. Каждый подраздел посвящён отдельной категории вопросов.

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

Сравнение с другими решениями HA

Почему Patroni требует отдельный кластер узлов DCS, а другие решения наподобие repmgr — нет?
Решения HA можно реализовать разными способами, каждый со своими преимуществами и недостатками.

Примечания к выпускам

Mon, 01 Jan 0001 00:00:00 +0000

Версия 4.1.5

Выпущено 2026-08-12

Улучшения совместимости

Совместимость с PostgreSQL 14.24, 15.19, 16.15, 17.11, 18.6 (Alexander Kukushkin)

Добавьте новый output_plugin_libraries GUC, который ограничивает вывод плагинов логического декодирования.

Улучшения

Записывать REST предупреждения о сбросе API соединений в DEBUG вместо WARNING (Kyle McLaren)

Убедитесь, что распространенные варианты “клиент неожиданно завершил операцию записи” не влияют на обработку реальных (не связанных с соединением) ошибок.

Исправления ошибок

Исправить выравнивание при проверке thread_stack_size (Sundong Kim)

9. Поддерживаемые фильтры

Mon, 01 Jan 0001 00:00:00 +0000

Ниже перечислены официально поддерживаемые фильтры и принимаемые ими параметры. В зависимости от параметров сборки некоторые фильтры могут быть недоступны. Список доступных фильтров выводится командой haproxy -vv.

См. также: «filter».

9.1. Трассировка

filter trace [name <name>] [random-forwarding] [max-fwd <max>] [hexdump]

Аргументы:

<name> is an arbitrary name that will be reported in
 messages. If no name is provided, "TRACE" is used.

<quiet> inhibits trace messages.

<random-forwarding> enables the random forwarding of parsed data. By
 default, this filter forwards all previously parsed
 data. With this parameter, it only forwards a random
 amount of the parsed data.

<max> is the maximum amount of data that can be forwarded at
 a time. "max-fwd" option can be combined with the
 random forwarding. <max> must be an positive integer.
 0 means there is no limit.

<hexdump> dumps all forwarded data to the server and the client.

Этот фильтр можно использовать как основу для разработки новых фильтров. Он определяет все обратные вызовы и для каждого из них выводит в стандартный поток ошибок (stderr) сообщение с полезными сведениями. Это может пригодиться для отладки работы других фильтров или самого HAProxy.

Команда версии (version)

Mon, 01 Jan 0001 00:00:00 +0000

Отображает установленную версию pgBackRest.

Опции команды

Параметр вывода (`--output`)

Тип вывода.

Поддерживаются следующие типы вывода:

text — Отображает установленную версию pgBackRest в виде текста.
num — Отображает установленную версию pgBackRest в виде целого числа.

default: text
example: --output=num

10. Приложения FastCGI

Mon, 01 Jan 0001 00:00:00 +0000

HAProxy может отправлять запросы HTTP приложениям FastCGI с ролью Responder. Эта возможность добавлена в HAProxy 2.1. Для её использования серверы необходимо настроить на протокол FastCGI (с помощью «proto fcgi» в строке server), а в управляющем ими бэкенде нужно настроить и подключить приложение FastCGI (с помощью «use-fcgi-app» в секции прокси). Можно определить несколько приложений FastCGI, но бэкенд одновременно может использовать только одно из них.

11. Таблицы привязок и одноранговые узлы

Mon, 01 Jan 0001 00:00:00 +0000

Таблицы привязок в HAProxy — это механизм, позволяющий ассоциировать определённое количество информации и метрик с ключом определённого типа на определённый срок после последнего обновления. Это можно рассматривать как строку в таблице с несколькими столбцами, где номер строки определяется значением ключа, а столбцы представляют отдельные критерии.

Таблицы привязок изначально были спроектированы для хранения информации о привязке сеанса между клиентом и сервером с целью поддержания постоянных сессий между этими сущностями. Клиент подключается или отправляет запрос, клиент идентифицируется с помощью дискриминатора (источний адрес, кука, URL параметр), и выбранный сервер сохраняется в ассоциации с этим дискриминатором в таблице привязок на заданное время, чтобы последующие запросы от того же клиента автоматически направлялись на тот же сервер, где клиент создавал свою сессию приложения.

12. Другие секции

Mon, 01 Jan 0001 00:00:00 +0000

Секции, описанные ниже, реже используются и обычно поддерживают лишь несколько параметров. Между ними нет неявной связи. Они все начинаются с одного ключевого слова. Ни одна из них не допускается до секции “global”. Поддержка некоторых из них может зависеть от опций сборки (например, что касается SSL).

12.1. Трассировка

Для отладки можно включить трассировку подсистемы HAProxy. При этом выводятся отладочные сообщения об определённой подсистеме. Это мощное средство диагностики проблем. Трассировку можно динамически настраивать через CLI. Некоторые параметры также можно заранее задать в файле конфигурации, в отдельных секциях “traces”. Подробнее о трассировке см. руководство по управлению. Это инструмент разработчика для сложных сеансов отладки. Он выводит много сообщений и требует дополнительных ресурсов, поэтому используйте его осторожно. Поскольку это инструмент разработчика, обратная совместимость этой секции не гарантируется.

Функциональные шлюзы

Mon, 01 Jan 0001 00:00:00 +0000

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

Описание стадий возможностей приведено в разделе стадий возможностей .

Обзор

Функциональные шлюзы — набор пар key=value, описывающих возможности etcd. Возможности включаются и отключаются флагом командной строки --feature-gates процесса etcd.

etcd позволяет включить или отключить набор функциональных шлюзов. Полный список можно увидеть с помощью флага -h. Чтобы задать шлюзы, присвойте флагу --feature-gates список пар возможностей в командной строке:

Часто задаваемые вопросы

Mon, 01 Jan 0001 00:00:00 +0000

Общие вопросы об etcd

Что такое etcd?

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

Как произносится etcd?

etcd произносится как /ˈɛtsiːdiː/ и означает «распределённый каталог etc».

Должны ли клиенты отправлять запросы лидеру etcd?

Raft основан на лидере: лидер обрабатывает все клиентские запросы, требующие консенсуса кластера. Однако клиенту не нужно знать, какой узел является лидером. Любой требующий консенсуса запрос, отправленный последователю, автоматически пересылается лидеру. Запросы, не требующие консенсуса (например, сериализуемое чтение), может обработать любой участник кластера.

Библиотеки и инструменты

Mon, 01 Jan 0001 00:00:00 +0000

Обратите внимание: перечисленные ниже сторонние библиотеки и инструменты (размещённые не на https://github.com/etcd-io ) не тестируются и не сопровождаются командой etcd. Перед использованием рекомендуется прочитать и изучить их документацию и исходный код.

Инструменты

etcdctl — клиент командной строки для etcd
etcd-dump — утилита командной строки для выгрузки и восстановления etcd.
etcd-fs — файловая система FUSE для etcd
etcddir — синхронизация etcd с локальным каталогом в реальном времени. Работает в Windows и Linux.
etcd-browser — веб-редактор ключей и значений etcd на AngularJS
etcd-lock — реализация выборов главного узла и распределённой блокировки чтения/записи на основе etcd; поддерживает v2
etcd-console — веб-редактор ключей и значений etcd на PHP
etcd-viewer — редактор и средство просмотра хранилища ключей и значений etcd, написанное на Java
etcdtool — экспорт, импорт и редактирование каталога etcd в JSON/YAML/TOML, а также проверка каталога по схеме JSON
etcdloadtest — клиент командной строки для нагрузочного тестирования etcd версии 3.0 и выше.
etcd-tui — современный терминальный пользовательский интерфейс (TUI) для работы с базой данных etcd. Позволяет переходить по ключам, просматривать значения, фильтровать данные и управлять кластером etcd непосредственно из терминала.
etcdfinder — сверхбыстрый современный веб-интерфейс etcd с мгновенным поиском. Поддерживает etcd v2 и v3.
lucas — веб-средство просмотра ключей и значений для кластера kubernetes etcd3.0+.
etcd-manager — современный, эффективный, многоплатформенный и бесплатный графический интерфейс и клиентский инструмент etcd 3.x. Доступен для Windows, Linux и Mac.
etcd-backup-restore — утилита для периодического инкрементного резервного копирования и восстановления etcd.
etcd-druid — оператор Kubernetes для развёртывания кластеров etcd и управления эксплуатационными операциями 2-го дня.
etcdadm — инструмент командной строки для эксплуатации кластера etcd.
etcd-defrag — более удобный и интеллектуальный инструмент дефрагментации etcd.
etcdhelper — плагин платформы intellij для etcd.

Библиотеки

В следующих разделах клиентские библиотеки etcd перечислены по языкам.

Метрики

Mon, 01 Jan 0001 00:00:00 +0000

Для публикации метрик etcd использует Prometheus . Метрики можно применять для мониторинга и отладки в реальном времени. etcd не сохраняет метрики: при перезапуске участника они сбрасываются.

Проще всего просмотреть доступные метрики, запросив конечную точку /metrics с помощью cURL. Формат описан в документации Prometheus .

Чтобы запустить сервер Prometheus для сбора метрик etcd, следуйте руководству Prometheus по началу работы .

Имена метрик соответствуют рекомендуемым практикам Prometheus . Имя метрики содержит префикс пространства имён etcd или etcd_debugging и префикс подсистемы (например, wal и etcdserver).

Протокол службы обнаружения

Mon, 01 Jan 0001 00:00:00 +0000

Протокол службы обнаружения помогает новому участнику etcd найти остальных участников на этапе начальной инициализации кластера с помощью общего URL обнаружения.

Протокол используется только при начальной инициализации и не подходит для реконфигурации во время выполнения или мониторинга кластера.

Один новый токен обнаружения предназначен для инициализации одного уникального кластера etcd. Один токен может представлять только один кластер. После запуска протокола для токена его нельзя использовать для инициализации другого кластера, даже если первый процесс завершился с ошибкой на полпути.

Протокол службы обнаружения

Mon, 01 Jan 0001 00:00:00 +0000

Протокол службы обнаружения помогает новому участнику etcd найти остальных участников на этапе начальной инициализации кластера с помощью общего токена обнаружения и списка конечных точек.

Протокол используется только во время начальной инициализации и не подходит для реконфигурации во время выполнения или мониторинга кластера.

Один новый токен обнаружения предназначен для инициализации одного уникального кластера etcd. Один токен может представлять только один кластер. После запуска протокола для токена его нельзя использовать для инициализации другого кластера etcd, даже если первый процесс завершился с ошибкой на полпути.

Соглашения по ведению журнала

Mon, 01 Jan 0001 00:00:00 +0000

etcd использует библиотеку zap для ведения журнала вывода приложения, категоризированного по уровням. Уровень сообщения в журнале определяется в соответствии со следующими соглашениями:

Логи DebugLevel обычно объёмные и обычно отключены в рабочей среде.
- Примеры:
  - Отправка обычного сообщения удалённому узлу
  - Запись записи журнала на диск
Уровень InfoLevel является уровнем ведения журнала по умолчанию.
- Примеры:
  - Конфигурация при запуске
  - Начало создания снимка
  - Добавление нового узла в кластер
  - Добавление нового пользователя в подсистему аутентификации
Журналы уровня Warn более важны, чем Info, но не требуют индивидуального человеческого контроля.

Модули Golang

Mon, 01 Jan 0001 00:00:00 +0000

Начиная с версии 3.5 проект etcd организован как несколько модулей Golang , размещённых в одном репозитории .

Проект включает следующие модули:

go.etcd.io/etcd/api/v3 — определения API, например protos и созданные из proto библиотеки, которые задают протокол взаимодействия между клиентами и сервером etcd.
go.etcd.io/etcd/pkg/v3 — набор вспомогательных пакетов, используемых etcd, но не зависящих от его специфики. Пакет следует размещать здесь только в том случае, если в будущем его можно будет вынести в отдельный репозиторий. Не добавляйте сюда код с большим числом собственных зависимостей: они автоматически станут зависимостями клиентской библиотеки, которую важно сохранять легковесной.

Глоссарий

Mon, 01 Jan 0001 00:00:00 +0000

Этот документ определяет различные термины, используемые в документации, командной строке и исходном коде etcd.

Аварийный сигнал

Сервер etcd подаёт аварийный сигнал, когда для сохранения надёжности кластера требуется вмешательство оператора.

Аутентификация

Аутентификация управляет правами доступа пользователей к ресурсам etcd.

Клиент

Клиент подключается к кластеру etcd и отправляет служебные запросы: получает пары «ключ — значение», записывает данные или наблюдает за обновлениями.

Ограничения системы

Mon, 01 Jan 0001 00:00:00 +0000

Ограничение размера запроса

etcd разработан для обработки небольших пар ключ-значение, характерных для метаданных. Более крупные запросы будут работать, но могут увеличить задержку других запросов. По умолчанию максимальный размер любого запроса составляет 1.5 MiB. Этот лимит можно настроить с помощью флага --max-request-bytes для сервера etcd.

Ограничение размера хранилища

По умолчанию ограничение размера хранилища составляет 2 GiB, настраивается с помощью флага --quota-backend-bytes. 8 GiB — рекомендуемый максимальный размер для обычных сред, etcd выдает предупреждение при запуске, если сконфигурированное значение превышает его.

Возможности etcd

Mon, 01 Jan 0001 00:00:00 +0000

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

Возможности etcd проходят три стадии: экспериментальную, стабильную и небезопасную. Получить их список можно командой etcd --help.

Экспериментальные

Чтобы получить обратную связь на раннем этапе, новые возможности обычно добавляются как экспериментальные. Их можно определить по имени флага с префиксом --experimental. При использовании экспериментальной возможности учитывайте следующее:

Справочник API

Mon, 01 Jan 0001 00:00:00 +0000

Этот справочник API автоматически создан из указанных файлов .proto.

Служба `Auth` (api/etcdserverpb/rpc.proto)

Метод	Тип запроса	Тип ответа	Описание
AuthEnable	AuthEnableRequest	AuthEnableResponse	AuthEnable включает аутентификацию.
AuthDisable	AuthDisableRequest	AuthDisableResponse	AuthDisable отключает аутентификацию.
AuthStatus	AuthStatusRequest	AuthStatusResponse	AuthStatus отображает состояние аутентификации.
Authenticate	AuthenticateRequest	AuthenticateResponse	Authenticate обрабатывает запрос аутентификации.
UserAdd	AuthUserAddRequest	AuthUserAddResponse	UserAdd добавляет нового пользователя. Имя пользователя не может быть пустым.
UserGet	AuthUserGetRequest	AuthUserGetResponse	UserGet получает подробные сведения о пользователе.
UserList	AuthUserListRequest	AuthUserListResponse	UserList получает список всех пользователей.
UserDelete	AuthUserDeleteRequest	AuthUserDeleteResponse	UserDelete удаляет указанного пользователя.
UserChangePassword	AuthUserChangePasswordRequest	AuthUserChangePasswordResponse	UserChangePassword изменяет пароль указанного пользователя.
UserGrantRole	AuthUserGrantRoleRequest	AuthUserGrantRoleResponse	UserGrant предоставляет указанному пользователю роль.
UserRevokeRole	AuthUserRevokeRoleRequest	AuthUserRevokeRoleResponse	UserRevokeRole отзывает роль указанного пользователя.
RoleAdd	AuthRoleAddRequest	AuthRoleAddResponse	RoleAdd добавляет новую роль. Имя роли не может быть пустым.
RoleGet	AuthRoleGetRequest	AuthRoleGetResponse	RoleGet получает подробные сведения о роли.
RoleList	AuthRoleListRequest	AuthRoleListResponse	RoleList получает список всех ролей.
RoleDelete	AuthRoleDeleteRequest	AuthRoleDeleteResponse	RoleDelete удаляет указанную роль.
RoleGrantPermission	AuthRoleGrantPermissionRequest	AuthRoleGrantPermissionResponse	RoleGrantPermission предоставляет указанной роли разрешение на заданный ключ или диапазон.
RoleRevokePermission	AuthRoleRevokePermissionRequest	AuthRoleRevokePermissionResponse	RoleRevokePermission отзывает у указанной роли разрешение на ключ или диапазон.

Служба `Cluster` (api/etcdserverpb/rpc.proto)

Метод	Тип запроса	Тип ответа	Описание
MemberAdd	MemberAddRequest	MemberAddResponse	MemberAdd добавляет участника в кластер.
MemberRemove	MemberRemoveRequest	MemberRemoveResponse	MemberRemove удаляет существующего участника из кластера.
MemberUpdate	MemberUpdateRequest	MemberUpdateResponse	MemberUpdate обновляет конфигурацию участника.
MemberList	MemberListRequest	MemberListResponse	MemberList перечисляет всех участников кластера.
MemberPromote	MemberPromoteRequest	MemberPromoteResponse	MemberPromote повышает обучающегося участника raft без права голоса до участника raft с правом голоса.

Служба `KV` (api/etcdserverpb/rpc.proto)

Метод	Тип запроса	Тип ответа	Описание
Range	RangeRequest	RangeResponse	Range получает ключи диапазона из хранилища ключей и значений.
Put	PutRequest	PutResponse	Put помещает заданный ключ в хранилище ключей и значений. Запрос put увеличивает ревизию хранилища и создаёт одно событие в истории событий.
DeleteRange	DeleteRangeRequest	DeleteRangeResponse	DeleteRange удаляет заданный диапазон из хранилища ключей и значений. Запрос удаления увеличивает ревизию хранилища и создаёт событие удаления в истории для каждого удалённого ключа.
Txn	TxnRequest	TxnResponse	Txn обрабатывает несколько запросов в одной транзакции. Запрос txn увеличивает ревизию хранилища ключей и значений и создаёт события с одной ревизией для каждого выполненного запроса. Многократное изменение одного ключа в одной txn недопустимо.
Compact	CompactionRequest	CompactionResponse	Compact компактизирует историю событий в хранилище ключей и значений etcd. Хранилище следует периодически компактизировать, иначе история событий будет расти бесконечно.

Служба `Lease` (api/etcdserverpb/rpc.proto)

Метод	Тип запроса	Тип ответа	Описание
LeaseGrant	LeaseGrantRequest	LeaseGrantResponse	LeaseGrant создаёт аренду, которая истекает, если сервер не получает keepAlive в течение заданного срока жизни. При истечении аренды все присоединённые к ней ключи истекают и удаляются. Каждый истёкший ключ создаёт событие удаления в истории событий.
LeaseRevoke	LeaseRevokeRequest	LeaseRevokeResponse	LeaseRevoke отзывает аренду. Все присоединённые к ней ключи истекают и удаляются.
LeaseKeepAlive	LeaseKeepAliveRequest	LeaseKeepAliveResponse	LeaseKeepAlive поддерживает аренду активной, передавая потоком запросы поддержания активности от клиента серверу и ответы от сервера клиенту.
LeaseTimeToLive	LeaseTimeToLiveRequest	LeaseTimeToLiveResponse	LeaseTimeToLive получает сведения об аренде.
LeaseLeases	LeaseLeasesRequest	LeaseLeasesResponse	LeaseLeases перечисляет все существующие аренды.

Служба `Maintenance` (api/etcdserverpb/rpc.proto)

Метод	Тип запроса	Тип ответа	Описание
Alarm	AlarmRequest	AlarmResponse	Alarm активирует, деактивирует и запрашивает аварийные сигналы о состоянии кластера.
Status	StatusRequest	StatusResponse	Status получает состояние участника.
Defragment	DefragmentRequest	DefragmentResponse	Defragment дефрагментирует базу данных бэкенда участника для освобождения места.
Hash	HashRequest	HashResponse	Hash вычисляет хеш всего пространства ключей бэкенда, включая сегменты key, lease и другие сегменты хранилища. Предназначено ТОЛЬКО для тестирования! Не полагайтесь на операцию в рабочей среде с текущими транзакциями, поскольку Hash не удерживает блокировки MVCC. Для проверки согласованности сегмента “key” используйте API “HashKV”.
HashKV	HashKVRequest	HashKVResponse	HashKV вычисляет хеш всех ключей MVCC до заданной ревизии. Перебирает только сегмент “key” в хранилище бэкенда.
Snapshot	SnapshotRequest	SnapshotResponse	Snapshot передаёт снимок всего бэкенда от участника клиенту потоком.
MoveLeader	MoveLeaderRequest	MoveLeaderResponse	MoveLeader запрашивает у текущего узла-лидера передачу лидерства назначенному узлу.
Downgrade	DowngradeRequest	DowngradeResponse	Downgrade запрашивает понижение версии, проверяет его допустимость или отменяет его для версии кластера. Поддерживается начиная с etcd 3.5.

Служба `Watch` (api/etcdserverpb/rpc.proto)

Метод	Тип запроса	Тип ответа	Описание
Watch	WatchRequest	WatchResponse	Watch наблюдает за происходящими или уже произошедшими событиями. Ввод и вывод являются потоками: входной поток создаёт и отменяет наблюдателей, выходной отправляет события. Один RPC watch может наблюдать несколько диапазонов ключей и одновременно передавать события нескольких наблюдений. Всю историю событий можно наблюдать с последней ревизии компактизации.

Сообщение `AlarmMember` (api/etcdserverpb/rpc.proto)

Поле	Описание	Тип
(versionpb.etcd_version_msg)		option
memberID	memberID — идентификатор участника, связанного с активированным аварийным сигналом.	uint64
alarm	alarm — тип активированного аварийного сигнала.	AlarmType

Сообщение `AlarmRequest` (api/etcdserverpb/rpc.proto)

Поле	Описание	Тип
(versionpb.etcd_version_msg)		option
action	action — тип отправляемого запроса аварийного сигнала. Действие может GET состояния сигналов, ACTIVATE сигнал или DEACTIVATE активированный сигнал.	AlarmAction
memberID	memberID — идентификатор участника, связанного с сигналом. Если memberID равен 0, запрос относится ко всем участникам.	uint64
alarm	alarm — тип аварийного сигнала, рассматриваемого запросом.	AlarmType

Сообщение `AlarmResponse` (api/etcdserverpb/rpc.proto)

Поле	Описание	Тип
(versionpb.etcd_version_msg)		option
header		ResponseHeader
alarms	alarms — список аварийных сигналов, связанных с запросом.	(slice of) AlarmMember

Сообщение `AuthDisableRequest` (api/etcdserverpb/rpc.proto)

Поле	Описание	Тип
(versionpb.etcd_version_msg)		option

Сообщение `AuthDisableResponse` (api/etcdserverpb/rpc.proto)

Поле	Описание	Тип
(versionpb.etcd_version_msg)		option
header		ResponseHeader

Сообщение `AuthEnableRequest` (api/etcdserverpb/rpc.proto)

Поле	Описание	Тип
(versionpb.etcd_version_msg)		option

Сообщение `AuthEnableResponse` (api/etcdserverpb/rpc.proto)

Поле	Описание	Тип
(versionpb.etcd_version_msg)		option
header		ResponseHeader

Сообщение `AuthRoleAddRequest` (api/etcdserverpb/rpc.proto)

Поле	Описание	Тип
(versionpb.etcd_version_msg)		option
name	name — имя роли, добавляемой в систему аутентификации.	string

Сообщение `AuthRoleAddResponse` (api/etcdserverpb/rpc.proto)

Поле	Описание	Тип
(versionpb.etcd_version_msg)		option
header		ResponseHeader

Сообщение `AuthRoleDeleteRequest` (api/etcdserverpb/rpc.proto)

Поле	Описание	Тип
(versionpb.etcd_version_msg)		option
role		string

Сообщение `AuthRoleDeleteResponse` (api/etcdserverpb/rpc.proto)

Поле	Описание	Тип
(versionpb.etcd_version_msg)		option
header		ResponseHeader

Сообщение `AuthRoleGetRequest` (api/etcdserverpb/rpc.proto)

Поле	Описание	Тип
(versionpb.etcd_version_msg)		option
role		string

Сообщение `AuthRoleGetResponse` (api/etcdserverpb/rpc.proto)

Поле	Описание	Тип
header		ResponseHeader
perm		(slice of) authpb.Permission

Сообщение `AuthRoleGrantPermissionRequest` (api/etcdserverpb/rpc.proto)

Поле	Описание	Тип
(versionpb.etcd_version_msg)		option
name	name — имя роли, которой будет предоставлено разрешение.	string
perm	perm — разрешение, предоставляемое роли.	authpb.Permission

Сообщение `AuthRoleGrantPermissionResponse` (api/etcdserverpb/rpc.proto)

Поле	Описание	Тип
(versionpb.etcd_version_msg)		option
header		ResponseHeader

Сообщение `AuthRoleListRequest` (api/etcdserverpb/rpc.proto)

Поле	Описание	Тип
(versionpb.etcd_version_msg)		option

Сообщение `AuthRoleListResponse` (api/etcdserverpb/rpc.proto)

Поле	Описание	Тип
(versionpb.etcd_version_msg)		option
header		ResponseHeader
roles		(slice of) string

Сообщение `AuthRoleRevokePermissionRequest` (api/etcdserverpb/rpc.proto)

Поле	Описание	Тип
(versionpb.etcd_version_msg)		option
role		string
key		bytes
range_end		bytes

Сообщение `AuthRoleRevokePermissionResponse` (api/etcdserverpb/rpc.proto)

Поле	Описание	Тип
(versionpb.etcd_version_msg)		option
header		ResponseHeader

Сообщение `AuthStatusRequest` (api/etcdserverpb/rpc.proto)

Поле	Описание	Тип
(versionpb.etcd_version_msg)		option

Сообщение `AuthStatusResponse` (api/etcdserverpb/rpc.proto)

Поле	Описание	Тип
(versionpb.etcd_version_msg)		option
header		ResponseHeader
enabled		bool
authRevision	authRevision — текущая ревизия хранилища аутентификации	uint64

Сообщение `AuthUserAddRequest` (api/etcdserverpb/rpc.proto)

Поле	Описание	Тип
(versionpb.etcd_version_msg)		option
name		string
password		string
options		authpb.UserAddOptions
hashedPassword		string

Сообщение `AuthUserAddResponse` (api/etcdserverpb/rpc.proto)

Поле	Описание	Тип
(versionpb.etcd_version_msg)		option
header		ResponseHeader

Сообщение `AuthUserChangePasswordRequest` (api/etcdserverpb/rpc.proto)

Поле	Описание	Тип
(versionpb.etcd_version_msg)		option
name	name — имя пользователя, пароль которого изменяется.	string
password	password — новый пароль пользователя. Обратите внимание: это поле будет удалено на уровне API.	string
hashedPassword	hashedPassword — новый пароль пользователя. Обратите внимание: это поле будет инициализировано на уровне API.	string

Сообщение `AuthUserChangePasswordResponse` (api/etcdserverpb/rpc.proto)

Поле	Описание	Тип
(versionpb.etcd_version_msg)		option
header		ResponseHeader

Сообщение `AuthUserDeleteRequest` (api/etcdserverpb/rpc.proto)

Поле	Описание	Тип
(versionpb.etcd_version_msg)		option
name	name — имя удаляемого пользователя.	string

Сообщение `AuthUserDeleteResponse` (api/etcdserverpb/rpc.proto)

Поле	Описание	Тип
(versionpb.etcd_version_msg)		option
header		ResponseHeader

Сообщение `AuthUserGetRequest` (api/etcdserverpb/rpc.proto)

Поле	Описание	Тип
(versionpb.etcd_version_msg)		option
name		string

Сообщение `AuthUserGetResponse` (api/etcdserverpb/rpc.proto)

Поле	Описание	Тип
(versionpb.etcd_version_msg)		option
header		ResponseHeader
roles		(slice of) string

Сообщение `AuthUserGrantRoleRequest` (api/etcdserverpb/rpc.proto)

Поле	Описание	Тип
(versionpb.etcd_version_msg)		option
user	user — имя пользователя, которому следует предоставить указанную роль.	string
role	role — имя роли, предоставляемой пользователю.	string

Сообщение `AuthUserGrantRoleResponse` (api/etcdserverpb/rpc.proto)

Поле	Описание	Тип
(versionpb.etcd_version_msg)		option
header		ResponseHeader

Сообщение `AuthUserListRequest` (api/etcdserverpb/rpc.proto)

Поле	Описание	Тип
(versionpb.etcd_version_msg)		option

Сообщение `AuthUserListResponse` (api/etcdserverpb/rpc.proto)

Поле	Описание	Тип
(versionpb.etcd_version_msg)		option
header		ResponseHeader
users		(slice of) string

Сообщение `AuthUserRevokeRoleRequest` (api/etcdserverpb/rpc.proto)

Поле	Описание	Тип
(versionpb.etcd_version_msg)		option
name		string
role		string

Сообщение `AuthUserRevokeRoleResponse` (api/etcdserverpb/rpc.proto)

Поле	Описание	Тип
(versionpb.etcd_version_msg)		option
header		ResponseHeader

Сообщение `AuthenticateRequest` (api/etcdserverpb/rpc.proto)

Поле	Описание	Тип
(versionpb.etcd_version_msg)		option
name		string
password		string

Сообщение `AuthenticateResponse` (api/etcdserverpb/rpc.proto)

Поле	Описание	Тип
(versionpb.etcd_version_msg)		option
header		ResponseHeader
token	token — авторизованный токен, который можно использовать в последующих RPC	string

Сообщение `CompactionRequest` (api/etcdserverpb/rpc.proto)

CompactionRequest компактизирует хранилище ключей и значений до заданной ревизии. Все замещённые ключи с ревизией меньше ревизии компактизации удаляются.

Справочник API: конкурентность

Mon, 01 Jan 0001 00:00:00 +0000

Этот справочник API автоматически создан из указанных файлов .proto.

служба `Lock` (server/etcdserver/api/v3lock/v3lockpb/v3lock.proto)

Служба блокировок предоставляет клиентские средства блокировки через интерфейс gRPC.

Метод	Тип запроса	Тип ответа	Описание
Lock	LockRequest	LockResponse	Lock получает распределённую совместную блокировку с указанным именем. При успехе возвращается уникальный ключ, существующий, пока вызывающая сторона удерживает блокировку. Вместе с транзакциями ключ позволяет безопасно гарантировать, что etcd обновляется только при владении блокировкой. Блокировка удерживается до вызова Unlock для ключа или истечения аренды владельца.
Unlock	UnlockRequest	UnlockResponse	Unlock принимает ключ, возвращённый Lock, и освобождает блокировку. Следующий ожидающий вызов Lock пробуждается и получает владение блокировкой.

сообщение `LockRequest` (server/etcdserver/api/v3lock/v3lockpb/v3lock.proto)

Поле	Описание	Тип
name	name — идентификатор получаемой распределённой совместной блокировки.	bytes
lease	lease — идентификатор аренды, привязанной к владению блокировкой. Если удерживающая блокировку аренда истекает или отзывается, блокировка освобождается автоматически. Вызовы Lock с одной арендой считаются одним получением; повторная блокировка с той же арендой ничего не делает.	int64

сообщение `LockResponse` (server/etcdserver/api/v3lock/v3lockpb/v3lock.proto)

Поле	Описание	Тип
header		etcdserverpb.ResponseHeader
key	key — ключ, существующий в etcd, пока вызывающая Lock сторона владеет блокировкой. Пользователи не должны изменять ключ, иначе поведение блокировки не определено.	bytes

сообщение `UnlockRequest` (server/etcdserver/api/v3lock/v3lockpb/v3lock.proto)

Поле	Описание	Тип
key	key — ключ владения блокировкой, выданный Lock.	bytes

сообщение `UnlockResponse` (server/etcdserver/api/v3lock/v3lockpb/v3lock.proto)

Поле	Описание	Тип
header		etcdserverpb.ResponseHeader

служба `Election` (server/etcdserver/api/v3election/v3electionpb/v3election.proto)

Служба выборов предоставляет клиентские средства выборов через интерфейс gRPC.

Параметры конфигурации

Mon, 01 Jan 0001 00:00:00 +0000

etcd можно настроить следующими способами:

Флаги командной строки
Переменные окружения: каждому флагу соответствует переменная окружения с тем же именем, префиксом ETCD_, прописными буквами и форматом snake case . Например, --some-flag соответствует ETCD_SOME_FLAG.
Файл конфигурации

Предупреждение

Внимание: при сочетании разных способов конфигурации действуют следующие правила.

Флаги командной строки имеют приоритет над переменными окружения.
Если указан файл конфигурации, все флаги командной строки и переменные окружения игнорируются.

Флаги командной строки

Ниже флаги представлены в формате --flag-name DEFAULT_VALUE.

Поддерживаемые платформы

Mon, 01 Jan 0001 00:00:00 +0000

Уровни поддержки

etcd работает на разных платформах, однако предоставляемые гарантии зависят от уровня поддержки платформы:

Уровень 1: полностью поддерживается сопровождающими etcd ; гарантируется прохождение всех тестов, включая функциональные тесты и тесты надёжности.
Уровень 2: гарантируется прохождение интеграционных и сквозных тестов, но не обязательно функциональных тестов или тестов надёжности.
Уровень 3: гарантируется успешная сборка; тестирование может быть минимальным или отсутствовать, поэтому платформу следует считать нестабильной.

Текущая поддержка

В следующей таблице перечислены поддерживаемые платформы и соответствующие уровни поддержки etcd:

Тестирование производительности

Mon, 01 Jan 0001 00:00:00 +0000

Тестирование производительности

Бенчмарки etcd будут регулярно публиковаться и отслеживаться для каждого выпуска ниже:

Тесты производительности использования памяти

Он фиксирует ожидаемое использование памяти в различных сценариях.

etcd v2.2.0-rc

Тестирование использования памяти хранилищем

Mon, 01 Jan 0001 00:00:00 +0000

Физическую память потребляют два компонента хранилища etcd. Для ускорения поиска ключей процесс etcd выделяет индекс в памяти. Управляемый операционной системой страничный кеш процесса хранит недавно прочитанные с диска данные для быстрого повторного использования.

Индекс в памяти хранит все ключи в структуре данных B-tree вместе с указателями на данные на диске — значения. Каждый ключ в B-tree может содержать несколько указателей на разные версии значения. Поэтому теоретическое потребление памяти индексом можно приблизительно оценить формулой:

Тестирование использования памяти наблюдателями

Mon, 01 Jan 0001 00:00:00 +0000

Примечание

Возможности наблюдения активно развиваются, поэтому потребление памяти может меняться. Мы не ожидаем, что оно значительно превысит приведённые ниже значения.

Одна из основных целей etcd — поддерживать очень большое число наблюдателей, выполняющих огромное количество наблюдений. etcd стремится поддерживать O(10k) клиентов, O(100K) потоков наблюдения (O(10) потоков на клиента) и O(10M) наблюдений в сумме (O(100) наблюдений на поток). На каждое отдельное наблюдение приходится наибольшая часть общего потребления памяти etcd, поэтому именно оно находится в центре текущей и будущей оптимизации.

Тестирование производительности etcd v3

Mon, 01 Jan 0001 00:00:00 +0000

Физические машины

GCE тип машинного оборудования n1-highcpu-2

1x выделенный локальный диск SSD, подключённый под /var/lib/etcd
1x выделенный медленный диск для ОС
1.8 GB памяти
2x процессора
версия etcd 2.2.0

etcd Кластер

1 участник etcd, работающий в режиме демонстрации v3

Тестирование

Используйте инструмент тестирования производительности etcd v3 .

Производительность

чтение одного ключа

размер ключа в байтах	количество клиентов	чтение QPS	90-й процентиль задержки (мс)
256	1	2716	0.4
256	64	16623	6.1
256	256	16622	21.7

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

Тестирование памяти etcd v2.2.0-rc

Mon, 01 Jan 0001 00:00:00 +0000

Физическая машина

Тип машины GCE n1-standard-2

1x выделенный локальный SSD, подключённый в /var/lib/etcd
1x выделенный медленный диск для ОС
7.5 GB памяти
2x CPU

etcd

etcd Version: 2.2.0-rc.0+git
Git SHA: 103cb5c
Go Version: go1.5
Go OS/Arch: linux/amd64

Тестирование

Запускается кластер etcd из 3 участников, каждый из которых использует 2 ядра.

Тестирование производительности etcd v2.2.0-rc

Mon, 01 Jan 0001 00:00:00 +0000

Физическая машина

Тип машины GCE n1-highcpu-2

1x выделенный локальный SSD, подключённый в /var/lib/etcd
1x выделенный медленный диск для ОС
1.8 GB памяти
2x CPU

Кластер etcd

3 участника etcd 2.2.0-rc, каждый работает на отдельной машине.

Точные версии:

etcd Version: 2.2.0-alpha.1+git
Git SHA: 59a5a7e
Go Version: go1.4.2
Go OS/Arch: linux/amd64

Кроме того, базовая производительность измеряется на кластере из 3 участников etcd 2.1.0 стадии alpha. Текущий коммит etcd — c7146bd5 , тот же, что использован в тестировании etcd 2.1 .

Тестирование производительности etcd v2.2.0

Mon, 01 Jan 0001 00:00:00 +0000

Физические машины

Тип машины GCE n1-highcpu-2

1x выделенный локальный SSD, используемый как каталог данных etcd
1x выделенный медленный диск для ОС
1.8 GB памяти
2x CPU

Кластер etcd

3 участника etcd 2.2.0, каждый работает на отдельной машине.

Точные версии:

etcd Version: 2.2.0
Git SHA: e4561dd
Go Version: go1.5
Go OS/Arch: linux/amd64

Тестирование

Запустите ещё одну машину вне кластера etcd и примените инструмент HTTP-тестирования hey с патчем повторного использования соединений для отправки запросов каждому участнику кластера etcd. Патч и шаги для воспроизведения процедуры приведены в инструкции по тестированию .

Тестирование производительности etcd v2.1.0

Mon, 01 Jan 0001 00:00:00 +0000

Физические машины

Тип машины GCE n1-highcpu-2

1x выделенный локальный SSD, подключённый в /var/lib/etcd
1x выделенный медленный диск для ОС
1.8 GB памяти
2x CPU
etcd версии 2.1.0 alpha

Кластер etcd

3 участника etcd, каждый работает на отдельной машине

Тестирование

Запустите ещё одну машину и с помощью инструмента HTTP-тестирования hey отправляйте запросы каждому участнику etcd. Подробные инструкции приведены в руководстве по разработке тестов производительности .

Справочник on PIG.CENTER

YAML Параметры конфигурации

Глобальный/Всемирный

Настройки динамической конфигурации

Конфигурация: pgbouncer.ini

Описание

Общие параметры

logfile

Patroni конфигурация

Настройки конфигурации среды

Глобальный/Всемирный

Журнал

Patroni REST API

Конечные точки проверки работоспособности

Справочник команд

Введение

Документация HAProxy 3.4.4

Выберите руководство

Охват издания

patronictl

Конфигурация

Загрузка исходных выпусков

PgBouncer 1.25

PgBouncer 1.24

PgBouncer 1.23

PgBouncer 1.22

PgBouncer 1.21

PgBouncer 1.20

PgBouncer 1.19

PgBouncer 1.18

PgBouncer 1.17

PgBouncer 1.16

PgBouncer 1.15

PgBouncer 1.14

PgBouncer 1.13

PgBouncer 1.12

PgBouncer 1.11

PgBouncer 1.10

PgBouncer 1.9

PgBouncer 1.8

PgBouncer 1.7

PgBouncer 1.6

PgBouncer 1.5

PgBouncer 1.4

PgBouncer 1.3

PgBouncer 1.2

PgBouncer 1.1

PgBouncer 1.0

Двоичные пакеты

Команда справки (help)

Опции команды

Показать сведения о параметре помощи (--help)

Журнал изменений

PgBouncer 1.25.x

Расчёт ресурсов и производительность

Часто задаваемые вопросы

Как подключиться к PgBouncer?

Как распределять запросы между несколькими серверами?

Документация и сообщество

1. Доступная документация

Команда сервера (server)

Опции команды

TLS Параметр адреса сервера (--tls-server-address)

TLS Параметр авторизованных клиентов сервера (--tls-server-auth)

2. Настройка HAProxy

2.1. Формат файла конфигурации

Команда проверки доступности сервера (server-ping)

Опции команды

TLS Параметр адреса сервера (--tls-server-address)

Параметр порта сервера TLS (--tls-server-port)

5. Параметры bind и server

5.1. Параметры bind

6. Кеш

Часто задаваемые вопросы

Сравнение с другими решениями HA

Примечания к выпускам

Версия 4.1.5

9. Поддерживаемые фильтры

9.1. Трассировка

Команда версии (version)

Показать сведения о параметре помощи (`--help`)

TLS Параметр адреса сервера (`--tls-server-address`)

TLS Параметр авторизованных клиентов сервера (`--tls-server-auth`)

TLS Параметр адреса сервера (`--tls-server-address`)

Параметр порта сервера TLS (`--tls-server-port`)

Параметр вывода (`--output`)

Служба `Auth` (api/etcdserverpb/rpc.proto)

Служба `Cluster` (api/etcdserverpb/rpc.proto)

Служба `KV` (api/etcdserverpb/rpc.proto)

Служба `Lease` (api/etcdserverpb/rpc.proto)

Служба `Maintenance` (api/etcdserverpb/rpc.proto)

Служба `Watch` (api/etcdserverpb/rpc.proto)

Сообщение `AlarmMember` (api/etcdserverpb/rpc.proto)

Сообщение `AlarmRequest` (api/etcdserverpb/rpc.proto)

Сообщение `AlarmResponse` (api/etcdserverpb/rpc.proto)

Сообщение `AuthDisableRequest` (api/etcdserverpb/rpc.proto)

Сообщение `AuthDisableResponse` (api/etcdserverpb/rpc.proto)

Сообщение `AuthEnableRequest` (api/etcdserverpb/rpc.proto)

Сообщение `AuthEnableResponse` (api/etcdserverpb/rpc.proto)

Сообщение `AuthRoleAddRequest` (api/etcdserverpb/rpc.proto)

Сообщение `AuthRoleAddResponse` (api/etcdserverpb/rpc.proto)

Сообщение `AuthRoleDeleteRequest` (api/etcdserverpb/rpc.proto)

Сообщение `AuthRoleDeleteResponse` (api/etcdserverpb/rpc.proto)

Сообщение `AuthRoleGetRequest` (api/etcdserverpb/rpc.proto)

Сообщение `AuthRoleGetResponse` (api/etcdserverpb/rpc.proto)

Сообщение `AuthRoleGrantPermissionRequest` (api/etcdserverpb/rpc.proto)

Сообщение `AuthRoleGrantPermissionResponse` (api/etcdserverpb/rpc.proto)

Сообщение `AuthRoleListRequest` (api/etcdserverpb/rpc.proto)

Сообщение `AuthRoleListResponse` (api/etcdserverpb/rpc.proto)

Сообщение `AuthRoleRevokePermissionRequest` (api/etcdserverpb/rpc.proto)

Сообщение `AuthRoleRevokePermissionResponse` (api/etcdserverpb/rpc.proto)

Сообщение `AuthStatusRequest` (api/etcdserverpb/rpc.proto)

Сообщение `AuthStatusResponse` (api/etcdserverpb/rpc.proto)

Сообщение `AuthUserAddRequest` (api/etcdserverpb/rpc.proto)

Сообщение `AuthUserAddResponse` (api/etcdserverpb/rpc.proto)

Сообщение `AuthUserChangePasswordRequest` (api/etcdserverpb/rpc.proto)

Сообщение `AuthUserChangePasswordResponse` (api/etcdserverpb/rpc.proto)

Сообщение `AuthUserDeleteRequest` (api/etcdserverpb/rpc.proto)

Сообщение `AuthUserDeleteResponse` (api/etcdserverpb/rpc.proto)

Сообщение `AuthUserGetRequest` (api/etcdserverpb/rpc.proto)

Сообщение `AuthUserGetResponse` (api/etcdserverpb/rpc.proto)

Сообщение `AuthUserGrantRoleRequest` (api/etcdserverpb/rpc.proto)

Сообщение `AuthUserGrantRoleResponse` (api/etcdserverpb/rpc.proto)

Сообщение `AuthUserListRequest` (api/etcdserverpb/rpc.proto)

Сообщение `AuthUserListResponse` (api/etcdserverpb/rpc.proto)