เชื่อมต่อ GitHub

คู่มือนี้อธิบายขั้นตอนการตั้งค่าทั้งหมด: การเชื่อมต่อบัญชี GitHub ของคุณกับ Atoms, การสร้าง repository, การยืนยันว่าการเชื่อมต่อทำงานอยู่, และการทำให้เวอร์ชันของโปรเจกต์ใน Atoms และ GitHub ซิงค์กัน

การเชื่อมต่อทำงานอย่างไร

การเชื่อมต่อ GitHub มี 2 ขั้นตอน:

1. เชื่อมต่อบัญชี GitHub ของคุณ การดำเนินการนี้จะให้สิทธิ์ Atoms ในการทำงานกับ GitHub ในนามของคุณ
2. สร้าง repository สำหรับโปรเจกต์ของคุณ repository คือพื้นที่ส่วนตัวใน GitHub ที่ใช้เก็บโค้ดและประวัติการเปลี่ยนแปลงของโปรเจกต์ของคุณ

ขณะนี้ Atoms สร้าง repository ส่วนตัวใหม่ ในบัญชี GitHub ส่วนตัวของผู้ใช้ที่เชื่อมต่ออยู่ คุณไม่สามารถเชื่อมต่อกับ repository ที่มีอยู่แล้ว สร้าง repository ภายใต้องค์กร หรือทำให้เป็นสาธารณะผ่านตัวเชื่อมต่อนี้ได้

ก่อนเริ่มต้น

ก่อนเชื่อมต่อโปรเจกต์ของคุณกับ GitHub โปรดตรวจสอบให้แน่ใจว่า:

• แพ็กเกจ Atoms ของคุณมี การเชื่อมต่อ GitHub. หากคุณใช้แพ็กเกจ Free การเลือก GitHub จะพาคุณไปยังหน้า Plans .
• มีเพียง เจ้าของ workspace เท่านั้นที่สามารถเชื่อมต่อหรือตัดการเชื่อมต่อ GitHub ได้ หากคุณเป็นผู้แก้ไข โปรดขอให้เจ้าของ workspace ดำเนินการขั้นตอนนี้
• คุณมีบัญชี GitHub หรือพร้อมที่จะสร้างบัญชีระหว่างการตั้งค่า
• เบราว์เซอร์ของคุณอนุญาตหน้าต่างป๊อปอัปจาก Atoms
• ไม่มี Agents กำลังทำงานกับโปรเจกต์ของคุณอยู่ในขณะนี้

คุณไม่จำเป็นต้องมี GitHub personal access token เพื่อเชื่อมต่อบัญชีของคุณ ห้ามวาง GitHub token, รหัสผ่าน หรือข้อมูลรับรองอื่นๆ ลงใน Chat โดยเด็ดขาด

เชื่อมต่อบัญชี GitHub ของคุณ

เปิดตัวเชื่อมต่อ GitHub

1. เปิดโปรเจกต์ที่คุณต้องการเชื่อมต่อ
2. คลิกชื่อโปรเจกต์ที่มุมขวาบนของแผงแชท
3. เลือก Connectors ในเมนูแบบเลื่อนลงที่ปรากฏ
4. ค้นหา Github ในรายการตัวเชื่อมต่อที่พร้อมใช้งาน แล้วคลิก เชื่อมต่อ.

คุณยังสามารถเปิด Settings → Connectors → GitHub แล้วเลือก Connect.

เปิด Settings → Connectors แล้วเลือก Connect สำหรับ GitHub

อนุญาต Atoms ใน GitHub

หาก Connected Account แสดงบัญชี GitHub ที่คุณต้องการใช้อยู่แล้ว แปลว่าได้อนุญาตไว้แล้ว คุณสามารถไปต่อที่ สร้าง repository ส่วนตัว.

1. Atoms จะเปิดหน้าต่างการอนุญาตของ GitHub ลงชื่อเข้าใช้บัญชี GitHub ที่คุณต้องการเชื่อมต่อ หรือสร้างบัญชีใหม่หากจำเป็น
2. ตรวจสอบว่าคุณลงชื่อเข้าใช้บัญชี GitHub ที่ถูกต้อง
3. ตรวจสอบสิทธิ์ที่ Atoms ขอ หากคุณยอมรับ ให้เลือก Authorize Atoms-Agents.
4. กลับไปที่ Atoms และรอข้อความ Connect success .
5. ใน Atoms ให้เปิด Connectors และยืนยันว่าบัญชี GitHub ของคุณแสดงเป็นเชื่อมต่อแล้ว

Atoms ขอสิทธิ์ repo, read:user, และ workflow OAuth permissions สิทธิ์เหล่านี้อนุญาตให้ Atoms อ่านและเขียน repository สาธารณะและส่วนตัวที่บัญชีที่เชื่อมต่อสามารถเข้าถึงได้ อ่านข้อมูลโปรไฟล์พื้นฐาน และเพิ่มหรืออัปเดตไฟล์ workflow ของ GitHub Actions .

การอนุญาตนี้มีผลกับบัญชี GitHub ที่เชื่อมต่อ และไม่ได้จำกัดเฉพาะ repository ที่สร้างสำหรับโปรเจกต์ Atoms ปัจจุบัน Atoms ไม่สามารถเข้าถึง repository ที่บัญชีที่เชื่อมต่อเองไม่สามารถเข้าถึงได้ และนโยบายขององค์กรอาจกำหนดข้อจำกัดเพิ่มเติม

ตรวจสอบสิทธิ์ GitHub และเลือก Authorize Atoms-Agents

สร้าง repository ส่วนตัว

หลังจากอนุญาตบัญชี GitHub ของคุณแล้ว ให้สร้าง repository ส่วนตัวที่จะใช้เก็บโค้ดของโปรเจกต์ของคุณ

1. ภายใต้ Connected Account, ตรวจสอบว่าชื่อผู้ใช้ที่แสดงตรงกับบัญชี GitHub ที่คุณต้องการใช้
2. ภายใต้ Create New Repository, ป้อนชื่อสำหรับ repository ชื่อต้อง:
   • มีความยาว 1–100 อักขระ;
   • ใช้ได้เฉพาะตัวอักษร ตัวเลข ขีดกลาง (-), ขีดล่าง (_), หรือจุด (.).
3. เลือก สร้าง.
4. รอข้อความ GitHub repository connected successfully! .

Atoms จะสร้าง repository ส่วนตัว ใหม่ในบัญชี GitHub ส่วนตัวของผู้ใช้ที่เชื่อมต่อ เชื่อมโยงเข้ากับโปรเจกต์ Atoms ปัจจุบัน แล้วพยายามอัปโหลดไฟล์ปัจจุบันของโปรเจกต์ไปยัง GitHub

ป้อนชื่อแล้วสร้าง repository ส่วนตัวใหม่

ตรวจสอบว่าการเชื่อมต่อทำงานแล้ว

ตรวจสอบการเชื่อมต่อทั้งใน Atoms และ GitHub ก่อนใช้งาน repository นี้จริง

1. ใน Atoms ให้ยืนยันว่า Repository Status แสดงเป็น Connected.
2. ภายใต้ Branches, ตรวจสอบว่ามีหนึ่ง branch ที่มีเครื่องหมายถูก นี่คือ branch ที่เชื่อมต่อกับโปรเจกต์ Atoms ของคุณอยู่ในขณะนี้ หากคุณเพิ่งเริ่มใช้ GitHub ให้คงการเลือก branch นี้ไว้
3. เลือก View on GitHub.
4. ใน GitHub ให้ยืนยันว่า repository นี้:
   • เป็นของบัญชี GitHub ที่ถูกต้อง;
   • ถูกทำเครื่องหมายเป็น Private;
   • มีไฟล์โปรเจกต์ตามที่คาดไว้; และ
   • มีอย่างน้อยหนึ่ง commit.

หาก repository ว่างเปล่าและ Push Changes พร้อมใช้งานใน Atoms ให้เลือกแล้วรอให้การดำเนินการเสร็จสิ้น จากนั้นรีเฟรชหน้า repository ใน GitHub และตรวจสอบว่าไฟล์โปรเจกต์ปรากฏแล้ว

ตรวจสอบ repository ที่เชื่อมต่อและ branch ที่เลือกใน Atoms

ยืนยัน repository ส่วนตัวและไฟล์โปรเจกต์ใน GitHub

ทำให้ Atoms และ GitHub ซิงค์กัน

Atoms และ GitHub จะไม่ซิงค์กันโดยอัตโนมัติ เมื่อมีการเปลี่ยนแปลงเกิดขึ้นในฝั่งใดฝั่งหนึ่ง ให้ใช้ตัวควบคุมการซิงโครไนซ์เพื่อย้ายการเปลี่ยนแปลงนั้นไปยังอีกฝั่ง

การดำเนินการ	ใช้เมื่อ	สิ่งที่เกิดขึ้น
Push Changes	คุณได้ทำการเปลี่ยนแปลงใน Atoms และต้องการส่งไปยัง GitHub	Atoms จะส่งไฟล์โปรเจกต์ปัจจุบันไปยัง GitHub branch ที่เลือก
Pull Updates	มีการเปลี่ยนแปลงใน branch ที่เลือกบน GitHub และคุณต้องการนำเข้ามาใน Atoms	Atoms จะอัปเดตโปรเจกต์ด้วยการเปลี่ยนแปลงล่าสุดจาก GitHub

ก่อน push หรือ pull การเปลี่ยนแปลง ให้รอจน Agent ทำงานเสร็จ และตรวจสอบให้แน่ใจว่าคุณกำลังดูเวอร์ชันล่าสุดของโปรเจกต์ใน Chat หากคุณเปิดเวอร์ชันเก่าจาก History, ให้กลับไปที่การ์ดเวอร์ชันล่าสุดด้านล่างของ Chat แล้วเปิด GitHub.

อีกครั้ง หากคุณไม่ได้อยู่ในเวอร์ชันล่าสุด Atoms จะแสดงข้อความ You must be on the latest version to pull updates or push changes.

ก่อนซิงโครไนซ์ ให้ตรวจสอบด้วยว่า branch ที่เลือกคือ branch ที่คุณต้องการอัปเดต

หากทั้ง Atoms และ GitHub มีการเปลี่ยนแปลงที่คุณจำเป็นต้องเก็บไว้ อย่าเพิ่งซิงโครไนซ์ ให้บันทึกสำเนาของงานสำคัญก่อน หรือขอให้ผู้ที่คุ้นเคยกับ GitHub ช่วยเก็บการเปลี่ยนแปลงไว้ใน branch แยกต่างหาก

หาก Repository Status แสดงเป็น Upstream Changes Available, GitHub มีการเปลี่ยนแปลงที่ Atoms ยังไม่มี ตรวจสอบ repository ก่อนเลือกการดำเนินการ

ใช้ Pull Updates และ Push Changes สำหรับ branch ที่เลือก

Push การเปลี่ยนแปลงจาก Atoms ไปยัง GitHub

1. ทำการเปลี่ยนแปลงใน Atoms ให้เสร็จ แล้วรอจน Agent หยุดทำงาน
2. ตรวจสอบให้แน่ใจว่าคุณกำลังดูเวอร์ชันล่าสุดของโปรเจกต์
3. เปิด Settings → Connectors → GitHub และตรวจสอบว่าเลือก branch ที่ถูกต้องอยู่
4. เลือก Push Changes.
5. เปิดหน้านี้ทิ้งไว้ขณะกำลัง push การเปลี่ยนแปลง
6. เมื่อ Changes pushed successfully ปรากฏขึ้น ให้เลือก View on GitHub และตรวจสอบว่าไฟล์โปรเจกต์ล่าสุดอยู่ที่นั่น

Push Changes จะพร้อมใช้งานเฉพาะเมื่อ Atoms มีการเปลี่ยนแปลงที่ยังไม่ได้ส่งไปยัง GitHub เท่านั้น และจะไม่พร้อมใช้งานขณะที่ Agent กำลังทำงาน หรือเมื่อคุณกำลังดูเวอร์ชันเก่าของโปรเจกต์

เมื่อคุณเลือก Push Changes, การเปลี่ยนแปลงจะถูกส่งไปยัง GitHub ทันทีโดยไม่ขอการยืนยัน หากไฟล์เดียวกันถูกเปลี่ยนแปลงทั้งใน Atoms และ GitHub เวอร์ชันใน Atoms จะมีลำดับความสำคัญและจะเขียนทับเวอร์ชันที่จัดเก็บอยู่ใน GitHub ปัจจุบัน

Pull การอัปเดตจาก GitHub เข้าสู่ Atoms

ต่างจากการ push การ pull การเปลี่ยนแปลงต้องมีการยืนยันก่อน หากไฟล์เดียวกันถูกเปลี่ยนแปลงทั้งใน GitHub และ Atoms เวอร์ชันใน GitHub จะมีลำดับความสำคัญและจะเขียนทับเวอร์ชันปัจจุบันใน Atoms

1. เปิด Settings → Connectors → GitHub.
2. ตรวจสอบว่า Repository Status แสดงการเปลี่ยนแปลงใหม่จาก GitHub และเลือก branch ที่ถูกต้องอยู่
3. เลือก Pull Updates.
4. อ่านข้อความเตือน Pull May Affect Project หากคุณต้องการนำการเปลี่ยนแปลงจาก GitHub เข้ามาในโปรเจกต์ Atoms ปัจจุบันของคุณ ให้เลือก Confirm.
5. เปิดหน้านี้ทิ้งไว้ขณะกำลัง pull การเปลี่ยนแปลง
6. เมื่อ Changes pulled successfully ปรากฏขึ้น ให้เปิด App Viewer และทดสอบส่วนต่างๆ ของโปรเจกต์ที่ได้รับผลกระทบจากการเปลี่ยนแปลง เพื่อให้แน่ใจว่าทุกอย่างยังทำงานได้ตามที่คาดไว้

Pull Updates จะพร้อมใช้งานเฉพาะเมื่อ GitHub branch ที่เลือกมีการเปลี่ยนแปลงที่ยังไม่ได้นำเข้ามาใน Atoms

ตัดการเชื่อมต่อ GitHub

ตัดการเชื่อมต่อ GitHub เมื่อคุณไม่ต้องการให้ Atoms เข้าถึงบัญชีที่เชื่อมต่ออีกต่อไป GitHub repository และไฟล์ในนั้นจะยังคงอยู่ใน GitHub แต่ Atoms จะไม่สามารถ push หรือ pull การเปลี่ยนแปลงได้อีก

การอนุญาต GitHub มีผลกับบัญชีที่เชื่อมต่อ การเพิกถอนการเข้าถึงจะตัดการเชื่อมต่อทุกโปรเจกต์ Atoms ที่ใช้บัญชี GitHub นั้น ดังนั้นโปรดตรวจสอบโปรเจกต์อื่นๆ ของคุณก่อนดำเนินการต่อ

1. เปิด Settings → Connectors → GitHub.
2. เลือก ตัดการเชื่อมต่อ.
3. ในการยืนยัน ตัดการเชื่อมต่อ GitHub ให้เลือก ตัดการเชื่อมต่อ อีกครั้ง
4. GitHub ควรเปิดหน้าอนุญาตที่เกี่ยวข้องโดยอัตโนมัติ หากไม่เปิด ใน GitHub ให้ไปที่ Settings → Applications → Authorized OAuth Apps.
5. ค้นหา Atoms, เลือก ... ทางด้านขวาของแถวนั้น แล้วเลือก Revoke. อย่าเลือก Revoke all; เพราะการดำเนินการนั้นจะลบการเข้าถึงของทุกแอป OAuth ที่ได้รับอนุญาตซึ่งแสดงอยู่ในหน้านั้น
6. ทำตามขั้นตอนการยืนยันจาก Github ตามที่จำเป็น
7. กลับไปที่ Atoms แล้วเปิด GitHub connector อีกครั้งเพื่อยืนยันว่าบัญชีไม่ได้เชื่อมต่ออยู่แล้ว

เลือก Disconnect ในตัวเชื่อมต่อ GitHub

เพิกถอนเฉพาะแอปพลิเคชัน OAuth ของ Atoms ใน GitHub