Skip to the content.

The single command you need to remember: ./dev.sh

🎯 Quick Start

# See all commands
./dev.sh help

# Start everything
./dev.sh start

# Check status
./dev.sh status

# Stop everything
./dev.sh stop

# Clean restart (testing)
./dev.sh clean

πŸ“‹ Command Categories

πŸš€ Service Management

./dev.sh start              # Start all services
./dev.sh start-infra        # Start infrastructure only
./dev.sh start-business     # Start business services only
./dev.sh start --restart    # Force restart

./dev.sh stop               # Stop all services
./dev.sh stop-infra         # Stop infrastructure only
./dev.sh stop-business      # Stop business services only

./dev.sh status             # Check all services
./dev.sh status-infra       # Check infrastructure
./dev.sh status-business    # Check business services

πŸ”„ Clean Restart

./dev.sh clean                      # Full clean restart
./dev.sh clean --keep-data          # Keep database data
./dev.sh clean --skip-maven         # Skip Maven rebuild
./dev.sh clean --skip-db            # Skip database init
./dev.sh clean --help               # More options

πŸ§ͺ Testing

./dev.sh test-avro          # Test Avro events
./dev.sh check-deps         # Check dependencies
./dev.sh check-health       # Full health check

πŸ’Ύ Database

./dev.sh db-setup           # Initialize database
./dev.sh db-backup          # Backup database
./dev.sh db-connect         # Connect to PostgreSQL

🐳 Docker

./dev.sh docker-start       # Start Docker infrastructure
./dev.sh docker-stop        # Stop Docker infrastructure
./dev.sh docker-status      # Check Docker health
./dev.sh docker-logs kafka  # View service logs
./dev.sh docker-clean       # Clean up containers

πŸ“Š Monitoring

./dev.sh logs reservation-engine    # View service logs
./dev.sh ui-kafka                   # Open Kafka UI
./dev.sh ui-eureka                  # Open Eureka Dashboard
./dev.sh ui-zipkin                  # Open Zipkin
./dev.sh ui-pgadmin                 # Open PgAdmin

πŸ’‘ Common Workflows

Morning Startup

./dev.sh start

Testing/Debugging (Fresh Environment)

./dev.sh clean

Quick Restart (Keep Data)

./dev.sh clean --keep-data --skip-maven

Code Changes Only

./dev.sh stop-business
# ... make changes ...
./dev.sh start-business

End of Day

./dev.sh stop

Check What’s Running

./dev.sh status

View Logs

./dev.sh logs reservation-engine
./dev.sh logs kafka

Database Access

./dev.sh db-connect

🎨 Command Aliases

Many commands have shortcuts:

# These are the same:
./dev.sh start-all          = ./dev.sh start
./dev.sh stop-all           = ./dev.sh stop
./dev.sh status-all         = ./dev.sh status
./dev.sh check              = ./dev.sh status

# Clean restart aliases:
./dev.sh clean              = ./dev.sh clean-restart
./dev.sh clean              = ./dev.sh restart-clean

# Infrastructure shortcuts:
./dev.sh start-infra        = ./dev.sh start-infrastructure
./dev.sh stop-infra         = ./dev.sh stop-infrastructure
./dev.sh status-infra       = ./dev.sh status-infrastructure

# Database shortcuts:
./dev.sh db-setup           = ./dev.sh setup-db
./dev.sh db-setup           = ./dev.sh init-db
./dev.sh db-backup          = ./dev.sh backup-db
./dev.sh db-connect         = ./dev.sh psql

# Docker shortcuts:
./dev.sh docker-start       = ./dev.sh docker-up
./dev.sh docker-stop        = ./dev.sh docker-down
./dev.sh docker-clean       = ./dev.sh docker-cleanup

# Testing shortcuts:
./dev.sh test-avro          = ./dev.sh avro-test
./dev.sh check-deps         = ./dev.sh check-dependencies
./dev.sh check-deps         = ./dev.sh deps
./dev.sh check-health       = ./dev.sh health

# UI shortcuts:
./dev.sh ui-kafka           = ./dev.sh kafka-ui
./dev.sh ui-eureka          = ./dev.sh eureka
./dev.sh ui-zipkin          = ./dev.sh zipkin
./dev.sh ui-pgadmin         = ./dev.sh pgadmin

πŸ” How It Works

dev.sh is a wrapper that delegates to scripts in the scripts/ folder:

dev.sh
β”œβ”€β”€ start          β†’ scripts/infra.sh start-all
β”œβ”€β”€ stop           β†’ scripts/infra.sh stop-all
β”œβ”€β”€ status         β†’ scripts/infra.sh status-all
β”œβ”€β”€ clean          β†’ scripts/clean-restart.sh
β”œβ”€β”€ test-avro      β†’ scripts/test-avro-event.sh
β”œβ”€β”€ db-setup       β†’ scripts/setup-database.sh
β”œβ”€β”€ docker-start   β†’ scripts/docker-infra.sh infra-start
└── ...

πŸ†˜ Need Help?

# Show all commands
./dev.sh help

# Show clean restart options
./dev.sh clean --help

# Check available logs
./dev.sh logs

Remember: Just use ./dev.sh for everything! πŸš€