Gamitin nang Mahusay ang Git Clone sa Ubuntu! Mula Basic hanggang Error at Options

1. Panimula

Sa mga kamakailang taon, sa pag-unlad ng software, pananaliksik, at personal na mga proyekto, ang “Git” ay naging isang hindi mawawala na tool. Lalo na, bilang isang sistema ng pamamahala ng bersyon na ginagamit sa buong mundo, ang Git ay naglalaro ng malaking papel sa pagbabahagi at pamamahala ng code sa pag-unlad ng koponan at mga proyekto ng open source.

Sa artikulong ito, ipapaliwanag namin nang malinaw para sa mga baguhan ang paraan ng pag-clone (pagkopya) ng Git repository gamit ang “git clone” command sa Ubuntu, isang popular na distribution ng Linux.
Ang “git clone” ay ang pinakabasic na command na ginagamit kapag kopyahin ang buong remote repository (halimbawa, mga proyekto na inilathala sa GitHub o GitLab) sa iyong lokal na environment.

Sa pamamagitan ng pag-master ng “git clone” para sa mga user ng Ubuntu, magiging mas madali ang pag-install ng iba’t ibang open source software at ang pagbuo ng iyong sariling development environment.
Bukod dito, ang pakikilahok sa mga koponan o komunidad ay magiging mas aktibo.

Sa artikulong ito, ipapakita namin nang komprehensibo mula sa pag-install ng Git hanggang sa basic na paggamit ng “git clone”, at ang mga karaniwang paraan ng paghawak sa mga error.
Ito ay magiging kapaki-pakinabang hindi lamang para sa mga unang beses na mag-Git sa Ubuntu, kundi pati na rin para sa mga may kaalamang gustong ayusin ang kanilang kaalaman.

2. Mga Prerequisite at Setting ng Environment

Upang magamit ang “git clone” sa Ubuntu, kailangan muna na naka-install ang Git mismo. Bukod dito, mahalaga rin ang initial setting para sa access sa remote repository at ang paghahanda ng authentication. Sa kabanatang ito, ipapaliwanag namin ang mga hakbang sa pagbuo ng environment isa-isa.

2.1 Paraan ng Pag-install ng Git

Sa Ubuntu, madali kang makakapag-install ng Git mula sa official repository. Buksan ang terminal at i-execute ang mga sumusunod na command nang sunod-sunod.

sudo apt update
sudo apt install git

Kapag natapos na ang pag-install, upang suriin kung tama ang pag-install ng Git, i-display ang impormasyon ng bersyon gamit ang sumusunod na command.

git --version

Kung naipakita ang impormasyon ng bersyon, matagumpay ang pag-install.

2.2 Setting ng Username at Email Address

Ang Git ay nag-iimbak ng “sino, kailan, ano ang ginawa” sa mga pagbabago ng file. Kaya, kapag unang beses na gagamitin ang Git, itakda ang username at email address.

git config --global user.name "Iyong Pangalan"
git config --global user.email "your.email@example.com"

Ang setting na ito ay ilalapat sa lahat ng Git operations pagkatapos ng isang beses na pag-set. Kung nais mong gumamit ng ibang setting bawat proyekto, i-omit ang --global at i-execute ang command sa loob ng project directory.

2.3 Pagpili at Paghanda ng Authentication Method

Kapag na-access ang remote repository sa Git, ang mga authentication method ay pangunahing “HTTPS” at “SSH”.

• HTTPS
  Aksesahin ito sa pamamagitan ng pagtukoy ng URL tulad ng sa browser. Sa GitHub o GitLab, kamakailan ay inalis ang password authentication, at inirerekomenda ang paggamit ng “Personal Access Token (PAT)”.
• SSH
  Autentikasyon gamit ang public key at private key. Mataas ang seguridad, at pagkatapos ng isang beses na setting, hindi na kailangang mag-input ng password bawat beses, kaya inirerekomenda para sa mga madalas gumamit ng Git.

2.4 Paggamit ng Git Credential Manager (GCM) (Kung Kinakailangan)

Kung nais mong mas safe at convenient ang pamamahala ng password o access token, isaalang-alang ang pag-install ng Git Credential Manager (GCM).
Sa pamamagitan ng pag-install ng GCM, maaari mong i-save nang ligtas ang token o authentication info, at maiiwasan ang pag-input bawat beses. Sa Ubuntu, maaari itong i-install sa pamamagitan ng official documentation o package.

Ngayon, natapos na ang mga paghahanda para sa paggamit ng “git clone” sa Ubuntu environment.
Sa susunod na kabanata, ipapakita namin ang basic na hakbang sa pag-clone ng repository gamit ang “git clone” command.

3. Basicong Paggamit ng git clone

Ang command na “git clone” ay isang basicong command upang kopyahin nang buo (kopya) ang nilalaman ng remote repository sa iyong local environment. Sa open source projects o team development, kapag nais mong gamitin ang repository na ginawa ng iba, ang unang hakbang na gagawin ay ang “git clone”.

3.1 Basic na Syntax ng Command

Ang pinakamababaw na paraan ng paggamit ay ang sumusunod.

git clone <URL ng Repository>

Halimbawa, kapag nag-clone ng public repository sa GitHub:

git clone https://github.com/exampleuser/sample-project.git

Kapag pinatupad ang command na ito, isang bagong folder na nagngangalang “sample-project” ang malilikha sa kasalukuyang directory, at lahat ng nilalaman ng repository ay madadownload doon.

3.2 Paraan ng Clone Gamit ang HTTPS

Ang karaniwang ginagamit sa maraming serbisyo ay ang clone sa pamamagitan ng HTTPS. Ang URL ay nagsisimula sa “https://”. Maaaring hilingin ang authentication information (pangalan ng user, Personal Access Token, atbp.) sa unang pagkakataon lamang.

git clone https://github.com/pangalan_ng_user/pangalan_ng_repository.git

3.3 Paraan ng Clone Gamit ang SSH

Kung may nirehistrong SSH key, mas ligtas at walang kailangang password ang pag-clone. Ang URL para sa SSH ay sa anyo tulad ng “git@github.com:”.

git clone git@github.com:pangalan_ng_user/pangalan_ng_repository.git

Upang magamit ang SSH clone, kailangang i-register muna ang public key sa GitHub o GitLab at iba pa.

3.4 Estraktura ng Repository Pagkatapos ng Clone

Kapag pinatupad ang command na “git clone”, hindi lamang lahat ng file at directory ng tinukoy na repository kundi maging ang “.git” directory na naglalaman ng impormasyon sa version control ay kopyahin nang magkasama.

• .git Directory
  Dito nakatago ang history ng repository at impormasyon sa setting. Dahil sa directory na ito, lahat ng file sa folder na iyon ay nasa ilalim ng pamamahala ng Git.
• Working Directory
  Ito ang grupo ng file na karaniwang ginagamit tulad ng source code ng project o dokumento.

3.5 Mag-ingat sa Current Directory Sa Panahon ng Clone

Ang command na “git clone” ay lumilikha ng bagong folder sa directory kung saan ito pinatupad. Inirerekomenda na lumipat muna sa directory na magiging save location (gamit ang cd command at iba pa) bago patuparin.

4. Paano Mag-clone ng Tiyak na Branch

Maaaring magkaroon ng maraming branch ang isang Git repository. Sa karaniwang “git clone”, ang default branch (hal. main o master) ang kinaklone, ngunit hindi biro ang mga kaso kung saan nais mong i-clone lamang ang isang tiyak na branch. Sa kabanatang ito, ipapakita namin ang paraan upang tukuyin ang ninanais na branch sa pag-clone.

4.1 Paggamit ng Opsyon na –branch

Ang command na “git clone” ay may --branch (o ang maikling anyo -b) na opsyon. Sa paggamit ng opsyong ito, maaari mong i-clone ang repository gamit ang tinukoy na branch.

git clone --branch branch_name repository_URL

Halimbawa, kung nais mong i-clone ang “develop” branch, ipasok ito nang ganito.

git clone --branch develop https://github.com/exampleuser/sample-project.git

Sa ganitong paraan, ang lokal na repository ay malilikha na may check out na “develop” branch.

4.2 Kapag Pinagsama ang Opsyon na –single-branch

Sa default, ang git clone ay nagdo-download ng lahat ng impormasyon ng branch. Gayunpaman, sa pagsama ng opsyon na “–single-branch”, maaari mong kunin lamang ang tinukoy na branch, na nagse-save ng espasyo sa disk at dami ng komunikasyon.

git clone --branch branch_name --single-branch repository_URL

Ang paraang ito ay kapaki-pakinabang kapag nais mong suriin lamang ang isang tiyak na functional branch o kapag hinahawakan ang malaking repository.

4.3 Kapag Kinukuha ang Iba Pang Branch Pagkatapos ng Clone

Kung nais mo ring gamitin ang iba pang branch bukod sa tiyak na iyon sa pagkatapos, i-execute ang sumusunod na command sa loob ng repository.

git fetch --all

Pagkatapos, upang mag-switch sa anumang branch,

git checkout branch_name

ipasok ito.

4.4 Mga Paalala

• Sa mga private repository o repository na may limitadong pahintulot, kailangan ng impormasyon sa pagpapatunay, kaya mag-ingat.
• Kung itutukoy ang hindi umiiral na pangalan ng branch, magiging error. Inirerekomenda na suriin muna ang mga pangalan ng branch sa remote repository nang maaga.

Kahit na nais mong i-clone lamang ang tiyak na branch, sa paggamit ng mga flexible na opsyon ng “git clone”, maaari mong epektibong isulong ang trabaho.

5. Karaniwang Mga Error at ang Kanilang Solusyon

Kapag gumagamit ng “git clone”, maaaring mangyari ang mga error dahil sa iba’t ibang dahilan tulad ng authentication, connection, permissions, at iba pa. Dito, ipinakikilala namin ang mga kinatawang error na madaling maharap ng mga user ng Ubuntu at ang kani-kanilang mga paraan ng pagresolba.

5.1 HTTPS Authentication Error at Paggamit ng Personal Access Token (PAT)

Sa mga kamakailang taon, upang mapahusay ang seguridad, ang tradisyunal na password authentication ay binasura sa GitHub at GitLab, na ginagawang kailangan ang paggamit ng Personal Access Token (PAT).
Habang nagko-clone, maaaring lumabas ang mga error tulad ng sumusunod.

remote: Support for password authentication was removed...
fatal: Authentication failed for 'https://github.com/...'

Sa kasong ito, mag-issue ng PAT sa GitHub, at ilagay ang iyong GitHub account sa halip na username, at PAT sa halip na password. Ang paraan ng paglikha ng PAT ay maaaring gawin mula sa “Settings”>”Developer settings”>”Personal access tokens” ng GitHub.

5.2 SSH Authentication Error at Pagrehistro ng Public Key

Kapag nagko-clone sa pamamagitan ng SSH, maaaring mangyari ang error na “Permission denied (publickey)”. Ito ay nangyayari kapag ang SSH key ay hindi tama ang rehistro.

【Paraan ng Paggawa】

1. Buuin ang SSH key sa terminal (kung wala pang umiiral)

   ssh-keygen -t ed25519 -C "your.email@example.com"

2. Kopyahin ang nilalaman ng public key

   cat ~/.ssh/id_ed25519.pub

3. Magdagdag ng public key sa settings screen ng GitHub o GitLab

Sa ganito, matutugunan ang error sa SSH authentication.

5.3 Error sa Access Rights ng Repository

Kapag sinubukan na i-clone ang private repository o repository ng organisasyon, maaaring lumabas ang mga error tulad ng sumusunod.

fatal: repository 'https://github.com/username/repository name.git/' not found

【Paraan ng Paggawa】

• Suriin kung tama ang URL ng repository
• Suriin kung may access rights ang account sa repository
• I-re-enter ang authentication information

5.4 Mga Error na Kaugnay ng Network

Ang mga network-related error tulad ng “Connection timed out” o “Could not resolve host” ay madalas na naapektuhan ng internet connection o proxy settings.

【Paraan ng Paggawa】

• Suriin kung tama ang koneksyon sa internet
• Kapag gumagamit ng VPN o proxy, suriin ang settings
• Kung pansamantalang problema sa side ng GitHub, maghintay ng kaunti at subukan muli

5.5 Iba Pang Karaniwang Mga Error

• Ang direktoryo ay umiiral na
  Kung may folder na may parehong pangalan na umiiral na, hindi mo ma-clone. Baguhin ang pangalan ng direktoryo o tanggalin ang umiiral na folder.
• Kulang ang espasyo sa disk
  Suriin kung sapat ang available space.

Sa ganitong paraan, kahit mangyari ang error, sa pamamagitan ng pagtukoy ng dahilan isa-isa at pagresolba, tiyak na malulutas ito.

6. Mga Kapaki-pakinabang na Opsyon ng git clone

Ang command na “git clone” ay may iba’t ibang opsyon na inihanda. Sa pamamagitan ng paggamit nito, maaari kang makuha nang mahusay lamang ang kinakailangang data, o kopyahin nang tama ang repository na may submodule, na nagpapalawak ng saklaw ng trabaho. Dito, ipapakita namin ang mga partikular na madalas na ginagamit na kapaki-pakinabang na opsyon.

6.1 Opsyon na –depth (Mababaw na Kopya)

Kung nais mong hindi kunin ang buong kasaysayan ng repository, ngunit ang pinakabagong kasaysayan lamang, ang opsyon na “–depth” ay kapaki-pakinabang.
Sa paggamit nito, maaari kang kunin ang kasaysayan hanggang sa tinukoy na bilang ng commit.

git clone --depth 1 https://github.com/exampleuser/sample-project.git

Sa halimbawang ito, kunin lamang ang pinakabagong 1 commit. Inirerekomenda ito para sa malalaking repository o CI environment na nakatuon sa bilis.

6.2 Opsyon na –single-branch

Sa default, ang git clone ay kumukuha ng lahat ng impormasyon ng branch, ngunit sa paggamit ng opsyon na “–single-branch”, maaari kang kopyahin lamang ang partikular na branch.
Lalo na madalas itong gamitin kasama ng opsyon na “–branch”.

git clone --branch develop --single-branch https://github.com/exampleuser/sample-project.git

Madali itong makakatulong kapag nais mong kopyahin nang mahusay lamang ang kinakailangang branch.

6.3 Opsyon na –recursive (Sabay-sabay na Pagkuha ng Submodule)

Sa Git repository, maaaring isama ang iba pang repository bilang “submodule”. Kapag kinokopya ang proyekto na may submodule, gamitin ang opsyon na “–recursive”.

git clone --recursive https://github.com/exampleuser/sample-project.git

Sa ganito, awtomatikong kopyahin ang main repository at ang submodule nang sabay. Kung nakalimutan ang “–recursive” sa pagkopya, maaari kang kunin ang submodule pagkatapos gamit ang sumusunod na command.

git submodule update --init --recursive

6.4 Iba Pang Kapaki-pakinabang na Opsyon

• Opsyon na –origin
  Gamitin ito kapag nais mong baguhin ang pangalan ng remote (origin) sa iba.
• Pag designate ng Pangalan ng Direktoryo
  Kung nais mong tukuyin nang eksplisito ang pangalan ng direktoryo sa pagkopya, idagdag ang pangalan ng direktoryo sa dulo ng command.

  git clone https://github.com/exampleuser/sample-project.git anumang pangalan ng direktoryo

Sa pagsasama ng mga opsyong ito, maaari mong gawing mas mahusay at flexible ang “git clone”.

7. Git Clone Gamit ang GUI Tool

Para sa mga hindi sanay sa operasyon sa command line o nais ng mas intuitive na paggamit ng Git, inirerekomenda ang paggamit ng GUI (Graphical User Interface) tool. Sa Ubuntu, maaaring gamitin ang ilang GUI tool upang madaling i-execute ang “git clone”.

7.1 Mga Halimbawa ng Pangunahing GUI Tool

• Gittyup Isang lightweight at simpleng Git client. Maaaring i-install sa opisyal na Ubuntu repository o sa pamamagitan ng Flatpak.
• Visual Studio Code (VS Code) Isang editor na popular sa maraming developer, at sa paggamit ng extension, maaaring intuitively gawin ang mga operasyon ng Git.
• GitKraken Nahuhoutan ng visually na madaling maunawaan na operation screen at maraming features (libre para sa personal na paggamit).

7.2 Paraan ng Cloning Gamit ang Gittyup

1. Mag-install ng Gittyup (hal.: sudo apt install gittyup o i-install mula sa Flatpak).
2. I-launch ang app at i-click ang mga button tulad ng “Clone Repository” o katulad.
3. Ipasok ang URL ng repository na nais i-clone, piliin ang destination folder, at i-execute upang madaling i-download ang repository.

7.3 Paraan ng Cloning Gamit ang Visual Studio Code

1. I-launch ang VS Code at i-click ang “Source Control” icon sa kaliwa.
2. Piliin ang button na “Clone Repository” (o “Clone Repository”) na ipinapakita sa itaas.
3. I-paste ang URL ng repository, pindutin ang Enter key, at tukuyin ang save location upang simulan ang cloning.
4. Pagkatapos ng pag-clone, maaaring gawin ang code editing, commit, push, at iba pang Git operations direktang sa loob ng VS Code.

7.4 Mga Benepisyo at Paalala ng GUI Tool

• Benepisyo Hindi kailangan ng input ng command, visually na na-ooperate kaya madaling gamitin kahit para sa mga baguhan. Maaari ring madaling maunawaan ang mga pagkakaiba ng file at history.
• Paalala Ang bawat tool ay may iba’t ibang features at interface, kaya piliin ang naaayon sa iyong pangangailangan at kagustuhan. Simulan sa GUI, unti-unting maging sanay sa command line upang maging mas flexible ang operasyon.

Kung gagamitin ang GUI tool, sa Ubuntu environment man, mas madali ang “git clone” at iba pang Git operations. Sa pagsasama ng command line at pag-adapt sa sitwasyon, mapapataas din ang efficiency ng trabaho.

8. Buod

Sa artikulong ito, inilarawan nang detalyado mula sa mga pundasyon hanggang sa mga aplikasyon ang paggamit ng “git clone” sa kapaligiran ng Ubuntu upang masahimpapanggamitin ito.
Mula sa mga hakbang sa pag-install ng Git, hanggang sa mga paraan ng pag-clone gamit ang HTTPS/SSH, paggamit ng partikular na branch o maginhawang mga opsyon, at pati na rin ang mga paraan ng pag-ooperate gamit ang GUI tools, ipinakilala namin nang sistematiko ang buong daloy.

Ang “git clone” ay isang command na napakagandang gamitin sa iba’t ibang sitwasyon tulad ng pagpasok sa mga open source project, team development, self-learning, at marami pang iba. Kapag natutunan mo nang mabuti ang paggamit nito, magiging madali at maayos ang iyong trabaho sa maraming sitwasyon sa hinaharap.

Lalo na para sa mga baguhan, subukang mapahusay nang patagal ng patagal ang iyong mga kasanayan sa mga hakbang na ito: “Kung may hindi mo naiintindihan, hanapin nang direkta ang error message o official documentation”, “Kapag sanay na, subukan ding gamitin ang mga maginhawang opsyon o GUI tools”.

Kung may mga tanong na hindi nasagot sa artikulong ito o may bagong problema na lumitaw, gamitin din ang FAQ, official documentation ng GitHub, at impormasyon mula sa komunidad.
Patuloy na gamitin ang kombinasyon ng Ubuntu at Git upang mapalawak pa ang saklaw ng iyong pag-unlad at pag-aaral.

9. Mga Madalas na Tanong at mga Sagot (FAQ)

Q1: Paano i-install ang Git sa Ubuntu?
A1: Tumakbo ng mga sumusunod na command sa terminal nang sunud-sunod.

sudo apt update
sudo apt install git

Pagkatapos ng pag-install, maaari mong suriin ang bersyon gamit ang git --version.

Q2: Paano kung gusto mong kunin lamang ang isang partikular na branch gamit ang git clone?
A2: Gamitin ang opsyon na --branch (o -b) at tukuyin ang pangalan ng branch upang i-clone.
Halimbawa:

git clone --branch branch_name URL_ng_repository

Kung kinakailangan, gamitin din ang --single-branch upang kunin lamang ang branch na iyon.

Q3: Lumalabas na authentication error kapag nag-clone sa pamamagitan ng HTTPS. Ano ang gagawin?
A3: Sa GitHub o GitLab, kailangan ng Personal Access Token (PAT) sa halip na password authentication. Mag-issue ng PAT mula sa settings screen ng GitHub at i-paste ang token sa field ng password.

Q4: Turuan mo ako ng paraan ng paglikha ng SSH key at ang proseso ng pagrehistro.
A4: Tumakbo ng sumusunod na command sa terminal upang gumawa ng SSH key.

ssh-keygen -t ed25519 -C "your.email@example.com"

Irehistro ang laman ng generated public key (~/.ssh/id_ed25519.pub) sa account settings screen ng GitHub o GitLab.

Q5: Paano suriin ang remote URL ng na-clone na repository?
A5: Sa directory ng na-clone na repository, tumakbo ng sumusunod na command.

git remote -v

Ito ay magpapakita ng listahan ng URL ng remote repository.

Q6: Ano ang mangyayari kung may umiiral nang directory na may parehong pangalan?
A6: Ang git clone ay mag-e-error kung umiiral na ang tinukoy na pangalan ng directory sa save location. Tukuyin ang ibang pangalan ng directory o alisin ang umiiral na kung hindi na kailangan bago muling i-execute.

Q7: Ano ang tamang paraan ng pag-clone ng repository na may submodules?
A7: Kapag nag-clone, idagdag ang opsyon na --recursive.

git clone --recursive URL_ng_repository

Kung na-clone na ito,

git submodule update --init --recursive

i-execute ito.

Q8: Ano ang inirerekomendang Git GUI tool para sa Ubuntu?
A8: Gittyup, Visual Studio Code (na may Git integration sa extensions), GitKraken at iba pa ay popular. Piliin batay sa layunin o kagustuhan mo.

Q9: Pagkatapos ng clone, paano mag-switch sa ibang branch?
A9:

git fetch --all
git checkout branch_name

maaari kang mag-switch sa ibang branch gamit ito.