Il tuo server clona ed esegue push dei tuoi repository da solo, quindi ha bisogno di una propria via d'accesso a GitHub, GitLab, Bitbucket o al tuo server Git. I repository pubblici non richiedono nulla. Per quelli privati, dai al server una chiave o un token una volta sola; da quel momento ogni progetto funziona senza altro.
Chiavi e token restano sul tuo server. rdev.cloud vede solo le chiavi pubbliche, e un token che digiti nel pannello viene cifrato nel tuo browser per il tuo server prima di essere inviato.
Tre modi per entrare
| Modo | Raggiunge | Ideale per |
|---|---|---|
| Chiave del server | Ogni repository che il tuo account Git può aprire | Un solo account personale |
| Account | I repository dei proprietari che elenchi, ciascuno con la propria chiave SSH o token | Più account, di lavoro e personali, altri host |
| Chiave di deploy | Un singolo repository | L'accesso più ristretto, repository dei clienti |
Quando il server clona, sceglie la prima che si adatta: la chiave di deploy del progetto, poi un account il cui host e proprietario corrispondono all'URL, poi la chiave del server. Se un clone SSH viene rifiutato e il repository è pubblico, ripiega su HTTPS. Ogni clone ricorda come è stato aperto, quindi git pull e git push continuano a funzionare.
La chiave del server
Apri il server in Server, vai alla scheda Accesso e trova Accesso Git. Scegli Crea chiave la prima volta, copia la chiave e aggiungila al tuo account: GitHub, GitLab e Bitbucket hanno ciascuno un pulsante che apre la pagina giusta. La stessa chiave funziona per i push, quindi può fare push anche il tuo agente AI.
Dal terminale del server:
rdev git key # print the key (made on first use)
rdev git key --rotate # make a new one; remove the old one from your hosts
Account
Aggiungi tutti gli account che vuoi: due account GitHub, un GitLab aziendale, Bitbucket e un Gitea self-hosted affiancati. Ogni account ha:
- Nome: breve, come
workopersonal. - Host:
github.com,gitlab.com,bitbucket.orgo il tuo, con:portquando SSH non è sulla 22. - Proprietari: utenti o organizzazioni, facoltativi. I repository al loro interno usano questo account; senza proprietari, lo usa ogni repository sull'host.
- Chiave SSH o token: un account SSH ottiene una propria chiave da aggiungere sull'host. Un account con token clona via HTTPS con un personal access token (token granulare di GitHub, token personale o di progetto di GitLab, token API di Bitbucket, PAT di Azure DevOps). GitLab si aspetta il nome utente
oauth2, Bitbucket la tua email.
Nel pannello scegli Aggiungi account. Nell'app per laptop lo stesso elenco si trova nella scheda Integrazioni. Dal terminale:
rdev git account add work --host github.com --owner acme
echo "$TOKEN" | rdev git account add lab --host git.example.com --token --user oauth2
rdev git account list
rdev git account remove lab
Chiavi di deploy
Una chiave di deploy apre un solo repository. In Chiavi di deploy digita il nome del progetto (un progetto esistente o quello che stai per aggiungere) e scegli Crea chiave di deploy, poi aggiungi la chiave alle chiavi di deploy del repository, con accesso in scrittura se l'agente deve fare push. Quando aggiungi il progetto, spunta Usa la chiave di deploy del progetto, oppure esegui:
rdev git key --project shop
rdev project add shop --git [email protected]:acme/shop.git --deploy-key
Considerare attendibile un host
Il server conosce già le chiavi di GitHub, GitLab e Bitbucket. La prima volta che incontra un altro host non si collega alla cieca: l'host compare in Host in attesa di essere considerati attendibili con la sua impronta digitale. Confrontala con quella pubblicata dal tuo host Git e scegli Considera attendibile, oppure esegui rdev git trust git.example.com --fingerprint SHA256:….
Verificare l'accesso
Prima di aggiungere un progetto, incolla il suo URL in Verifica l'accesso. Il server prova a leggerlo e, se spunti Controlla anche che possa fare push, a fare push senza cambiare nulla. La risposta indica quale chiave o token ha usato, o cosa fare dopo. Dal terminale: rdev git test <url> [--write].