GitHub naon éta sareng kumaha ngagunakeunana

GitHub mangrupikeun sapotong parangkat lunak anu seueur dianggo ku tim pamekar parangkat lunak, pikeun kontrol versi pamekaran.

Ieu mangpaat lamun leuwih ti hiji jalma keur dipake dina hiji proyek.

Salaku conto, anggap tim pamekar parangkat lunak hoyong ngawangun halaman wéb sareng aranjeunna sadayana kedah ngapdet kodeu, sakaligus, nalika damel dina proyék éta. Dina hal ieu, Github mantuan nyieun gudang terpusat dimana dulur bisa unggah, edit, jeung ngatur file kode program.

Sateuacan anjeun ngamimitian nganggo GitHub, anjeun kedah ngadamel akun GitHub.

Repository

Repository biasana dianggo pikeun ngatur proyék parangkat lunak aplikasi. Repositories tiasa ngandung polder sareng file, gambar, pidéo, spreadsheet sareng set data - sadayana anu diperyogikeun ku proyék anjeun. Sering repositories kalebet file README, file kalayan inpormasi ngeunaan proyék anjeun.

Berkas README ditulis dina basa Markdown dina téks polos. Anjeun tiasa konsultasi Halaman ieu web salaku rujukan gancang basa Markdown. GitHub ngidinan Anjeun pikeun nambahkeun file README dina waktos anu sareng anjeun nyieun gudang anyar Anjeun. GitHub ogé nawiskeun pilihan umum anu sanés sapertos file lisénsi, tapi anjeun henteu kedah milih anu mana waé.

Pikeun nyieun gudang anyar, di katuhu luhur pilih dina ménu New repository. Teraskeun léngkah-léngkah ieu:

1. Di pojok katuhu luhur halaman mana waé, paké ménu turun-handap teras pilih New repository.

1. Dina kotak Ngaran Repository, asupkeun first-repository.
2. Dina kotak Pedaran, tulis pedaran pondok.
3. Pilih Tambahkeun file README.
4. Pilih naha gudang anjeun bakal umum atanapi swasta.
5. Pencét Create repository.

Nyiptakeun cabang

Nyiptakeun cabang ngamungkinkeun anjeun gaduh sababaraha versi gudang dina waktos anu sami.

Sacara standardefinita, gudang first-repository boga cabang ngaranna main nu dianggap dahan definitip. Anjeun tiasa nyiptakeun cabang tambahan pikeun main di gudang first-repository. Anjeun tiasa nganggo cabang pikeun gaduh vérsi proyék anu béda dina waktos anu sami. Ieu mangpaat lamun rék nambahkeun fungsionalitas anyar pikeun proyék tanpa ngarobah kodeu sumber utama. Karya anu dilakukeun dina cabang anu béda-béda moal muncul dina cabang master dugi ka anjeun ngahijikeunana. Anjeun tiasa nganggo cabang pikeun ékspérimén sareng ngadamel parobihan sateuacan ngalaksanakeunana kana utama.

Lamun anjeun nyieun cabang tina cabang utama, anjeun nyieun salinan, atawa snapshot, tina utama sakumaha anu kasebut dina momen éta. Upami batur ngadamel parobihan kana cabang master nalika anjeun damel di cabang anjeun, anjeun tiasa nyorong apdet éta.

Dina diagram di handap ieu urang tiasa ningali:

Cabang utama
Cabang anyar disebut feature
Jalur anu feature ngalakukeun sateuacan dihijikeun sareng utama

Nyiptakeun cabang pikeun palaksanaan énggal atanapi perbaikan bug sapertos nyimpen file. Kalayan GitHub, pamekar parangkat lunak nganggo cabang pikeun ngajaga bug fix, sareng fitur karya, misah ti cabang produksi utama. Nalika parobahan tos siap, éta dihijikeun kana cabang master.

Hayu urang nyieun cabang

Sanggeus nyieun gudang urang, pindah ka tab <>Code(1) tina gudang:

Klik menu turun-handap utama (2), lajeng masihan nu anyar ngaran branch (3)

Klik dina Create branch: first branch from 'main'

Ayeuna urang gaduh dua branch, main e first-branch. Ayeuna, aranjeunna kasampak persis sarua. Engké urang bakal nambahan parobahan ka nu anyar branch.

Jieun tur mastikeun parobahan

Karek nyieun nu anyar branch, GitHub mawa anjeun ka code page kanggo anu énggal first-branch, anu mangrupa salinan utama.

Urang tiasa ngadamel sareng nyimpen parobihan kana file dina gudang. Dina GitHub, parobahan disimpen disebut commit. Saban commit gaduh pesen ti commit pakait, nu mangrupakeun pedaran anu ngécéskeun naon sababna parobahan husus dijieun. Pesen ti commit aranjeunna nangkep sajarah parobahan supados kontributor séjén tiasa ngartos naon anu dilakukeun sareng kunaon.

Handapeun dahan first-branch dijieun, klik dina file README.md, lajeng dina pensil pikeun ngédit file.

Dina éditor, nyerat nganggo Markdown.

Dina kotak Commit changes (Preview), urang nulis pesen tina commit ngajéntrékeun parobahan.

Tungtungna klik dina tombol Commit changes.

Parobihan ieu ngan bakal dilakukeun kana file README first-branch, jadi ayeuna cabang ieu ngandung eusi béda ti nu utama.

Bubuka hiji pull request

Ayeuna urang ngagaduhan parobahan dina cabang utama, urang tiasa muka hiji pull request.

Le pull request aranjeunna jantung kolaborasi on GitHub. Lamun anjeun muka a pull request, anjeun ngajukeun parobahan anjeun sarta requesting batur sangkan a review e pull kontribusi anjeun sarta ngagabung aranjeunna dina cabang maranéhanana. The pull request nuduhkeun bédana eusi duanana dahan. Parobahan, tambahan sareng pangurangan dipidangkeun dina warna anu béda.

Pas anjeun ngadamel komitmen, anjeun tiasa muka pamundut tarik sareng ngamimitian diskusi, bahkan sateuacan kodeu réngsé.

Ngagunakeun fungsi @mention ti GitHub dina pos anjeun ti pull request, Anjeun bisa nanya ka jalma atawa tim husus pikeun eupan balik, paduli lokasi maranéhanana.

Anjeun malah bisa muka pull request dina gudang anjeun sarta ngagabungkeun aranjeunna sorangan. Ieu mangrupikeun cara anu saé pikeun diajar aliran GitHub sateuacan ngerjakeun proyék anu langkung ageung.

Pikeun nyieun hiji pull request Anjeun kedah:

• Klik dina tab pull request tina gudang Anjeun first-repository.

• Pencét New pull request
• Dina kotak Example Comparisons, pilih cabang anu anjeun jieun, first-branch, mun dibandingkeun jeung utama (aslina).
• Tinjau parobahan anjeun dina bédana dina kaca Bandingkeun, pastikeun aranjeunna anu anjeun hoyong kirimkeun.

• Pencét Create pull request.

• Pasihan gelar anjeun pull request nulis pedaran pondok parobahan anjeun. Anjeun tiasa ngalebetkeun emojis sareng sered sareng teundeun gambar sareng gif.

• Optionally, ka katuhu tina judul jeung déskripsi, klik gigireun Reviewers. Panarima, Label, Proyék atanapi Milestones pikeun nambihan salah sahiji pilihan ieu ka anjeun pull request. Anjeun teu kedah nambihanana acan, tapi pilihan ieu nawiskeun sababaraha cara pikeun kolaborasi nganggo anjeun pull request.
• Pencét Create pull request.

Kolaborator anjeun ayeuna tiasa marios parobihan anjeun sareng ngadamel saran.

Ngahijikeun anjeun pull request

Dina léngkah ahir ieu, anjeun bakal ngahijikeun cabang anjeun first-branch dina cabang utama. Sanggeus ngahijikeun pull request, robah kana cabang first-branch bakal diselapkeun dina file utama.

Sakapeung, pamundut tarikan tiasa ngenalkeun parobahan kode anu bertentangan sareng kode anu aya dina utama. Upami aya bentrok, GitHub bakal ngingetkeun anjeun ngeunaan kode anu bentrok sareng nyegah ngahiji dugi ka konflik direngsekeun. Anjeun tiasa ngadamel komitmen anu ngabéréskeun konflik atanapi nganggo koméntar dina pamundut tarik pikeun ngabahas konflik sareng anggota tim anjeun.

• Pencét Merge pull request pikeun ngagabungkeun parobahan kana utama.

• Pencét Confirm merge. Anjeun bakal nampi pesen yén pamundut éta suksés dihijikeun sareng pamenta parantos ditutup.
• Pencét Delete branch. Ayeuna anjeun richiesta pull dihijikeun sareng parobihan anjeun dina utama, anjeun tiasa ngahapus cabangna first-branch. Lamun hayang nyieun parobahan salajengna pikeun proyék Anjeun, Anjeun salawasna bisa nyieun cabang anyar jeung ngulang prosés ieu.

Ercole Palmeri