ADO-Git
ADO-Git zeigt Git-Repositorys aus Azure DevOps unmittelbar im Wiki: im Baum browsen, Quellcode anzeigen, eine Datei bearbeiten und committen sowie clone, pull und push über einen Proxy. Gedacht ist das Paket für Leser, die Quellcode ohne eigene ADO-Lizenz einsehen sollen, für Autoren, die ein Repository auf einer Wiki-Seite zeigen, und für Verwalter, die Repositorys anbinden und ihre Sichtbarkeit festlegen.
Der Arbeitsbereich eines Repositorys: links wählen Sie Repository und Branch und navigieren den Dateibaum, rechts steht die geöffnete Datei. Die Statusleiste unten nennt durchgehend Repository, Sichtbarkeit, Branch und Ihre Rolle.
Oben in der Seitenleiste wechseln Sie mit den beiden Auswahlfeldern Repository und Branch. Dieses Repository beziehen öffnet die Adresse zum Klonen.
Erste Schritte
Schnelleinstieg: Das erste ADO-Repository sichtbar machen – der kürzeste Weg zum ersten Ergebnis, in drei Schritten.
Verbindung anlegen → Repository mounten → Sichtbarkeit festlegen → Repository auf einer Seite zeigen
{{wk:adogit>…}} auf einer Seite. Das ist der häufigste Grund für den Eindruck, ein Mount funktioniere nicht.
Häufige Aufgaben
| Was Sie wollen | Für wen | Wo Sie das tun | Anleitung |
|---|---|---|---|
| eine Verbindung zu Azure DevOps einrichten | Verwaltung | do=wkdoado auf einer Projektseite | Anleitung: Verbindung |
| ein Repository mounten | Verwaltung | Administration > Repository-Mounts | Anleitung: Mount |
die Sichtbarkeit festlegen (private, readonly, showcase, library, public oder team) | Verwaltung | derselbe Bildschirm, Auswahl der Sichtbarkeitsstufe | Anleitung: Sichtbarkeitsstufe |
| ein Repository auf einer Seite zeigen | Autor | Wiki-Seite im Projekt, Marke {{wk:adogit>…}} | Anleitung: Seite mit dem Browser |
| ein Repository ohne eigene Seite öffnen | Leser | do=wkdoadogit_repo&ns=<Einhängenamensraum> | Referenz: Repository-Bildschirm |
| einen Ordner oder eine Datei öffnen | Leser | Baum auf der Seite | Anleitung: Ordner und Datei |
| Quellcode auf einer Seite anzeigen | Autor | Marke {{source>ado:…}} | How-to: Quellcode anzeigen |
| eine Datei bearbeiten und committen | Editor | Schaltfläche neben der Datei im Baum | How-to: Datei bearbeiten |
| eine neue Datei anlegen | Editor | Schaltfläche Neue Datei im Kopf des Arbeitsbereichs | How-to: Neue Datei anlegen |
| auf ein anderes Repository oder einen anderen Branch wechseln | Leser | Auswahl im Kopf des Arbeitsbereichs | Referenz: Repository-Bildschirm |
clone, pull und push lokal nutzen | Entwickler | Adresse des Git-Proxys | How-to: Repository klonen |
| ein persönliches Git-Token ausstellen | Entwickler | do=wkdoadogit_tokens | How-to klonen: persönliches Token |
| eine Momentaufnahme als ZIP herunterladen | Leser ab ACL-Stufe 2 | Repository-Browser | Anleitung: Ordner und Datei |
| die Ursache eines Fehlers finden | alle | – | Diagnose |
Ablauf im Überblick
Der Weg eines Repositorys aus Azure DevOps bis zur sichtbaren Datei im Wiki:
| Schritt | Wo | Was geschieht |
|---|---|---|
| 1 | do=wkdoado auf einer Projektseite | Es entsteht die Verbindung: Schlüssel, Serveradresse und Secret-Verweis. Ohne sie ist nichts lesbar |
| 2 | Administration > Repository-Mounts | Es entsteht der Mount: das Repository wird an einen Wiki-Namespace gebunden |
| 3 | derselbe Bildschirm, Auswahl der Sichtbarkeitsstufe | Die Sichtbarkeitsstufe schreibt die Rechte dieses Namespace automatisch |
| 4 | Wiki-Seite innerhalb des Projekts | Ein Autor setzt die Marke {{wk:adogit>…}}. Erst diese Seite zeigt das Repository |
| 5 | Baum auf dieser Seite | Ein Leser öffnet Ordner und Datei; die Datei erscheint in der Quellcode-Schublade |
| 6 | do=wkdoadogit_tokens | Wer außerhalb des Wikis git clone will, stellt sich ein persönliches Token aus |
Wichtigste Funktionen
- Repository-Browser auf einer Wiki-Seite. Die Marke
{{wk:adogit>verbindung:projekt:repo}}zeichnet den Kopf mit der Sichtbarkeitsstufe und den Ordnerbaum; Unterordner laden erst beim Öffnen. - Darstellung einer einzelnen Datei. Die Marke
{{source>ado:…}}zeigt eine Datei, auf Wunsch nur einen Zeilenbereich. - Bearbeiten und Committen einer einzelnen Datei. Der Commit greift gegen die Fassung, die der Autor gesehen hat; andernfalls weist der Server ihn zurück.
- Eine neue Textdatei anlegen unmittelbar aus dem Arbeitsbereich. Liegt unter dem Pfad schon etwas, lehnt der Server ab und schreibt nichts.
- Branch oder Tag anlegen unmittelbar aus dem Browser, für Benutzer mit Schreibrecht.
- Auswahl von Repository und Branch im Arbeitsbereich, ohne den Umweg über die Repository-Liste.
- Git-Proxy für
clone,pullundpushmit einem gewöhnlichen Client. Die Anmeldung läuft über ein persönliches Token, nicht über das Wiki-Kennwort. - Momentaufnahme als ZIP aus dem Repository-Browser herunterladen.
- Eine einzige Stellschraube für die Sichtbarkeit: die Sichtbarkeitsstufe des Mounts; sie schreibt die Rechte automatisch.
Kernbegriffe
Eine Verbindung beschreibt den ADO-Server und gehört zu einem DWDO-Projekt; ein Mount bindet ein Repository dieser Verbindung an einen Wiki-Namespace und trägt eine Sichtbarkeitsstufe; sie schreibt die Rechte dieses Namespace. Eine Verbindung trägt beliebig viele Mounts.
Der Mount-Namespace ist virtuell: es liegt keine Seite darin, und jeder Zugriff – Browser, Dateidarstellung, Git-Proxy und ZIP-Download – fragt nach den Rechten dieses Namespace, nicht nach denen der Seite, auf welcher der Leser steht. Bei Azure DevOps meldet sich stets ein einziger Service-Account an; wer was darf, entscheiden deshalb ausschließlich die DokuWiki-Rechte.
Vollständig, mit der Tabelle der Sichtbarkeitsstufen und der doppelten Bedeutung einer ACL-Stufe: Konzepte, Abschnitt „Sichtbarkeitsstufe und DokuWiki-ACL“.
Verwaltung
- Administration > Repository-Mounts (
do=admin&page=wkdoadogit_mounts) – Repositorys anbinden, Namespace und Sichtbarkeitsstufe ändern - Administration > ADO-Git-Zugriffstoken – ausgestellte Token einsehen und zurückziehen
- Einstellungen des Pakets – Werte, Vorgaben und ihre Wirkung
Diagnose
Für Entwickler
- Technische Referenz – Mounts verwalten, Auszeichnung, Aktionen, Token, Einstellungen
- Grundlagen – Mounts, Sichtbarkeitsstufe, zweiter Faktor, Grenzen
- wkdoado – die gehärtete ADO-Verbindung, auf der dieses Paket aufsetzt
- wksourceview – die Quellcode-Darstellung, die dieses Paket beliefert
- wkcore – die Registry, über die beide Dienste gefunden werden
Verwandte Themen
- Ein ADO-Repository erstmals im Wiki anzeigen – ein Repository erstmals im Wiki anzeigen, von der Verbindung bis zur Datei
- Quellcode auf einer Wiki-Seite anzeigen – Quellcode auf einer Wiki-Seite anzeigen
- Eine Datei aus dem Wiki bearbeiten und committen – eine Datei aus dem Wiki bearbeiten und committen
- Eine neue Datei im Browser anlegen – eine Datei anlegen, die es noch nicht gibt
- Diagnose – Symptom, Ursache und Abhilfe