dimgigov
8993cdc6f3
- Update README.md status from 'educational proof-of-concept' to 'production-ready' - Fix binary size: 286KB -> 3.3MB - Update test count: 162/35 -> 262/56 - Add sections: benchmarks, Docker, clients, security, config, monitoring, backup, cross-modal queries, troubleshooting - Expand project structure with all 49 modules and ~14,100 LOC - Add 10 new docs: performance, deployment, configuration, clients, security, monitoring, backup, crossmodal, troubleshooting, changelog - Expand docs/en: architecture, baraql, installation, protocol - Update docs/bg: architecture, installation - Update docs/index.md with new links - Update .gitignore for __pycache__, rust/target, nim binaries
3.7 KiB
3.7 KiB
BaraDB - Ръководство за Инсталация
Изисквания
- Nim Компилатор >= 2.2.0
- OpenSSL development headers (за TLS поддръжка)
- Операционна система: Linux, macOS, Windows
Поддържани Платформи
| ОС | Архитектура | Статус |
|---|---|---|
| Linux | x86_64 | ✅ Пълна поддръжка |
| Linux | ARM64 | ✅ Пълна поддръжка |
| macOS | x86_64 | ✅ Пълна поддръжка |
| macOS | ARM64 (Apple Silicon) | ✅ Пълна поддръжка |
| Windows | x86_64 | ✅ Поддръжка |
Инсталиране на Nim
Linux
# Официален инсталатор
curl https://nim-lang.org/choosenim/init.sh -sSf | sh
# Ubuntu/Debian
sudo apt-get update
sudo apt-get install nim
# Fedora
sudo dnf install nim
# Arch Linux
sudo pacman -S nim
macOS
# Homebrew
brew install nim
# MacPorts
sudo port install nim
Windows
# Winget
winget install nim
# Scoop
scoop install nim
Проверка
nim --version
# Очакван резултат: Nim Compiler Version 2.2.0 или по-нова
Инсталиране на OpenSSL
Linux
# Ubuntu/Debian
sudo apt-get install libssl-dev
# Fedora
sudo dnf install openssl-devel
# Arch Linux
sudo pacman -S openssl
macOS
brew install openssl
Компилиране на BaraDB
Клониране на Репозиторито
git clone https://github.com/katehonz/barabaDB.git
cd barabaDB
Инсталиране на Зависимости
nimble install -d -y
Опции за Компилация
Debug Компилация
nim c -d:ssl -o:build/baradadb src/baradadb.nim
Release Компилация (Препоръчителна)
nim c -d:ssl -d:release --opt:speed -o:build/baradadb src/baradadb.nim
Използване на Nimble
nimble build_debug
nimble build_release
Минимален Размер
nim c -d:ssl -d:release --opt:size -o:build/baradadb src/baradadb.nim
strip build/baradadb
Проверка на Компилацията
./build/baradadb --version
# Очакван резултат: BaraDB v0.1.0 — Multimodal Database Engine
Стартиране на Тестове
# Всички тестове (262 теста, 56 сюита)
nim c -d:ssl -r tests/test_all.nim
# Бенчмаркове
nim c -d:ssl -d:release -r benchmarks/bench_all.nim
Опции за Инсталация
Системна Инсталация
nimble build_release
sudo cp build/baradadb /usr/local/bin/
sudo chmod +x /usr/local/bin/baradadb
sudo mkdir -p /var/lib/baradb
Docker
docker pull barabadb/barabadb:latest
docker run -d \
-p 5432:5432 \
-p 8080:8080 \
-p 8081:8081 \
-v baradb_data:/data \
barabadb/barabadb
Docker Compose
docker-compose up -d
Вградено Използване
requires "barabadb >= 0.1.0"
import barabadb/storage/lsm
var db = newLSMTree("./data")
db.put("key", cast[seq[byte]]("value"))
let (found, val) = db.get("key")
db.close()
Първо Стартиране
# Стартиране на сървъра
./build/baradadb
# Тестване на HTTP API
curl http://localhost:8080/health
# Интерактивна конзола
./build/baradadb --shell