Je server kloont en pusht je repositories zelf, dus hij heeft een eigen toegang nodig tot GitHub, GitLab, Bitbucket of je eigen Git-server. Openbare repositories hebben niets nodig. Geef de server voor privérepositories één keer een sleutel of token; elk project daarna werkt gewoon.
Sleutels en tokens blijven op je server. rdev.cloud ziet alleen openbare sleutels, en een token dat je in het paneel typt wordt in je browser voor je server versleuteld voordat het wordt verstuurd.
Drie manieren om binnen te komen
| Manier | Bereikt | Het best voor |
|---|---|---|
| Serversleutel | Elke repository die je Git-account kan openen | Eén persoonlijk account |
| Accounts | De repositories van de eigenaren die je opgeeft, elk met een eigen SSH-sleutel of token | Meerdere accounts, werk en privé, andere hosts |
| Deploy key | Eén enkele repository | De smalste toegang, klantrepositories |
Wanneer de server kloont, kiest hij de eerste die past: de deploy key van het project, dan een account waarvan host en eigenaar overeenkomen met de URL, dan de serversleutel. Als een SSH-kloon wordt geweigerd en de repository openbaar is, valt hij terug op HTTPS. Elke kloon onthoudt hoe hij is geopend, dus git pull en git push blijven werken.
De serversleutel
Open de server onder Servers, ga naar het tabblad Toegang en zoek Git-toegang. Kies de eerste keer Sleutel maken, kopieer de sleutel en voeg hem toe aan je account: GitHub, GitLab en Bitbucket hebben elk een knop die de juiste pagina opent. Dezelfde sleutel werkt voor pushes, dus je AI-agent kan ook pushen.
Vanuit de terminal van de 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
Accounts
Voeg zoveel accounts toe als je wilt: twee GitHub-accounts, een GitLab van het bedrijf, Bitbucket en een zelfgehoste Gitea naast elkaar. Elk account heeft:
- Naam: kort, zoals
workofpersonal. - Host:
github.com,gitlab.com,bitbucket.orgof je eigen, met:portwanneer SSH niet op 22 staat. - Eigenaren: optionele gebruikers of organisaties. Repositories eronder gebruiken dit account; zonder eigenaren doet elke repository op de host dat.
- SSH-sleutel of token: een SSH-account krijgt een eigen sleutel om op de host toe te voegen. Een tokenaccount kloont via HTTPS met een persoonlijk toegangstoken (fine-grained token van GitHub, persoonlijk of projecttoken van GitLab, API-token van Bitbucket, Azure DevOps-PAT). GitLab verwacht de gebruikersnaam
oauth2, Bitbucket je e-mailadres.
Kies in het paneel Account toevoegen. In de laptopapp staat dezelfde lijst op het tabblad Integraties. Vanuit de terminal:
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
Deploy keys
Een deploy key opent één repository. Typ onder Deploy keys de naam van het project (een bestaand project of het project dat je gaat toevoegen) en kies Deploy key maken, voeg de sleutel dan toe aan de deploy keys van de repository, met schrijftoegang als de agent moet pushen. Vink bij het toevoegen van het project De deploy key van het project gebruiken aan, of voer uit:
rdev git key --project shop
rdev project add shop --git [email protected]:acme/shop.git --deploy-key
Een host vertrouwen
De server kent al de sleutels van GitHub, GitLab en Bitbucket. De eerste keer dat hij een andere host tegenkomt, verbindt hij niet blindelings: de host verschijnt onder Hosts die op vertrouwen wachten met zijn vingerafdruk. Vergelijk die met die je Git-host publiceert en kies Vertrouwen, of voer rdev git trust git.example.com --fingerprint SHA256:… uit.
Toegang testen
Plak vóór het toevoegen van een project zijn URL onder Toegang testen. De server probeert hem te lezen en, als je Controleer ook of pushen mag aanvinkt, te pushen zonder iets te wijzigen. Het antwoord zegt welke sleutel of token hij gebruikte, of wat je daarna moet doen. Vanuit de terminal: rdev git test <url> [--write].