GitHub
Plugin GitHub prepojí vlastnú identitu GitHubu každého účtu a priradí Projekt k jeho repozitáru na GitHube. Agenti potom s GitHubom pracujú cez git a GitHub CLI (gh) v termináli: príkazy v termináli, ktoré v tomto Projekte spustí držiteľ priradenia, sú prihlásené ako on. Celý postup pre Projekty a worktrees opisuje článok Projekty, prostredia a GitHub.
Plugin github nainštalujte v Nastavenia → Dostupné pluginy. Aktuálnu verziu pluginu a minimálnu verziu Elowen nájdete v registri. Plugin podporuje iba Linux; Windows a macOS podporované nie sú.
GitHub pripojíte v Účet → Prepojené účty. Riadok GitHubu zobrazuje pripojené prihlasovacie meno, Otestovať pripojenie, Nahradiť identitu a Odpojiť; keď autorizácia vyprší, ponúkne namiesto toho Pripojiť znova. Priradenie repozitára nájdete na karte GitHub pri vybranom Projekte. Formulár priradenia napovedá hodnoty z Git remote adries Projektu a nepriradený Projekt vypíše repozitáre, ktoré z nich vyplývajú; tlačidlo na zistenie tam nie je.
Pole na osobný prístupový token tu nie je. Pripojenie prebieha prihlásením GitHub CLI pomocou jednorazového kódu s rozsahom workflow, takže gh musí byť nainštalované na hostiteľovi s Elowen. Jednorazový kód potvrďte na GitHube. Keď GitHub vyžaduje nové pripojenie, pripojte sa znova; Elowen autorizáciu sama na pozadí neobnovuje.
Priradenie repozitára
Projekt má najviac jedno mapovanie. Drží ho účet, ktorý ho vytvoril, a zaznamenáva základný repozitár a repozitár na odoslanie zmien; pri práci s forkom sa môžu líšiť. Uloženie mapovania overí, že pripojený účet GitHubu vie základný repozitár čítať a do repozitára na odoslanie zmien zapisovať. Iný účet už namapovaný Projekt namapovať nemôže. Mapovanie môže odstrániť iba držiteľ alebo správca. Ostatní členovia zdieľaného Projektu vidia, že je Projekt namapovaný a kým.
Vymazaním Projektu sa odstráni jeho mapovanie aj nevybavené potvrdenia mapovania. Vaše pripojenie GitHubu, repozitáre ani mapovania iných Projektov sa nemažú.
Spárovaný počítač namapovať nemožno. Spúšťa git a gh s vlastným prihlásením, takže jeho karta GitHub to oznamuje namiesto ponuky mapovania a pokus o namapovanie počítača sa odmietne.
Git a gh v termináli
Keď držiteľ priradenia spustí v namapovanom Projekte príkaz v termináli, Elowen mu pre tento príkaz odovzdá token GitHubu v premennej prostredia GH_TOKEN, takže git cez HTTPS aj gh fungujú bez toho, aby sa prihlasovací údaj ukladal do domovského priečinka. Publikovanie vetvy, otvorenie pull requestu, revízia aj zlúčenie sú bežné príkazy git a gh; plugin k nim nepridáva žiadne nástroje ani tlačidlá. Príkazy iných účtov a príkazy v Projekte bez overeného mapovania bežia bez identity GitHubu. Prostredia spravovaných Projektov vytvorené z aktuálneho image obsahujú gh; prostredie zo staršieho image ho môže potrebovať doinštalovať.
Spravovaný kontajner je zdieľaný a beží ako root, takže iný člen môže token držiteľa vyčítať z bežiaceho procesu. Rátajte s tým, že mapovanie v zdieľanom Projekte je pre jeho členov viditeľné. Odpojenie GitHubu alebo odstránenie mapovania zastaví odovzdávanie tokenu ďalším príkazom; príkaz, ktorý ho už dostal, si ho podrží do svojho skončenia.
Životný cyklus pripojenia
Pre jeden účet môže bežať vždy iba jedna požiadavka na pripojenie. Po opätovnom načítaní panela účtu sa zo servera obnoví rozpracovaný kód. Zrušenie alebo vypršanie kód vymaže; reštart démona alebo opätovné načítanie pluginu požiadavku preruší a vyžaduje nové prihlásenie. Odpojenie zruší čakajúce prihlásenie a deaktivuje mapovania repozitárov. Opätovné pripojenie overí existujúce mapovania, kým ich znova povolí; zrušenie, vymazanie účtu alebo úprava mapovania počas overovania nemôžu obnoviť zastaraný stav.
Odpojenie, nahradenie identity GitHubu aj odstránenie mapovania najprv zobrazia potvrdenie. Potvrdenie platí raz a vyprší po piatich minútach; ak sa účet alebo mapovanie medzitým zmení, zobrazte náhľad akcie znova.
Plugin nemá vlastné nastavenia ani oprávnenie pre jednotlivé účty: riadok GitHubu patrí prihlásenému účtu a o tom, kto mapovanie uvidí, rozhoduje členstvo v Projekte. Všeobecne o účtoch a oprávneniach pozri Používatelia a prístup.