apunkt/dograh
1
0
Fork 0
mirror of https://github.com/dograh-hq/dograh.git synced 2026-06-19 08:28:10 +02:00
Code Issues Projects Releases Packages Wiki Activity

Chore/add setup and contributing docs (#90)

Browse source 
* chore: add dev setup documentation

* Add agents.md files

* simplify contributing documentation
This commit is contained in:
Abhishek 2025-12-27 09:25:20 +05:30 • committed by GitHub
parent e83f3a36d2
commit 59894d7dec
No known key found for this signature in database
GPG key ID: B5690EEEBB952194
20 changed files with 510 additions and 329 deletions
Download patch file Download diff file Expand all files Collapse all files

65
scripts/start_services.sh
View file

@ -1,6 +1,42 @@
#!/usr/bin/env bash
set -e # Exit on error
###############################################################################
### ARGUMENT PARSING
###############################################################################
DEV_MODE=false
show_help() {
echo "Usage: $0 [OPTIONS]"
echo ""
echo "Options:"
echo " --dev Enable development mode with auto-reload for API changes"
echo " --help Show this help message"
echo ""
echo "Examples:"
echo " $0 # Start in production mode"
echo " $0 --dev # Start in development mode with auto-reload"
}
while [[ $# -gt 0 ]]; do
case $1 in
--dev)
DEV_MODE=true
shift
;;
--help|-h)
show_help
exit 0
;;
*)
echo "Unknown option: $1"
show_help
exit 1
;;
esac
done
###############################################################################
### CONFIGURATION
###############################################################################
@ -15,13 +51,18 @@ BASE_LOG_DIR="$BASE_DIR/logs" # Base logs directory
TIMESTAMP=$(date +"%Y%m%d_%H%M%S")
LOG_DIR="$BASE_LOG_DIR/$TIMESTAMP" # Timestamped log directory
LATEST_LINK="$BASE_LOG_DIR/latest" # Symlink to latest logs
VENV_PATH="$(dirname "$BASE_DIR")/venv"
VENV_PATH="$BASE_DIR/venv"
ARQ_WORKERS=${ARQ_WORKERS:-1}
# Log startup
cd "$BASE_DIR"
echo "Starting Dograh Services at $(date) in BASE_DIR: ${BASE_DIR}"
if $DEV_MODE; then
echo "Starting Dograh Services (DEV MODE) at $(date) in BASE_DIR: ${BASE_DIR}"
echo "Auto-reload enabled for api/ directory changes"
else
echo "Starting Dograh Services at $(date) in BASE_DIR: ${BASE_DIR}"
fi
###############################################################################
### 1) Load environment variables
@ -47,10 +88,19 @@ SERVICE_NAMES=(
"uvicorn"
)
# Build uvicorn command based on mode
if $DEV_MODE; then
# Dev mode: single worker with auto-reload (--reload is incompatible with --workers > 1)
UVICORN_CMD="uvicorn api.app:app --host 0.0.0.0 --port $FASTAPI_PORT --reload --reload-dir api"
else
# Production mode: multiple workers, no reload
UVICORN_CMD="uvicorn api.app:app --host 0.0.0.0 --port $FASTAPI_PORT --workers $FASTAPI_WORKERS"
fi
SERVICE_COMMANDS=(
"python -m api.services.telephony.ari_manager"
"python -m api.services.campaign.campaign_orchestrator"
"uvicorn api.app:app --host 0.0.0.0 --port $FASTAPI_PORT --workers $FASTAPI_WORKERS"
"$UVICORN_CMD"
)
# Add ARQ workers dynamically
@ -208,14 +258,21 @@ done
echo
echo "──────────────────────────────────────────────────"
if $DEV_MODE; then
echo "Mode: DEVELOPMENT (auto-reload enabled)"
else
echo "Mode: PRODUCTION"
fi
echo ""
for name in "${SERVICE_NAMES[@]}"; do
pid=$(<"$RUN_DIR/$name.pid")
echo "✓ $name (PID $pid) → $LOG_DIR/$name.log"
done
echo ""
echo " Rotation: ${LOG_ROTATION_SIZE:-100 MB}"
echo " Retention: ${LOG_RETENTION:-7 days}"
echo " Compression: ${LOG_COMPRESSION:-gz}"
echo "Logs: tail -f $LOG_DIR/*.log"
echo "Rotated logs: ls $LOG_DIR/*.log.*"
echo "To stop: run this script again or kill -TERM -<PID> for process groups"
echo "To stop: ./scripts/stop_services.sh"
echo "──────────────────────────────────────────────────"