Questa guida ti accompagna passo dopo passo dalla registrazione al tuo primo deploy. In pochi minuti avrai un server configurato e funzionante.

Panoramica del Processo

Il flusso di lavoro con Kuboide è semplice e lineare:

1. Registrati e accedi a Kuboide
2. Crea una chiave SSH e installala sul server
3. Configura il server in Kuboide
4. Verifica la connessione e avvia l'installazione
5. Crea un progetto e collega il repository Git
6. Crea un ambiente e seleziona i servizi
7. Fai il deploy

Step 1: Registrazione

Vai su kuboide.com e crea il tuo account. Puoi iniziare con il piano gratuito per testare tutte le funzionalità.

Step 2: Prepara il Server

Prima di collegare un server a Kuboide, assicurati di avere:

• Un server Linux (Debian 12 o 13 consigliato)
• Accesso root o sudo al server
• Connessione SSH funzionante

Step 3: Crea e Installa la Chiave SSH

1. Vai nella sezione SSH Keys in Kuboide
2. Clicca su Add SSH Key
3. Compila i campi:
   • User: seleziona il tuo utente
   • Name: un nome descrittivo (es. "Server Production")
   • Description: una descrizione opzionale
4. Clicca su Generate
5. Nella pagina dettaglio, clicca Show sulla chiave pubblica
6. Clicca Copy to Clipboard
7. Accedi al tuo server via SSH e aggiungi la chiave:

echo "LA_TUA_CHIAVE_PUBBLICA" >> ~/.ssh/authorized_keys
chmod 600 ~/.ssh/authorized_keys

Per maggiori dettagli, consulta Chiavi Server.

Step 4: Aggiungi il Server in Kuboide

1. Vai nella sezione Servers
2. Clicca su Add Server
3. Compila i campi:
   • User: seleziona il tuo utente
   • Name: un nome descrittivo (es. "Production Server")
   • Host: indirizzo IP o hostname del server
   • SSH Key: seleziona la chiave creata allo Step 3
   • SSH Port: porta SSH (default: 22)
   • Description: una descrizione opzionale
4. Clicca su Save

Step 5: Verifica Connessione e Installazione

Dalla pagina dettaglio del server:

1. Clicca sul menu operazioni (icona tre punti in alto a destra)
2. Seleziona Server Check Connection per verificare la connessione SSH
3. Se la connessione ha successo, seleziona Server Install per avviare l'installazione

L'installazione automatica richiede alcuni minuti. Kuboide installerà Docker e tutti i componenti necessari. Puoi monitorare il progresso nella sezione Tasks.

Step 6: Configura la Chiave per Git

Se il tuo repository è privato:

1. Vai su SSH Keys e crea una nuova chiave (o usa la stessa)
2. Copia la chiave pubblica
3. Su GitHub, vai nel repository > Settings > Deploy keys
4. Clicca Add deploy key e incolla la chiave

Per maggiori dettagli, consulta Chiavi Git.

Step 7: Crea un Progetto

1. Vai nella sezione Projects
2. Clicca su Add Project
3. Compila i campi:
   • Server: seleziona il server configurato
   • SSH Key: seleziona la chiave per Git (se repository privato)
   • Name: nome del progetto
   • Description: una descrizione opzionale
   • Git Repository: URL SSH del repository (es. git@github.com:user/repo.git)
4. Clicca su Save

Step 8: Crea un Ambiente

1. Vai nella sezione Environments
2. Clicca su Add Environment
3. Seleziona il progetto
4. Configura:
   • Type: Development, Staging o Production
   • Servizi: seleziona i servizi necessari (Nginx, PHP, MySQL, ecc.)
   • Dominio: configura il dominio
5. Salva l'ambiente

Step 9: Deploy

1. Dalla pagina dettaglio dell'ambiente
2. Avvia le operazioni Docker per creare i container
3. Attendi il completamento

Il tuo sito è ora online!

Prossimi Passi

Ora che hai completato il primo deploy, puoi approfondire:

• Requisiti - Requisiti dettagliati del sistema
• Configurazione Servizi - Personalizza i servizi
• Gestione Risorse - Alloca CPU e RAM