Hitri začetek: prvi repozitorij ADO viden v wikiju

Najkrajša pot od „vtičnik je nameščen“ do „repozitorij iz Azure DevOps je mogoče pregledovati v wikiju“. Trije koraki, približno petnajst minut. Obširnejša različica z vsemi zasloni čarovnika in vsemi posebnimi primeri stoji v nemškem vodiču (v nemščini).

Predpogoji

wkdoadogit, wkdocore, wkdostorage, wkdoado in wkcore so nameščeni in vklopljeni. Brez wksourceview se datoteke ne odprejo v predalu.
Razširitev PHP curl je na voljo.
Obstaja preizkušena povezava ADO — glejte hitri začetek za wkdoado. Motnjo povezave, ki se raziskuje od tod, se razišče dvakrat.
Za priklop potrebujete skrbniške pravice: priklop zapiše pravice za celotno spletišče.

Pred prvim priklopom naredite varnostno kopijo datoteke conf/acl.auth.php. Priklop piše v upravljani blok te datoteke.

Korak 1: razumite, v kakšno kupčijo greste

Azure DevOps se doseže prek enega samega storitvenega računa. Iz tega sledi dvoje, in oboje velja takoj:

Wiki odloča, kdo kaj vidi. Kdor v Azure DevOps nima računa, lahko priklopljen repozitorij vseeno pregleduje, če mu wiki to dovoli.
Vse, kar storitveni račun doseže, je dosegljivo — vsakomur, ki mu wiki to dovoli.

Zato storitvenemu računu zdaj dajte najožje pravice, ki pokrivajo predvidene repozitorije. Njegov doseg je zgornja meja; ACL wikija so vrata.

Korak 2: priklopite repozitorij

Skrbništvo → Priklopi repozitorijev ADO-Git, neposredno /doku.php?do=admin&page=wkdoadogit_mounts. Razprite Registriraj priklop; čarovnik vodi skozi štiri zaslone:

Povezava — povezava iz predpogojev, na seznamu kot projekt / ključ.
Projekt ADO — projekt v Azure DevOps.
Repozitoriji — označite enega ali več repozitorijev, izberite stopnjo vidnosti, nato Predogled.
Predogled — kaj stopnja podeli, kateri imenski prostor nastane in vsaka vrstica pravic, ki bo zapisana. Nato Registriraj.

Na izbiro so štiri stopnje:

Stopnja	Kdo sme brati
`private`	Nihče razen obratovalne skupine.
`team`	Vlogovne skupine prav tega projekta — bralci, sodelavci, vzdrževalci.
`readonly`	Vsak prijavljen račun.
`public`	Vsi, tudi neprijavljeni.

Dokler ta priklop ne obstaja, je repozitorij v wikiju neviden. To, da ga storitveni račun vidi, ne zadošča — izpostavitev je izrecno dejanje.

Korak 3: postavite prikaz na stran

Priklop in oznaka sta dve ločeni dejanji. Priklop zapiše samo pravice in ne ustvari nobene strani. Repozitorij postane viden šele z oznako na strani. To je najpogostejši razlog za vtis, da priklop ne deluje.

Uredite stran repozitorijev projekta — sl:projects:acme:repos — in vanjo vpišite:

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

Na tej namestitvi na de:projects:dwplugins:repos stoji na primer {{wk:adogit>wvds:DokuWiki-Plugins:wkdoadogit region=toc}}.

Preverjanje rezultata

Vidite sklice, drevo datotek in datoteke. Vsak od teh klicev gre skozi ista vrata, ovrednotena ob vsakem klicu znova in nikoli predpomnjena. Zato odvzem pravic učinkuje že ob naslednjem klicu in ne šele po izteku nekega roka.
Protipreverba z drugim računom — tisti dve minuti se enkrat na namestitev splačata: račun brez pravice branja nad imenskim prostorom priklopa ne vidi ničesar. Ne delnega seznama in ne sporočila o napaki, ki bi repozitorij poimenovalo. Nato dodelite pravico branja in preverite, da lahko pregleduje.
Branje in pisanje sta dve stopnji istega imenskega prostora: pravica branja pomeni pregledovati, pravica pisanja pomeni objavljati spremembe in ustvarjati sklice. Za to se ne nastavlja nič dodatnega.

Naslednji korak

Vodič (v nemščini) — celotna različica z vsemi polji in pastmi.
Prikaz datotek repozitorija na wiki strani (v nemščini)
Kloniranje priklopljenega repozitorija (v nemščini) — dostop od zunaj, z osebnim dostopnim žetonom pod ?do=wkdoadogit_tokens.
Diagnostika (v nemščini)