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