ស្គាល់ GitHub

មាតិកា

  1. បង្កើតគណនី GitHub
  2. ការចូលគណនីពី Terminal
  3. ដំឡើង GitHub CLI ហើយ Log In
  4. បង្កើត Repository នៅលើ GitHub
  5. ភ្ជាប់ Project របស់អ្នក៖ git remote
  6. Upload វា៖ git push
  7. បន្ថែម README
  8. ទាញយកវា៖ git clone
  9. Public, Private និង Secret
  10. សាកល្បងដោយខ្លួនឯង

1. បង្កើតគណនី GitHub

ចូលទៅកាន់ github.com ហើយចុះឈ្មោះ។ វាឥតគិតថ្លៃ ហើយគម្រោងឥតគិតថ្លៃនេះអនុញ្ញាតឲ្យមាន repository ទាំង public និង private ដោយគ្មានកំណត់។

មានជម្រើសមួយចំនួនដែលសំខាន់ជាងអ្វីដែលអ្នកគិត៖

  • Username របស់អ្នកគឺជាសាធារណៈ ហើយស្ទើរតែជាអចិន្ត្រៃយ៍។ វាលេចឡើងនៅក្នុងអាសយដ្ឋាននៃគ្រប់ project — github.com/<username>/my-site — ហើយនិយោជកនឹងឃើញវា។ ឈ្មោះពិតរបស់អ្នក ឬអ្វីដែលជិតនឹងវា គឺជាជម្រើសល្អ។ (dara-sok ល្អជាង xX_dara_Xx។)
  • ប្រើ email ដែលអ្នកបានកំណត់ជា user.email នៅក្នុងជំពូកទី 2 ដើម្បីឲ្យ GitHub អាចភ្ជាប់ commit របស់អ្នកទៅនឹងគណនីរបស់អ្នក។ ប្រសិនបើអ្នកបានកំណត់ email ផ្សេង សូមបន្ថែមវានៅក្រោម Settings → Emails។
  • បើក two-factor authentication (2FA) នៅក្រោម Settings → Password and authentication។ GitHub តម្រូវឲ្យមានវាសម្រាប់អ្នកណាក៏ដោយដែលចូលរួមសរសេរកូដ ហើយវាការពារមិនឲ្យអ្នកដែលទាយត្រូវ password របស់អ្នកដណ្តើមយកគណនីរបស់អ្នក។ App authenticator នៅលើទូរស័ព្ទរបស់អ្នកដំណើរការបានល្អ។

ពេលនៅទីនោះ សូមបន្ថែមរូប profile និងការពិពណ៌នាខ្លីអំពីខ្លួនអ្នក។ Profile GitHub របស់អ្នកនឹងក្លាយជាផ្នែកមួយនៃ portfolio របស់អ្នក។

2. ការចូលគណនីពី Terminal

នៅពេលអ្នកផ្ញើកូដទៅ GitHub នោះ Git ត្រូវបញ្ជាក់ថាជាអ្នកពិតមែន។ អ្នកប្រហែលជារំពឹងថាត្រូវវាយ password GitHub របស់អ្នក — ប៉ុន្តែ GitHub មិនទទួលយក password គណនីសម្រាប់ប្រតិបត្តិការ Git ទេ។ វាត្រូវបានបិទតាំងពីឆ្នាំ 2021 ព្រោះ password ងាយនឹងត្រូវគេលួច និងយកទៅប្រើឡើងវិញពេក។

ផ្ទុយទៅវិញ Git ត្រូវការរបស់មួយក្នុងចំណោមរបស់ពីរ៖

  • token ដែលផ្ញើតាម HTTPS — ជា key វែង ចៃដន្យ ហើយអាចដកហូតវិញបាន ឬ
  • SSH key — ជាគូ key ដែលរក្សាទុកនៅលើកុំព្យូទ័ររបស់អ្នក

ទាំងពីរដំណើរការបាន។ ការបង្កើត និងរក្សាទុក token ដោយដៃគឺរញ៉េរញ៉ៃបន្តិច ដូច្នេះស៊េរីនេះប្រើ GitHub CLI (gh) ដែលជាឧបករណ៍ terminal ផ្លូវការរបស់ GitHub។ វា log in ឲ្យអ្នកតាមរយៈ browser របស់អ្នក ហើយរៀបចំ Git ឲ្យអ្នកក្នុងជំហានតែមួយ។

SSH key គឺជាជម្រើសទូទៅមួយទៀត ហើយអ្នកនឹងជួបវាម្តងទៀតនៅពេលអ្នកធ្វើការជាមួយ server។ ប្រសិនបើអ្នកចង់ប្រើវាសម្រាប់ GitHub ការណែនាំផ្លូវការមាននៅក្រោម Docs → Authentication → Connecting to GitHub with SSH។ អ្វីៗផ្សេងទៀតនៅក្នុងស៊េរីនេះដំណើរការដូចគ្នា មិនថាអ្នកប្រើវិធីណាក៏ដោយ។

3. ដំឡើង GitHub CLI ហើយ Log In

ដំឡើង gh៖

# macOS (Homebrew)
brew install gh

# Windows with Git Bash (run in PowerShell)
winget install --id GitHub.cli

នៅលើ Linux និង WSL សូមដំឡើងវានៅខាងក្នុង Linux — កុំប្រើ winget ព្រោះវានឹងដាក់ gh នៅខាង Windows ដែល terminal WSL របស់អ្នកមិនអាចប្រើបាន។ Ubuntu កំណែថ្មីៗមានវាជា package (sudo apt install gh) បើមិនដូច្នោះទេ សូមធ្វើតាមការណែនាំសម្រាប់ distribution របស់អ្នកនៅ cli.github.com។ បិទ terminal របស់អ្នក ហើយបើកវាឡើងវិញ រួចពិនិត្យ៖

gh --version

ឥឡូវ log in៖

gh auth login

វាសួរសំណួរមួយចំនួន។ ប្រើគ្រាប់ចុចព្រួញ និង Enter ដើម្បីជ្រើសរើស៖

? Where do you use GitHub?  GitHub.com
? What is your preferred protocol for Git operations on this host?  HTTPS
? Authenticate Git with your GitHub credentials?  Yes
? How would you like to authenticate GitHub CLI?  Login with a web browser

! First copy your one-time code: 1A2B-3C4D
Press Enter to open https://github.com/login/device in your browser...

ចម្លងកូដនោះ ចុច Enter បិទភ្ជាប់កូដនោះចូលទំព័រដែលបើកឡើង ហើយចុច Authorize។ ត្រឡប់មក terminal វិញ៖

✓ Authentication complete.
- gh config set -h github.com git_protocol https
✓ Configured git protocol
✓ Logged in as dara-sok

ពិនិត្យវាបានគ្រប់ពេលដោយប្រើ៖

gh auth status

ប៉ុណ្ណឹងឯង — ចាប់ពីពេលនេះតទៅ git push និង git pull ទៅ GitHub នឹងដំណើរការភ្លាមៗ។ អ្នកមិនចាំបាច់ប្រើ gh សម្រាប់អ្វីផ្សេងទៀតនៅក្នុងស៊េរីនេះទេ ទោះបីជាវាអាចធ្វើបានច្រើនក៏ដោយ (អ្នកនឹងឃើញ shortcut ពីរបីនៅពេលក្រោយ)។

4. បង្កើត Repository នៅលើ GitHub

នៅលើ GitHub ចុចសញ្ញា + នៅជ្រុងខាងស្តាំផ្នែកខាងលើ → New repository ហើយបំពេញ៖

  • Repository name: my-site
  • Description: My personal website, built while learning Git
  • Public (ត្រូវការសម្រាប់ hosting GitHub Pages ឥតគិតថ្លៃនៅក្នុងជំពូកទី 11)

កុំធីកអ្វីទាំងអស់នៅក្រោម "Initialize this repository with" — គ្មាន README គ្មាន .gitignore គ្មាន license។ អ្នកមាន project ដែលមាន history រួចហើយ អ្នកចង់ឲ្យ GitHub ចាប់ផ្តើមជាមួយ repository ទទេ ដើម្បី push វាចូល។ (ប្រសិនបើ GitHub បង្កើត commit ដំបូងរបស់វាផ្ទាល់ history ទាំងពីររបស់អ្នកនឹងមិនត្រូវគ្នា ហើយការ push ដំបូងនឹងស្មុគស្មាញ។)

ចុច Create repository។ GitHub បង្ហាញទំព័រ "Quick setup" ជាមួយអាសយដ្ឋានរបស់ repository។ វាមើលទៅដូចនេះ៖

https://github.com/dara-sok/my-site.git

5. ភ្ជាប់ Project របស់អ្នក៖ git remote

Repository នៅលើកុំព្យូទ័ររបស់អ្នកមិនទាន់ដឹងថា GitHub មានទេ។ ប្រាប់វា ពីខាងក្នុង my-site៖

git remote add origin https://github.com/dara-sok/my-site.git

(ពិតណាស់ ត្រូវប្រើ username ផ្ទាល់ខ្លួនរបស់អ្នក។) នេះបន្ថែម remote មួយ — ជា link ដែលមានឈ្មោះ ទៅកាន់ច្បាប់ចម្លងមួយទៀតនៃ repository។ origin គឺជាឈ្មោះដែលមនុស្សគ្រប់គ្នាប្រើសម្រាប់ «ច្បាប់ចម្លងចម្បងនៅលើ GitHub»។ វាគ្រាន់តែជាទម្លាប់ប៉ុណ្ណោះ ប៉ុន្តែអ្នកនឹងឃើញវានៅក្នុងគ្រប់ project និងគ្រប់មេរៀន។

ពិនិត្យវា៖

git remote -v

origin	https://github.com/dara-sok/my-site.git (fetch)
origin	https://github.com/dara-sok/my-site.git (push)

6. Upload វា៖ git push

ផ្ញើ commit របស់អ្នកឡើងទៅ GitHub៖

git push -u origin main

Enumerating objects: 34, done.
Counting objects: 100% (34/34), done.
Delta compression using up to 8 threads
Compressing objects: 100% (30/30), done.
Writing objects: 100% (34/34), 3.41 KiB | 3.41 MiB/s, done.
Total 34 (delta 12), reused 0 (delta 0), pack-reused 0
To https://github.com/dara-sok/my-site.git
 * [new branch]      main -> main
branch 'main' set up to track 'origin/main'.

នេះមានន័យថា៖ «push branch main របស់ខ្ញុំទៅ origin»។ -u ធ្វើឲ្យ main នៅលើកុំព្យូទ័ររបស់អ្នកចងចាំថាវាជាគូនឹង origin/main ដូច្នេះចាប់ពីពេលនេះតទៅ អ្នកគ្រាន់តែវាយ៖

git push

Refresh ទំព័រ repository នៅលើ GitHub។ File របស់អ្នកនៅទីនោះហើយ។ ចុច link commits (ដែលមានរូបនាឡិកា)៖ history ទាំងមូល របស់អ្នកក៏នៅទីនោះដែរ ជាមួយ message, author និង hash ដូចគ្នានឹង git log --oneline នៅលើកុំព្យូទ័ររបស់អ្នក។ Git មិនបាន upload តែ file ប៉ុណ្ណោះទេ — វាបានចម្លង repository ទាំងមូល។

7. បន្ថែម README

នៅពេលនរណាម្នាក់បើក repository របស់អ្នក GitHub បង្ហាញ file មួយឈ្មោះ README.md នៅខាងក្រោមបញ្ជី file ប្រសិនបើវាមាន។ វាជាទំព័រមុខនៃ project របស់អ្នក។ .md មានន័យថា Markdown ដែលជាវិធីសាមញ្ញមួយក្នុងការធ្វើទម្រង់អត្ថបទ៖ # សម្រាប់ចំណងជើង - សម្រាប់បញ្ជី និង **bold** សម្រាប់អក្សរដិត។

បង្កើត README.md នៅក្នុង my-site៖

# my-site

My personal website, built while learning Git and GitHub.

## Pages

- `index.html` — home
- `about.html` — about me
- `contact.html` — how to reach me

បន្ទាប់មកធ្វើជំហានធម្មតា បូកនឹងការ push មួយ៖

git add README.md
git commit -m "Add README"
git push

Refresh GitHub ហើយ README របស់អ្នកនឹងលេចឡើងនៅលើទំព័រមុខនៃ repository។ គ្រប់ project ដែលធ្វើយ៉ាងយកចិត្តទុកដាក់សុទ្ធតែមានវា — វាជារបស់ដំបូងគេដែលមនុស្សអាន។

8. ទាញយកវា៖ git clone

ការ push គឺ upload repository មួយ ឯការ clone គឺទាញយកវាមកវិញ។ សាកល្បងវាឥឡូវនេះ ហាក់ដូចជាអ្នកនៅលើកុំព្យូទ័រផ្សេងមួយ។ ចូលទៅ home folder របស់អ្នក ហើយ clone repository របស់អ្នកចូលទៅក្នុង folder ថ្មីមួយឈ្មោះ my-site-laptop៖

cd ~
git clone https://github.com/dara-sok/my-site.git my-site-laptop
cd my-site-laptop
git log --oneline

អ្វីៗទាំងអស់នៅទីនោះ៖ គ្រប់ file គ្រប់ commit គ្រប់ message។ ការ clone ក៏រៀបចំ origin ដោយស្វ័យប្រវត្តិដែរ ដូច្នេះ git push និង git pull ដំណើរការភ្លាមៗ។

អ្នកនឹងប្រើការ clone សម្រាប់៖

  • យក project ផ្ទាល់ខ្លួនរបស់អ្នកទៅដាក់លើកុំព្យូទ័រថ្មី
  • ទាញយក project របស់អ្នកដទៃមករត់ ឬសិក្សា — ដូចជា source code សម្រាប់មេរៀន Docker ឬ NestJS នៅលើគេហទំព័រនេះ
  • ចូលរួម project ក្រុមនៅកន្លែងធ្វើការ ជាធម្មតាវាជា command ដំបូងរបស់អ្នកនៅថ្ងៃដំបូង

រក្សាទុក my-site-laptop — នៅក្នុងជំពូកបន្ទាប់ អ្នកនឹងប្រើវាដើម្បីធ្វើជាកុំព្យូទ័រទីពីរ។

Shortcut៖ នៅពេលអ្នកស្ទាត់ហើយ GitHub CLI អាចបង្កើត repository នៅលើ GitHub បន្ថែម remote ហើយ push ក្នុង command តែមួយ ពីខាងក្នុង project ដែលមានស្រាប់៖ gh repo create my-site --public --source=. --remote=origin --push

9. Public, Private និង Secret

  • Repository Public អាចមើលឃើញដោយអ្នកណាម្នាក់នៅលើអ៊ីនធឺណិត។ ល្អសម្រាប់ portfolio, project open-source និងការរៀនជាសាធារណៈ។
  • Repository Private មើលឃើញតែអ្នក និងមនុស្សដែលអ្នកអញ្ជើញប៉ុណ្ណោះ។ ប្រើវាសម្រាប់ការងាររបស់អតិថិជន ឬអ្វីក៏ដោយដែលអ្នកមិនទាន់ត្រៀមខ្លួនចែករំលែក។ អ្នកអាចប្តូរ visibility នៅពេលក្រោយបាននៅក្រោម Settings។

មិនថាមួយណាក៏ដោយ កុំ push password, API key ឬ file .env ជាដាច់ខាត។ Bot ស្វ័យប្រវត្តិស្កេន repository public នៅលើ GitHub រកមើល key ដែលលេចធ្លាយពេញមួយថ្ងៃមួយយប់ ហើយ cloud key ដែលលេចធ្លាយអាចត្រូវគេរំលោភបំពានក្នុងរយៈពេលតែប៉ុន្មាននាទី។ GitHub អាចនឹងរារាំងការ push ដែលមានអ្វីមួយមើលទៅដូចជា key ដែលគេស្គាល់ — ប៉ុន្តែកុំពឹងលើវា។ រក្សាទុក secret នៅក្នុង file ដែលស្ថិតក្នុង .gitignore ហើយប្រសិនបើមានមួយត្រូវបាន push ទៅដោយចៃដន្យ ត្រូវដកហូត ឬប្តូរវាភ្លាមៗ ព្រោះការលុបវានៅក្នុង commit ថ្មីមិនបានលុបវាចេញពី history ទេ។

10. សាកល្បងដោយខ្លួនឯង

  1. បង្កើតគណនី GitHub របស់អ្នក ហើយបើក two-factor authentication។
  2. ដំឡើង gh ហើយរត់ gh auth login។ បន្ទាប់មករត់ gh auth status។
  3. បង្កើត repository my-site ទទេមួយ នៅលើ GitHub បន្ថែមវាជា origin ហើយ git push -u origin main។
  4. រុករក repository របស់អ្នកនៅលើ GitHub។ បើកបញ្ជី commit ហើយប្រៀបធៀបវាជាមួយ git log --oneline។ ចុចលើ commit មួយដើម្បីមើល diff របស់វា។ បើក index.html ហើយចុច Blame។
  5. បន្ថែម README push វា ហើយមើលវានៅលើទំព័រមុខ។
  6. Clone វា ចូល ~/my-site-laptop ហើយពិនិត្យថា history ពេញលេញ។

ឥឡូវនេះ project របស់អ្នករស់នៅពីរកន្លែង។ បន្ទាប់ តោះធ្វើឲ្យពួកវាស្របគ្នាជានិច្ច។

មុនMerge Conflictបន្ទាប់ធ្វើការជាមួយ Remote

ទិញកាហ្វេជូនខ្ញុំ

ចូលចិត្តមេរៀននេះមែនទេ? សូមពិចារណាទិញកាហ្វេជូនខ្ញុំមួយកែវ ដើម្បីគាំទ្រការបង្កើតមាតិកាឥតគិតថ្លៃបន្ថែមទៀត!