Перейти к содержанию

Запуск Picodata

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

Инстанс — экземпляр приложения Picodata, из которых состоит кластер. Picodata может создать кластер, состоящий всего из одного экземпляра/инстанса.

Минимальный вариант запуска

В самом простом случае запуск инстанса сводится к выполнению команды picodata run без каких-либо параметров:

picodata run

Будет запущен кластер, состоящий из одного инстанса. Все параметры будут стандартны, и, скорее всего, вы захотите их переопределить.

Читайте далее:

Запуск нескольких инстансов

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

  • рабочую директорию (--instance-dir)
  • сетевой адрес (--iproto-listen)
  • адрес одного или нескольких соседних инстансов (--peer)
  • адрес сервера PostgreSQL (--pg-listen)

Полный перечень возможных параметров запуска и их описание содержатся в разделе Аргументы командной строки, а также в выводе команды picodata run --help.

Чтобы запустить два инстанса, которые объединятся в кластер, выполните в двух соседних терминалах следующие команды:

picodata run --instance-dir ./data/i1 --iproto-listen 127.0.0.1:3301 --pg-listen 127.0.0.1:5432

picodata run --instance-dir ./data/i2 --iproto-listen 127.0.0.1:3302 --pg-listen 127.0.0.1:5433 --peer 127.0.0.1:3301

Обратите внимание на различия в запуске инстансов:

  • каждый инстанс использует свою рабочую директорию и сетевой адрес
  • в отсутствие параметра --peer запуск инстанса приводит к созданию нового кластера. Чтобы инстансы добавлялись в уже существующий кластер в этом параметре передается адрес первого инстанса

Читайте далее:

Запуск с помощью Docker Compose

Picodata поддерживает запуск при помощи инструментария Docker Compose и предоставляет пример файла docker-compose.yml для запуска тестового кластера. Этот способ удобен тем, что позволяет запускать Picodata без необходимости установки пакетов или сборки из исходного кода.

Для развертывания тестового кластера данным способом выполните следующие шаги.

Убедитесь, что у вас установлены Docker, Docker Compose, а также что системная служба docker запущена, см Docker Compose overview

Скачайте файл docker-compose.yml, который описывает тестовый кластер из 4-х инстансов:

curl -O https://git.picodata.io/core/picodata/-/raw/master/docker/docker-compose.yml?inline=false

Создайте директорию для рабочих файлов проекта и задайте путь к Docker-репозиторию Picodata:

mkdir pico
export REGISTRY=docker-public.binary.picodata.io

Запустите контейнеры:

docker-compose up -d

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

Для подключения к консоли администратора используйте команду:

picodata admin pico/data/picodata-1-1/admin.sock

Для подключения к SQL-консоли используйте команду:

picodata connect admin@127.0.0.1:13301

Пароль администратора T0psecret задан через переменную окружения PICODATA_ADMIN_PASSWORD, см. docker-compose.yml:17

Для подключения по протоколу PostgreSQL используйте команду:

psql postgres://admin@127.0.0.1:55432?sslmode=disable

Безопасный запуск

Для обеспечения мер безопасности рекомендуется организовать хранение пароля для внутреннего системного пользователя pico_service в отдельном файле .picodata-cookie, который следует поместить в рабочую директорию инстанса. Пароль пользователя pico_service используется в рамках всего кластера, поэтому его нужно задать одинаковым для всех инстансов кластера до их первого запуска (соответственно, следует также заранее подготовить рабочие директории инстансов).

Дополнительно, в опции --audit явно укажите способ вывода журнала аудита.

Также рекомендуется использовать опцию --shredding, которая обеспечивает безопасное удаление рабочих файлов.

Пример команд, реализующих безопасный запуск:

mkdir data
echo "shAreDs3cr3t" > data/.picodata-cookie
chmod 600 data/.picodata-cookie
picodata run --instance-dir=data --audit audit.log --shredding

Безопасное завершение работы

Для безопасного завершения работы инстанса нажмите сочетание Ctrl+C в консоли, в которой он был запущен. После этого процесс инстанса будет корректно завершен.