microdao-daarion/NODE-REGISTRY-QUICK-START.md

🚀 Node Registry — Quick Start

1-минутний гайд для швидкого старту

---

✅ Що готово

Node Registry Service повністю реалізовано (Infrastructure + Full API by Cursor):

• ✅ FastAPI application з повним API
• ✅ SQLAlchemy ORM models (Node, NodeProfile)
• ✅ CRUD operations (register, heartbeat, list, get)
• ✅ PostgreSQL database (node_registry) зі схемою
• ✅ Docker image configuration
• ✅ docker-compose integration
• ✅ Deployment script з firewall rules
• ✅ Bootstrap tool для автоматичної реєстрації
• ✅ Unit та integration tests

---

🚀 Deploy на Node #1 (Production)

Швидкий старт (з автоматичними скриптами):

# 1. Ініціалізувати БД (якщо city-db є)
./scripts/init_node_registry_db.sh

# 2. Запустити сервіс
docker-compose up -d node-registry

# 3. Протестувати API
./scripts/test_node_registry.sh

# 4. Зареєструвати ноду
python3 -m tools.dagi_node_agent.bootstrap --role test-node --labels test

# 5. Перевірити в Router
curl http://localhost:9102/nodes

Deployment script (повний deploy):

./scripts/deploy-node-registry.sh

Скрипт автоматично:

1. Перевірить з'єднання з Node #1
2. Ініціалізує базу даних
3. Згенерує secure password
4. Зб'є Docker image
5. Запустить сервіс
6. Налаштує firewall
7. Перевірить deployment

Manual deploy:

# 1. SSH до Node #1
ssh root@144.76.224.179
cd /opt/microdao-daarion

# 2. Ініціалізувати БД
docker exec -i dagi-postgres psql -U postgres < services/node-registry/migrations/init_node_registry.sql

# 3. Додати password до .env
echo "NODE_REGISTRY_DB_PASSWORD=$(openssl rand -base64 32)" >> .env

# 4. Запустити
docker-compose up -d --build node-registry

# 5. Перевірити
curl http://localhost:9205/health

---

🧪 Тестування локально (Node #2)

# Install dependencies
cd services/node-registry
pip install -r requirements.txt

# Run
export NODE_REGISTRY_ENV=development
python -m app.main

# Test
curl http://localhost:9205/health
open http://localhost:9205/docs

---

📊 Endpoints

Node Registry Service (Port 9205)

Endpoint	Method	Status	Description
/health	GET	✅ Working	Health check (with DB)
/metrics	GET	✅ Working	Prometheus metrics
/	GET	✅ Working	Service info
/api/v1/nodes/register	POST	✅ Working	Register/update node
/api/v1/nodes/heartbeat	POST	✅ Working	Update heartbeat
/api/v1/nodes	GET	✅ Working	List nodes (filters: role, label, status)
/api/v1/nodes/{id}	GET	✅ Working	Get node details
/api/v1/profiles/{role}	GET	✅ Working	Get role profile

DAGI Router Integration (Port 9102)

Endpoint	Method	Status	Description
/nodes	GET	✅ NEW	List nodes (proxy to Registry, filter by role)

---

🗄️ Database

Database: node_registry
User: node_registry_user
Tables:

• nodes (2 rows: Node #1, Node #2 pre-registered)
• node_profiles (empty)
• heartbeat_log (empty)

---

🔌 Configuration

Port: 9205 (internal only)
Access: LAN/VPN only, no public internet

Environment:

NODE_REGISTRY_DB_HOST=postgres
NODE_REGISTRY_DB_PORT=5432
NODE_REGISTRY_DB_NAME=node_registry
NODE_REGISTRY_DB_USER=node_registry_user
NODE_REGISTRY_DB_PASSWORD=***auto-generated***
NODE_REGISTRY_HTTP_PORT=9205
NODE_REGISTRY_ENV=production
NODE_REGISTRY_LOG_LEVEL=info

---

🔧 Management

# Start
docker-compose up -d node-registry

# Restart
docker-compose restart node-registry

# Logs
docker logs -f dagi-node-registry

# Stop
docker-compose stop node-registry

# Test API
./scripts/test_node_registry.sh

# Test Bootstrap
./scripts/test_bootstrap.sh

# Initialize DB (if needed)
./scripts/init_node_registry_db.sh

---

📚 Full Documentation

• Detailed Status: NODE-REGISTRY-STATUS.md
• Setup Guide: README_NODE_REGISTRY_SETUP.md
• Service README: services/node-registry/README.md
• API Docs: docs/node_registry/overview.md
• Deploy Script: scripts/deploy-node-registry.sh
• Test Scripts: scripts/test_node_registry.sh, scripts/test_bootstrap.sh

---

✅ Виконано Cursor

Усі компоненти реалізовані:

• ✅ Database models (SQLAlchemy: Node, NodeProfile)
• ✅ API logic (registration, heartbeat, listing)
• ✅ CRUD operations (crud.py)
• ✅ Pydantic schemas (schemas.py)
• ✅ Bootstrap tool (tools/dagi_node_agent/bootstrap.py)
• ✅ Unit та integration tests
• ⚠️ Authentication (future enhancement)

Status: ✅ Ready for Production Deployment

---

Created: 2025-01-17 by WARP AI
For: DAGI Stack Network Management