refactor(ports): standardize service ports to 8000-8017 range and update CORS configurations across all services
- Update CORS allow_origins in blockchain-node app.py and gossip relay.py to use new port logic (8000-8016) - Update coordinator-api config.py and config_pg.py with standardized port ranges and service labels - Update coordinator-api health check script from port 18000 to 8000 - Update geo_load_balancer.py to use configurable host/port (default 0.0.0.0:8017) - Update agent_security.py sandbox
This commit is contained in:
oib
246
docs/10_plan/debian11-removal-summary.md
Normal file
246
docs/10_plan/debian11-removal-summary.md
Normal file
@@ -0,0 +1,246 @@
|
||||
# Debian 11+ Removal from AITBC Requirements
|
||||
|
||||
## 🎯 Update Summary
|
||||
|
||||
**Action**: Removed Debian 11+ from AITBC operating system requirements, focusing on Debian 13 Trixie as primary and Ubuntu 20.04+ as secondary
|
||||
|
||||
**Date**: March 4, 2026
|
||||
|
||||
**Reason**: Simplify requirements and focus on current development environment (Debian 13 Trixie) and production environment (Ubuntu LTS)
|
||||
|
||||
---
|
||||
|
||||
## ✅ Changes Made
|
||||
|
||||
### **1. Main Deployment Guide Updated**
|
||||
|
||||
**aitbc.md** - Primary deployment documentation:
|
||||
```diff
|
||||
### **Software Requirements**
|
||||
- **Operating System**: Debian 13 Trixie (dev) / Ubuntu 20.04+ / Debian 11+
|
||||
+ **Operating System**: Debian 13 Trixie (dev) / Ubuntu 20.04+
|
||||
```
|
||||
|
||||
### **2. Requirements Validation System Updated**
|
||||
|
||||
**requirements-validation-system.md** - Validation system documentation:
|
||||
```diff
|
||||
#### **System Requirements**
|
||||
- **Operating System**: Debian 13 Trixie (dev) / Ubuntu 20.04+ / Debian 11+
|
||||
+ **Operating System**: Debian 13 Trixie (dev) / Ubuntu 20.04+
|
||||
```
|
||||
|
||||
**Configuration Section**:
|
||||
```diff
|
||||
system:
|
||||
operating_systems:
|
||||
- "Debian 13 Trixie (dev environment)"
|
||||
- "Ubuntu 20.04+"
|
||||
- - "Debian 11+"
|
||||
architecture: "x86_64"
|
||||
```
|
||||
|
||||
### **3. Validation Script Updated**
|
||||
|
||||
**validate-requirements.sh** - Requirements validation script:
|
||||
```diff
|
||||
"Debian"*)
|
||||
- if [ "$(echo $VERSION | cut -d'.' -f1)" -lt 11 ]; then
|
||||
- ERRORS+=("Debian version $VERSION is below minimum requirement 11")
|
||||
+ if [ "$(echo $VERSION | cut -d'.' -f1)" -lt 13 ]; then
|
||||
+ ERRORS+=("Debian version $VERSION is below minimum requirement 13")
|
||||
fi
|
||||
```
|
||||
|
||||
### **4. Comprehensive Summary Updated**
|
||||
|
||||
**requirements-updates-comprehensive-summary.md** - Complete summary:
|
||||
```diff
|
||||
### **🚀 Software Requirements**
|
||||
- **Operating System**: Debian 13 Trixie (dev) / Ubuntu 20.04+ / Debian 11+
|
||||
+ **Operating System**: Debian 13 Trixie (dev) / Ubuntu 20.04+
|
||||
|
||||
### **Current Supported Versions**
|
||||
- **Operating System**: Debian 13 Trixie (dev), Ubuntu 20.04+, Debian 11+
|
||||
+ **Operating System**: Debian 13 Trixie (dev), Ubuntu 20.04+
|
||||
|
||||
### **Troubleshooting**
|
||||
- **OS Compatibility**: Debian 13 Trixie fully supported
|
||||
+ **OS Compatibility**: Debian 13 Trixie fully supported, Ubuntu 20.04+ supported
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## 📊 Operating System Requirements Changes
|
||||
|
||||
### **Before Update**
|
||||
```
|
||||
Operating System Requirements:
|
||||
- Primary: Debian 13 Trixie (dev)
|
||||
- Secondary: Ubuntu 20.04+
|
||||
- Legacy: Debian 11+
|
||||
```
|
||||
|
||||
### **After Update**
|
||||
```
|
||||
Operating System Requirements:
|
||||
- Primary: Debian 13 Trixie (dev)
|
||||
- Secondary: Ubuntu 20.04+
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## 🎯 Benefits Achieved
|
||||
|
||||
### **✅ Simplified Requirements**
|
||||
- **Clear Focus**: Only two supported OS versions
|
||||
- **No Legacy**: Removed older Debian 11+ requirement
|
||||
- **Current Standards**: Focus on modern OS versions
|
||||
|
||||
### **✅ Better Documentation**
|
||||
- **Less Confusion**: Clear OS requirements without legacy options
|
||||
- **Current Environment**: Accurately reflects current development stack
|
||||
- **Production Ready**: Ubuntu LTS for production environments
|
||||
|
||||
### **✅ Improved Validation**
|
||||
- **Stricter Requirements**: Debian 13+ minimum enforced
|
||||
- **Clear Error Messages**: Specific version requirements
|
||||
- **Better Support**: Focus on supported versions only
|
||||
|
||||
---
|
||||
|
||||
## 📋 Files Updated
|
||||
|
||||
### **Documentation Files (3)**
|
||||
1. **docs/10_plan/aitbc.md** - Main deployment guide
|
||||
2. **docs/10_plan/requirements-validation-system.md** - Validation system documentation
|
||||
3. **docs/10_plan/requirements-updates-comprehensive-summary.md** - Complete summary
|
||||
|
||||
### **Validation Scripts (1)**
|
||||
1. **scripts/validate-requirements.sh** - Requirements validation script
|
||||
|
||||
---
|
||||
|
||||
## 🧪 Validation Results
|
||||
|
||||
### **✅ Current System Status**
|
||||
```
|
||||
📋 Checking System Requirements...
|
||||
Operating System: Debian GNU/Linux 13
|
||||
✅ Detected Debian 13 Trixie (dev environment)
|
||||
✅ System requirements check passed
|
||||
```
|
||||
|
||||
### **✅ Validation Behavior**
|
||||
- **Debian 13+**: ✅ Accepted with special detection
|
||||
- **Debian < 13**: ❌ Rejected with error
|
||||
- **Ubuntu 20.04+**: ✅ Accepted
|
||||
- **Ubuntu < 20.04**: ❌ Rejected with error
|
||||
- **Other OS**: ⚠️ Warning but may work
|
||||
|
||||
### **✅ Compatibility Check**
|
||||
- **Current Version**: Debian 13 ✅ (Meets requirement)
|
||||
- **Minimum Requirement**: Debian 13 ✅ (Current version meets)
|
||||
- **Secondary Option**: Ubuntu 20.04+ ✅ (Production ready)
|
||||
|
||||
---
|
||||
|
||||
## 🔄 Impact Assessment
|
||||
|
||||
### **✅ Development Impact**
|
||||
- **Clear Requirements**: Developers know Debian 13+ is required
|
||||
- **No Legacy Support**: No longer supports Debian 11
|
||||
- **Current Stack**: Accurately reflects current development environment
|
||||
|
||||
### **✅ Production Impact**
|
||||
- **Ubuntu LTS Focus**: Ubuntu 20.04+ for production
|
||||
- **Modern Standards**: No legacy OS support
|
||||
- **Clear Guidance**: Production environment clearly defined
|
||||
|
||||
### **✅ Maintenance Impact**
|
||||
- **Reduced Complexity**: Fewer OS versions to support
|
||||
- **Better Testing**: Focus on current OS versions
|
||||
- **Clear Documentation**: Simplified requirements
|
||||
|
||||
---
|
||||
|
||||
## 📞 Support Information
|
||||
|
||||
### **✅ Current Operating System Status**
|
||||
- **Primary**: Debian 13 Trixie (development environment) ✅
|
||||
- **Secondary**: Ubuntu 20.04+ (production environment) ✅
|
||||
- **Current**: Debian 13 Trixie ✅ (Fully operational)
|
||||
- **Legacy**: Debian 11+ ❌ (No longer supported)
|
||||
|
||||
### **✅ Development Environment**
|
||||
- **OS**: Debian 13 Trixie ✅ (Primary development)
|
||||
- **Python**: 3.13.5 ✅ (Meets requirements)
|
||||
- **Node.js**: v22.22.x ✅ (Within supported range)
|
||||
- **Resources**: 62GB RAM, 686GB Storage, 32 CPU cores ✅
|
||||
|
||||
### **✅ Production Environment**
|
||||
- **OS**: Ubuntu 20.04+ ✅ (Production ready)
|
||||
- **Stability**: LTS version for production
|
||||
- **Support**: Long-term support available
|
||||
- **Compatibility**: Compatible with AITBC requirements
|
||||
|
||||
### **✅ Installation Guidance**
|
||||
```bash
|
||||
# Development Environment (Debian 13 Trixie)
|
||||
sudo apt update
|
||||
sudo apt install -y python3.13 python3.13-venv python3.13-dev
|
||||
sudo apt install -y nodejs npm
|
||||
|
||||
# Production Environment (Ubuntu 20.04+)
|
||||
sudo apt update
|
||||
sudo apt install -y python3.13 python3.13-venv python3.13-dev
|
||||
sudo apt install -y nodejs npm
|
||||
```
|
||||
|
||||
---
|
||||
|
||||
## 🎉 Update Success
|
||||
|
||||
**✅ Debian 11+ Removal Complete**:
|
||||
- Debian 11+ removed from all documentation
|
||||
- Validation script updated to enforce Debian 13+
|
||||
- Clear OS requirements with two options only
|
||||
- No legacy OS references
|
||||
|
||||
**✅ Benefits Achieved**:
|
||||
- Simplified requirements
|
||||
- Better documentation clarity
|
||||
- Improved validation
|
||||
- Modern OS focus
|
||||
|
||||
**✅ Quality Assurance**:
|
||||
- All files updated consistently
|
||||
- Current system meets new requirement
|
||||
- Validation script functional
|
||||
- No documentation conflicts
|
||||
|
||||
---
|
||||
|
||||
## 🚀 Final Status
|
||||
|
||||
**🎯 Update Status**: ✅ **COMPLETE AND VERIFIED**
|
||||
|
||||
**📊 Success Metrics**:
|
||||
- **Files Updated**: 4 total (3 docs, 1 script)
|
||||
- **OS Requirements**: Simplified from 3 to 2 options
|
||||
- **Validation Updated**: Debian 13+ minimum enforced
|
||||
- **Legacy Removed**: Debian 11+ no longer supported
|
||||
|
||||
**🔍 Verification Complete**:
|
||||
- All documentation files verified
|
||||
- Validation script tested and functional
|
||||
- Current system meets new requirement
|
||||
- No conflicts detected
|
||||
|
||||
**🚀 Debian 11+ successfully removed from AITBC requirements - focus on modern OS versions!**
|
||||
|
||||
---
|
||||
|
||||
**Status**: ✅ **COMPLETE AND VERIFIED**
|
||||
**Last Updated**: 2026-03-04
|
||||
**Maintainer**: AITBC Development Team
|
||||
Reference in New Issue
Block a user