Руководство on PIG.CENTER

Установка

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

Предварительные требования для Mac OS

Чтобы установить необходимые компоненты на Mac, выполните:

brew install postgresql etcd haproxy libyaml python

Psycopg

Начиная с psycopg2-2.8 двоичная версия psycopg2 больше не устанавливается по умолчанию. Для установки из исходного кода необходим компилятор C и пакеты разработки postgres и python. Поскольку в экосистеме Python нельзя указать зависимость как psycopg2 OR psycopg2-binary, способ установки нужно выбрать самостоятельно.

Компиляция и установка PgBouncer

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

Сборка

Для компиляции PgBouncer требуется несколько компонентов:

GNU Make 3.81+
Libevent 2.0+
pkg-config
OpenSSL 1.0.1+ для поддержки TLS
(необязательно) c-ares как альтернатива evdns из Libevent
(необязательно) библиотеки LDAP
(необязательно) библиотеки PAM

После установки зависимостей выполните:

$ ./configure --prefix=/usr/local
$ make
$ make install

Для сборки из Git или под Windows используйте отдельные инструкции ниже.

Поддержка поиска DNS

PgBouncer разрешает имена узлов при установке соединения, а не только один раз при загрузке конфигурации. Для этого нужна асинхронная реализация DNS. В таблице перечислены поддерживаемые бэкенды в порядке их проверки:

Быстрый старт

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

Следуйте этим инструкциям, чтобы локально установить, запустить и проверить кластер etcd из одного участника:

Установите etcd из готовых бинарных файлов или исходного кода. Подробности см. в разделе [Установка][].

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

Важно: обязательно выполните последний шаг инструкции по установке и убедитесь, что etcd доступен в пути поиска.
Запустите etcd:
```
$ etcd
{"level":"info","ts":"2021-09-17T09:19:32.783-0400","caller":"etcdmain/etcd.go:72","msg":... }
⋮
```
Примечание

Примечание: вывод etcd представляет собой журналы — сообщения уровня info можно игнорировать.

Демонстрация

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

В этом ряду примеров показаны базовые процедуры работы с кластером etcd.

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

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 --endpoints=${ENDPOINTS} user grant-role root root
etcdctl --endpoints=${ENDPOINTS} user get root

etcdctl --endpoints=${ENDPOINTS} role add role0
etcdctl --endpoints=${ENDPOINTS} role grant-permission role0 readwrite foo
etcdctl --endpoints=${ENDPOINTS} user add user0
etcdctl --endpoints=${ENDPOINTS} user grant-role user0 role0

etcdctl --endpoints=${ENDPOINTS} auth enable
# now all client requests go through auth

etcdctl --endpoints=${ENDPOINTS} --user=user0:123 put foo bar
etcdctl --endpoints=${ENDPOINTS} get foo
# permission denied, user name is empty because the request does not issue an authentication request
etcdctl --endpoints=${ENDPOINTS} --user=user0:123 get foo
# user0 can read the key foo
etcdctl --endpoints=${ENDPOINTS} --user=user0:123 get foo1

Настройка локального кластера

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

Для тестирования и разработки быстрее и проще всего настроить локальный кластер. Промышленное развёртывание описано в разделе кластеризации .

Локальный автономный кластер

Запуск кластера

Чтобы развернуть автономный кластер etcd, выполните:

$ ./etcd
...

Если бинарный файл etcd отсутствует в текущем рабочем каталоге, он может находиться в $GOPATH/bin/etcd или /usr/local/bin/etcd. Укажите правильный путь при запуске.

Работающий участник etcd принимает клиентские запросы на localhost:2379.