Jinsi ya Kutumia GitHub kwenye Ubuntu: Mwongozo Kamili wa Mwanzo hadi Juu kwa Git, SSH, na VS Code

1. Utangulizi

Kwa Nini Kuunganisha Ubuntu na GitHub?

Katika miaka ya hivi karibuni, matumizi ya Git na GitHub yamekuwa mazoea ya kawaida katika maendeleo ya programu na uendeshaji wa mifumo. Kwa wahandisi na watengenezaji programu wanaofanya kazi katika mazingira ya Linux kama Ubuntu, kuunganisha na GitHub ni sehemu ya mtiririko wa kazi wa kila siku.

Git ni chombo cha kusimamia historia ya matoleo ya msimbo wa chanzo na ni muhimu kwa ushirikiano wa ufanisi kati ya watengenezaji wengi. GitHub, kwa upande mwingine, ni huduma ya kuhifadhi inayowezesha hazina zilizodhibitiwa na Git kushirikiwa na kuchapishwa mtandaoni, ikitoa kituo cha kimataifa kwa watengenezaji kubadilishana msimbo.

Kwa Nini Kutumia GitHub kwenye Ubuntu?

Ubuntu ni usambazaji wa Linux ambao ni maarufu sana miongoni mwa watengenezaji na unajulikana kwa utangamano bora na maendeleo ya chanzo wazi. Inatoa mazingira ambapo Git na zana nyingine za maendeleo zinaweza kusanikishwa kwa urahisi, na kufanya muunganiko wa GitHub kuwa laini na wa ufanisi.

Matumizi ya kawaida ya kuunganisha Ubuntu na GitHub ni pamoja na:

• Kusimamia na kushiriki msimbo wa Python, C++, na msimbo mwingine wa chanzo kwenye GitHub
• Kuchangia katika miradi ya chanzo wazi
• Kuchapisha kazi yako kama wasifu

Unachojifunza katika Makala Hii

Mwongozo huu unaelezea kila kitu kutoka kwa matumizi ya msingi hadi ya hali ya juu ya GitHub kwenye Ubuntu kupitia hatua zifuatazo:

• Jinsi ya kusanikisha Git kwenye Ubuntu
• Usanidi wa awali wa Git na usanidi wa SSH
• Kuunda na kusimamia hazina za GitHub
• Maendeleo yenye ufanisi kwa kutumia Visual Studio Code
• Vidokezo vya kawaida vya utatuzi wa matatizo na Maswali Yanayoulizwa Mara kwa Mara

Hata watumiaji wapya wa GitHub wanaweza kufuata kwa usalama, pamoja na mifano halisi ya amri na maelezo muhimu yaliyojumuishwa. Ikiwa unataka kutumia GitHub kikamilifu kwenye Ubuntu, soma hadi mwisho.

2. Kusanikisha Git kwenye Ubuntu

Git ni Nini? Ukumbusho wa Haraka

Git ni Mfumo wa Udhibiti wa Matoleo (VCS) unaotumika katika maendeleo ya programu kusimamia historia ya mabadiliko ya msimbo wa chanzo. Inawawezesha watengenezaji kurejesha hali za awali na kushirikiana kwa wakati mmoja.

Moja ya faida kuu ya mazingira ya Linux kama Ubuntu ni jinsi Git inavyoweza kusanikishwa kwa urahisi. Kwa kutumia njia ifuatayo, usanikishaji unaweza kukamilika ndani ya dakika chache kupitia terminal.

Kusanikisha Git kupitia APT

Njia ya kawaida zaidi ya kusanikisha Git kwenye Ubuntu ni kwa kutumia APT (Advanced Package Tool). Fuata hatua hizi:

1. Sasisha Orodha ya Pakiti

sudo apt update

Amri hii inachukua taarifa za pakiti za hivi karibuni. Daima iite kabla ya kusanikisha programu mpya.

2. Sasisha Git

sudo apt install git

Unapoombwa na “Y/n”, andika y na ubofye Enter kuanza usanikishaji.

Thibitisha Usanikishaji wa Git

Baada ya usanikishaji, thibitisha kwamba Git imewekwa kwa usahihi:

git --version

Ukiona matokeo kama yafuatayo, Git imewekwa kwa mafanikio:

git version 2.34.1

Nambari ya toleo inaweza kutofautiana kulingana na toleo la Ubuntu ulilokuwa nalo, lakini toleo lolote lililochapishwa linathibitisha mafanikio.

Kusanikisha kupitia Snap (Hiari)

Ingawa Git pia inaweza kusanikishwa kwa kutumia amri ya snap, APT kwa ujumla ni thabiti zaidi na hutumika sana. Isipokuwa una sababu maalum, APT inashauriwa.

3. Usanidi wa Awali wa Git

Usanidi Muhimu Kabla ya Kutumia Git

Mara Git inapokuwekwa, hatua inayofuata ni kusanidi maelezo ya mtumiaji na uthibitishaji. Usanidi sahihi unahakikisha mwingiliano mzuri na hazina za mbali na mtiririko wa kazi wa timu.

Kuweka Jina la Mtumiaji na Barua Pepe ya Git

Git hushikilia nani alifanya kila commit. Kwa hiyo, lazima usanidishe jina la mtumiaji na anwani ya barua pepe.

Amri za Usanidi

git config --global user.name "Your Name"
git config --global user.email "you@example.com"

Thamani hizi hazihitaji kulingana kabisa na akaunti yako ya GitHub, lakini kutumia barua pepe ile ile kama GitHub husaidia kuhusisha commit kwa usahihi.

Thibitisha Usanidi

git config --list

Amri hii inaonyesha usanidi wako wa Git wa sasa.

Kuunda na Kurekodi Funguo za SSH

.Ingawa HTTPS inaungwa mkono, uthibitishaji wa SSH unaondoa maombi ya nywila yanayojirudia na hutoa mtiririko wa kazi salama zaidi na wa ufanisi.

1. Tengeneza Ufunguo wa SSH

ssh-keygen -t ed25519 -C "you@example.com"

Bonyeza Enter mara kadhaa ili kutengeneza ufunguo binafsi (~/.ssh/id_ed25519) na ufunguo wa umma (~/.ssh/id_ed25519.pub).

2. Anzisha Wakala wa SSH na Ongeza Ufunguo

eval "$(ssh-agent -s)"
ssh-add ~/.ssh/id_ed25519

Ufunguo wa SSH sasa uko tayari kutumika.

3. Ongeza Ufunguo wa Umma kwenye GitHub

Nakili ufunguo wa umma:

cat ~/.ssh/id_ed25519.pub

Kisha ujiandikishe kwenye GitHub:

1. Ingia kwenye GitHub
2. Bofya picha yako ya wasifu → Mipangilio
3. Chagua “SSH and GPG keys”
4. Bofya “New SSH key”, bandika ufunguo, na uuhifadhi

4. Jaribu Muunganisho wa SSH

ssh -T git@github.com

Andika yes unapoulizwa kuamini mwenyeji.

Kama itakamilika, utaona:

Hi your-username! You've successfully authenticated, but GitHub does not provide shell access.

Hatua Zilizo Pendekezwa Zifuatazo

Ukimaliza usanidi huu, sasa unaweza kunakili, kusukuma, na kuvuta hazina za GitHub. Sehemu ijayo inaelezea jinsi ya kuunda na kuendesha hazina za GitHub katika vitendo.

4. Kufanya Kazi na Hazina za GitHub

Kuunda Hazina Mpya kwenye GitHub

Baada ya kuingia kwenye GitHub, anza kwa kuunda hazina mpya.

Hatua (kupitia Kivinjari cha Wavuti)

1. Bofya kitufe cha “+” kilicho kona ya juu kulia ya ukurasa wa nyumbani wa GitHub na uchague “New repository”.
2. Ingiza maelezo yafuatayo:

• Jina la hazina : Mfano: my-first-repo
• Maelezo (hiari) : Maelezo mafupi
• Umma / Binafsi : Chagua uwazi wa hazina

1. Bofya “Create repository”.

Baada ya kuundwa, URL ya hazina itaonyeshwa. Utatumia URL hii kunakili na kusimamia hazina.

Kunakili Hazina ya GitHub Iliyopo

Ili kunakili hazina kwenye mazingira yako ya Ubuntu, tumia amri ya git clone.

git clone git@github.com:your-username/my-first-repo.git

Mfano huu unatumia SSH. Ikiwa utatumia HTTPS, URL itakuwa tofauti.

Baada ya kutekeleza, saraka iitwayo my-first-repo itaundwa ikijumuisha faili za hazina.

Mabadiliko ya Faili, Uwekaji Kwenye Staging, na Mtiririko wa Commit

1. Ongeza au Hariri Faili

Kwa mfano, unda faili mpya:

echo "# My First GitHub Project" > README.md

2. Weka Mabadiliko Kwenye Staging

git add README.md

Staging huchagua mabadiliko ambayo yatajumuishwa katika commit ijayo.

3. Fanya Commit ya Mabadiliko

git commit -m "Initial commit: add README.md"

Mabadiliko yako sasa yamehifadhiwa katika historia ya hazina ya ndani.

Kusukuma Mabadiliko kwa GitHub

Ili kuonyesha mabadiliko ya ndani kwenye hazina ya mbali ya GitHub, tumia git push.

git push origin main

Kama tawi lako chaguomsingi si main (kwa mfano, master), rekebisha jina la tawi ipasavyo.

Kuvuta Mabadiliko ya Mbali kwa Ndani

Kama msanidi mwingine amefanya mabadiliko, tumia amri ifuatayo kusasisha hazina yako ya ndani:

git pull origin main

Hii inaunganisha mabadiliko ya mbali kwenye tawi lako la ndani.

Operesheni za Ziada za Kawaida

• Angalia hazina za mbali:

  git remote -v
  

• Ongeza hazina nyingine ya GitHub baadaye:

  git remote add origin git@github.com:your-username/another-repo.git
  

• Kuhariri README.md au .gitignore kunafuata mtiririko huo huo.

5. Kuunganisha na Visual Studio Code

Kwa Nini VS Code Ni Bora kwa Operesheni za Git

Unapotumia GitHub kwenye Ubuntu, kuichanganya na Visual Studio Code (VS Code) huongeza uzalishaji kwa kiasi kikubwa. VS Code ni mhariri wa chanzo huria uliotengenezwa na Microsoft na unajulikana kwa ujumuishaji bora wa Git. Inaruhusu commits, pushes, na mapitio ya diff kupitia GUI, na kuifanya iwe rafiki kwa wanaoanza.

Kusanidi VS Code kwenye Ubuntu

Unaweza kusanidi VS Code kwenye Ubuntu kwa urahisi ukitumia hatua zifuatazo.

1. Ongeza Hifadhi ya Microsoft

.

sudo apt update
sudo apt install wget gpg
wget -qO- https://packages.microsoft.com/keys/microsoft.asc | gpg --dearmor > packages.microsoft.gpg
sudo install -o root -g root -m 644 packages.microsoft.gpg /usr/share/keyrings/

2. Sajili Hifadhi ya Msimbo

sudo sh -c 'echo "deb [arch=amd64 signed-by=/usr/share/keyrings/packages.microsoft.gpg] https://packages.microsoft.com/repos/vscode stable main" > /etc/apt/sources.list.d/vscode.list'

3. Sakinisha VS Code

sudo apt update
sudo apt install code

Baada ya usakinishaji, unaweza kuzindua VS Code kwa kuandika code kwenye terminal.

Usaidizi wa Git Umejengwa

VS Code inaunganisha Git kwa chaguo-msingi, hivyo hakuna viendelezi vya ziada vinavyohitajika kwa operesheni za msingi za Git. Kwa matumizi ya hali ya juu, viendelezi vifuatavyo vinapendekezwa:

• GitHub Pull Requests and Issues Inaruhusu usimamizi wa Pull Request na Masuala kwa kutumia GUI.
• GitLens Inaonyesha historia ya kila mstari, ikionyesha nani alibadilisha nini na lini.

Operesheni za Msingi za Git katika VS Code

Kufungua Hifadhi

Nenda kwenye hifadhi yako iliyoklonwa na uendeshe:

code .

Kukagua Mabadiliko na Kujaza (Commit)

• Bofya ikoni ya Udhibiti wa Chanzo kwenye upau wa upande wa kushoto
• Tazama orodha ya faili zilizobadilishwa
• Chagua faili kuona tofauti
• Ingiza ujumbe wa commit na bofya ikoni ya ✓

Operesheni za “Push” na “Pull”

• Chagua “Push” au “Pull” kutoka kwenye menyu ya “…”
• Au tumia upau wa hali kwenye sehemu ya chini kulia

Kutumia Terminal Imejumuishwa

Terminal iliyojumuishwa (Ctrl + `) inaruhusu ubadilishaji usio na dosari kati ya mtiririko wa GUI na CLI. Kwa mfano, unaweza kujaza kupitia GUI na kusimamia matawi kupitia terminal.

Vidokezo vya Utatuzi wa Tatizo

• Kama makosa ya SSH yanatokea, thibitisha kuwa VS Code inarejelea ufunguo sahihi wa SSH
• Huenda ukahitaji kusanidi upya uthibitishaji au kutumia GitHub Personal Access Token (PAT)

6. Utatuzi wa Tatizo wa Kawaida

Kosa la SSH: “Permission denied (publickey).”

Sababu Zinazowezekana

• Funguo za SSH hazijaundwa kwa usahihi
• Ufunguo wa umma haujarekodiwa kwenye GitHub
• Wakala wa SSH haubeba ufunguo

Suluhisho

1. Angalia ufunguo wa SSH uliopo:

   ls ~/.ssh/id_ed25519.pub
   

Kama haupo, unda mmoja:

ssh-keygen -t ed25519 -C "your_email@example.com"

2. Anzisha wakala wa SSH na ongeza ufunguo:

   eval "$(ssh-agent -s)"
   ssh-add ~/.ssh/id_ed25519
   

3. Ongeza ufunguo wa umma kwenye GitHub:

   cat ~/.ssh/id_ed25519.pub
   

Uongeze chini ya “SSH and GPG keys” kwenye GitHub.

4. Jaribu muunganisho:

   ssh -T git@github.com
   

Kosa la Uthibitishaji kwa HTTPS

Sababu

• Uthibitishaji wa nenosiri umepitwa na wakati; uthibitishaji wa token unahitajika

Suluhisho

1. Unda Personal Access Token kwenye GitHub https://github.com/settings/tokens Angalia kipengele cha repo unapounda token
2. Tumia jina lako la mtumiaji la GitHub na kamba ya token kama nenosiri
3. Washa uhifadhi wa vitambulisho ikiwa unataka:

   git config --global credential.helper cache
   

Kosa: “fatal: not a git repository”

Sababu

• Saraka ya sasa si hifadhi ya Git

Suluhisho

• Nenda kwenye saraka ya hifadhi iliyopo:

  cd ~/your-project-directory
  

• Au anzisha hifadhi mpya:

  git init
  

Kushughulikia Migogoro ya Kuunganisha

Sababu

• Migogoro hutokea wakati watumiaji wengi wanahariri sehemu ile ile ya faili kwa wakati mmoja

Suluhisho

1. Fungua faili yenye mgogoro baada ya kosa la git pull
2. Tafuta alama za mgogoro:

   <<<<<<< HEAD
   Your changes
   =======
   Other changes
   >>>>>>> origin/main
   

3. Hariri maudhui, ondoa alama, na uhifadhi
4. Kisha endesha:

   git add .
   git commit
   

Kosa: “remote: Repository not found.”

Sababu

• URL ya hifadhi si sahihi
• Hakuna ruhusa ya kufikia hifadhi

Suluhisho

• Angalia URL ya mbali:

  git remote -v
  

• Weka upya URL ikiwa inahitajika:

.“` git remote set-url origin git@github.com:your-username/your-repo.git

Masuala haya huwa yanatokea kwa wajasiriamali. Hata hivyo, kwa sababu na suluhisho zilizo wazi, yanaweza kutatuliwa kwa utulivu. Chukulia makosa kama **fursa za kujifunza** na polepole jenga ujasiri.



## 7. Maswali Yanayoulizwa Mara kwa Mara



### Q1. Ni tofauti gani kati ya Git na GitHub?



**A:**  
Git ni **zana ya udhibiti wa matoleo** inayosimamia historia ya mabadiliko kwa ndani. GitHub ni **huduma ya wingu** inayohifadhi hazina za Git na kuwezesha ushirikiano na kushiriki.



* Git: Usimamizi wa historia ya ndani na bila mtandao
* GitHub: Uhifadhi wa hazina mtandaoni na ushirikiano



### Q2. Je, ninapaswa kutumia SSH au HTTPS?



**A:**  
**SSH inashauriwa** kwa sababu:



* Hakuna kuingiza nenosiri tena na tena
* Ni salama zaidi na rahisi kwa muda mrefu



Hata hivyo, HTTPS inaweza kuhitajika katika mazingira fulani ya kampuni au mtandao.



### Q3. Ninawezaje kutumia akaunti nyingi za GitHub kwenye Ubuntu?



**A:**  
Tengeneza funguo za SSH tofauti kwa kila akaunti na uzipange waziwazi.



1. Tengeneza funguo za SSH tofauti. Mifano: `~/.ssh/id_ed25519_work` , `~/.ssh/id_ed25519_personal`
2. Hariri `~/.ssh/config` :

Host github.com-work HostName github.com User git IdentityFile ~/.ssh/id_ed25519_work

Host github.com-personal HostName github.com User git IdentityFile ~/.ssh/id_ed25519_personal

3. Sasisha URL ya mbali:

git remote set-url origin git@github.com-work:your-work-user/your-repo.git

### Q4. Je, naweza kutumia Git na GUI?



**A:**  
Ndiyo. Visual Studio Code hutoa operesheni za Git kwa GUI, ikijumuisha commit, push, diffs, na usimamizi wa matawi. Inashauriwa sana kwa wajasiriamali.



### Q5. Nini kinatokea nikifuta hazina ya mbali?



**A:**  
Kufuta hazina ya mbali hakushtaki hazina ya ndani. Hata hivyo, `git push` itashindwa.



Unaweza kuunganisha tena kwa hazina mpya kama ifuatavyo:

git remote set-url origin git@github.com:new-user/new-repo.git

### Q6. Je, inawezekana kuepuka terminal kabisa?



**A:**  
Ndiyo. Wateja wa Git wa GUI huruhusu mtiririko wa kazi bila terminal:



* **GitKraken**
* **Sourcetree** (haijaungwa mkono rasmi kwenye Linux)
* **Visual Studio Code** (ina usaidizi wa Git uliyojengwa ndani)



Kwa watumiaji wa Ubuntu, muunganiko wa **VS Code + GitLens** ndio wa kiutendaji zaidi na rafiki kwa mtumiaji.



### Q7. Historia ya Git inaweza kurudi nyuma hadi lini?



**A:**  
Git huhifadhi **historia yote tangu commit ya kwanza**. Unaweza kuiangalia kwa kutumia:

git log

Kuangalia historia ya faili maalum:

git log path/to/file “`