Workshop: สร้างโปรเจกต์แรกบน GitHub จาก 0 ถึง Push สำเร็จ

Categories

Workshop: สร้างโปรเจกต์แรกบน GitHub จาก 0 ถึง Push สำเร็จ

บทความนี้จะสอนเข้าในขั้นตอนเมื่อก่อนที่สร้าง GitHub Repository ที่สามารถส่ง Push ไปยังคอมพิวเตอร์ของคุณ การเรียนรู้ Git และ GitHub เป็นพื้นฐานที่สำคัญสำหรับนักพัฒนาสมัยใหม่ ไม่ว่าจะเป็นการทำงานในทีม หรือการสร้าง Project ส่วนตัว บทความนี้จะพาคุณผ่านแต่ละขั้นตอนตั้งแต่เริ่มต้นจนถึงการ Push Code ไปยัง GitHub Repository ได้สำเร็จ ซึ่งจะช่วยให้คุณเข้าใจ Git Workflow พื้นฐานได้อย่างชัดเจน

ขั้นตอนที่ 1: สร้างบัญชี GitHub Account

GitHub เป็นแพลตฟอร์มสำหรับจัดเก็บและจัดการ Git Repository ซึ่งเป็นหนึ่งในเครื่องมือที่นักพัฒนาใช้งานกันอย่างแพร่หลาย ก่อนที่จะเริ่มสร้าง Repository คุณต้องสร้างบัญชี GitHub ขึ้นมา

  • ไปที่ https://github.com
  • คลิก Sign up
  • เลือกชื่อผู้ใช้และกรอกข้อมูลของคุณ
  • ยืนยันอีเมลจากข้อความที่ GitHub ส่งมา

ขั้นตอนที่ 2: สร้าง Repository ชื่อใหม่ใน GitHub

Repository (หรือ Repo) คือโฟลเดอร์เสมือนที่เก็บ Code และ Version Control ทั้งหมดของโปรเจกต์คุณ การสร้าง Repository ใช้เวลาเพียงไม่กี่นาที

  • คลิก New repository บนหน้า GitHub Dashboard
  • ตั้งชื่อโคด: my-first-project หรือชื่ออื่นที่คุณต้องการ
  • เลือก Public (เปิดให้ทั่วไปดู) หรือ Private (เฉพาะตัวเอง)
  • ตั้งให้มี README.md โดยเลือก “Add a README file”
  • คลิก Create repository

ขั้นตอนที่ 3: ติดตั้ง Git บนเครื่องของคุณ

ก่อนที่จะเริ่มทำงาน คุณต้องติดตั้ง Git Command Line Tool บนเครื่องของคุณ หากคุณยังไม่ได้ติดตั้ง ให้ไปที่ git-scm.com และดาวน์โหลดตามระบบปฏิบัติการของคุณ (Windows, macOS, หรือ Linux)

ขั้นตอนที่ 4: สร้างโฟลเดอร์ในเดสก์ท็อปของคุณ

เปิด Terminal หรือ Command Prompt และสร้างโฟลเดอร์สำหรับโปรเจกต์ของคุณ

mkdir my-first-project
cd my-first-project

ขั้นตอนที่ 5: เริ่มต้น Git ในโปรเจกต์

คำสั่ง git init จะเริ่มต้นระบบ Git ในโฟลเดอร์ของคุณ และสร้างไฟล์ .git ที่ใช้เก็บข้อมูล Version Control

git init

ขั้นตอนที่ 6: ตั้งค่า Git Config

ก่อนที่จะทำการ Commit ครั้งแรก คุณต้องบอก Git ว่า คุณคือใคร โดยการตั้งค่า User Name และ Email

git config --global user.name "Your Name"
git config --global user.email "[email protected]"

# ตรวจสอบว่าการตั้งค่าทำได้ถูกต้อง
git config --global user.name
git config --global user.email

ขั้นตอนที่ 7: สร้างไฟล์แรก

สร้างไฟล์ README.md ที่เป็นไฟล์เอกสารหลักของโปรเจกต์ ไฟล์นี้จะแสดงคำอธิบายของโปรเจกต์เมื่อมีคนเข้ามาดู Repository บน GitHub

echo "# My First Project" > README.md

ขั้นตอนที่ 8: Stage Files ด้วย git add

คำสั่ง git add ใช้เพื่อเตรียมไฟล์ให้พร้อมสำหรับ Commit ไฟล์ที่ถูก Stage จะเก็บไว้ใน Staging Area เพื่อรอการ Commit

# เพิ่มไฟล์เฉพาะ
git add README.md

# หรือเพิ่มไฟล์ทั้งหมด
git add .

ขั้นตอนที่ 9: สร้าง Commit

Commit คือการบันทึกการเปลี่ยนแปลงของ Code พร้อมกับข้อความที่อธิบายว่าเปลี่ยนแปลงอะไร ข้อความ Commit ควรมีความหมาย เพื่อให้คนอื่นเข้าใจว่าทำอะไร

git commit -m "Initial commit: Add README"

ขั้นตอนที่ 10: ตั้งค่า Remote URL

Remote URL คือ URL ของ Repository บน GitHub ที่คุณต้องการส่ง Code ไปหา โดยปกติแล้ว URL นี้จะชื่อว่า “origin” ซึ่งเป็นชื่อมาตรฐาน

git remote add origin https://github.com/YOUR_USERNAME/my-first-project.git

# ตรวจสอบว่า Remote ถูกตั้งค่าแล้ว
git remote -v

ขั้นตอนที่ 11: ส่ง Code ด้วย git push

นี่คือขั้นตอนสุดท้าย คำสั่ง git push จะส่ง Commits ของคุณไปยัง GitHub Repository ข้าง -u หมายถึง “Set upstream” ซึ่งจะบอก Git ให้จำไว้ว่า Branch นี้ส่งไปที่ไหน

git push -u origin main

หากระบบขอให้ยืนยันตัวตน ให้ใส่ Username และ Password (หรือ Personal Access Token) ของคุณ

ขั้นตอนที่ 12: ตรวจสอบ GitHub

เมื่อ Push สำเร็จแล้ว ให้เข้าไปดูที่ GitHub Repository ของคุณ

  • ไปที่ GitHub และไปที่โปรเจกต์ของคุณ
  • คลิก Refresh ในเบราว์เซอร์
  • ตรวจว่า README.md ปรากฏแล้ว
  • ตรวจ Commit History ในแท็บ Commits

การแก้ไขเพิ่มเติมสำหรับการเริ่มต้น

หากคุณเจอข้อผิดพลาดในการ Push ลองตรวจสอบสิ่งต่อไปนี้

ปัญหา: Authentication Failed

  • ถ้า Clone เป็นครั้งแรก ลองทำการสร้าง SSH Key สำหรับการตรวจสอบตัวตน
  • หรือใช้ Token Authentication: ไปที่ https://github.com/settings/tokens และสร้าง Personal Access Token
  • ใช้ Token เมื่อทำ git push แทนที่ Password

ปัญหา: Branch ชื่อ “main” ไม่มีอยู่

  • ตรวจสอบชื่อ Branch ปัจจุบันด้วย git branch
  • อาจจะชื่อ “master” แทน ให้ใช้ git push -u origin master แทน

เมื่อทำงานบน Cloud VPS หรือ Server ของ ผู้ให้บริการโฮสติ้ง สิ่งเหล่านี้ก็ยังใช้ได้เช่นเดิม เพราะ Git ทำงานได้ทุกที่ที่มี Unix-like System

Tips สำหรับการทำงานต่อเนื่อง

หลังจากที่ Push สำเร็จแล้ว เมื่อต้องการทำการเปลี่ยนแปลงเพิ่มเติม ให้ทำตามขั้นตอนนี้

  • แก้ไขไฟล์ที่ต้องการ
  • ใช้ git add . เพื่อ Stage ไฟล์
  • ใช้ git commit -m "Message" เพื่อบันทึกการเปลี่ยนแปลง
  • ใช้ git push เพื่อส่งไปยัง GitHub (ครั้งถัดไปไม่ต้องใส่ -u)

สรุป

ยินดีด้วย Workshop นี้เสร็จสิ้น คุณสามารถสร้าง GitHub Repository ได้สำเร็จ ทำให้คุณพร้อมสำหรับการทำงานแบบ Collaborative กับนักพัฒนาคนอื่นๆ ขั้นตอนที่เรียนรู้ในบทความนี้เป็นพื้นฐาน Git Workflow ที่ใช้ได้ทั่วไปในการพัฒนา Application บน Local Machine หรือ Cloud VPS ของ ผู้ให้บริการโฮสติ้ง การเข้าใจ Git อย่างลึกซึ้งจะช่วยให้คุณทำงานได้มีประสิทธิภาพมากขึ้น