Brzi početak: prvi ADO repozitorij vidljiv u wikiju

Najkraći put od „dodatak je instaliran“ do „repozitorij iz Azure DevOps može se pregledavati u wikiju“. Tri koraka, otprilike petnaest minuta. Opširna inačica sa svim zaslonima čarobnjaka i svim posebnim slučajevima stoji u njemačkom vodiču (njemački).

Preduvjeti

wkdoadogit, wkdocore, wkdostorage, wkdoado i wkcore su instalirani i uključeni. Bez wksourceview datoteke se ne otvaraju u ladici.
PHP proširenje curl postoji.
Postoji testirana ADO veza — vidi brzi početak za wkdoado. Smetnju u vezi koju se istražuje odavde istražuje se dvaput.
Za mount trebate administratorska prava: mount zapisuje prava za cijelo sjedište.

Prije prvog mounta načinite sigurnosnu kopiju datoteke conf/acl.auth.php. Mount zapisuje u upravljani blok te datoteke.

Korak 1: shvatite na koju pogodbu pristajete

Azure DevOps doseže se preko jednog servisnog računa. Iz toga slijedi dvoje, i oboje vrijedi odmah:

Wiki odlučuje tko što vidi. Tko u Azure DevOps nema račun, može mountirani repozitorij ipak pregledavati ako mu wiki to dopusti.
Sve što servisni račun doseže, dosežno je — svakomu komu wiki to dopusti.

Dajte zato servisnom računu sada najuže ovlasti koje pokrivaju predviđene repozitorije. Njegov je doseg gornja granica; wiki ACL su vrata.

Korak 2: mountirajte repozitorij

Administracija → ADO-Git repo mountovi, izravno /doku.php?do=admin&page=wkdoadogit_mounts. Rasklopite Registriraj mount; čarobnjak vodi kroz četiri zaslona:

Veza — veza iz preduvjeta, na popisu kao projekt / ključ.
ADO projekt — projekt u Azure DevOps.
Repozitoriji — označite jedan ili više repozitorija, odaberite razinu vidljivosti, pa Pretpregled.
Pretpregled — što razina daje, koji imenski prostor nastaje i svaki redak prava koji će biti zapisan. Zatim Registriraj.

Na izbor su četiri razine:

Razina	Tko smije čitati
`private`	Nitko osim pogonske grupe.
`team`	Grupe uloga upravo ovog projekta — čitatelji, suradnici, održavatelji.
`readonly`	Svaki prijavljeni račun.
`public`	Svi, i neprijavljeni.

Dok taj mount ne postoji, repozitorij je u wikiju nevidljiv. To što ga servisni račun vidi nije dovoljno — otvaranje je izričit čin.

Korak 3: postavite prikaz na stranicu

Mount i oznaka dva su odvojena čina. Mount zapisuje samo prava i ne stvara stranicu. Repozitorij postaje vidljiv tek oznakom na stranici. To je najčešći razlog dojmu da mount ne radi.

Uredite stranicu repozitorija projekta — hr:projects:acme:repos — i upišite u nju:

{{wk:adogit>veza:ADO-projekt:repozitorij region=toc}}

Na ovoj instalaciji na de:projects:dwplugins:repos stoji primjerice {{wk:adogit>wvds:DokuWiki-Plugins:wkdoadogit region=toc}}.

Provjera rezultata

Vidite reference, stablo datoteka i datoteke. Svaki od tih poziva prolazi kroz ista vrata, ocijenjena iznova pri svakom pozivu i nikada spremljena u međuspremnik. Zato oduzimanje prava djeluje već pri sljedećem pozivu, a ne tek nakon isteka nekog roka.
Protuprovjera drugim računom — te dvije minute vrijede jednom po instalaciji: račun bez prava čitanja nad imenskim prostorom mounta ne vidi ništa. Ni djelomičan popis, ni poruku o pogrešci koja repozitorij imenuje. Zatim dajte pravo čitanja i provjerite da može pregledavati.
Čitanje i pisanje dvije su razine istog imenskog prostora: pravo čitanja znači pregledavati, pravo pisanja znači zapisivati i stvarati reference. Za to se dodatno ne postavlja ništa.

Sljedeći korak

Vodič (njemački) — potpuna inačica sa svim poljima i zamkama.
Prikaz datoteka repozitorija na wiki stranici (njemački)
Kloniranje mountiranog repozitorija (njemački) — pristup izvana, s osobnim pristupnim tokenom pod ?do=wkdoadogit_tokens.
Dijagnostika (njemački)