Creare un Progetto

Un progetto in Kuboide rappresenta un'applicazione o un sito web. Ogni progetto può contenere più ambienti (sviluppo, staging, produzione) ed è collegato a un repository Git.

Prerequisiti: Prima di creare un progetto, assicurati di avere:

Almeno un server installato

La chiave Git configurata sul provider (per repository privati)

L'URL SSH del repository Git

Creare un Nuovo Progetto

Accedi a Kuboide
Nel menu laterale, clicca su Projects
Clicca sul pulsante Add Project

Configurazione del Progetto

Campo	Tipo	Obbligatorio	Descrizione
Server	Select	Sì	Server su cui ospitare il progetto
SSH Key	Select	No	Chiave SSH per accedere al repository (per repo privati)
Name	Text	Sì	Nome descrittivo del progetto
Description	Textarea	No	Note aggiuntive sul progetto
Git Repository	Text	No	URL SSH del repository Git

Configurazione Git

Il campo Git Repository deve contenere l'URL SSH del repository:

Provider	Formato URL
GitHub	`git@github.com:username/repository.git`
GitLab	`git@gitlab.com:username/repository.git`
Bitbucket	`git@bitbucket.org:username/repository.git`

Nota: Usa sempre l'URL SSH, non HTTPS.

Descrizione (Opzionale)

Aggiungi una descrizione per documentare:

Lo scopo del progetto
Le tecnologie utilizzate
Note per il team

Salva il Progetto

Verifica che tutti i dati siano corretti
Clicca su Save
Il progetto viene creato e appare nella lista

Dopo la Creazione

Dopo aver creato il progetto, puoi:

Creare ambienti: sviluppo, staging, produzione
Configurare i servizi: scegli PHP, Node.js, database, ecc.
Eseguire il deploy: pubblica il tuo codice

Struttura Consigliata

Ti consigliamo di organizzare i progetti seguendo questa struttura:

terminal

Progetto (es. "E-commerce")
├── Ambiente Development
│   └── Branch: develop
├── Ambiente Staging
│   └── Branch: staging
└── Ambiente Production
    └── Branch: main

Questa struttura permette di:

Sviluppare sul branch develop
Testare su staging prima della produzione
Deployare su main solo codice stabile

Modificare un Progetto

Per modificare un progetto esistente:

Vai nella sezione Projects
Clicca sul progetto da modificare
Clicca su Configure
Modifica i campi necessari
Clicca su Save

Eliminare un Progetto

Per eliminare un progetto:

Vai nei dettagli del progetto
Clicca su Delete
Conferma l'operazione

Attenzione: Eliminare un progetto rimuove anche tutti gli ambienti associati. Questa azione è irreversibile.

Limiti del Piano

Il numero di progetti che puoi creare dipende dal tuo piano:

Piano	Progetti
Free	1
Premium	3
Pro	9
Elite	18

Prossimi Passi

Integrazione Git - Approfondisci la configurazione Git
Creare un Ambiente - Crea il primo ambiente del progetto

Docs