Twój serwer sam klonuje i wypycha Twoje repozytoria, więc potrzebuje własnej drogi do GitHuba, GitLaba, Bitbucket lub Twojego własnego serwera Git. Publiczne repozytoria nie wymagają niczego. Dla prywatnych daj serwerowi raz klucz lub token; każdy kolejny projekt po prostu działa.
Klucze i tokeny zostają na Twoim serwerze. rdev.cloud widzi tylko klucze publiczne, a token wpisany w panelu jest szyfrowany w przeglądarce dla Twojego serwera, zanim zostanie wysłany.
Trzy drogi
| Droga | Dociera do | Najlepsza do |
|---|---|---|
| Klucz serwera | Każde repozytorium, które może otworzyć Twoje konto Git | Jedno konto osobiste |
| Konta | Repozytoria wymienionych właścicieli, każde z własnym kluczem SSH lub tokenem | Kilka kont, służbowe i prywatne, inne hosty |
| Klucz wdrożeniowy | Jedno repozytorium | Najwęższy dostęp, repozytoria klientów |
Gdy serwer klonuje, wybiera pierwszą pasującą: klucz wdrożeniowy projektu, potem konto, którego host i właściciel pasują do adresu URL, potem klucz serwera. Jeśli klonowanie przez SSH zostanie odrzucone, a repozytorium jest publiczne, wraca do HTTPS. Każdy klon zapamiętuje, jak został otwarty, więc git pull i git push nadal działają.
Klucz serwera
Otwórz serwer w Serwery, przejdź do karty Dostęp i znajdź Dostęp do Git. Przy pierwszym razie wybierz Utwórz klucz, skopiuj klucz i dodaj go do swojego konta: GitHub, GitLab i Bitbucket mają po przycisku, który otwiera właściwą stronę. Ten sam klucz działa przy wypychaniu, więc Twój agent AI też może wypychać.
Z terminala serwera:
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
Konta
Dodaj tyle kont, ile chcesz: dwa konta GitHub, firmowy GitLab, Bitbucket i własny Gitea obok siebie. Każde konto ma:
- Nazwa: krótka, na przykład
worklubpersonal. - Host:
github.com,gitlab.com,bitbucket.orglub własny, z:port, gdy SSH nie jest na 22. - Właściciele: opcjonalnie użytkownicy lub organizacje. Repozytoria pod nimi używają tego konta; bez właścicieli używa go każde repozytorium na hoście.
- Klucz SSH lub token: konto SSH dostaje własny klucz do dodania na hoście. Konto z tokenem klonuje przez HTTPS za pomocą osobistego tokena dostępu (token szczegółowy GitHub, osobisty lub projektowy token GitLab, token API Bitbucket, PAT Azure DevOps). GitLab oczekuje nazwy użytkownika
oauth2, Bitbucket Twojego e-maila.
W panelu wybierz Dodaj konto. W aplikacji na laptopa ta sama lista jest na karcie Integracje. Z terminala:
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
Klucze wdrożeniowe
Klucz wdrożeniowy otwiera jedno repozytorium. W sekcji Klucze wdrożeniowe wpisz nazwę projektu (istniejącego lub tego, który zaraz dodasz) i wybierz Utwórz klucz wdrożeniowy, a potem dodaj klucz do kluczy wdrożeniowych repozytorium, z dostępem do zapisu, jeśli agent ma wypychać. Gdy dodajesz projekt, zaznacz Użyj klucza wdrożeniowego projektu albo uruchom:
rdev git key --project shop
rdev project add shop --git [email protected]:acme/shop.git --deploy-key
Zaufanie do hosta
Serwer zna już klucze GitHuba, GitLaba i Bitbucket. Gdy po raz pierwszy spotyka inny host, nie łączy się na ślepo: host pojawia się w Hosty oczekujące na zaufanie wraz ze swoim odciskiem palca. Porównaj go z tym, który publikuje Twój host Git, i wybierz Zaufaj, albo uruchom rdev git trust git.example.com --fingerprint SHA256:….
Testowanie dostępu
Przed dodaniem projektu wklej jego adres URL w Przetestuj dostęp. Serwer próbuje go odczytać i, jeśli zaznaczysz Sprawdź też, czy może wypychać zmiany, wypchnąć bez zmieniania czegokolwiek. Odpowiedź mówi, którego klucza lub tokena użył, albo co zrobić dalej. Z terminala: rdev git test <url> [--write].