github tutorial developers how use github
Ta vadnica za GitHub pojasnjuje, kaj je GitHub in kako ustvariti repozitorij, zahtevo za razvejanje in vlečenje. Vključuje pravila za zaščito podružnic in reševanje sporov:
Kaj je GitHub?
GitHub je storitev v oblaku, ki razvijalcem pomaga pri shranjevanju in upravljanju izvorne kode ter spremljanju in nadzoru vseh sprememb izvorne kode.
Preprosto povedano, GitHub je namenjen razvijalcem, pri katerih lahko upravljajo projekt, gostijo izvorno kodo in jih tudi pregledajo. Vse to bomo raziskali v tej seriji.
Seznam vadnic v tej seriji GitHub:
Vadnica št. 1: Vadnica za razvijalce GitHub | Kako uporabljati GitHub (Ta vadnica)
Vadnica # 2: Projekti GitHub, skupine, vilice in Wiki za dokumentiranje projektov
Vadnica št. 3: Napredni ukazi Git in vadnica za integracijo GitHub
Vadnica # 4: Vadnica za API za GitHub REST - Podpora za REST API v GitHub
Vadnica št. 5: Vadnica za namizje GitHub - sodelujte z namizjem GitHub
Vadnica # 6: Vadnica za TortoiseGit - Kako uporabljati TortoiseGit za nadzor različic
Kaj se boste naučili:
Kaj je Git?
Git je odprtokodni sistem za nadzor različic, kjer je celotna izvorna koda na voljo v računalniku razvijalca. Git je tudi odjemalski in porazdeljeni sistem za nadzor različic (DVCS), kjer lahko izvajate razvejanje in združevanje.
Uvod v GitHub
Za začetek uporabe GitHub bomo izvedli naslednje korake.
- Ustvarite skladišče za organizacijo projektov.
- Ustvari podružnico
- Spremenite datoteko in se zavežite.
- Ustvarite zahtevo za vlečenje za združitev vsebine.
- Protect Branch
V drugem delu serije si bomo ogledali tudi druge značilnosti GitHub-a, kot so Ustvarjanje organizacije, Skupine, Težave, Mejniki, Forks, Izdaje in Wikiji.
Ustvarite repozitorij GitHub
Repozitorij GitHub vsebuje artefakte projekta, kot so izvorna koda, dokumenti, slike itd. Ustvarili in uporabili bomo demo repozitorij za izvajanje vseh zgornjih korakov.
Prijavite se v Github.com in Ustvarite novo skladišče . Kliknite na Novo .
Dodajte spodnje podrobnosti o repo, kot je prikazano, in kliknite na Ustvari repozitorij . Nastavite dostop do zasebnega ali javnega. Bolje je, da jo nastavite za javno, saj je le malo funkcij odvisno od tega dostopa.
Opomba: Uporabnik, ki ustvari skladišče, je lastnik skladišča GitHub.
Repozitorij je ustvarjen z datoteko README.
Dodajanje sodelavcev v skladišče GitHub
Želeli bi, da ekipa dela na tem odlagališču. Za to bomo morali sodelavce povabiti k delu na odlagališču. Če želite dodati sodelavce, pojdite na glavno stran skladišča in kliknite na Nastavitve ikono.
Kliknite na Sodelavci v levo podokno in dodajte sodelavce, ki imajo račun Github. Povabilo bi bilo poslano, sodelavci pa bi ga morali sprejeti.
Sodelavci so dodani, kot je prikazano spodaj. Kasneje bomo v tej vadnici videli, kako bodo sodelavci dodani kot pregledovalec zahteve za vlečenje, ustvarjene za združitev kode.
Izvedba Basic C ommit
Odprite datoteko README in izvedite osnovno odobritev. Kliknite na Ikona za urejanje da začnete spreminjati datoteko.
Spremenite datoteko, dodajte komentar in kliknite Zavežite se .
Datoteka je predana (spremembe so shranjene) v skladišče Github.
Ogledanih bo nekaj operacij za ustvarjanje map in datotek v skladišču.
Če želite ustvariti mapo in datoteko v: Kliknite na Ustvari novo datoteko na ravni odlagališča. Vnesite ime imenika, ki mu sledi / in ime datoteke, kot je prikazano spodaj.
Kliknite na Zavežite se na dnu. Mapa in datoteka sta ustvarjeni, kot je prikazano. Tako se datoteke in mape ustvarijo na mojster veja, ki je glavna veja integracije in večinoma tam, kjer je mogoče izdelati izdaje programske opreme.
Razvijalci običajno delajo na nalogi, ki jim je dodeljena v ločeni veji, in spremembe združijo v glavno vejo. Na primer, veje je mogoče ustvariti za razvoj funkcij ali odpravljanje napak ali delo na izboljšavah itd. Tako je z ustvarjanjem veje delo izolirano, ne da bi motilo druge veje.
V naslednjem koraku si lahko ogledamo, kako je mogoče ustvariti veje in določimo zahteve za povlečenje, da pregledamo in združimo kodo v glavno vejo.
Premikanje datoteke
Če želite datoteko premakniti v drugo mapo, naredite naslednje. Na primer, da datoteko rules.txt premaknete v mapo z dokumenti. Kliknite datoteko.
Kliknite ikono za urejanje datoteke.
Dodajte pot doc / pred datoteko rules.txt . Kliknite na Zavedi spremembe.
Pot je zdaj posodobljena.
Ustvarjanje podružnice GitHub
Pojdite na glavno stran skladišča in vnesite, da ustvarite funkcija podružnica, kot je prikazano. Kliknite na Ustvari vejo.
Zdaj smo v funkcija podružnica. Datoteke so enake. Zdaj bomo naredili nekaj sprememb v datotekah v funkcija in ustvarite zahtevo za vlečenje za pregled sprememb in združitev kode v mojster podružnica.
Spremenite datoteke v veji funkcije.
Odprite datoteko Java v mapi Src in dodajte nekaj kode ter izvedite spremembo.
Ustvarite zahtevo za vlečenje GitHub
V prejšnjem poglavju smo ustvarili vejo funkcija in naredil nekaj sprememb v datoteki. Spremembe niso v mojster podružnica. Za to moramo ustvariti zahtevo za vlečenje, s katero uporabnik predlaga nekatere spremembe, ki jih je treba pregledati in združiti v mojster podružnica.
Ustvarjanje zahteve za vlečenje bo pokazalo razlike med izvorno in ciljno vejo in bo moralo rešiti konflikte, če obstajajo.
Kliknite na Zahteva za primerjavo in vlečenje na glavni strani odlagališča.
Vidite lahko, da je mogoče spremembe v obeh vejah združiti. Kliknite na Ustvari zahtevo za vlečenje.
Kliknite na Spoji zahtevo za vlečenje in Potrdite za dokončanje združitve.
Spremembe so uspešno združene v mojster podružnica. Naša prva zahteva za vlečenje je uspešno zaključena.
Dodelite pregledovalcem zahteve za vlečenje in pregled kode
Github ima dobro lastnost uporabe datoteke CODEOWNERS, v kateri lahko v repozitoriju izberemo osebe, odgovorne za izvorno kodo. Lastniki repozitorija lahko ustvarijo to datoteko in vsi uporabniki, definirani v datoteki, so privzeto zahtevani za pregled med ustvarjanjem zahteve za vlečenje.
Če želite uporabljati to funkcijo, morate uporabiti različico GitHub Pro ali shraniti javno skladišče.
V korenu repozitorija ustvarite to datoteko v naslednji obliki in jo odobrite.
* @ uporabniško ime ali @orgname ali @teamname
* pomeni predvsem vse datoteke v repo. Določite lahko tudi posebne končnice, kot sta * .java ali * .js itd. Uporabnikom, določenim v datoteki, bo samodejno poslana zahteva za pregled. Z definirano datoteko CODEOWNERS ni treba izrecno ročno dodajati pregledovalcev in ima nekoliko večjo prilagodljivost pri izbiri datotek za pregled.
Nazaj v funkcija podružnico naredite majhno spremembo v datoteki Java in ustvarite zahtevo za vlečenje. Na zaslonu Pull Request določite pregledovalca na desni strani. Kliknite na Ustvari zahtevo za vlečenje.
Na zgornjem zaslonu lahko vidite, da je pregledovalce mogoče dodeliti ročno, vendar so pregledovalci določeni v datoteki CODEOWNERS, ki bodo samodejno prejeli zahtevo za pregled sprememb kode.
Kakorkoli, za zdaj, dajmo Vpiši se kot pregledovalec in odobri spremembe. Prijavite se kot uporabnik vniranjan2512, da odobrite spremembe.
Obstaja zahteva za odobritev / zavrnitev sprememb pod Zahteva za vlečenje.
Kliknite zahtevo za vlečenje in Dodajte svoje mnenje.
Lahko kliknete na + podpišite in dodajte komentarje za pregled za vrstico kode Dodano / Spremenjeno / Zbrisano na zaslonu, ki se odpre.
Kliknite na Začnite pregled.
Kliknite na Dokončajte pregled. Odobrite, kot je prikazano in Pošlji pregled .
Kot prvotni uporabnik, ki je sprožil zahtevo za vlečenje, lahko dodate komentar in pogovor razrešite ali zaprete.
Zahtevo za združitev potegnite zdaj.
Spremembe so uspešno združene v mojster podružnica objavi pregled in združitev zahteve za vlečenje.
Če povzamemo na tej stopnji, smo videli, da razvijalci delajo na funkcija in nato dvignite zahtevo za vlečenje za združitev sprememb v mojster podružnica. Zgoraj je bil scenarij, ko konfliktov ni bilo. V naslednjem razdelku bomo videli načine za ročno reševanje sporov, če se datoteke spremenijo v več vejah.
Reševanje konfliktov
Možno je, da bi se spremenile iste datoteke v več vejah. V tem primeru bi prišlo do konfliktov in jih je treba rešiti z dvignjeno zahtevo za vlečenje.
Na primer, spremenite datoteko Java v obeh datotekah mojster in funkcija veje in dvignite zahtevo za vlečenje.
Prikaže se sporočilo o zahtevi za vlečenje, da sprememb ni mogoče samodejno združiti. Zato je treba konflikte rešiti. Nadaljujte z ustvarjanjem zahteve za vlečenje.
Ko je povlečena zahteva za vlečenje, bo treba konflikte rešiti s klikom na Rešujte konflikte .
Odstranite oznake, ki v bistvu ročno rešujejo konflikte, in kliknite Označi kot rešeno in Objavi združitev.
Končni pogled datoteke po odstranitvi oznak.
Zahtevo za združitev vlečenja je mogoče izpolniti. The mojster in funkcija podružnice bodo zdaj enake.
Na zgornjem zaslonu še vedno vidite, da je pregled zahtevan, vendar ni obvezen. V naslednjem razdelku bomo videli pravila o zaščiti podružnice, pri katerih lahko lastnik skladišča obvezno zahteva pregled in zaščiti mojster podružnice, da se ne zaveže neposredno zanjo, vendar le prek zahteve za vlečenje.
Pravilnik o zaščiti podružnic
V prejšnjih odsekih smo videli zahteve za povlečenje Github-a in tudi zahteve za preglede, ki niso bili obvezni ali neobvezni. V tipični kodi projektnih scenarijev so pregledi nujni del razvojnega procesa.
Poglejmo, kako to uveljaviti.
V github.com lahko to funkcijo nastavite samo za javne repozitorije ali z uporabo različice Github pro. Na glavni strani odlagališča pojdite na Nastavitve in kliknite na Podružnice kategorija na levi.
Kliknite na Dodaj pravilo pod Pravila o zaščiti podružnic. Pravilo je dodalo zahteve za obvezne preglede zahtev za vlečenje lastnikov kode pred združitvijo za mojster podružnica.
To bo tudi zagotovilo, da glavna veja je zaščiten in na tej veji ni mogoče izvajati neposrednih prevzemov, po temeljitem pregledu pa se lahko izvršijo le prek zahtev za vlečenje. To nastavitev nastavi lastnik skladišča.
Res odlična lastnost !!!
Kliknite na Ustvari enkrat opravljeno. Če želite preizkusiti ta scenarij, spremenite datoteko v datoteki funkcija vejo in ustvarite zahtevo za vlečenje.
Naslednji zaslon prikazuje, da lastniki kode obvezno zahtevajo pregled.
Objavite pregled lastnikov kode, zahtevo za vlečenje lahko združite.
Če spremenite katero koli datoteko kot sodelavec repozitorija, zaradi ustvarjenih pravil zaščitenih vej ne boste mogli prevzeti obveznosti neposredno v glavno vejo, temveč le z zahtevo za vlečenje po ustvarjanju veje, kot je prikazano spodaj.
Prenos repozitorija na drug uporabniški račun
Običajno ima osebno skladišče uporabnikov enega lastnika, vsi ostali pa so sodelavci. Torej, v smislu, da v repozitoriju uporabniškega računa ne morete imeti več lastnikov. Toda lastništvo je mogoče prenesti na drug uporabniški račun. Ko konča, lastnik prvotnega repozitorija samodejno postane sodelavec v novem repozitoriju uporabniškega računa.
Novi lastnik lahko nato začne upravljati artefakte, težave, zahteve za vlečenje, projekte, izdaje in nastavitve.
Običajno, ko se ukazi, kot sta 'git clone' ali 'git push' izvajajo v lokalnem repozitoriju, ukazi preusmerijo v novo repozitorij. Ko pa zaženete ukaz 'git remote -v', bo še vedno prikazal izvirni URL repozitorija. Da bi se izognili zmedi, preklopite na novo oddaljeno URL objavo s pomočjo ukaza ‘git remote set-url’.
Če želite prenesti skladišče, pojdite na zavihek Nastavitve skladišča in pod Možnosti? Kliknite nevarno območje Prenos
Vnesite ime repozitorija in novi uporabniški račun, na katerega je treba prenesti lastništvo.
Kliknite Razumem, prenesite to skladišče
Videli bi sporočilo, da je skladišče preneseno na novega lastnika.
Prvotnemu lastniku skladišča bo poslano e-poštno sporočilo, da bo odobril prenos. Ko bo prenos odobren, bo repozitorij prenesen na novega lastnika, izvirni lastnik repozitorija pa bo dodan kot sodelavec.
Zdaj nastavite nov URL repozitorija v napravi, kjer je bilo klonirano staro repozitorij. Naslednje ukaze je treba nastaviti v vseh strojih, kjer je bilo klonirano staro skladišče.
Vse zahteve za vlečenje, vprašanja, wiki bodo preneseni. Naloge izdaje bodo ostale nedotaknjene.
Nekaj uporabnih ukazov Git
Obstaja nekaj osnovnih ukazov Git, ki jih je treba najprej konfigurirati na vašem lokalnem računalniku, ko je odjemalec Git nameščen na vašem računalniku Linux ali Windows. Razvijalci delajo lokalno, brez povezave s skladiščem v GitHubu, na celotni kopiji izvorne kode, ki je na voljo v GitHubu, in se sinhronizirajo z njo.
Najprej nastavite svoje uporabniško ime in e-poštni naslov, da zagotovite, da vsi prevzeti obveznosti uporabljajo te podatke.
git config –global user.name “UserName”
git config –global user.email “myemail@myemail.com”
Ko morate med potrditvami dodati sporočilo, lahko nastavite tudi urejevalnik, potreben za isto.
razlika med SQL in SQL strežnikom
git config –global core.editor notepad
Pridobite seznam vseh nastavljenih vrednosti konfiguracije.
git config –list
Včasih imajo organizacije proxy strežnike za povezavo z internetom. V tem primeru boste morali določiti proxy strežnik in številko vrat za dostop do vseh skladišč v GitHubu.
git config –global http.proxyhttp: // Uporabniško ime: Geslo @ proxyserver: port
Klonirajte ali naredite lokalno kopijo skladišča. Pridobite URL klona skladišča v GitHub in zaženite ukaz git.
Zaključek
V tej vadnici smo videli, kako lahko razvijalec začne delati na GitHubu, neposredno od Ustvarjanja repozitorija GitHub, veje, zahteve za vlečenje, zaščite veje in nekaterih osnovnih ukazov Git.
V naši prihajajoči vadnici bomo videli druge funkcije GitHub-a, predvsem o tem, kako ustvariti organizacije, skupine, razstaviti skladišče, ustvariti težave, mejnike in povezovanje z zahtevami za vlečenje, wikije in njihovo uporabo ter nekaj drugih naprednih ukazov Git, ki bodo koristni razvijalcem.
Priporočeno branje
- Vadnica za odsev Java s primeri
- Git vs GitHub: raziščite razlike s primeri
- Vadnica Python DateTime s primeri
- Integracija selena z GitHubom s pomočjo Eclipse
- Kratek vodnik SoapUI za shranjevanje podatkov o zahtevah in odzivih v datoteki - Vadnica SoapUI # 15
- Vadnica za Bugzilla: Praktična vadnica o orodju za upravljanje napak
- 20+ MongoDB vadnica za začetnike: brezplačen tečaj MongoDB
- MongoDB Vadnica za osenčenje s primerom