Files

Marius Mutu 4da36593da Implement unified Oracle mode support with auto-detection

- Unified Dockerfile with thick/thin mode auto-detection
- Single docker-compose.yaml with build arguments
- Auto-detect logic: thick mode for Oracle 10g/11g, thin mode for 12.1+
- Simplified .env configuration with clear mode selection
- Updated admin.py with FORCE_THIN_MODE and INSTANTCLIENTPATH support
- Added comprehensive documentation for both deployment modes
- Container tested successfully with thick mode for Oracle 11g compatibility

🤖 Generated with [Claude Code](https://claude.ai/code)

Co-Authored-By: Claude <noreply@anthropic.com>

2025-09-09 11:44:31 +03:00

3.2 KiB

Raw Blame History

Oracle Modes Configuration Guide - UNIFIED

🎯 Un Singur Dockerfile + Docker Compose

Oracle Version	Configurație .env	Comandă Build	Port
10g (test)	`INSTANTCLIENTPATH=...`	`docker-compose up --build`	5003
11g (prod)	`INSTANTCLIENTPATH=...`	`docker-compose up --build`	5003
12.1+ (nou)	`FORCE_THIN_MODE=true`	`ORACLE_MODE=thin docker-compose up --build`	5003

🔧 THICK MODE (Oracle 10g/11g) - DEFAULT

Configurare .env:

# Uncomment această linie pentru thick mode:
INSTANTCLIENTPATH=/opt/oracle/instantclient_23_9

# Comment această linie:
# FORCE_THIN_MODE=true

Rulare:

docker-compose up --build -d
curl http://localhost:5003/health

🚀 THIN MODE (Oracle 12.1+)

Varianta 1 - Prin .env (Recomandat):

# Comment această linie pentru thin mode:
# INSTANTCLIENTPATH=/opt/oracle/instantclient_23_9  

# Uncomment această linie:
FORCE_THIN_MODE=true

Varianta 2 - Prin build argument:

ORACLE_MODE=thin docker-compose up --build -d

Test:

curl http://localhost:5003/health

🔄 LOGICA AUTO-DETECT

Container-ul detectează automat modul:

FORCE_THIN_MODE=true → Thin Mode
INSTANTCLIENTPATH există → Thick Mode
Build cu ORACLE_MODE=thin → Thin Mode
Default → Thick Mode

🛠️ COMENZI SIMPLE

Pentru Oracle 10g/11g (setup-ul tău actual):

# Verifică .env să aibă:
grep INSTANTCLIENTPATH ./api/.env

# Start
docker-compose up --build -d
curl http://localhost:5003/test-db

Pentru Oracle 12.1+ (viitor):

# Editează .env: decomentează FORCE_THIN_MODE=true
# SAU rulează direct:
ORACLE_MODE=thin docker-compose up --build -d
curl http://localhost:5003/test-db

Switch rapid:

# Stop
docker-compose down

# Edit .env (change INSTANTCLIENTPATH ↔ FORCE_THIN_MODE)
# Start
docker-compose up --build -d

⚠️ TROUBLESHOOTING

Eroare DPY-3010 în Thin Mode:

DPY-3010: connections to this database server version are not supported

Soluție: Oracle este 11g sau mai vechi → folosește thick mode

Eroare libaio în Thick Mode:

Cannot locate a 64-bit Oracle Client library: libaio.so.1

Soluție: Rebuild container (fix automat în Dockerfile.thick)

Container nu pornește:

docker-compose logs
docker-compose down && docker-compose up --build

📊 COMPARAȚIE PERFORMANȚĂ

Aspect	Thick Mode	Thin Mode
Container Size	~200MB	~50MB
Startup Time	10-15s	3-5s
Memory Usage	~100MB	~30MB
Oracle Support	10g+	12.1+
Dependencies	Instant Client	None

🔧 DEZVOLTARE

Pentru dezvoltatori:

Thick mode pentru compatibilitate maximă
Thin mode pentru development rapid pe Oracle nou
Auto-detect în producție pentru flexibilitate

Testare ambele moduri:

# Thick pe port 5003
docker-compose -f docker-compose.thick.yaml up -d

# Thin pe port 5004  
docker-compose -f docker-compose.thin.yaml up -d

# Test ambele
curl http://localhost:5003/health
curl http://localhost:5004/health

3.2 KiB Raw Blame History