Digita almeno due lettere per cercare in ogni pagina della documentazione.

↑ ↓ per navigare ↵ per aprire esc per chiudere

Usare rdev

Accesso Git

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 work o personal.
  • Host: github.com, gitlab.com, bitbucket.org o il tuo, con :port quando 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].