Configurazione Servizi
Ogni ambiente in Kuboide può includere diversi servizi. Questa guida spiega come selezionare, configurare e personalizzare i servizi per le tue esigenze.
Servizi Disponibili
Reverse Proxy e SSL
Traefik
- Gestione automatica certificati SSL Let's Encrypt
- Routing del traffico verso i servizi
- Load balancing
Cache HTTP
Varnish
- Cache delle pagine per performance estreme
- Riduzione carico sul web server
- Configurazione VCL personalizzabile
Web Server
Nginx
- Server web ad alte prestazioni
- Configurazione virtual host
- Gestione file statici
Runtime Applicativi
PHP
- Versioni: 7.4, 8.0, 8.1, 8.2, 8.3
- PHP-FPM ottimizzato
- Estensioni comuni preinstallate
- Composer e WP-CLI opzionali
Node.js
- Versioni: 18, 20, 22
- NVM e NPM inclusi
- Process manager integrato
Database
MySQL
- Database relazionale classico
- Compatibile con la maggior parte delle applicazioni
MariaDB
- Fork di MySQL con miglioramenti
- Compatibile al 100% con MySQL
- Performance ottimizzate
PostgreSQL
- Database relazionale avanzato
- Supporto JSON nativo
- Estensioni avanzate
MongoDB
- Database NoSQL document-oriented
- Schema flessibile
- Ideale per dati non strutturati
Cache e Session
Redis
- Cache in memoria ultra-veloce
- Gestione sessioni
- Code e pub/sub
Storage
MinIO
- Object storage S3-compatible
- Gestione file e media
- API compatibile con AWS S3
AI e Vector Database
Qdrant
- Vector database per AI/ML
- Ricerca semantica
- Embeddings storage
Ollama
- LLM locale (Llama, Mistral, ecc.)
- Privacy totale dei dati
- No costi API esterni
Automazione
N8N
- Workflow automation
- Integrazione con centinaia di servizi
- Alternativa self-hosted a Zapier
Altri Servizi
ProFTPD - Server FTP/SFTP per trasferimento file
Cron - Esecuzione task programmati
Abilitare un Servizio
- Vai nei dettagli dell'ambiente
- Seleziona la tab del servizio desiderato
- Attiva lo switch Enabled
- Seleziona la versione
- Clicca su Save per salvare la configurazione del servizio
Configurare un Servizio
Ogni servizio ha opzioni specifiche. Clicca sulla tab del servizio per accedere alla configurazione:
Opzioni Comuni
| Opzione | Descrizione |
|---|---|
| Enabled | Attiva/disattiva il servizio |
| Version | Versione del servizio da utilizzare |
| CPU | Risorse CPU allocate |
| Memory | RAM allocata |
File di Configurazione
Per ogni servizio puoi modificare i file di configurazione:
- Clicca sulla tab del servizio
- Scorri alla sezione Configuration Files
- Clicca su Edit per aprire l'editor
- Modifica il file
- Clicca su Save
Nota: Kuboide fornisce configurazioni ottimizzate di default. Modifica solo se necessario.
Esempi di Stack
Stack PHP Classico (Laravel, WordPress)
| Servizio | Note |
|---|---|
| Traefik | SSL automatico |
| Nginx | Web server |
| PHP 8.2 | Runtime |
| MySQL/MariaDB | Database |
| Redis | Cache/session |
Stack Node.js (Next.js, Express)
| Servizio | Note |
|---|---|
| Traefik | SSL automatico |
| Nginx | Reverse proxy |
| Node.js 20 | Runtime |
| PostgreSQL | Database |
| Redis | Cache |
Stack con AI
| Servizio | Note |
|---|---|
| Qdrant | Vector database |
| Ollama | LLM locale |
| Redis | Cache embeddings |
Disabilitare un Servizio
- Vai nei dettagli dell'ambiente
- Seleziona la tab del servizio
- Disattiva lo switch Enabled
- Clicca su Save
Attenzione: Disabilitare un servizio non elimina i suoi dati, ma il servizio non sarà più attivo.
Riavviare i Servizi
Dopo modifiche alla configurazione:
- Vai nei dettagli dell'ambiente
- Dal menu operazioni, seleziona Docker Compose Restart
Best Practices
- Inizia semplice: aggiungi solo i servizi necessari
- Testa su staging: prova le configurazioni prima della produzione
- Documenta: annota le personalizzazioni fatte
- Monitora: controlla l'uso delle risorse dopo le modifiche
Prossimi Passi
- Gestione Risorse - Alloca CPU e RAM ai servizi
- Consulta le guide specifiche per ogni servizio nella sezione Services