Startseite / Funktionen / Code / GitNest

GitNest — privates Git-Hosting mit Clone und Push in osFoundry

Echtes Git über HTTPS für Ihre Workspace-Repositories — mit Zugriffstokens, die Sie kontrollieren.

GitNest ist das eingebaute Git-Hosting von osFoundry. Jedes Repository in Ihrem Workspace hat ein echtes Git-Remote, das Sie mit jedem gängigen Git-Client über HTTPS klonen und in das Sie pushen können — ohne Plugin, ohne Export, ohne zweites Konto. Die Authentifizierung läuft über Workspace-Zugriffstokens, die Sie selbst anlegen und selbst widerrufen. Das Repository, das Sie klonen, ist dasselbe, das die Web-IDE bearbeitet und das Maestro liest: Was Sie lokal tun und was im Workspace passiert, ist dieselbe Historie.

Kurzantwort

Jedes Workspace-Repository mit gewöhnlichem Git über HTTPS klonen und pushen.
Authentifizierung über Workspace-Zugriffstokens, die Sie selbst anlegen, einschränken und widerrufen.
Repositories sind standardmäßig auf ihren Workspace beschränkt und damit privat.
Dasselbe Repository liegt der Web-IDE zugrunde — ein Push ist sofort im Workspace sichtbar.
Funktioniert mit jedem Git-Client: Kommandozeile, IDE oder CI-Job.

Was es ist

GitNest ist ein Git-Remote, das zu Ihrem Workspace gehört. Es ist kein Spiegel eines anderswo gehosteten Repositories und kein Ersatz für öffentliches Open-Source-Hosting — es ist der Ort, an dem der Code Ihres Workspace tatsächlich liegt, erreichbar von Ihrem Rechner aus mit dem Git, das Sie ohnehin benutzen. Weil es echtes Git ist und kein Export, funktionieren die gewohnten Befehle unverändert: Clone, Fetch, Branch, Push und jedes Werkzeug, das darauf aufsetzt.

Wichtige Funktionen

Clone, Fetch und Push über Smart HTTP, auf Basis der Referenzimplementierung von Git.
Zugriffstokens pro Benutzer, mit Ablaufdatum und Widerruf per Klick.
Autorisierung auf Workspace-Ebene — ein Token erreicht nur Repositories des eigenen Workspace.
Lese- und Schreibrechte pro Repository, sodass einem Token der Push verweigert werden kann.
Pushes erscheinen im Workspace: Web-IDE und Maestro sehen, was Sie gepusht haben.
Veröffentlichte Versionen sind geschützt — ein Push, der eine davon überschreiben würde, wird abgelehnt und nicht stillschweigend übernommen.

So geht’s in osFoundry

Zugriffstoken anlegen — Öffnen Sie Einstellungen → Repository-Tokens und legen Sie eines an. Es wird nur einmal angezeigt, kopieren Sie es also sofort. Geben Sie ihm ein Ablaufdatum — ein Token, das nie abläuft, ist eines, über das Sie sich nie wieder beruhigt zurücklehnen können.
Clone-URL kopieren — Öffnen Sie das Repository unter Code und benutzen Sie das Clone-Panel. Die URL enthält Ihren Workspace, denn ein Git-Client kann keine eigenen Header senden — die Adresse muss für sich allein vollständig sein.
Repository klonen — Führen Sie git clone mit dieser URL aus. Wenn Git nach dem Passwort fragt, geben Sie Ihr Token an; der Benutzername ist beliebig. Ein Credential-Helper merkt sich die Angaben.
Wie gewohnt committen und pushen — Branchen, committen und pushen Sie mit den Befehlen, die Sie ohnehin verwenden. Am Arbeitsablauf ist nichts osFoundry-spezifisch.
Ergebnis im Workspace sehen — Der Push wird in den Workspace zurückgespiegelt: Der Branch und seine Dateien erscheinen in der Web-IDE und stehen Maestro zur Verfügung.

So schneidet osFoundry ab

Funktion	osFoundry	Die meisten anderen Tools
Wo der Code liegt	Ein echtes Git-Remote in Ihrem eigenen Workspace.	Ein separates Hosting-Konto, über eine Integration angebunden.
Code herausbekommen	git clone — der Standardbefehl, ohne Export-Schritt.	Ein Archiv herunterladen oder ein Plugin zum Synchronisieren installieren.
Zugangsdaten	Workspace-Tokens mit Ablaufdatum, die Sie anlegen und widerrufen.	Ein Konto-Passwort oder eine OAuth-Freigabe an Dritte.
Editor und Remote	Beiden liegt dasselbe Repository zugrunde, sie können also nicht auseinanderlaufen.	Ein gehostetes Repo, das per Job in den Editor gespiegelt und synchron gehalten wird.

Anwendungsfälle

Entwicklerin oder Entwickler mit lokaler Umgebung: Klont das Workspace-Repository, arbeitet im eigenen Editor mit dem eigenen Werkzeugkasten und pusht zurück. Das Team sieht die Änderung im Workspace, ohne dass jemand etwas exportieren müsste.
CI-Pipeline: Ein Build-Job klont das Repository mit einem eingeschränkten Token samt Ablaufdatum, lässt die Testsuite laufen und braucht dafür weder ein persönliches Konto noch persönliche Zugangsdaten.
Team, das Code nicht öffentlich hosten will: Hält Repositories auf den Workspace beschränkt und arbeitet trotzdem mit gewöhnlichem Git, statt für Vertraulichkeit auf gewohnte Werkzeuge zu verzichten.

Häufig gestellte Fragen

Was ist GitNest?

GitNest ist das eingebaute Git-Hosting von osFoundry. Es gibt jedem Repository in Ihrem Workspace ein echtes Git-Remote, das Sie mit jedem gängigen Git-Client über HTTPS klonen und in das Sie pushen können.

Ist GitNest ein Ersatz für GitHub?

Nein, und das ist auch nicht das Ziel. GitHub bleibt der Ort für öffentliches Open-Source-Hosting und die Community drumherum. In GitNest liegen die eigenen Repositories Ihres Workspace, damit Sie lokal und in osFoundry daran arbeiten können, ohne Code zwischen zwei Systemen hin- und herzuschieben.

Kann ich meine gewohnten Git-Befehle benutzen?

Ja. GitNest spricht das übliche Smart-HTTP-Protokoll von Git und nutzt dafür dessen eigene Referenzimplementierung. Clone, Fetch, Branch und Push verhalten sich also genau wie überall sonst.

Unterstützt GitNest SSH?

Derzeit nicht — GitNest läuft ausschließlich über HTTPS. Sie authentifizieren sich mit einem Workspace-Zugriffstoken statt mit einem SSH-Schlüssel.

Wie authentifiziere ich mich?

Legen Sie in den Einstellungen ein Zugriffstoken an und geben Sie es als Passwort ein, wenn Git danach fragt. Der Benutzername wird nicht geprüft. Tokens werden nur einmal angezeigt, können ein Ablaufdatum bekommen und lassen sich jederzeit widerrufen.

Was passiert, wenn ich ein Token widerrufe?

Es funktioniert ab der nächsten Anfrage sofort nicht mehr. Was bereits auf einen Rechner geklont wurde, bleibt dort — ein Widerruf beendet den künftigen Zugriff, er löscht keine vorhandene Arbeitskopie.

Sind meine Repositories privat?

Ja. Repositories sind standardmäßig auf ihren Workspace beschränkt, und ein Token erreicht nur Repositories des Workspace, zu dem es gehört.

Erscheint ein Push im Workspace?

Ja. Sobald ein Push angenommen wurde, werden der Branch und seine Dateien in den Workspace zurückgespiegelt. Die Web-IDE zeigt also, was Sie gepusht haben, und Maestro kann es lesen.

Kann ich in eine veröffentlichte Version pushen?

Nein, und der Push wird von vornherein abgelehnt statt halb angewendet. Eine veröffentlichte Version ist ein feststehender Stand; würde ein Push sie überschreiben, weist GitNest ihn zurück und nennt Ihnen den betroffenen Branch — Ihr Repository bleibt unangetastet.

Kann ich GitNest aus CI heraus nutzen?

Ja. Legen Sie ein Token mit Ablaufdatum an, hinterlegen Sie es im Secret-Store Ihres CI-Anbieters und klonen Sie damit wie mit jedem anderen Git-Remote.

Preise

Das Hosting eines Repositories gehört zu Ihrem Workspace — es gibt keine gesonderte Gebühr pro Repository oder für deren Anzahl. Der Datenverkehr durch Clone und Push wird wie andere Bandbreite auf die Nutzung Ihres Workspace angerechnet.