Cevovodi

Cevovodi (paket wkdopipelines) za projekt prikažejo njegove cevovode, zgodovino zagonov in dnevnik vsakega zagona. Paket je namenjen sodelujočim v projektu, ki zagone pregledujejo, in upraviteljem, ki morajo vedeti, kaj na njihovi namestitvi dejansko zmore.

Trenutno stanje: evidenca zagonov brez izvajalnika. Izdelek ne vsebuje vtičnika, ki bi zagone izvajal, in ne ponuja načina, da bi cevovod ustvarili. Na sveži namestitvi je seznam prazen, zagon, ki ga kljub temu sprožite, pa se konča kot spodletelo z vrstico [sys] pwsh runner is unavailable (plugin not loaded). Zato vozlišče Cevovodi ostane skrito, dokler izvajalnika ni.

Prvi koraki

Hitri začetek: v treh korakih preverite, kaj Cevovodi tu zmorejo

Pogosta opravila

Kaj želite	Za koga	Kje	Navodilo
ugotoviti, zakaj vozlišča ni	vsi	stran projekta	Kdaj se vozlišče prikaže
pogledati zgodovino zagonov	sodelujoči v projektu	zaslon prek naslova	Kaj deluje brez izvajalnika
prebrati dnevnik	sodelujoči v projektu	odprite zagon	Branje dnevnika zagona
sprožiti zagon	skrbnik wikija	zgodovina zagonov	Kdo sme gledati in kdo sprožiti
vedeti, česa paket ne zmore	vsi	–	Omejitve

Kaj deluje brez izvajalnika

Zaslon	Naslov	Kdo
cevovodi projekta	stran projekta in `&do=wkdopipelines`	projektna vloga Bralec ali višja
zgodovina zagonov cevovoda	`…&op=runs&pipeline=<številka>`	Bralec ali višja
posamezen zagon z dnevnikom	`…&op=run&run=<številka>`	Bralec ali višja
sprožitev zagona (Zaženi zdaj)	gumb v zgodovini zagonov	samo skrbnik wikija

Cevovoda ni mogoče ustvariti – ne na zaslonu ne v ukazni vrstici. Cevovod je vrstica v shrambi paketa wkdostorage (ime, dejanje action_id, privzeti parametri), funkcije, ki jo zapiše, pa noben del izdelka ne kliče. Ko je seznam prazen, zaslon sporoči: Za ta projekt še ni določen noben cevovod.

Kdaj se vozlišče prikaže

Projektna vrstica in nadzorna plošča prikažeta Cevovode samo, če je vtičnik nameščen in neki vtičnik prijavi obe storitvi: pwsh.catalog (odobrene skripte) in pwsh.runner (izvajanje). Če katera manjka, tja ne vodi nobena povezava; zasloni so še vedno dosegljivi prek naslova.

Predhodnik wvds-dw-pwsh-plugin storitvi prijavi ob dogodku, ki se ne sproža več, zato se tudi nameščen ne poveže.

Kdo sme gledati in kdo sprožiti

Dejanje	Pogoj
ogled cevovodov, zagonov in dnevnikov	projektna vloga Bralec ali višja
sprožitev zagona	skrbnik wikija – nobena projektna vloga ne zadošča

Sprožitev ni stvar projektne vloge. Zagon na strežniku zažene proces, tega pa nobena projektna vloga sama po sebi ne bi smela dovoliti. Sprožitev poleg tega zahteva zahtevo POST z varnostnim žetonom.

Vsak zagon zabeleži, kdo ga je sprožil.

Branje dnevnika zagona

Vsak zagon ima eno polje dnevnika z največ 512 KiB. Od kod je vrstica, pove njena predpona:

Vrstica	Izvor
brez predpone	standardni izhod skripte
`[err] …`	standardni izhod za napake skripte
`[sys] …`	poročilo samega izvajalnika

Če so v dnevniku samo vrstice [sys], skripta ni bila nikoli dosežena. Zadnja pove, zakaj:

Vrstica `[sys]`	Pomen
`pipeline is disabled`	Cevovod je izklopljen.
`pipeline has no action_id`	Cevovod ne navaja skripte.
`pwsh runner is unavailable (plugin not loaded)`	Noben vtičnik ne prijavi storitev `pwsh.catalog` in `pwsh.runner`.
`action '…' is not an allowlisted catalog script`	Katalog izvajalnika skripte ne vsebuje.

Ko je meja dosežena, se dnevnik konča z [sys] [log truncated at 524288 bytes].

Nastavitve

Jih ni. Kdo sme gledati, določa projektna vloga; sprožiti sme skrbnik wikija; ali se vozlišče prikaže, je odvisno od nameščenih vtičnikov in storitev.

Predpogoji

PHP 8.2 ali novejši.
wkcore, wkdocore, wkdostorage.
Za zagone, ki res kaj izvedejo: vtičnik, ki prijavi pwsh.catalog in pwsh.runner – v izdelku ga ni.

Omejitve

Izdelek nima izvajalnika in ne omogoča ustvarjanja cevovodov, glejte zgoraj.
Zagon teče znotraj zahteve, ki ga sproži. Stran čaka, dokler se skripta ne konča ali dokler PHP zahteve ne prekine pri max_execution_time. Ni čakalne vrste, ni preklica in ni lastne časovne omejitve. Skripta, ki čaka na vnos, se nikoli ne konča.
Samo ročna sprožitev. Ni sprožilca ob pushu, zahtevi za združitev ali po urniku; zagon ne zabeleži repozitorija, veje ali commita.
Brez artefaktov, okolij, odobritev in rezultatov testov – zagon ima izhodno kodo in dnevnik.
Ni nadomestilo za Azure DevOps Pipelines.

Podatki o paketu

Vtičnik: wkdopipelines
Imenski prostor: lib/plugins/wkdopipelines/
Avtor: Wolfgang van der Stille Wolfgang.van.der.Stille@gmail.com (The White Knight Labs)
Licenca: GPL 2