Fa'avae poto / Kōti

Galue i se fale teu oloa git

E mafai e Pro ona galulue i totonu o tasi o au repositories e pei o se agent fa'akodanu — faitauina au failauga moni, ma saini i luga o i latou, ma suia i latou.

O lenei itulau ua fa'aliliuina i masini mo le fa'afaigofieina. O le ulua'i fa'a-Peretania o le fa'amatalaga lea e fa'atatau.

Feso'ota'i mai se fa'aputu (repository)

?git, pe lelei Git vaega i le toolbar, fesoʻotaʻi mai se lautele auaunaga: GitHub, GitLab, po o le Gitea/Forgejo — lea e aofia ai Codeberg ma isi faʻataʻitaʻiga ua faʻapitoa i ai. E fiaʻai ai se token o le faʻamaoniaga masani (personal access token), se faʻapotopoto (repository) ma se lala (branch). O se faʻapotopoto e faailoa atu lava ia i luga o le Nostr e mafai ona fa'apipi'i i lona tuatusi nai loa.

E te le mana'omia ona tusia le igoa o le repository. Fa'aputa le token ma filifili Lisi mea e mafai ona o'o atu i lenei token: O loo fesili Nymbot i le forge po o le ā le mea e mafai ona vaai i ai le token ma faaali le tali o se lisi e siaki ai oe. O le siakiina e fesoota'i ai mea ta'itasi ma lona lava lava vaega (branch) ua mae'a ona fa'apena, ma fa'aofi ai uma i lenei talanoaga. O mea ua mae'a ona feso'ota'i e fa'aali lava i lona tulaga ae le toe tuuina atu i se isi taimi. O lea talosaga e alu sa'o mai lau masini i le forge — e le o va'ai i le Nymbot worker — ina ia le alu i so'o se mea e le'i alu i ai le token. O se forge e fa'aopoopoina lava (self-hosted) e teena ai talosaga cross-origin e le mafai ona lisiina; tusi le repository i lalo ma o le a galue tutusa mea uma.

Pe a uma ona fesootai, o le ipu o loʻo faʻaalia ai le igoa o le faʻaputugā, ma au feʻau ua lafoina ma se Model fa'apitoa filifili le tausia i le tulaga o lena teuiga. ?git disconnect fa'amalumaluina lea o ia. Fa'afeso'ota'i ese i to'itungaina o lisi o teuvesa matea le token ae tumau pea le teuvesa i ai, ua faailoa o loo iai se atuaga e leai se token, ina ia mafai ona e faaopoopoina se isi fou i luso mai.

O numera o teu Polynesian (Repositories) ua faasalalauina i luga o le Nostr

O nisi fa'aputuga e fa'ailoa o latou lava ia i luga o le Nostr nai lo le na'o i luga o se forge, e fa'aaogāina NIP-34 — le polokalame i tua atu ngit ma le gitworkshop. O le faalauiloaga o se mea e faia i luga o le Nostr e aofia ai le igoa o le polokalame, ona tausisia ia, le relays o lo'o faaputuputu ana patches ma ona faafitauli, faapea URL e mafai ai ona nu'u mai ai. O se isi faalauiloaga e faailoa ai po o fea o lo'o i ai ia falasiga (branches) ta'itasi i le taimi nei.

Fa'apipi'i se naddr po oe a nostr:// tu'u le lauiloa i totonu o le lisi o fa'amaumauga ma fa'alogo Sau itu ma vaai i aiE faitau Nymbot le faalauiloaga mai relai ma fa mengisi le fomu: le git host o lo'o fa'asaoina mai ai, le repository iina, ma le branch o lo'o fai mai lava le polokalame o lo'o tumau. E te fa'aopoopo pea se token mo lea host, ona o lo'o aveina e Nostr le faalauiloaga ae o lo'o aveina e le git server le kōdi.

O lona uiga o le tulafono e faigofie lava o le mea ua lafo mai ai. O se teu lava (repository) o loʻo iai lona URL o loʻo i luga o GitHub, GitLab, Gitea po o Forgejo — e aofia ai ma ia o loʻo faʻaopoopoina lava — o se tasi e mafai e Nymbot ona faitau. O se tasi ua lafo naʻo i luga o git:// po o le ssh e leai se HTTP API e faitau ai failauga, ma o lo'o fai atu Nymbot i lea nai lo le feso'ota'iga e lē atoatoa. Afai o le uo o lo'o fa'agaoioia lava i lona lava faleseaiga, o le tu'uina atu o le pulega o se fa'ata'ita'iga mai lona igoa, ma e mafai ona e toe fa'aleleia ae ae le'i teuina.

O se o se fa'aopoopoina o se tupuga (repository) i lenei auala e iai lona fa'ailoga (badge) ngit i to'itungā, ma tali e ta'u ai i le igoa o lo'o faailoa mai nai lo lona ala i luga o le mataupu.

O le ā se mea e mafai ona faia e ia

O se feau i le fa'amatalaga o le repo e fa'agaioia e pei o se agena itiiti nai lo se fa'ai'uga e tasi. E mafai e le polokalame ona lisiina fa'alala, faitau failauga, ma su'e i totonu o le fa'atulagaga, ona tali mai ai i mea ua moni lava ua maua — ina ia tali ai le fesili "aisea e tu'u ai le toe fa'aaoaoina (retry loop) vave lava" mai lau lava polokalame, ae lē mai se fa'alua e tusa ai ma se polokalame e foliga mai fa'apena.

E vaai i le lava na e faafeso'ota'i ai, i lona ulu o lo'o iai nei.

Fa'atasi 'i o lo'o fa'agaioia le server ua tatala mo le talanoaga, e e mafai fo'i ona talosaga e fa'atino se polokalame i lau kōdi, e pei o su'esu'ega, i luga o se Nymbot server. O so'o se fa'atino e fa'atali mo oe ina ia fa'atagaina.

Fa'agaioia tusiga

?git writes on o lo'o fa'aopoopo ai le malosi e fa'aputu ai failauga, fa'atūina o ni suiga (branches), ma tatala ni pull po'o merge requests. E lē o ola i luma, ma e sili le tu'u pea i lalo se'ia o'o ina e mana'o i ai.

A'o iai le fa'atagaina e tusi ai, talosaga mo se suiga ma maua ai se 'branch' ma se 'pull request' e siaki ai, nai lo le lafoina o se 'patch' i le 'chat': o galuega ta'itasi e galue ai se vaega o lona lava iaE leai se mea e lafo i lau lava falaga (default branch) se afai e le e toe fa'ai'uina lena mea, o le falaga lea na e fa'afeso'ota'i ai, ma na e talosaga ai.

O suiga o se faatinoga e tuuina atu o se commit ta'itasi i le teu o faamaumauga (repository), i le faaiuga o le faatinoga pe a filifili le masini (model) ua mae'a se vaega o galuega. Afai e te manao e vaai muamua i ai, fa'aopoopo le Fesili a'o le'i faia se faautaga mo lea o le teu oloa. O le fa'atino lena e taofia ana suiga, o le iloilo e fa'aalia ai i le tulaga fa'aopoopo ma le fa'aitiitia, ma Fa'aaoga faia ai i latou a o Tāua tau fa'atautaia i latou. E lē tau te oe le fa'aaogāina.

O se lala mo lauga ta'itasi

Fa'atasi 'i O fa'ata'ita'iga ta'itasi e maua lona lava vaega fa'apitoa o lo'o i ai mo soo se fa'aputugatu'aga a'o le'i tapeina, se galuega e tusi ai commits i se latalata a'o ia lava, e ta'u o le nymbot/ ma se ID puupuu. O lo'o faia e Nymbot mai le ulu o le vaega galuega pe a fai le laifi mai muamua a le tiute, o lea o se tiute e faitau na'o ia e le mafai ona faia se vaega lava e aunoa. O le vaega galuega lava ia e le pulea, o le mafuaaga lea e mafai ai ni tiute e toatele ona tusia i le tautua fa'apitoa i le taimi e tasi nai lo le fa'atali mo le isi taimi.

Pe a mae'a le galuega, o le a faia e Nymbot le a what Pe a mae'a ataupia. Tatala se upega o luʻitau o le mea masani; Tuuina atu se faʻapipiʻiga tu'uina atu se uiga o le Merge i luga o le fa'asilasilaga; Tuua le laau e lē fai se isi mea. O le tulaga masani ua faatulaga i le Settings, i lalo o Pe a ua mae'a le vaega o se galuega, ma e mafai e repo o se tasi lava i latou ona filifili i lona lava faiga. Afai e leai se API mo pull requests i le forge e mafai ona fa'aaogā e Nymbot, po o le lē talia lea o se tasi, o le a nofo pea le branch i lona tulaga o lo'o iai ma o le tali e fa'ailoa mai ai lena mea.

O loo faaali le tali o le vaega ma le Tatala le PR, Faʻatasi ma Tape, ma o le vaega o Galuega o loʻo faʻaalia ai faʻatasi o le galuega. A o faʻasaoina pea le galuega, le pepa, le vaega o Galuega ma le lisi o mea o loʻo faʻatino o loʻo taʻuina le lava (branch) i le taimi lava e tulaʻi mai ai, i soʻo se masini ua saomia i le teugatupe. O se galuega ua tuʻa pe le manuia i le ala, e toe foʻi mai lava lona lava (branch), ina ia mafai ona faʻapipiʻi, tape pe faʻamamā e pei o soʻo se isi. O le faʻapipiʻiina (merge) o se faʻapipiʻiina o le commit e ala i le pull request a le forge, ua faʻatali i le commit na pisia e le Nymbot, ina ia aua neʻi faʻapipiʻiina ni commit fou ua lafo i ai i lena taimi e aunoa ma le vaʻai atu. E lē faʻatinoina lava se force-push. Afai e tauua le lava (branch) ma le lava o loʻo galulue ai, o le tali o loʻo ofoina atu Tatala le PR e fa'atonutonu ai poʻo Fa'atonutonu Nymbot e toe fa'afou le branch, lea e fa'apipi'i ai le branch o lo'o galulue ai i ai i se merge commit nai lo le rebasing. E mafai e GitHub ma Gitea po'o Forgejo ona faia lena mea; e leai se API i GitLab mo lena mea, o lea i ai e tatau ona mae'a i le merge request.

O suiga i faila o le CI ma le workflow o loʻo faʻatali pea mo lau suʻesuʻega, e tutusa lava pe a leai se lua o la latou lava sapalai.

Fa'amati le filifiliga e fa'atino ai le commit sa'o i le lame galulue (working branch). O le a avea lava lea ma se fa'agaioiga e iai lona lava teu lava (repository), ma o se isi fa'agaioiga i le lava e tasi e faitau na'o le mea lea se'ia o'o ina mae'a le fa'atinoga a le muamua. O tufulau tuai o le polokalame e galulue foi i lea auala.

Toe toeina mea na suia e se tasi o le faataunuuina o se mea

O se tali na tusia i lau teu lava o lo'o fa'ailoa mai mea na silasila ai: le teu lava, le lala, ma ta'itasi file. Toe aveese nei suiga toe fa'afo'i i ai — o isi ala ta'itasi e faitauina i le commit na tu'u ai le lava a'o le'i amata le fa'agaioiga ma fa'amaumauina pei ona iai. O se galuega na galulue ai se lala patino ia na tuua le vaega galuega na o ia lava, o lea e lēai se mea i ai e toe toe fa'afo'i mai: Tape fa'asolo lona laau i se isi tulaga.

O se toe fa'afo'i lena, ae le o se toe tusia. E leai se mea ua tapeina ma e le toe tusia se talafaasolopito: o mea na faia e Nymbot e tumau pea i le log, na'o le mea e le o toe tulaga o le branch. O so'o se tasi na tula'i mai i le va o taimi e maua pea se checkout e tumau pea ona galue.

E lē totogi lava. O le toe fa'aleleia e lē oo atu i se modele, o lea e lē fa'aalu ai ni kirediti — o le access token e malaga fa'atasi ma lea lava talosaga e pei ona masani ai i isi uma, ma e lēai se mea e uiga i le checkpoint e teuina i so'o se mea i fa'aleleia o lau masini lava.

O le a le tau o se galuega repo

O se galuega repo e fa'aaogāina e o'o i le ono vala'au o le modele i le savali ta'itasi — va'ai, faitau, su'esu'e, tali — e totogi tasi lava e tusa ai ma le modele ua fa'apipi'iina. Tau o le ProNa'o finagalo e fa'aaogā moni lava e totogi ai, o lea o se fesili taliina mai se tasi failauga e tusaловиavā ai le tau o se tali masani.

O lo'o tu'uina atu e le polokalame le aofa'i atoa ma le numera o vā calls pe a uma mea uma i le repo task.

Pe a uma le avanoa mo se galuega

O se galuega o se fa'aputuga (repository) o se toe fa'asolo lea, ae le o se tali e tasi: o lo'o fa'aopoopoina e le tautala se lisi o se fa'aata, faitau se fa'amatalaga, su'esu'e le fa'atulagaga, faitau se isi, ma pe a uma lena, e tusia. O lea fa'asolo e iai lona fa'atolega — o se numera o vala'au o le tautala ua fa'asaoina ai krediti e le tali — ona o se agena e leai se fa'atapula'a o le a avea ma se pili e leai se fa'atapula'a.

Pe a faaaogā e se galuega lona tapuaga ae o lo'o iai pea galuega e fai, e tuu Nymbot, e tuuina atu ia te oe mea ua ia iai, ma faailoa atu. E leai se isi totogi faaopoopo.

E mafai fo'i ona e fa'atagaina ina ia fa'aauau. Fa'atulaga se paketi fa'aauau i le Settings ma o le a fa'atau ai e Nymbot se isi tupe fa'aautsiasi mai le tutusa o le totogi o lo'o iai pe a mae'a se galuega, ina ia amata ai tulaga tonu latoina, ae le o le toe faitauina o le repository mai le amataga. E fa'atinoina i vaega ta'itasi, o vaega ta'itasi e fa'ailoa ai le tau o le galuega, ma taofi i le taimi lava e mae'a ai le paketi, pe ua mae'a le galuega, pe ua e kiliki atu le Stop. O le filifiliga o “pe a uma la'u tupe” o se fa'atapula'a lava — o lau tupe lea ae le o se numera na e tusia.

E masani lava ona lafo e lau masini o vaega ta'itasi, ina ia fa'aauau ai se galuega na'o taimi lava e tatala ai le polokalame. Ma le fa'asologa i tua pe a tatala, e lafo e le server le isi vaega lava ia a o le'i tapuni le app, i totonu o le paketi tutusa, e sili atu i le 40 vaega ma le 6 itula, ma faailoa atu ia te oe i le taimi lava e mae'a ai le galuega. Ina ia mafai ai lena mea, e taofia le token o le repository i se ki e ia lava e te'i maua ae o lo'o galulue le galuega, ma tapeina pe a mae'a le galuega ma aiga i totonu o le 6 itula. O se galuega i le tua (background task) e tusia i lona lava lava e pei o isi galuega uma.

E uiga i lena faailoga

Auā ona e fa'atatau, o se talanoaga o lo'o fa'aaogaina le repository e galue i so'o se masini o lo'o e fa'amaumauina i ai e aunoa ma le toe fa'afeso'ota'i atu. O le aveeseina o le repository i se masini e fa'aitiitia ai le token i isi masini fo'i. E le ulufaleina lava le token i se server ata'io le uo a 's.