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.
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 > ADO-Git Repo-Mounts | Anleitung: Mount |
die Sichtbarkeit festlegen (private, readonly, public oder team) | Verwaltung | derselbe Bildschirm, Tier-Auswahl | Anleitung: Sichtbarkeits-Tier |
| 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 Level 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 > ADO-Git Repo-Mounts | Es entsteht der Mount: das Repository wird an einen Wiki-Namespace gebunden |
| 3 | derselbe Bildschirm, Tier-Auswahl | Der Sichtbarkeits-Tier 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 dem Sichtbarkeits-Tier 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: der Tier des Mounts, der die Rechte automatisch schreibt.
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 einen Sichtbarkeits-Tier, der die Rechte dieses Namespace schreibt. 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 Tier-Matrix und der doppelten Bedeutung eines Levels: Technische Referenz, Abschnitt „Sichtbarkeits-Tier und DokuWiki-ACL".
Verwaltung
- Administration > ADO-Git Repo-Mounts (
do=admin&page=wkdoadogit_mounts) — Repositorys anbinden, Namespace und Tier ändern - Administration > ADO-Git-Zugriffstoken — ausgestellte Token einsehen und zurückziehen
- Administration > ADO-Git Subversion-Verbindungen — Subversion-Endpunkte derselben Verbindung
- Einstellungen des Pakets — Werte, Vorgaben und ihre Wirkung
Diagnose
Für Entwickler
- Technische Referenz — Mounts verwalten, Auszeichnung, Aktionen, Token, Einstellungen
- Konzepte — Mounts, Sichtbarkeits-Tier, 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