github tutorial developers how use github
Tento výukový program GitHub vysvetľuje, čo je GitHub a ako vytvoriť požiadavku na úložisko, pobočku a ťahanie. Zahŕňa pravidlá ochrany pobočiek a riešenie konfliktov:
Čo je GitHub?
GitHub je cloudová služba, ktorá pomáha vývojárom ukladať a spravovať ich zdrojový kód, ako aj sledovať a riadiť všetky zmeny zdrojového kódu.
GitHub je zjednodušene určený pre vývojárov, kde môžu spravovať projekt, hostovať zdrojový kód a tiež ich kontrolovať. To všetko preskúmame v tejto sérii.
Zoznam tutoriálov v tejto sérii GitHub:
Výukový program č. 1: Výukový program GitHub pre vývojárov Ako používať GitHub (Tento návod)
Výukový program č. 2: GitHub Projects, Teams, Fork & Wiki For Documenting Projects
Výukový program č. 3: Výukový program pre pokročilé príkazy Git a integráciu GitHub
Výukový program č. 4: Výukový program GITHub REST API - Podpora REST API v GitHub
Výukový program č. 5: Výukový program GitHub Desktop - Spolupráca s GitHub z vášho počítača
Výukový program č. 6: Výukový program TortoiseGit - Ako používať TortoiseGit na správu verzií
Čo sa dozviete:
Čo je to Git?
Git je systém riadenia verzií Open Source, kde je na stroji vývojára k dispozícii celý zdrojový kód. Git je tiež systém riadenia klientov a distribuovaných verzií (DVCS), kde môžete vykonávať rozvetvenie a zlúčenie.
Začíname s GitHubom
Ak chcete začať používať GitHub, vykonáme nasledujúce kroky.
- Vytvorte úložisko na organizáciu projektov.
- Vytvorte pobočku
- Vykonajte zmeny v súbore a potvrďte.
- Vytvorte žiadosť o stiahnutie a zlúčenie obsahu.
- Chráňte pobočku
V druhej časti série sa pozrieme tiež na ďalšie funkcie GitHubu, ako napríklad Vytváranie organizácií, Tímy, Problémy, Milníky, Vidličky, Vydania a Wikis.
Vytvorte úložisko GitHub
Repozitár GitHub obsahuje artefakty projektu, ako sú zdrojový kód, dokumenty, obrázky atď. Na vykonanie všetkých vyššie uvedených krokov vytvoríme a použijeme demo úložisko.
Prihláste sa na Github.com a Vytvorte nové úložisko . Klikni na Nový tlačidlo.
Pridajte nižšie uvedené podrobnosti repo operácie, ako je to znázornené, a kliknite na Vytvorte úložisko . Nastavte prístup na Súkromný alebo Verejný. Je lepšie ho nastaviť ako verejný, pretože na tomto prístupe závisí iba málo funkcií.
Poznámka: Používateľ, ktorý vytvára úložisko, je vlastníkom úložiska GitHub.
Repozitár je vytvorený pomocou súboru README.
Pridávanie spolupracovníkov do úložiska GitHub
Chceli by sme, aby tím pracoval na tomto úložisku. Za týmto účelom budeme musieť pozvať spolupracovníkov, aby pracovali na úložisku. Ak chcete pridať spolupracovníkov, prejdite na hlavnú stránku úložiska a kliknite na ikonu nastavenie ikona.
Kliknite na Spolupracovníci na ľavom paneli a pridajte spolupracovníkov, ktorí majú účet Github. Bude odoslaná pozvánka a spolupracovníci by ju museli prijať.
Spolupracovníci sa pridávajú, ako je uvedené nižšie. Neskôr v tomto tutoriále uvidíme, ako budú pridaní Spolupracovníci ako recenzent vytvorenej žiadosti o načítanie na zlúčenie kódu.
Vykonanie základného C. vynechať
Otvorte súbor README a vykonajte základné odovzdanie. Klikni na Ikona úprav začať upravovať súbor.
Upravte súbor, pridajte komentár a kliknite na Zaviazať .
Súbor je odovzdaný (zmeny uložené) do úložiska Github.
Bude videných niekoľko operácií na vytvorenie priečinka a súborov vo vnútri úložiska.
Vytvorenie priečinka a súboru v rámci: Klikni na Vytvoriť nový súbor tlačidlo na úrovni úložiska. Zadajte názov adresára, za ktorým nasleduje /, a názov súboru, ako je uvedené nižšie.
Kliknite na Zaviazať na spodku. Priečinok a súbor sa vytvoria podľa obrázka. Súbory a priečinky sa tak vytvárajú na serveri pán vetva, ktorá je hlavnou vetvou integrácie, a hlavne tam, kde je možné vytvoriť softvérové vydania.
Vývojári normálne pracujú na úlohe, ktorá im bola pridelená, na samostatnej vetve a zmeny zlúčia do hlavnej vetvy. Napríklad, vetvy je možné vytvárať pre vývoj funkcií alebo riešenie chýb alebo pre prácu na vylepšeniach atď. Vytvorením vetvy je teda práca izolovaná bez toho, aby rušila ostatné vetvy.
V ďalšom kroku sa môžeme pozrieť na to, ako je možné pobočky vytvárať a definovať požiadavky na ťahanie, aby sme skontrolovali a zlúčili kód do hlavnej vetvy.
Presun súboru
Ak chcete presunúť súbor do iného priečinka, postupujte takto. Napríklad, presunúť súbor rules.txt do priečinka doc. Kliknite na súbor.
Kliknutím na ikonu upravte súbor.
Pridajte cesto doc / pred spisom rules.txt . Kliknite na Potvrdiť zmeny.
Cesta je teraz aktualizovaná.
Vytvorenie pobočky GitHub
Prejdite na hlavnú stránku úložiska a zadaním výrazu vytvorte a vlastnosť vetva, ako je znázornené. Kliknite na Vytvorte pobočku.
Teraz sme v vlastnosť pobočka. Súbory sú rovnaké. Teraz urobíme niekoľko zmien v súboroch v vlastnosť vetvu a vytvorte žiadosť o stiahnutie, aby ste skontrolovali zmeny a zlúčili kód do priečinka pán pobočka.
Vykonajte zmeny v súboroch vo vetve funkcií.
Otvorte súbor Java v priečinku Src, pridajte nejaký kód a vykonajte zmenu.
Vytvorte požiadavku na stiahnutie z GitHubu
V predchádzajúcej časti sme vytvorili pobočku vlastnosť a vykonal niekoľko zmien v súbore. Zmeny nie sú v pán pobočka. Za týmto účelom musíme vytvoriť požiadavku na stiahnutie, pomocou ktorej používateľ navrhuje určité zmeny, ktoré sa majú skontrolovať a zlúčiť do pán pobočka.
Vytvorenie požiadavky na vytiahnutie zobrazí rozdiely medzi zdrojovou a cieľovou vetvou a bude sa od neho vyžadovať riešenie prípadných konfliktov.
Kliknite na Porovnať a vytiahnuť žiadosť na hlavnej stránke úložiska.
Vidíte, že zmeny v oboch pobočkách je možné zlúčiť. Kliknite na Vytvorte žiadosť o stiahnutie.
Kliknite na Zlúčiť žiadosť o stiahnutie a Potvrdiť na dokončenie zlúčenia.
Zmeny sú úspešne zlúčené do pán pobočka. Naša prvá požiadavka na stiahnutie je úspešne dokončená.
Priraďte recenzentom žiadosti o stiahnutie a kontrolu kódu
Github má dobrú vlastnosť používať súbor CODEOWNERS, v ktorom si môžeme v úložisku vybrať ľudí zodpovedných za zdrojový kód. Vlastníci úložiska môžu vytvoriť tento súbor a všetci používatelia definovaní v súbore sú predvolene požadovaní na kontrolu počas vytvárania žiadosti o stiahnutie.
Ak chcete používať túto funkciu, musíte použiť verziu GitHub Pro alebo nastaviť úložisko ako verejné.
V koreňovom adresári úložiska vytvorte tento súbor v nasledujúcom formáte a potvrďte ho.
* @username alebo @orgname alebo @teamname
* primárne znamená všetky súbory v repo. Môžete tiež určiť konkrétne prípony ako * .java alebo * .js atď. Používateľom definovaným v súbore bude automaticky zaslaná žiadosť o kontrolu. S definovaným súborom CODEOWNERS nie je potrebné explicitne pridávať recenzentov manuálne a má trochu väčšiu flexibilitu pri výbere súborov, ktoré sa majú skontrolovať.
Späť v vlastnosť vetva urobte malú zmenu v súbore Java a vytvorte požiadavku na stiahnutie. Na obrazovke Pull Request priraďte recenzenta na pravej strane. Kliknite na Vytvorte žiadosť o stiahnutie.
Na obrazovke vyššie vidíte, že recenzentov je možné priradiť manuálne, ale recenzenti sú definovaní v súbore CODEOWNERS, ktorí automaticky dostanú žiadosť o kontrolu zmien kódu.
Zatiaľ však Prihlásiť sa ako recenzent a schváliť zmeny. Ak chcete zmeny schváliť, prihláste sa ako používateľ vniranjan2512.
Existuje žiadosť o schválenie / odmietnutie zmien pod Pull Request.
Kliknite na Pull Request a Pridajte svoju recenziu.
Môžete kliknúť na ikonu + podpíšte a pridajte komentáre k riadku kódu Pridané / upravené / odstránené na obrazovke, ktorá sa objaví.
Kliknite na Spustiť kontrolu.
Kliknite na Dokončite svoju kontrolu. Schválte podľa obrázka a Odoslať kontrolu .
Späť ako pôvodný používateľ, ktorý vzniesol požiadavku na stiahnutie, môžete pridať komentár a konverzáciu vyriešiť alebo uzavrieť.
Teraz je možné dokončiť požiadavku na zlúčenie.
Zmeny sú úspešne zlúčené do pán pobočka po kontrole a zlúčení požiadavky na stiahnutie.
Takže, aby sme to zhrnuli v tejto fáze, videli sme, že vývojári pracujú na vlastnosť vetva a potom vyvolajte Pull Request, aby sa zmeny zlúčili do pán pobočka. Vyššie uvedený bol scenár, v ktorom konflikty neexistovali. V nasledujúcej časti uvidíme spôsoby, ako vyriešiť konflikty manuálne, ak sa súbory zmenia vo viacerých vetvách.
Riešenie konfliktov
Je možné, že by sa zmenili rovnaké súbory vo viacerých vetvách. V takom prípade by došlo ku konfliktom a je potrebné ich vyriešiť na základe predloženej žiadosti o zatiahnutie.
Napríklad, vykonať zmeny v súbore Java v oboch pán a vlastnosť vetvy a vzniesť požiadavku na ťah.
Zobrazená správa s požiadavkou na stiahnutie je, že zmeny nie je možné automaticky zlúčiť. Preto musia byť konflikty vyriešené. Pokračujte vytvorením žiadosti o stiahnutie.
Akonáhle bude vznesená Pull Request, konflikty bude potrebné vyriešiť kliknutím na Vyriešte konflikty tlačidlo.
Odstráňte označenia, ktoré v podstate riešia konflikty manuálne, a kliknite na Označiť ako vyriešené a Potvrdiť zlúčenie.
Konečné zobrazenie súboru po odstránení značiek.
Žiadosť o zlúčenie je možné dokončiť. The pán a vlastnosť pobočky budú teraz identické.
Na obrazovke vyššie môžete vidieť, že kontrola je požadovaná, ale nie je povinná. V nasledujúcej časti sa dozvieme o pravidlách ochrany pobočiek, kde môže vlastník úložiska povinne požadovať kontrolu a tiež chrániť pán vetva od spáchania priamo k nej, ale iba prostredníctvom žiadosti o zatiahnutie.
Pravidlá ochrany pobočiek
V predchádzajúcich častiach sme videli informácie o požiadavkách na stiahnutie z Githubu a tiež o žiadostiach o kontroly, ktoré neboli nariadené alebo voliteľné. V kóde typických scenárov projektu sú kontroly nevyhnutnosťou a súčasťou procesu vývoja.
Pozrime sa, ako to vynútiť.
Na github.com je možné túto funkciu nastaviť iba pre verejné úložiská alebo pomocou verzie Github pro. Na hlavnej stránke úložiska prejdite na nastavenie a kliknite na ikonu Pobočky kategória vľavo.
Kliknite na Pridať pravidlo pod Pravidlá ochrany pobočiek. Pravidlo pridalo žiadosti o povinné kontroly vyžiadania vyžiadania od vlastníkov kódu pred zlúčením pre server pán pobočka.
Týmto sa tiež zabezpečí, že: hlavná vetva je chránený a v tejto pobočke nie je možné vykonávať priame provízie a je možné ho spáchať iba prostredníctvom Pull Request po dôkladnej kontrole. Toto nastavenie je nastavené vlastníkom úložiska.
Skutočne skvelá vlastnosť !!!
Kliknite na Vytvoriť raz hotovo. Ak chcete tento scenár otestovať, urobte zmenu v súbore v priečinku vlastnosť vetva a vytvorte požiadavku na vytiahnutie.
Nasledujúca obrazovka ukazuje, že vlastníci kódu povinne vyžadujú kontrolu.
Odošlite recenziu od Vlastníkov kódu, žiadosť o načítanie je možné zlúčiť.
Ako spolupracovník úložiska, ak urobíte zmeny v niektorom zo súborov, z dôvodu vytvorených pravidiel chránených pobočiek sa nebudete môcť zaviazať priamo do hlavnej pobočky, ale iba prostredníctvom požiadavky Pull po vytvorení pobočky, ako je to znázornené. nižšie.
Prevod úložiska na iný používateľský účet
Osobné úložisko používateľov má zvyčajne jedného vlastníka a všetci ostatní sú spolupracovníci. Takže v tom zmysle, že v úložisku používateľských účtov nemôžete mať viacerých vlastníkov. Vlastníctvo je ale možné previesť na iný používateľský účet. Po dokončení sa z pôvodného vlastníka úložiska automaticky stanú spolupracovníci v novom úložisku používateľských účtov.
Nový vlastník potom môže začať spravovať artefakty, problémy, sťahovať žiadosti, projekty, vydania a nastavenia.
Za normálnych okolností, keď sa v miestnom úložisku vykonávajú príkazy ako „git clone“ alebo „git push“, príkazy sa presmerujú do nového úložiska. Po spustení príkazu „git remote -v“ sa však stále zobrazí pôvodná adresa URL úložiska. Aby ste predišli nejasnostiam pri zmene na novú vzdialenú adresu URL, zverejnite prenos úložiska pomocou príkazu „git remote set-url“.
Ak chcete preniesť úložisko, prejdite na kartu Nastavenia v úložisku a v časti Možnosti? Danger Zone kliknite na Prenos
Zadajte názov úložiska a nový používateľský účet, na ktorý sa musí previesť vlastníctvo.
Kliknite na Rozumiem, preniesť toto úložisko
Mali by ste vidieť správu, že úložisko bolo prevedené na nového vlastníka.
Originálnemu vlastníkovi úložiska sa odošle e-mail so schválením prevodu. Po schválení prevodu bude úložisko prevedené na nového vlastníka a pôvodný vlastník úložiska bude pridaný ako spolupracovník.
Teraz nastavte adresu URL nového úložiska v stroji, kde bolo klonované staré úložisko. Nasledujúce príkazy musia byť nastavené na všetkých počítačoch, kde bolo klonované staré úložisko.
Všetky požiadavky na stiahnutie, problémy, wiki budú prenesené. Priradenia problémov zostanú nedotknuté.
Niekoľko užitočných príkazov Git
Existuje niekoľko základných príkazov Git, ktoré sa majú najskôr nakonfigurovať na vašom lokálnom počítači, akonáhle je klient Git nainštalovaný na vašom počítači so systémom Linux alebo Windows. Vývojári pracujú lokálne, bez pripojenia k úložisku na GitHub, na úplnej kópii zdrojového kódu dostupného na GitHub a synchronizujú sa s ním.
Najskôr nastavte svoje používateľské meno a e-mailovú adresu, aby ste sa ubezpečili, že tieto informácie budú používať všetky vaše záväzky.
git config –global user.name „UserName“
git config –global user.email „myemail@myemail.com“
Ak potrebujete pridať správu pri potvrdení, môžete tiež nakonfigurovať editor, ktorý je pre ne potrebný.
sql rozhovor s vývojárom otázky a odpovede pdf
git config –global poznámkový blok core.editor
Získajte zoznam všetkých nastavených konfiguračných hodnôt.
git config –list
Organizácie niekedy majú servery proxy na pripojenie k internetu. V takom prípade budete musieť zadať proxy server a číslo portu pre prístup do všetkých úložísk na GitHub.
git config –global http.proxyhttp: // Užívateľské meno: Heslo @ proxyserver: port
Klonujte alebo vytvorte miestnu kópiu úložiska. Získajte klonovanú adresu URL úložiska v GitHub a spustite príkaz git.
Záver
V tomto tutoriáli sme videli, ako môže vývojár začať pracovať na GitHube, hneď od vytvorenia úložiska GitHub, pobočky, žiadosti o stiahnutie, ochrany pobočky a niekoľkých základných príkazov Git.
V našom pripravovanom výučbe uvidíme ďalšie funkcie GitHubu, hlavne čo sa týka vytvárania organizácií, tímov, rozvetvenia úložiska, vytvárania problémov, míľnikov a združovania s požiadavkami na stiahnutie, wiki a ich použitia a niekoľko ďalších pokročilých príkazov Git, ktoré budú užitočné vývojárom.
Odporúčané čítanie
- Výukový program Java Reflection s príkladmi
- Git vs GitHub: Preskúmajte rozdiely pomocou príkladov
- Výukový program pre Python DateTime s príkladmi
- Integrácia selénu s GitHubom pomocou Eclipse
- Stručný sprievodca SoapUI pre ukladanie údajov o požiadavkách a odpovediach do súboru - SoapUI Tutorial # 15
- Výukový program Bugzilla: Výukový program pre nástroj na správu chýb
- 20+ výučba MongoDB pre začiatočníkov: bezplatný kurz MongoDB
- Výukový program zdieľania MongoDB s príkladom