Baradb/docs/ru/docker.md

Руководство по развёртыванию Docker

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

# Клонировать репозиторий
git clone https://github.com/katehonz/barabaDB.git
cd barabaDB

# Собрать образ
docker build -t baradb:latest .

# Запустить с Docker Compose
docker compose up -d

# Проверить статус
docker compose ps
docker compose logs -f

Файлы

Файл	Описание
Dockerfile	Multi-stage production build
docker-compose.yml	Development конфигурация
docker-compose.prod.yml	Production конфигурация
docker-compose.override.yml	Development override (автоматически загружается)
docker-entrypoint.sh	Entrypoint скрипт для инициализации
.dockerignore	Файлы, которые не копируются в образ
scripts/docker-build.sh	Helper скрипт для сборки
scripts/docker-run.sh	Helper скрипт для ручного запуска

Создание образа

# Стандартная сборка
docker build -t baradb:latest .

# Со скриптом
./scripts/docker-build.sh

# С конкретной версией
IMAGE_NAME=baradb VERSION=0.1.0 ./scripts/docker-build.sh

Запуск

Development (docker compose)

# Запуск в фоне
docker compose up -d

# Остановка
docker compose down

# Остановка и удаление volumes (ВНИМАНИЕ — удаляет данные!)
docker compose down -v

# Просмотр логов
docker compose logs -f

Production (docker compose)

# Запуск с production конфигурацией
docker compose -f docker-compose.prod.yml up -d

# Проверка healthcheck
docker compose -f docker-compose.prod.yml ps

Ручной (docker run)

# Со скриптом
./scripts/docker-run.sh

# Вручную
docker run -d \
  --name baradb \
  -p 9472:9472 \
  -p 9470:9470 \
  -p 9471:9471 \
  -v baradb_data:/data \
  -e BARADB_LOG_LEVEL=info \
  baradb:latest

Порты

Порт	Описание
9472	Binary wire protocol
9470	HTTP/REST API
9471	WebSocket

Переменные окружения

Переменная	По умолчанию	Описание
BARADB_ADDRESS	0.0.0.0	Адрес для прослушивания
BARADB_PORT	9472	Binary protocol порт
BARADB_HTTP_PORT	9470	HTTP порт
BARADB_WS_PORT	9471	WebSocket порт
BARADB_DATA_DIR	/data	Директория для данных
BARADB_LOG_LEVEL	info	Уровень логирования

Volumes

Путь в контейнере	Описание
/data	Основная директория базы данных
/data/server/wal	Write-ahead log
/data/server/sstables	SSTable файлы

Production чеклист

• Создать TLS сертификаты в ./certs/
• Установить сильный BARADB_JWT_SECRET
• Настроить файрвол правила
• Настроить регулярные бэкапы
• Проверить resource limits
• Настроить мониторинг (healthcheck, logs)

TLS в Docker

1. Создайте сертификаты:

mkdir -p certs
openssl req -x509 -nodes -days 365 -newkey rsa:2048 \
  -keyout certs/server.key -out certs/server.crt

2. Активируйте в docker-compose.prod.yml:

environment:
  - BARADB_TLS_ENABLED=true
  - BARADB_CERT_FILE=/certs/server.crt
  - BARADB_KEY_FILE=/certs/server.key
volumes:
  - ./certs:/certs:ro

Бэкап в Docker

# Ручной бэкап
docker exec baradb /app/backup backup --data-dir=/data

# Список бэкапов
docker exec baradb /app/backup list

# Восстановление
docker exec baradb /app/backup restore --input=backup_xxx.tar.gz

Устранение проблем

Контейнер не запускается

# Проверка логов
docker compose logs -f baradb

# Проверка статуса
docker compose ps

Нет соединения с базой

# Проверка экспонированных портов
docker port baradb

# Проверка изнутри
docker exec baradb wget -qO- http://localhost:9470/health

Permission denied на /data

Entrypoint скрипт автоматически создаёт директории и устанавливает правильные permissions. При проблемах:

docker exec baradb ls -la /data
docker exec baradb chown -R baradb:baradb /data