Задача

Назначение Ускорить управление PR. PR проекта etcd перечислены на странице https://github.com/etcd-io/etcd/pulls У PR могут быть различные метки, этап, рецензент и другие атрибуты. Подробный список меток находится на странице …

Назначение Ускорить управление issue. Issue проекта etcd перечислены на странице https://github.com/etcd-io/etcd/issues и классифицируются с помощью меток. Например, issue, признанный ошибкой, в итоге получает метку area/bug . Новые issue сначала не …

В общем случае обновление etcd с 2.3 до 3.0 можно выполнить поэтапно без простоя: по очереди останавливать процессы etcd v2.3 и заменять их процессами etcd v3.0; после запуска всех процессов v3.0 кластеру станут доступны новые возможности v3.0. Перед …

В общем случае обновление etcd с 3.0 до 3.1 можно выполнить поэтапно без простоя: по очереди останавливать процессы etcd v3.0 и заменять их процессами etcd v3.1; после запуска всех процессов v3.1 кластеру станут доступны новые возможности v3.1. Перед …

В общем случае переход с etcd 3.1 на 3.2 можно выполнить как поэтапное обновление без простоя: поочерёдно останавливать процессы etcd v3.1 и заменять их процессами etcd v3.2 после запуска всех процессов v3.2 кластеру станут доступны новые возможности …

В общем случае переход с etcd 3.2 на 3.3 можно выполнить как поэтапное обновление без простоя: поочерёдно останавливать процессы etcd v3.2 и заменять их процессами etcd v3.3 после запуска всех процессов v3.3 кластеру становятся доступны новые …

В общем случае переход с etcd 3.5 на 3.4 можно выполнить поэтапно без простоя: по одному останавливайте процессы etcd 3.5 и заменяйте их на процессы etcd 3.4 после запуска любых процессов 3.4 новые функции в 3.5 больше не доступны для кластера Перед …

В общем случае переход с etcd 3.3 на 3.4 можно выполнить как поэтапное обновление без простоя: поочерёдно останавливать процессы etcd v3.3 и заменять их процессами etcd v3.4 после запуска всех процессов v3.4 кластеру становятся доступны новые …

В общем случае переход с etcd v3.6 на v3.5 можно выполнить как поэтапное понижение версии без простоя: поочерёдно останавливать процессы etcd v3.6 и заменять их процессами etcd v3.5 после включения понижения версии новые возможности v3.6 становятся …

В общем случае переход с etcd 3.4 на 3.5 можно выполнить как поэтапное обновление без простоя: поочерёдно останавливать процессы etcd v3.4 и заменять их процессами etcd v3.5 после запуска всех процессов v3.5 кластеру становятся доступны новые …

В общем случае переход с etcd v3.7 на v3.6 можно выполнить как поэтапное понижение версии без простоя: поочерёдно останавливать процессы etcd v3.7 и заменять их процессами etcd v3.6 после включения понижения версии новые возможности v3.7 становятся …

В общем случае переход с etcd v3.5 на v3.6 можно выполнить как поэтапное обновление без простоя: поочерёдно останавливать процессы etcd v3.5 и заменять их процессами etcd v3.6 после запуска всех процессов v3.6 кластеру становятся доступны новые …

В общем случае переход с etcd v3.6 на v3.7 можно выполнить как поэтапное обновление без простоя: поочерёдно останавливать процессы etcd v3.6 и заменять их процессами etcd v3.7 после запуска всех процессов v3.7 кластеру становятся доступны новые …

В этом разделе содержатся документы, специфичные для понижения версии кластеров etcd и приложений. Понижение версии кластера etcd v3.x Понижение версии etcd с 3.5 до 3.4 Понижение версии etcd с 3.6 до 3.5 Понижение версии etcd с 3.7 до 3.6

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

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

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

Каждый сервер etcd предоставляет локальные сведения мониторинга через конечные точки HTTP на клиентском порту. Эти данные полезны для проверки состояния системы и отладки кластера. Конечная точка отладки Если задан --log-level=debug, сервер etcd …

Обзор Для сохранения надёжности кластер etcd нуждается в периодическом обслуживании. В зависимости от требований использующего etcd приложения такое обслуживание обычно можно автоматизировать и выполнять без простоя или существенного снижения …

Прокси gRPC — это не сохраняющий состояние обратный прокси etcd, работающий на уровне gRPC (L7). Он предназначен для снижения общей вычислительной нагрузки на основной кластер etcd. Для горизонтального масштабирования прокси объединяет запросы API …

Что такое шлюз etcd Шлюз etcd — простой TCP-прокси, пересылающий сетевые данные кластеру etcd. Шлюз не хранит состояния и работает прозрачно: он не анализирует клиентские запросы и не вмешивается в ответы кластера. Он не завершает TLS-соединения, не …

etcd рассчитан на отказы машин. Кластер etcd автоматически восстанавливается после временных сбоев, например перезагрузки машины, и допускает до (N-1)/2 постоянных отказов в кластере из N участников. При постоянном отказе из-за неисправности …

Ниже показано, как выполнить статическую начальную инициализацию в виде StatefulSet Kubernetes. Пример манифеста Этот манифест содержит службу и StatefulSet для развёртывания статического кластера etcd в Kubernetes. Если скопировать содержимое …

В этом руководстве показано, как запустить etcd в Docker с помощью процесса статической начальной инициализации . Docker Чтобы предоставить клиентам вне узла Docker доступ к API etcd, используйте IP-адрес узла контейнера. Способ получения IP-адреса …

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

etcd поддерживает автоматический TLS и аутентификацию по клиентским сертификатам как для связи клиентов с сервером, так и для связи одноранговых узлов (серверов друг с другом внутри кластера). Обратите внимание: по умолчанию etcd не включает …

Обзор Аутентификация появилась в etcd 2.1. В API etcd v3 интерфейс API и пользовательский интерфейс аутентификации немного изменены, чтобы лучше соответствовать новой модели данных. Это руководство поможет настроить базовую аутентификацию и …

auth,user,role для аутентификации: export ETCDCTL_API=3 ENDPOINTS=localhost:2379 etcdctl --endpoints=${ENDPOINTS} role add root etcdctl --endpoints=${ENDPOINTS} role get root etcdctl --endpoints=${ENDPOINTS} user add root etcdctl …

Пакет Go embed проекта etcd предоставляет простой способ встраивания сервера etcd непосредственно в ваше приложение. Дополнительные сведения см. в документации пакета embed .

etcd предоставляет резолвер gRPC для поддержки альтернативной системы имён, которая получает конечные точки из etcd при обнаружении служб gRPC. Механизм основан на наблюдении за обновлениями ключей с префиксом имени службы. Эта возможность является …

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

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

Если в какой-либо части проекта etcd обнаружена ошибка или неточность в документации, сообщите нам, создав issue . Мы очень серьёзно относимся к ошибкам и считаем, что незначительных проблем не бывает. Перед созданием отчёта убедитесь, что issue с …

Команда member добавляет, удаляет и обновляет участников: # For each machine TOKEN=my-etcd-token-1 CLUSTER_STATE=new NAME_1=etcd-node-1 NAME_2=etcd-node-2 NAME_3=etcd-node-3 HOST_1=10.240.0.13 HOST_2=10.240.0.14 HOST_3=10.240.0.15 …

Требования Перед установкой etcd ознакомьтесь со следующими страницами: Поддерживаемые платформы Рекомендации по оборудованию Установка готовых бинарных файлов Проще всего установить etcd из готовых бинарных файлов: Загрузите с Releases сжатый архив …

Предварительные требования Установите etcdctl, etcdutl Настройте локальный кластер Сделать снимок базы данных snapshot для создания снимка базы данных etcd в определённый момент времени: etcdctl --endpoints=$ENDPOINT snapshot save DB_NAME Глобальные …

Предварительные условия Установите etcd и etcdctl Проверка общего состояния Команда endpoint status проверяет общее состояние каждой конечной точки, указанной флагом --endpoints: etcdctl endpoint status (--endpoints=$ENDPOINTS|--cluster) Параметры …

Предварительные требования Убедитесь, что установлены etcd и etcdctl . Проверьте наличие активного кластера etcd. Проведение выборов лидера Команда etcdctl используется для проведения выборов лидера в кластере etcd. Она гарантирует, что в один момент …

LOCK приобретает распределённый мьютекс с указанным именем. Как только блокировка будет получена, она будет удерживаться до завершения работы etcdctl. Предварительные требования Установите etcd и etcdctl Создание блокировки lock для распределённой …

Команда lease позволяет записывать ключи с TTL: etcdctl --endpoints=$ENDPOINTS lease grant 300 # lease 2be7547fbc6a5afa granted with TTL(300s) etcdctl --endpoints=$ENDPOINTS put sample value --lease=2be7547fbc6a5afa etcdctl --endpoints=$ENDPOINTS get …

Предварительные требования Установите etcd и etcdctl Наблюдение за ключами watch для получения уведомлений о будущих изменениях: etcdctl watch $KEY [$END_KEY] Параметры -i, --interactive[=false]: interactive mode --prefix[=false]: watch on a prefix …

Предварительные условия Установите etcd и etcdctl . Работающий кластер etcd. Терминология Ниже определены некоторые ключевые термины, используемые в примере . Термин Определение etcdctl Инструмент командной строки для взаимодействия с сервером etcd. …

Предварительные требования Установите etcd и etcdctl Добавление или удаление ключей del для удаления указанного ключа или диапазона ключей: etcdctl del $KEY [$END_KEY] Параметры --prefix[=false]: delete keys with matching prefix --prev-kv[=false]: …

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

При запуске HAProxy с параметром «-d» процесс остаётся на переднем плане и выводит по строке на каждое событие — входящее соединение, завершение соединения, каждую встреченную строку заголовка запроса или ответа. Этот отладочный вывод формируется до …

Время от времени кто-нибудь сообщает, что после перезагрузки системы служба haproxy не запустилась, но при ручном запуске работает. Чаще всего такие пользователи применяют механизм кластерного IP-адреса, например keepalived, чтобы назначать IP-адрес …

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

HAProxy позволяет запрашивать сведения о своём состоянии. Чаще всего для этого используется страница статистики HTTP. Она также предоставляет альтернативный формат вывода CSV для средств мониторинга. Тот же формат доступен через сокет Unix. …

Для ведения журнала HAProxy всегда использует сервер syslog, поскольку сам не обращается к файловой системе. Стандартный способ — отправлять журналы по UDP на сервер журналирования (по умолчанию на порт 514). Очень часто используется адрес …

Предупреждение Примечание о версии: в этой главе сохранены исторические рекомендации по работе с несколькими процессами. Начиная с HAProxy 2.5, nbproc и bind process больше не поддерживаются. В этой редакции настраивайте потоки с помощью nbthread, …

Предварительные требования Установите etcdctl Настройте локальный кластер Получить ключи по префиксу $ etcdctl --endpoints=$ENDPOINTS get PREFIX --prefix Глобальные параметры --endpoints=[127.0.0.1:2379], gRPC endpoints Параметры --prefix, get a …

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

Чтобы обеспечить успешное обслуживание всех входящих соединений, HAProxy при загрузке вычисляет общее число файловых дескрипторов, которые потребуются за время жизни процесса. Обычному процессу Unix по умолчанию обычно предоставляется 1024 файловых …

HAProxy поддерживает плавную и жёсткую остановку. Жёсткая остановка проста: при отправке процессу haproxy сигнала SIGTERM он немедленно завершается, а все установленные соединения закрываются. Плавная остановка запускается сигналом SIGUSR1, …

HAProxy запускается путём вызова программы “haproxy” с передачей на командной строке нескольких аргументов. Фактический синтаксис следующий: $ haproxy [<options>]* где [<options>]* — произвольное число параметров. Параметр всегда начинается с ‘-’, …

Предварительные условия Установите etcdctl Процедура Используйте подкоманду put для записи пары «ключ — значение»: etcdctl --endpoints=$ENDPOINTS put foo "Hello World!" где: foo — имя ключа "Hello World!" — значение, заключённое в кавычки

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

Предварительные требования Установите etcdctl Процедура Используйте подкоманду get для чтения из etcd: $ etcdctl --endpoints=$ENDPOINTS get foo foo Hello World! $ где: foo — запрашиваемый ключ Hello World! — полученное значение Или для …

Общение Если у вас есть вопрос, нужна интерактивная помощь в устранении неполадок или хочется пообщаться с другими пользователями Patroni, присоединяйтесь к каналу #patroni в PostgreSQL Slack . Сообщение об ошибках Перед сообщением об ошибке …

Одна из сильных сторон HAProxy — точность его журналов. Вероятно, они предоставляют наиболее подробную информацию среди продуктов такого рода, что очень важно для устранения неполадок в сложных средах. Стандартные сведения в журналах включают порты …

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

Patroni может использовать объекты Kubernetes для хранения состояния кластера и управления ключом лидера. Это позволяет работать с Postgres в среде Kubernetes без дополнительного хранилища согласованности, то есть не требуется запуск отдельного …

pgBadger развивается как открытый проект. Сообщения об ошибках, предложения функций, исправления документации и патчи принимаются через репозиторий исходного проекта на GitHub. Ошибки и запросы функций Обновитесь до самой новой выпущенной версии и …

Цель В некоторых случаях Patroni должен временно прекратить управление кластером, сохраняя при этом состояние кластера в DCS. Возможные сценарии использования — редкие операции с кластером, такие как обновление до новой старшей версии или …

На каждом узле etcd укажите участников кластера: TOKEN=token-01 CLUSTER_STATE=new NAME_1=machine-1 NAME_2=machine-2 NAME_3=machine-3 HOST_1=10.240.0.17 HOST_2=10.240.0.18 HOST_3=10.240.0.19 …

Patroni также поддерживает работу каскадной репликации на удалённый центр обработки данных (регион) с использованием функции, называемой «резервный кластер». Такие кластеры обладают следующими характеристиками: «резервный лидер», который ведёт себя …

HAProxy — проект с открытым исходным кодом под лицензией GPLv2. Это означает, что его разрешено распространять при условии предоставления доступа к исходному коду по запросу, особенно если в него внесены изменения. HAProxy развивается в основной …

Patroni позволяет настраивать создание новой реплики и определять действия при начальной инициализации нового пустого кластера. Различие строго определено: Patroni создаёт реплики, только если для кластера в DCS присутствует ключ initialize. Если …

Инкрементальный режим сохраняет разобранную статистику в двоичном виде, а затем строит по одному HTML-отчёту на день, накопительный отчёт на неделю и связывающий их календарный индекс. Он предназначен для регулярной обработки ротируемых журналов без …

pgBadger поддерживает два взаимодополняющих режима многопроцессной обработки. Выбирайте режим по структуре входных данных, а не просто по числу процессоров. Параметр Единица параллельной обработки Лучше всего подходит для Основное ограничение -j N / …

pgBadger может отобразить только те сведения, которые PostgreSQL записывает в журнал. Начните с префикса, пригодного для разбора, и продуманной политики журналирования операторов, а затем добавьте эксплуатационные события, которые требуется …

Синтаксис pgbouncer [-d][-v][-u user] <pgbouncer.ini> pgbouncer -V|-h Параметры для Windows: pgbouncer.exe [-v][-u user] <pgbouncer.ini> pgbouncer.exe -V|-h Дополнительные параметры для настройки службы Windows: pgbouncer.exe --regservice …