เชื่อมต่อบัญชี GitHub ของคุณด้วยโทเค็นเพื่อให้สามารถปรับใช้ไซต์ของคุณจากที่เก็บได้

สิ่งที่การเชื่อมต่อนี้มอบให้คุณ

การเชื่อมต่อ GitHub ด้วยโทเคนช่วยให้เว็บไซต์สามารถปรับใช้ (deploy) ได้จากหนึ่งในที่เก็บโค้ด (repository) ของคุณ: เพียงพุช (push) ไปยังแบรนช์ เว็บไซต์ก็จะอัปเดต นอกจากนี้ยังช่วยให้เราสามารถเผยแพร่ไปยัง GitHub Pages ในบัญชีของคุณได้เมื่อคุณเลือกบริการดังกล่าวเป็นโฮสต์ของเว็บไซต์

หากที่เก็บโค้ดของคุณเป็นขององค์กร โปรดเลือกใช้ แอป Zinn® GitHub แทน — ดู ติดตั้งแอป Zinn® GitHub เนื่องจากโทเคนจะผูกอยู่กับบุคคลเพียงคนเดียวและจะหยุดทำงานเมื่อบุคคลนั้นออกจากองค์กร

ก่อนที่คุณจะเริ่มต้น

บัญชี GitHub ที่มีสิทธิ์เข้าถึงที่เก็บโค้ดที่คุณต้องการปรับใช้ หากเป็นขององค์กร เจ้าขององค์กรอาจต้องอนุมัติโทเคนแบบละเอียด (fine-grained tokens) สำหรับองค์กรนั้น

1. สร้างคีย์ที่ GitHub

บน GitHub ให้คลิกรูปโปรไฟล์ของคุณ จากนั้นไปที่ Settings → Developer settings → Personal access tokens → Fine-grained tokens → Generate new token ตั้งชื่อและเลือกวันหมดอายุ ภายใต้ Repository access ให้เลือก Only select repositories และเลือกเฉพาะที่เก็บโค้ดที่คุณปรับใช้ — ซึ่งเป็นสิทธิ์การเข้าถึงที่แคบที่สุดที่เพียงพอต่อการทำงาน

ภายใต้ Repository permissions ให้กำหนดสิทธิ์ Read and write สำหรับ:

• Contents
• Pages
• Administration

กด Generate token แล้วคัดลอกไว้ — GitHub จะแสดงโทเคนนี้เพียงครั้งเดียวเท่านั้น

2. เชื่อมต่อที่นี่

เปิด Integrations ในแดชบอร์ดของคุณแล้วเลือก Connect an account เลือกกลุ่มเป็น Code hosting และเลือกบัญชีเป็น GitHub จากนั้นกรอก API token แล้วกด Connect account

เราจะทดสอบสิ่งที่คุณวางก่อนที่จะบันทึกข้อมูลใดๆ เสมอ คีย์ที่ใช้งานไม่ได้จะไม่ถูกจัดเก็บ และระบบจะแจ้งให้ทราบว่ามีข้อผิดพลาดใดเกิดขึ้น คีย์ที่ใช้งานได้จะถูกเก็บรักษาแบบเข้ารหัสไว้ในตู้นิรภัยความลับ (secrets vault) ของเรา — จะไม่ถูกเก็บไว้ในฐานข้อมูลของเราเด็ดขาด — และจะไม่แสดงให้เห็นอีก ไม่เว้นแม้กระทั่งกับคุณ

สิ่งที่จะเกิดขึ้นต่อไป

• เว็บไซต์สามารถปรับใช้ได้โดยตรงจากที่เก็บโค้ดในบัญชีนี้: เลือกที่เก็บโค้ดนั้นในการเชื่อมต่อที่เก็บโค้ดของเว็บไซต์ เลือกที่เก็บโค้ดและแบรนช์ จากนั้นเมื่อพุชก็จะทำการปรับใช้ทันที
• แบรนช์อื่นๆ ทุกแบรนช์สามารถมีพรีวิวของตัวเองได้ เพื่อให้คุณสามารถตรวจสอบการเปลี่ยนแปลงก่อนที่จะนำขึ้นสู่เว็บไซต์จริง
• โฮสต์สแตติกที่สร้างจาก Git เช่น Render และ Azure Static Web Apps จะใช้การเชื่อมต่อนี้เป็นแหล่งที่มาของโค้ดสำหรับเว็บไซต์

หากเชื่อมต่อไม่สำเร็จ

ไม่พบที่เก็บโค้ด สิทธิ์การเข้าถึงที่เก็บโค้ดของโทเคนไม่ครอบคลุมที่เก็บโค้ดดังกล่าว ให้แก้ไขโทเคนบน GitHub แล้วเพิ่มที่เก็บโค้ดนั้นเข้าไป

เคยใช้งานได้แล้วหยุดทำงาน โทเคนแบบละเอียดจะหมดอายุตามวันที่คุณเลือก ให้สร้างโทเคนใหม่แล้วนำมาเชื่อมต่อ โดย GitHub จะส่งอีเมลแจ้งเตือนคุณก่อนที่โทเคนจะหมดอายุ

ระบบแจ้งว่าคีย์ถูกปฏิเสธ เกือบทุกกรณีมักเกิดจากหนึ่งในสามสาเหตุนี้: มีการคัดลอกช่องว่างหรือการขึ้นบรรทัดใหม่ติดมาด้วย, คีย์หมดอายุแล้ว, หรือคีย์ถูกเพิกถอนหรือสร้างใหม่หลังจากที่คุณคัดลอก ให้สร้างคีย์ใหม่และวางอีกครั้ง

เชื่อมต่อได้ แต่มีข้อผิดพลาดเกิดขึ้นในภายหลัง คีย์สามารถยืนยันตัวตนได้แต่ขาดสิทธิ์การอนุญาตที่การดำเนินการนั้นต้องการ ให้สร้างคีย์ใหม่ที่มีสิทธิ์ตามรายการข้างต้น จากนั้นยกเลิกการเชื่อมต่อเดิมแล้วเชื่อมต่อด้วยคีย์ใหม่

การยกเลิกการเชื่อมต่อ

เปิด Integrations ค้นหาบัญชีแล้วกด Disconnect การดำเนินการนี้จะลบคีย์ที่จัดเก็บไว้ทันที ทุกสิ่งที่เคยใช้คีย์ดังกล่าวจะหยุดทำงานในการดำเนินการครั้งถัดไป และหน้าจอที่ต้องพึ่งพาคีย์นั้นจะแสดงข้อความแจ้งเตือนแทนที่จะล้มเหลวไปเงียบๆ

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