Kuboide si integra nativamente con i principali provider Git per gestire il codice sorgente e automatizzare i deploy. Questa guida approfondisce le opzioni di integrazione disponibili.

Provider Supportati

Kuboide supporta i seguenti provider Git:

• GitHub (github.com)
• GitLab (gitlab.com)
• Bitbucket (bitbucket.org)
• Repository self-hosted con accesso SSH

Formato URL Repository

Usa sempre il formato SSH per gli URL dei repository:

Nota: Non usare URL HTTPS. Usa sempre il formato SSH.

Configurare la Deploy Key

Per repository privati, devi aggiungere la deploy key di Kuboide al provider Git:

1. Crea una chiave SSH in Kuboide (SSH Keys > Add SSH Key)
2. Copia la chiave pubblica
3. Sul provider Git, vai nelle impostazioni del repository > Deploy keys
4. Aggiungi la chiave pubblica
5. Nel progetto Kuboide, seleziona la chiave nel campo SSH Key

Per le istruzioni dettagliate, consulta Chiavi Git.

Branch e Ambienti

Ogni ambiente in Kuboide può essere collegato a un branch specifico:

Questa configurazione permette un workflow Git standard:

1. Sviluppa sul branch develop
2. Merge su staging per i test
3. Merge su main per la produzione

Operazioni Git Disponibili

Da Kuboide puoi eseguire diverse operazioni Git:

Clone

Alla creazione di un ambiente, Kuboide clona automaticamente il repository sul server.

Pull

Scarica le ultime modifiche dal branch configurato. Utile per aggiornare l'ambiente senza un deploy completo.

Deploy

Esegue pull + eventuali operazioni post-deploy (build, cache clear, ecc.).

Repository Privati

Per repository privati, la deploy key è indispensabile. Assicurati che:

1. La deploy key sia aggiunta al repository sul provider Git
2. La chiave abbia i permessi di lettura
3. L'URL sia nel formato SSH
4. La chiave SSH sia selezionata nel progetto Kuboide

Cambiare Repository

Per cambiare il repository associato a un progetto:

1. Vai nei dettagli del progetto
2. Clicca su Configure
3. Modifica l'URL nel campo Git Repository
4. Salva le modifiche

Nota: Cambiare repository potrebbe richiedere un nuovo clone sugli ambienti esistenti.

Cambiare Branch

Per cambiare il branch di un ambiente:

1. Vai nei dettagli dell'ambiente
2. Modifica il branch
3. Salva e esegui un pull o deploy

Best Practices

Proteggi i Branch di Produzione

Sul provider Git, configura regole di protezione sul branch main:

• Richiedi review prima del merge
• Blocca push diretti
• Richiedi che i test passino

Usa Tag per le Release

Per le release di produzione, considera l'uso di tag Git:

git tag -a v1.0.0 -m "Release 1.0.0"
git push origin v1.0.0

Mantieni i Branch Aggiornati

Esegui regolarmente merge dal branch principale per evitare conflitti:

git checkout develop
git merge main

Risoluzione Problemi

"Repository not found"

• Verifica che l'URL sia corretto e nel formato SSH
• Controlla che la deploy key sia configurata sul provider Git
• Verifica i permessi sul repository

"Permission denied"

• La deploy key non è configurata o è stata rimossa
• L'URL usa HTTPS invece di SSH
• La chiave SSH selezionata nel progetto non è quella configurata

Conflitti Durante il Pull

• Risolvi i conflitti manualmente sul repository
• Esegui push delle modifiche
• Riprova il pull da Kuboide

Prossimi Passi

• Creare un Ambiente - Configura gli ambienti del progetto
• Configurazione Servizi - Scegli i servizi da installare