I collegamenti Git associano i tuoi account Git alla tua organizzazione, così i siti possono fare il deploy dai tuoi repository. Vimonto Deploy supporta GitHub, GitLab (gitlab.com), GitLab (self-hosted) e Bitbucket. Con un collegamento scegli repository e branch da un elenco quando crei un sito, e Vimonto Deploy configura il repository per te: una deploy key in sola lettura, così il server può clonarlo, e un webhook per i push, così ogni push può avviare un deployment.
Colleghi GitHub, GitLab e Bitbucket con OAuth (un clic, accedendo presso l'host Git); un GitLab self-hosted con un personal access token. Puoi collegare più account, anche dello stesso servizio. Si trovano nella sezione Git di Impostazioni → Integrazioni.
Chi può collegare un account Git?
Ogni membro può vedere gli account collegati. Per collegare, verificare, rinominare, riconnettere e scollegare serve il ruolo Proprietario o Amministratore. Una volta collegato un account, ogni membro che può gestire i siti può usarlo per i propri siti. Collegamenti, cambi di nome e scollegamenti vengono registrati nel registro di audit, senza i token.
Collegare GitHub, GitLab o Bitbucket
- Apri Impostazioni → Integrazioni.
- Sotto Aggiungi un’integrazione, scegli Connetti nella scheda GitHub, GitLab o Bitbucket.
- Accedi presso l'host Git e approva l'accesso.
- Torni su Integrazioni con un messaggio che conferma che l'account è collegato. Il collegamento prende il nome del servizio e del tuo nome utente lì, per esempio
GitHub (octocat).
Se colleghi lo stesso account una seconda volta, Vimonto Deploy aggiorna il collegamento esistente invece di aggiungerne un duplicato.
Quale accesso chiede Vimonto Deploy?
| Servizio | Accesso richiesto | Perché |
|---|---|---|
| GitHub | repo, admin:repo_hook, read:user, read:org |
Leggere i tuoi repository (anche quelli privati e quelli delle tue organizzazioni GitHub), aggiungere deploy key e webhook per i push |
| GitLab | api |
Leggere i tuoi progetti, aggiungere deploy key e webhook per i push |
| Bitbucket | Account: Read, Repositories: Admin, Webhooks: Read and write | Leggere i tuoi repository, aggiungere deploy key e webhook per i push |
Con OAuth, Vimonto Deploy ha accesso a tutti i repository che l'account può vedere. Vuoi limitarlo? Usa invece un URL Git personalizzato con la deploy key del sito e aggiungi tu stesso quella chiave all'unico repository.
Collegare un GitLab self-hosted
- Nel tuo GitLab, apri Preferences → Access tokens → Add new token.
- Scegli lo scope
apie una data di scadenza adatta alle tue policy. - In Vimonto Deploy, scegli Connetti nella scheda GitLab (self-hosted) sotto Aggiungi un’integrazione.
- Inserisci l'Indirizzo del tuo GitLab (per esempio
https://gitlab.company.com) e il Personal access token. - Scegli Verifica e collega.
Vimonto Deploy verifica subito il token chiedendo a GitLab a chi appartiene. L'indirizzo deve usare HTTPS. Il tuo GitLab deve essere raggiungibile da Vimonto Deploy (per l'API) e dai tuoi server (per clonare).
Scegliere un repository per un sito
Quando crei un sito, scegli l'account collegato in Codice sorgente. Se vuoi, restringi l'elenco con Organizzazione, poi scegli il Repository e il suo branch. L'elenco parte dai 100 repository in cui l'account è stato attivo più di recente. Scrivi nel campo di ricerca per cercare tra tutti i repository a cui l'account ha accesso presso l'host Git; ciò che trova viene aggiunto all'elenco. Puoi anche usare qualsiasi repository tramite un URL Git personalizzato. Il repository di un sito lo cambi in seguito nella sua pagina Deployment.
Cosa succede quando un sito usa un collegamento?
Quando crei un sito con un repository di un account collegato, o cambi più tardi il repository di un sito, Vimonto Deploy esegue un task che collega il repository:
- Deploy key. Per impostazione predefinita ogni sito riceve la propria coppia di chiavi SSH (l'opzione Deploy key dedicata per … quando crei un sito). La chiave pubblica viene aggiunta al repository presso l'host Git come deploy key in sola lettura, con il nome del dominio e del server del sito. La chiave privata viene messa sul server, così il server può clonare e fare pull ma mai push.
- Webhook per i push. Per un repository di un account collegato, Deploy a ogni push (quick deploy) è attivo: Vimonto Deploy aggiunge quindi al repository un webhook che invia ogni push all'URL di deploy del sito. I push sul branch del sito avviano allora un deploy. Disattivando il quick deploy nella pagina Deployment del sito, il webhook viene rimosso. Se l'host Git rifiuta il webhook, il quick deploy viene disattivato e l'attività spiega perché; il sito fa comunque il deploy quando lo avvii tu.
- Primo deploy. Per un nuovo sito il primo deploy parte non appena il repository è collegato.
- Pulizia. Quando passi un sito a un altro repository o collegamento, o elimini il sito, la vecchia deploy key e il webhook vengono rimossi dall'host Git. Se non riesce, per esempio perché l'accesso del vecchio collegamento è scaduto, l'attività lo segnala e li rimuovi tu presso l'host Git. In caso di passaggio, il sito riceve allora una nuova deploy key, così il nuovo repository non rifiuta quella vecchia.
Senza una deploy key dedicata, un sito clona con la chiave del server. Trovi quella chiave in Chiave pubblica del server nella panoramica del server; aggiungila tu stesso al tuo host Git.
Rinnovo dei token
Alcuni host Git rilasciano token di accesso che scadono dopo qualche ora (GitLab e Bitbucket sempre, GitHub a seconda dell'app). Vimonto Deploy salva il refresh token e ottiene da solo un nuovo token di accesso, appena prima che una richiesta ne abbia bisogno. Non devi ricollegarti per questo.
Se il rinnovo fallisce, perché l'accesso è stato revocato presso l'host Git o l'account è stato rimosso, le richieste falliscono con un messaggio come "Il collegamento con GitHub è scaduto. Collegalo di nuovo." Scegli Riconnetti nel menu del collegamento per accedere di nuovo; i tuoi siti continuano a usare lo stesso collegamento.
Verificare, rinominare e riconnettere un collegamento
Ogni collegamento mostra Funzionante quando l'ultima verifica è riuscita, altrimenti Riconnetti. Nel menu (⋯) accanto a un collegamento puoi:
- Verifica connessione: chiede all'host Git a quale account appartiene il token e mostra "Accesso effettuato come …".
- Riconnetti: accede di nuovo con OAuth e rinnova i token (GitHub, GitLab e Bitbucket).
- Aggiorna token: sostituisce il personal access token di un collegamento GitLab (self-hosted) (solo questi). Il nuovo token deve appartenere allo stesso account GitLab.
- Rinomina: cambia il nome mostrato in Vimonto Deploy.
- Scollega: rimuove il collegamento.
Scollegare un account Git
Scegli Scollega nel menu e conferma. Scollegare non impedisce a nessun sito di fare il deploy. Si ferma tutto ciò che passa per l'account: non puoi più sceglierne i repository, e Vimonto Deploy non può più aggiungere o rimuovere deploy key e webhook nei suoi repository. I siti collegati tramite questo account mantengono indirizzo del repository, deploy key e webhook, quindi continuano a clonare e i push avviano ancora i deploy; nella loro pagina Deployment ora mostrano un URL Git personalizzato. Se elimini un sito del genere, rimuovi tu la sua deploy key e il webhook presso l'host Git.
Vimonto Deploy non revoca il proprio accesso presso l'host Git; per farlo, rimuovi anche l'app OAuth autorizzata (o elimina il token di accesso) su GitHub, GitLab o Bitbucket.
Domande frequenti
Mi serve un collegamento Git per fare il deploy?
No. Puoi anche fare il deploy da un URL Git personalizzato: SSH (git@…) per i repository privati, con la deploy key del sito che aggiungi tu stesso al repository, oppure HTTPS per quelli pubblici. In quel caso avvii tu i deploy, o li avvii dalla CI con l'URL di deploy del sito. Vedi deployment.
Vimonto Deploy può fare push sul mio repository?
No. Le deploy key vengono aggiunte in sola lettura, quindi un server può clonare e fare pull ma non push.
Vimonto Deploy vede tutti i miei repository?
Con OAuth può leggere ogni repository che l'account collegato può leggere; modifica solo i repository che colleghi a un sito (una deploy key e, con il quick deploy, un webhook). Per un accesso più ristretto, collega un account Git separato con accesso solo ai repository di cui fai il deploy, oppure usa un URL Git personalizzato.
Posso usare le organizzazioni GitHub?
Sì. L'elenco dei repository include i repository del tuo account e delle organizzazioni GitHub di cui sei membro, nella misura in cui l'organizzazione consente l'app OAuth.
Cosa succede ai repository collegati quando trasferisco un server?
I collegamenti restano nella tua organizzazione. I siti di un server trasferito perdono il legame con il collegamento e il quick deploy viene disattivato; continuano a fare il deploy dal loro indirizzo del repository con la propria deploy key. La nuova organizzazione può collegarli a uno dei propri collegamenti nella pagina Deployment di ogni sito.