Per permettere a Kuboide di clonare e aggiornare i tuoi repository Git privati, devi aggiungere una deploy key al repository.

Cos'è una Deploy Key

Una deploy key è una chiave SSH che permette l'accesso in sola lettura (o lettura/scrittura) a un singolo repository. È più sicura rispetto a usare le credenziali personali perché:

• È limitata a un solo repository
• Può essere revocata senza impattare altri accessi
• Non richiede di condividere le tue credenziali

Step 1: Crea una Chiave SSH

Se non hai ancora una chiave SSH per Git:

1. Vai su SSH Keys
2. Clicca su Add SSH Key
3. Compila i campi:
   • User: seleziona il tuo utente
   • Name: un nome descrittivo (es. "GitHub - Nome Progetto")
   • Description: una descrizione opzionale
4. Clicca su Generate

Step 2: Copia la Chiave Pubblica

1. Vai su SSH Keys
2. Clicca sulla chiave appena creata
3. Clicca su Show accanto a "Public Key"
4. Clicca su Copy to Clipboard

Step 3: Aggiungi la Deploy Key

Su GitHub

1. Vai al repository su GitHub
2. Clicca su Settings (icona ingranaggio)
3. Nel menu laterale, clicca su Deploy keys
4. Clicca su Add deploy key
5. Nel campo Title, inserisci un nome (es. "Kuboide Deploy")
6. Nel campo Key, incolla la chiave pubblica copiata
7. Se hai bisogno di push, spunta Allow write access
8. Clicca su Add key

Su GitLab

1. Vai al repository su GitLab
2. Clicca su Settings > Repository
3. Espandi la sezione Deploy keys
4. Inserisci un titolo e incolla la chiave pubblica
5. Clicca su Add key

Su Bitbucket

1. Vai al repository su Bitbucket
2. Clicca su Repository settings > Access keys
3. Clicca su Add key
4. Inserisci un'etichetta e incolla la chiave pubblica
5. Clicca su Add key

Configurazione nel Progetto

Quando crei o modifichi un progetto in Kuboide:

1. Nel campo SSH Key, seleziona la chiave configurata sul provider Git
2. Nel campo Git Repository, inserisci l'URL SSH del repository

L'URL SSH ha questo formato:

Verifica la Configurazione

Per verificare che la chiave funzioni:

1. Crea un ambiente nel progetto
2. Kuboide clonerà automaticamente il repository durante il deploy

Se il clone fallisce, verifica che:

• La deploy key sia stata aggiunta correttamente sul provider Git
• L'URL del repository sia nel formato SSH (non HTTPS)
• La chiave SSH selezionata nel progetto sia quella configurata

Prossimi Passi

• Creare un Progetto - Configura un nuovo progetto
• Integrazione Git - Approfondisci le operazioni Git