การเชื่อมต่อนี้ช่วยคุณได้อย่างไร
การติดตั้งแอป Zinn® GitHub ช่วยให้เว็บไซต์สามารถปรับใช้จากที่เก็บโค้ดของคุณได้ และทำให้บอร์ดโปรเจกต์ซิงโครไนซ์กับ GitHub ได้ โดยไม่ต้องมอบ personal token ให้กับเรา เราจะเก็บบันทึกเฉพาะ หมายเลขการติดตั้ง ของแอปเท่านั้น ซึ่งไม่มีประโยชน์อันใดในตัวมันเอง และเราจะสร้างโทเค็นที่มีอายุการใช้งานหนึ่งชั่วโมงขึ้นมาใหม่ทุกครั้งที่เราจำเป็นต้องใช้งาน นี่จึงเป็นตัวเลือกที่ดีกว่าสำหรับองค์กร เนื่องจากโทเค็นนี้ไม่ได้เป็นของบุคคลใดบุคคลหนึ่งโดยเฉพาะ และจะไม่หยุดทำงานเมื่อมีพนักงานลาออก
ก่อนที่คุณจะเริ่มต้น
บัญชี GitHub หรือสิทธิ์เจ้าของบนองค์กรที่คุณต้องการติดตั้งแอป องค์กรที่ไม่อนุญาตให้ใช้แอปพลิเคชันของบุคคลที่สามจำเป็นต้องให้เจ้าของอนุญาต หากไม่สามารถทำได้ ให้ใช้ fine-grained token แทน (เชื่อมต่อบัญชี GitHub ของคุณ)
1. สร้างคีย์ที่ GitHub
ไม่มีคีย์ที่ต้องสร้าง ติดตั้งแอป Zinn® GitHub บนบัญชีส่วนตัวหรือองค์กรของคุณ และเลือกที่เก็บโค้ดทั้งหมดหรือเฉพาะที่เก็บโค้ดที่คุณต้องการให้เราปรับใช้
จากนั้นค้นหาหมายเลขการติดตั้ง:
- บัญชีส่วนตัว — การตั้งค่า (Settings) → แอปพลิเคชัน (Applications) → แอป GitHub ที่ติดตั้งแล้ว (Installed GitHub Apps) และคลิก กำหนดค่า (Configure) ถัดจากแอป Zinn®
- องค์กร — องค์กรของคุณ (Your organizations) → การตั้งค่า (Settings) → แอป GitHub (GitHub Apps) และคลิก กำหนดค่า (Configure) ถัดจากแอป Zinn®
หมายเลขที่อยู่ส่วนท้ายของแถบที่อยู่บนหน้านั้น เช่น github.com/settings/installations/12345678 คือหมายเลขการติดตั้ง
2. เชื่อมต่อที่นี่
แอปจะถูกเลือกในจุดที่จะใช้งาน แทนที่จะเลือกบนหน้าจอการผสานรวม (Integrations):
- ในการเชื่อมต่อที่เก็บโค้ดของเว็บไซต์ ให้เลือก GitHub (การติดตั้งแอป)
- ในลิงก์ GitHub ของบอร์ดโปรเจกต์ ให้เลือก แอป Zinn® GitHub
วาง หมายเลขการติดตั้ง แล้วดำเนินการต่อ เราจะตรวจสอบการติดตั้งก่อนบันทึกข้อมูลใดๆ หมายเลขที่เราไม่สามารถเข้าถึงได้จะไม่ถูกจัดเก็บไว้อย่างเด็ดขาด
สิ่งที่จะเกิดขึ้นต่อไป
- ที่เก็บโค้ดที่คุณให้สิทธิ์แอปจะปรากฏขึ้นเพื่อให้เว็บไซต์สามารถปรับใช้ได้ และการพุชโค้ด (push) จะเป็นการปรับใช้เว็บไซต์
- ทุกการกระทำที่เราดำเนินการจะปรากฏในบันทึกการตรวจสอบ (audit log) ของการติดตั้งบน GitHub ภายใต้ชื่อของแอป ไม่ใช่ชื่อของคุณ
- หากต้องการให้สิทธิ์เข้าถึงที่เก็บโค้ดเพิ่มเติมแก่เรา ให้เปลี่ยนสิทธิ์การเข้าถึงที่เก็บโค้ดของแอปบนหน้า กำหนดค่า (Configure) หน้าเดิม โดยไม่ต้องเชื่อมต่อใหม่
หากเชื่อมต่อไม่สำเร็จ
ไม่พบที่เก็บโค้ดบางแห่ง การติดตั้งครอบคลุมเฉพาะที่เก็บโค้ดที่คุณเลือกไว้เท่านั้น เปิดหน้า กำหนดค่า (Configure) แล้วเพิ่มที่เก็บโค้ดนั้น
หมายเลขถูกปฏิเสธ ตรวจสอบว่าเป็นหมายเลขการติดตั้งจากแถบที่อยู่ ไม่ใช่ ID ของแอปเอง และตรวจสอบว่าแอปยังคงติดตั้งอยู่ แอปที่ถูกถอนการติดตั้งแล้วจะไม่มีหมายเลขการติดตั้ง
ระบบแจ้งว่าคีย์ถูกปฏิเสธ เกือบทุกครั้งมักเกิดจากหนึ่งในสามสาธยายนี้: มีช่องว่างหรือการขึ้นบรรทัดใหม่ติดมาด้วยเมื่อคีย์ถูกคัดลอก, คีย์หมดอายุแล้ว, หรือคีย์ถูกเพิกถอนหรือสร้างใหม่หลังจากที่คุณคัดลอกไปแล้ว สร้างคีย์ใหม่แล้ววางอีกครั้ง
เชื่อมต่อได้ แต่มีบางอย่างล้มเหลวในภายหลัง คีย์ได้รับการตรวจสอบสิทธิ์แล้วแต่ขาดสิทธิ์ที่จำเป็นสำหรับการดำเนินการดังกล่าว สร้างคีย์ใหม่ที่มีสิทธิ์ตามรายการข้างต้น จากนั้นยกเลิกการเชื่อมต่อเดิมแล้วเชื่อมต่อด้วยคีย์ใหม่
การยกเลิกการเชื่อมต่อ
เปิดหน้า การผสานรวม (Integrations) ค้นหาบัญชีแล้วคลิก ยกเลิกการเชื่อมต่อ (Disconnect) การดำเนินการนี้จะลบKีย์ที่จัดเก็บไว้อันตรธานไปทันที สิ่งใดก็ตามที่กำลังใช้งานคีย์ดังกล่าวจะหยุดทำงานในการดำเนินการถัดไป และหน้าจอที่ต้องพึ่งพาคีย์นั้นจะแสดงข้อความแจ้งเตือนแทนที่จะล้มเหลวไปเงียบๆ
การยกเลิกการเชื่อมต่อจะไม่ยกเลิกสิ่งที่เราได้ดำเนินการไปแล้ว บันทึก การปรับใช้ หรือการตั้งค่าที่เราได้เปลี่ยนแปลงบนบัญชีของคุณจะยังคงอยู่ตามเดิม หากคุณคิดว่าคีย์ดังกล่าวอาจรั่วไหล โปรดเพิกถอนคีย์นั้นที่ผู้ให้บริการด้วยเช่นกัน การยกเลิกการเชื่อมต่อจะเป็นการลบสำเนาของเรา ไม่ใช่สำเนาของพวกเขา