Creare un Ambiente
Un ambiente in Kuboide rappresenta un'istanza del tuo progetto: può essere un ambiente di sviluppo, staging o produzione. Ogni ambiente ha la propria configurazione, i propri servizi e può essere collegato a un branch Git diverso.
Prerequisiti: Prima di creare un ambiente:
- Devi aver creato un progetto
- Il server del progetto deve essere installato
- La chiave Git deve essere configurata (per repository privati)
Tipi di Ambiente
Kuboide supporta tre tipi di ambiente:
| Tipo | Branch Tipico | Uso |
|---|---|---|
| Development | `develop` | Test nuove funzionalità |
| Staging | `staging` | Test finali pre-produzione |
| Production | `main` | Ambiente per utenti finali |
Creare un Nuovo Ambiente
- Vai nella sezione Environments
- Clicca sul pulsante Add Environment
Configurazione Base
| Campo | Tipo | Obbligatorio | Descrizione |
|---|---|---|---|
| Project | Select | Sì | Progetto a cui appartiene l'ambiente |
| Type | Select | Sì | Development, Staging o Production |
| Name | Text | Sì | Nome descrittivo (es. "Development", "Staging IT") |
| Description | Textarea | No | Note aggiuntive sull'ambiente |
| Git Branch | Text | No | Branch Git da utilizzare (es. `develop`, `main`) |
| Timezone | Text | No | Fuso orario del server |
Selezione Servizi
Scegli i servizi necessari per il tuo ambiente. I servizi disponibili includono:
Reverse Proxy
- Traefik - Gestione SSL automatica con Let's Encrypt
Cache
- Varnish - HTTP cache per prestazioni elevate
Web Server
- Nginx - Web server per contenuti statici e dinamici
Runtime
- PHP - Con Composer e WP-CLI opzionali
- Node.js - Con NVM e NPM
Database
- MySQL
- MariaDB
- PostgreSQL
- MongoDB
Cache/Session
- Redis
Storage
- MinIO - Object storage S3-compatible
AI
- Qdrant - Vector database per AI
- Ollama - LLM locale
Automation
- N8N - Workflow automation
Altri
- Cron - Task schedulati
- ProFTPD - Server FTP
Nota: Seleziona solo i servizi che ti servono. Puoi sempre aggiungerli o rimuoverli in seguito.
Configurazione Avanzata
Dopo aver selezionato i servizi, puoi configurare per ogni servizio:
- Risorse: CPU e RAM allocate
- Configurazioni: File di configurazione personalizzati
- Credenziali: Username, password e porte
Queste opzioni sono descritte in Configurazione Servizi e Gestione Risorse.
Salva e Avvia
- Verifica la configurazione
- Clicca su Save
- Dal menu operazioni, seleziona Docker Compose Up per avviare i container
Operazioni Ambiente
Dalla pagina dettaglio dell'ambiente, tramite il menu operazioni puoi:
| Operazione | Descrizione |
|---|---|
| Git Push | Carica le modifiche sul repository |
| Git Pull | Scarica le ultime modifiche dal repository |
| Docker Compose Up | Avvia i container |
| Docker Compose Restart | Riavvia i container |
| Docker Compose Down | Ferma i container |
| Docker Compose Clean | Rimuove container e volumi |
Modificare un Ambiente
Per modificare un ambiente esistente:
- Vai nei dettagli dell'ambiente
- Modifica le configurazioni necessarie
- Salva le modifiche
- Alcune modifiche potrebbero richiedere un riavvio dei servizi
Eliminare un Ambiente
Per eliminare un ambiente:
- Vai nei dettagli dell'ambiente
- Clicca su Delete
- Conferma l'operazione
Attenzione: L'eliminazione rimuove tutti i dati dell'ambiente dal server. Questa azione è irreversibile.
Prossimi Passi
- Configurazione Servizi - Personalizza i servizi
- Gestione Risorse - Alloca CPU e RAM