Geben Sie mindestens zwei Buchstaben ein, um alle Seiten der Doku zu durchsuchen.

↑ ↓ zum Navigieren ↵ zum Öffnen esc zum Schließen

rdev nutzen

Git-Zugriff

Ihr Server klont und pusht Ihre Repositories selbst, braucht also einen eigenen Zugang zu GitHub, GitLab, Bitbucket oder Ihrem eigenen Git-Server. Öffentliche Repositories brauchen nichts. Für private geben Sie dem Server einmal einen Schlüssel oder Token; danach funktioniert jedes Projekt einfach.

Schlüssel und Tokens bleiben auf Ihrem Server. rdev.cloud sieht nur öffentliche Schlüssel, und ein Token, den Sie im Panel eingeben, wird in Ihrem Browser für Ihren Server verschlüsselt, bevor er gesendet wird.

Drei Wege hinein

Weg Erreicht Am besten für
Server-Schlüssel Jedes Repository, das Ihr Git-Konto öffnen kann Ein persönliches Konto
Konten Die Repositories der von Ihnen aufgeführten Inhaber, jeweils mit eigenem SSH-Schlüssel oder Token Mehrere Konten, beruflich und privat, andere Hosts
Deploy-Schlüssel Ein einzelnes Repository Engster Zugriff, Kunden-Repositories

Beim Klonen wählt der Server den ersten passenden: den Deploy-Schlüssel des Projekts, dann ein Konto, dessen Host und Inhaber zur URL passen, dann den Server-Schlüssel. Wird ein SSH-Klon abgelehnt und das Repository ist öffentlich, weicht er auf HTTPS aus. Jeder Klon merkt sich, wie er geöffnet wurde, sodass git pull und git push weiter funktionieren.

Der Server-Schlüssel

Öffnen Sie den Server unter Server, wechseln Sie zum Tab Zugriff und suchen Sie Git-Zugriff. Wählen Sie beim ersten Mal Schlüssel erstellen, kopieren Sie den Schlüssel und fügen Sie ihn Ihrem Konto hinzu: GitHub, GitLab und Bitbucket haben je eine Schaltfläche, die die richtige Seite öffnet. Derselbe Schlüssel funktioniert auch für Pushes, sodass Ihr KI-Agent ebenfalls pushen kann.

Im Terminal des Servers:

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

Konten

Fügen Sie beliebig viele Konten hinzu: zwei GitHub-Konten, ein Firmen-GitLab, Bitbucket und ein selbst gehostetes Gitea nebeneinander. Jedes Konto hat:

  • Name: kurz, etwa work oder personal.
  • Host: github.com, gitlab.com, bitbucket.org oder Ihr eigener, mit :port, wenn SSH nicht auf 22 läuft.
  • Inhaber: optional Benutzer oder Organisationen. Repositories unter ihnen verwenden dieses Konto; ohne Inhaber verwendet es jedes Repository auf dem Host.
  • SSH-Schlüssel oder Token: Ein SSH-Konto erhält einen eigenen Schlüssel, den Sie beim Host hinzufügen. Ein Token-Konto klont per HTTPS mit einem Personal Access Token (feingranularer GitHub-Token, persönlicher oder Projekt-Token von GitLab, Bitbucket-API-Token, Azure-DevOps-PAT). GitLab erwartet den Benutzernamen oauth2, Bitbucket Ihre E-Mail-Adresse.

Wählen Sie im Panel Konto hinzufügen. In der Laptop-App steht dieselbe Liste im Tab Integrations. Im 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-Schlüssel

Ein Deploy-Schlüssel öffnet ein Repository. Geben Sie unter Deploy-Schlüssel den Namen des Projekts ein (ein bestehendes Projekt oder das, das Sie gleich hinzufügen) und wählen Sie Deploy-Schlüssel erstellen; fügen Sie den Schlüssel dann den Deploy-Schlüsseln des Repositories hinzu, mit Schreibzugriff, wenn der Agent pushen soll. Wenn Sie das Projekt hinzufügen, aktivieren Sie Den Deploy-Schlüssel des Projekts verwenden, oder führen Sie aus:

rdev git key --project shop
rdev project add shop --git [email protected]:acme/shop.git --deploy-key

Einem Host vertrauen

Der Server kennt die Schlüssel von GitHub, GitLab und Bitbucket bereits. Beim ersten Treffen mit einem anderen Host verbindet er sich nicht blind: Der Host erscheint mit seinem Fingerabdruck unter Hosts, die auf Vertrauensstellung warten. Vergleichen Sie ihn mit dem, den Ihr Git-Host veröffentlicht, und wählen Sie Vertrauen, oder führen Sie rdev git trust git.example.com --fingerprint SHA256:… aus.

Zugriff testen

Fügen Sie vor dem Hinzufügen eines Projekts dessen URL unter Zugriff testen ein. Der Server versucht, es zu lesen, und, wenn Sie Auch prüfen, ob er pushen darf aktivieren, zu pushen, ohne etwas zu ändern. Die Antwort sagt, welchen Schlüssel oder Token er verwendet hat oder was als Nächstes zu tun ist. Im Terminal: rdev git test <url> [--write].