ADO-Git
ADO-Git prikazuje git repozitorije iz Azure DevOpsa izravno u wikiju: pregledavanje stabla, prikaz izvornog koda, uređivanje i commit datoteke te naredbe clone, pull i push preko posrednika. Paket je namijenjen čitateljima, koji izvorni kod trebaju vidjeti bez vlastite ADO licencije, autorima, koji repozitorij pokazuju na wiki stranici, i operaterima, koji repozitorije povezuju i određuju njihovu vidljivost.
Prvi koraci
Stvorite vezu → Montirajte repozitorij → Odredite vidljivost → Pokažite repozitorij na stranici
{{wk:adogit>…}} na stranici. To je najčešći razlog dojma da montiranje ne radi.
Česti zadaci
| Što želite | Za koga | Gdje to radite | Upute |
|---|---|---|---|
| postaviti vezu s Azure DevOpsom | operateri | do=wkdoado na stranici projekta | Vodič: veza |
| montirati repozitorij | operateri | Administracija > ADO-Git montiranja repozitorija | Vodič: montiranje |
odrediti vidljivost (private, readonly, public ili team) | operateri | isti zaslon, odabir razine | Vodič: razina vidljivosti |
| pokazati repozitorij na stranici | autori | wiki stranica u projektu, oznaka {{wk:adogit>…}} | Vodič: stranica s preglednikom |
| otvoriti repozitorij bez vlastite stranice | čitatelji | %do=wkdoadogit_repo&ns=<imenski prostor priključka>% | Referenca: zaslon repozitorija (njemački) |
| otvoriti mapu ili datoteku | čitatelji | stablo na stranici | Vodič: mapa i datoteka |
| prikazati izvorni kod na stranici | autori | oznaka {{source>ado:…}} | Kako: prikazati izvorni kod |
| urediti datoteku i napraviti commit | urednici | gumb uz datoteku u stablu | Kako: urediti datoteku |
lokalno rabiti clone, pull i push | razvijatelji | adresa git posrednika | Kako: klonirati repozitorij |
| izdati osobni git token | razvijatelji | do=wkdoadogit_tokens | Kako klonirati: osobni token |
| preuzeti snimku kao arhivu ZIP | čitatelji od razine 2 | preglednik repozitorija | Vodič: mapa i datoteka |
| pronaći uzrok pogreške | svi | – | Dijagnostika |
Tijek ukratko
Put repozitorija iz Azure DevOpsa do vidljive datoteke u wikiju:
| Korak | Gdje | Što se događa |
|---|---|---|
| 1 | do=wkdoado na stranici projekta | Nastaje veza: ključ, adresa poslužitelja i uputa na tajnu. Bez nje se ne može pročitati ništa |
| 2 | Administracija > ADO-Git montiranja repozitorija | Nastaje montiranje: repozitorij se veže uz imenski prostor wikija |
| 3 | isti zaslon, odabir razine | Razina vidljivosti automatski zapisuje prava tog imenskog prostora |
| 4 | wiki stranica unutar projekta | Autor postavlja oznaku {{wk:adogit>…}}. Tek ta stranica prikazuje repozitorij |
| 5 | stablo na toj stranici | Čitatelj otvara mapu i datoteku; datoteka se pojavljuje u ladici s izvornim kodom |
| 6 | do=wkdoadogit_tokens | Tko želi git clone izvan wikija, izdaje si osobni token |
Ključne mogućnosti
- Preglednik repozitorija na wiki stranici. Oznaka
{{wk:adogit>veza:projekt:repozitorij}}crta zaglavlje s razinom vidljivosti i stablo mapa; podmape se učitavaju tek pri otvaranju. - Prikaz pojedine datoteke. Oznaka
{{source>ado:…}}prikazuje jednu datoteku, po želji samo odabrani raspon redaka. - Uređivanje i commit pojedine datoteke. Commit se primjenjuje na inačicu koju je autor vidio; inače ga poslužitelj odbija.
- Stvaranje grane ili oznake tag izravno iz preglednika, za korisnike s pravom pisanja.
- Git posrednik za
clone,pullipushs uobičajenim klijentom. Prijava ide osobnim tokenom, a ne lozinkom wikija. - Preuzimanje snimke kao arhive ZIP iz preglednika repozitorija.
- Jedna jedina ručica za vidljivost: razina montiranja, koja automatski zapisuje prava.
Ključni pojmovi
Veza opisuje ADO poslužitelj i pripada DWDO projektu; montiranje veže jedan repozitorij te veze uz imenski prostor wikija i nosi razinu vidljivosti, koja prava tog imenskog prostora zapisuje. Jedna veza nosi koliko god montiranja.
Imenski prostor montiranja virtualan je: u njemu nema nijedne stranice, a svaki pristup — preglednik, prikaz datoteke, git posrednik i preuzimanje arhive — pita za prava tog imenskog prostora, a ne za prava stranice na kojoj čitatelj stoji. Prema Azure DevOpsu uvijek se prijavljuje jedan jedini servisni račun; tko što smije, stoga odlučuju isključivo prava DokuWikija.
U cijelosti, s tablicom razina i dvostrukim značenjem razine: Tehnička referenca, odjeljak „Razina vidljivosti i DokuWiki ACL”.
Upravljanje
- Administracija > ADO-Git montiranja repozitorija (
do=admin&page=wkdoadogit_mounts) — povežite repozitorije, promijenite imenski prostor i razinu - Administracija > ADO-Git pristupni tokeni — pregled i opoziv izdanih tokena
- Administracija > Subversion veze za ADO-Git — Subversion krajnje točke iste veze
- Postavke paketa — vrijednosti, zadano i njihov učinak
Dijagnostika
Za razvijatelje
- Tehnička referenca — upravljanje montiranjima, oznake, radnje, tokeni, postavke
- Koncepti — montiranja, razina vidljivosti, drugi faktor, granice
- wkdoado — očvrsnuta ADO veza na kojoj ovaj paket stoji
- wksourceview — prikaz izvornog koda koji ovaj paket opskrbljuje
- wkcore — registar preko kojega se obje usluge pronalaze
Povezane teme
- Prvi prikaz ADO repozitorija u wikiju — prvi prikaz repozitorija u wikiju, od veze do datoteke
- Kako prikazati izvorni kod na wiki stranici — prikaz izvornog koda na wiki stranici
- Kako urediti datoteku i napraviti commit iz wikija — uređivanje datoteke i commit iz wikija
- Dijagnostika — simptom, uzrok i rješenje