ids.alfacom.it/deployment/BOOTSTRAP_PRIMO_DEPLOYMENT.md

🚀 BOOTSTRAP - Primo Deployment su Server AlmaLinux

Problema

Sul server AlmaLinux in /opt/ids esiste già:

• ✅ .env con credenziali PostgreSQL funzionanti
• ✅ Database PostgreSQL configurato
• ✅ Servizi attivi (syslog_parser, ecc.)

Ma NON esiste ancora:

• ❌ update_from_git.sh (script di aggiornamento)
• ❌ git.env (credenziali GitLab)

RISCHIO: Se fai semplicemente git pull, potresti sovrascrivere .env e perdere le configurazioni.

---

✅ Soluzione: Clone + Swap Atomico

Step 1: Clone in Directory Separata

# Login come root
sudo su -

# Vai in /opt
cd /opt

# Clone repository in directory temporanea
sudo -u ids git clone https://marco:553da84c94093919d46055d6ec37dfa2a03d0f46@git.alfacom.it/marco/ids.git ids_git

# Verifica clone
ls -la ids_git/

Step 2: Preserva File Locali (NON su Git)

# Copia .env esistente nel clone
sudo -u ids cp /opt/ids/.env /opt/ids_git/.env

# Se esiste git.env, copialo (altrimenti crealo dopo)
if [ -f /opt/ids/git.env ]; then
  sudo -u ids cp /opt/ids/git.env /opt/ids_git/git.env
fi

# Copia modelli ML addestrati (se esistono)
if [ -d /opt/ids/python_ml/models ]; then
  sudo -u ids cp -r /opt/ids/python_ml/models/*.pkl /opt/ids_git/python_ml/models/ 2>/dev/null || true
  sudo -u ids cp -r /opt/ids/python_ml/models/*.joblib /opt/ids_git/python_ml/models/ 2>/dev/null || true
fi

# Copia backup database locali (se esistono)
if [ -d /opt/ids/database-backups ]; then
  sudo -u ids cp -r /opt/ids/database-backups /opt/ids_git/
fi

Step 3: Verifica Configurazione

# Verifica .env
cat /opt/ids_git/.env | grep PGHOST
# Output atteso: PGHOST=127.0.0.1

# Verifica permessi
ls -la /opt/ids_git/.env
# Owner deve essere: ids:ids

Step 4: Ferma Servizi

# Ferma syslog_parser
pkill -f syslog_parser

# Verifica che sia fermo
ps aux | grep syslog_parser

Step 5: Swap Atomico Directory

# Rinomina directory vecchia
mv /opt/ids /opt/ids_legacy

# Sposta nuova directory
mv /opt/ids_git /opt/ids

# Verifica
ls -la /opt/ids/update_from_git.sh
# Deve esistere!

Step 6: Installa Dipendenze

# Node.js dependencies
cd /opt/ids
sudo -u ids npm install

# Python dependencies
cd /opt/ids/python_ml
sudo -u ids pip3.11 install -r requirements.txt

Step 7: Crea git.env (se non esiste)

cd /opt/ids

# Crea git.env
sudo -u ids nano git.env

Contenuto git.env:

GITLAB_USER=marco
GITLAB_TOKEN=553da84c94093919d46055d6ec37dfa2a03d0f46
GITLAB_REPO=https://git.alfacom.it/marco/ids.git
GITLAB_BRANCH=main

Step 8: Riavvia Servizi

# Riavvia syslog_parser
cd /opt/ids/python_ml
sudo -u ids nohup python3.11 syslog_parser.py > /var/log/ids/syslog_parser.log 2>&1 &

# Verifica log
tail -f /var/log/ids/syslog_parser.log
# Output atteso: "Connesso a PostgreSQL via 127.0.0.1"

# Riavvia applicazione web (se configurata)
systemctl restart ids-web 2>/dev/null || echo "Servizio web non configurato"

Step 9: Test Funzionamento

# Verifica update_from_git.sh
cd /opt/ids
./update_from_git.sh --help

# Test database
psql -h 127.0.0.1 -U ids_user -d ids_db -c "SELECT COUNT(*) FROM network_logs;"
# Deve mostrare i log esistenti

# Verifica git remote
git remote -v
# Deve mostrare: origin https://git.alfacom.it/marco/ids.git

---

🔄 Aggiornamenti Futuri (Dopo Bootstrap)

Usa SEMPRE update_from_git.sh:

# Aggiornamento codice
cd /opt/ids
./update_from_git.sh

# Aggiornamento codice + sync schema database
cd /opt/ids
./update_from_git.sh --db

IMPORTANTE: update_from_git.sh fa backup automatico di .env e git.env prima di fare git pull, quindi è sicuro!

---

🔒 Sicurezza

File Protetti (NON su Git)

• .env - Credenziali PostgreSQL
• git.env - Token GitLab
• database-backups/*.sql.gz - Backup completi
• python_ml/models/*.pkl - Modelli addestrati

File su Git (Template)

• .env.example - Template configurazione
• git.env.example - Template credenziali Git
• database-schema/schema.sql - SOLO schema (no dati)

---

🆘 Rollback (In caso di problemi)

# Ripristina directory vecchia
sudo mv /opt/ids /opt/ids_failed
sudo mv /opt/ids_legacy /opt/ids

# Riavvia servizi
cd /opt/ids/python_ml
sudo -u ids pkill -f syslog_parser
sudo -u ids nohup python3.11 syslog_parser.py > /var/log/ids/syslog_parser.log 2>&1 &

---

✅ Checklist Post-Bootstrap

• /opt/ids/update_from_git.sh esiste ed è eseguibile
• /opt/ids/.env contiene PGHOST=127.0.0.1
• /opt/ids/git.env contiene credenziali GitLab
• syslog_parser.py è attivo e scrive su PostgreSQL
• Database contiene log esistenti
• git remote -v mostra origin corretto
• /opt/ids_legacy può essere eliminato dopo 1 settimana

---

📝 Note

• Bootstrap è un'operazione ONE-TIME (una volta sola)
• Dopo bootstrap, usa SEMPRE update_from_git.sh
• NON eliminare /opt/ids_legacy prima di 7 giorni
• Verifica sempre i log dopo ogni aggiornamento