Skip to content

COMMANDS.md

Latest commit

 

History

History
221 lines (165 loc) · 4.21 KB

COMMANDS.md

File metadata and controls

221 lines (165 loc) · 4.21 KB

FlexDeploy - Quick Command Reference

🚀 First Time Setup

# 1. Install all dependencies (Python + npm)
./install.sh

# 2. Configure AWS credentials
nano ~/.aws/credentials

# 3. Test AWS Bedrock connection
python test_bedrock_agents.py

# 4. Start the application
./run_app.sh

🎮 Running the Application

Start Everything

./run_app.sh

Start Services Separately

# Backend only
python -m server.main

# Frontend only (in another terminal)
cd ui && npm run dev

🧪 Testing

# Test AI agents
python test_bedrock_agents.py

# Test API endpoints
curl http://localhost:8000/api/devices

# Check database
sqlite3 flexdeploy.db "SELECT COUNT(*) FROM devices;"

⚙️ Configuration

# Setup configuration
./setup_config.sh

# View current configuration
python -c "from server.config import get_config; get_config().print_config()"

# Edit app settings
nano config.ini

# Edit AWS credentials
nano ~/.aws/credentials

📦 Package Management

# Install Python packages
uv pip install -e .
# or
pip install -e .

# Install npm packages
cd ui && npm install

# Update packages
uv pip install --upgrade -e .
cd ui && npm update

🔧 Maintenance

# View server logs
tail -f server.log

# View UI logs
tail -f ui.log

# Check running processes
ps aux | grep python
ps aux | grep node

# Clear logs
rm server.log ui.log

# Restart services
# Press Ctrl+C to stop, then run:
./run_app.sh

🐛 Troubleshooting

# Check AWS credentials
aws sts get-caller-identity --profile <profile_id>

# Test AWS Bedrock access
aws bedrock list-foundation-models --region us-east-2 --profile <profile_id>

# Verify config files
ls -la config.ini ~/.aws/credentials

# Check Python version
python3 --version  # Should be 3.11+

# Check Node version
node --version  # Should be 18+

# Reinstall packages
uv pip install --force-reinstall -e .
cd ui && rm -rf node_modules && npm install

🌐 URLs

📝 Common Tasks

Create a Deployment

curl -X POST http://localhost:8000/api/deployments \
  -H "Content-Type: application/json" \
  -d '{"deploymentName": "Test Deploy", "status": "Not Started"}'

Run AI Categorization

curl -X POST http://localhost:8000/api/ai/categorize-devices \
  -H "Content-Type: application/json" \
  -d '{"deviceIds": null}'  # null = all devices

Analyze Deployment Failure

curl -X POST http://localhost:8000/api/ai/analyze-failure \
  -H "Content-Type: application/json" \
  -d '{"deploymentId": "DEP-001", "ringName": "Ring 1 - Low Risk Devices"}'

Parse Natural Language Gating

curl -X POST http://localhost:8000/api/ai/gating-factors \
  -H "Content-Type: application/json" \
  -d '{"naturalLanguageInput": "Deploy to stable devices only"}'

📚 Documentation

All documentation is consolidated in README.md

Key sections:

  • Architecture
  • Installation
  • Configuration
  • AI Agents
  • API Documentation
  • Troubleshooting

🔑 File Locations

config.ini                    # App configuration
~/.aws/credentials           # AWS credentials
flexdeploy.db                # Database (root directory)
server.log                   # Backend logs
ui.log                       # Frontend logs

⚡ Quick Fixes

Server won't start:

lsof -ti:8000 | xargs kill -9  # Kill process on port 8000
python -m server.main

UI won't start:

lsof -ti:5173 | xargs kill -9  # Kill process on port 5173
cd ui && npm run dev

Database locked:

fuser flexdeploy.db  # Find process using DB
# Kill the process, then restart

AWS credentials expired:

aws sso login
# Or get new credentials from SSO portal

📞 Getting Help

  1. Check README.md for comprehensive documentation
  2. Review logs: tail -f server.log ui.log
  3. Test components: python test_bedrock_agents.py
  4. Verify setup: ./install.sh (safe to re-run)

For full documentation, see README.md