ด้วยการเชื่อมต่อ GitLab คุณเห็น merge request ไปป์ไลน์ สภาพแวดล้อม และคอมมิตได้ที่งานใน FeatValue โดยตรง ลูกค้าของคุณรู้ด้วยภาษาง่าย ๆ ว่างานที่ขอไว้กำลังดำเนินการ อยู่บน staging รอทดสอบ หรือใช้งานจริงแล้ว
การเชื่อมต่อ GitLab มีไว้ทำอะไร
บริษัทซอฟต์แวร์และเว็บเอเจนซีมักถูกถามคำถามเดิมซ้ำ ๆ ว่า “ออนไลน์หรือยัง?” ด้วยการเชื่อมต่อนี้ FeatValue ตอบคำถามนั้นในงาน:
- แบรนช์ คอมมิต และ merge request ที่มีรหัสงานจะแสดงในงานที่ตรงกัน
- ไปป์ไลน์และการเผยแพร่บอกว่าการเปลี่ยนแปลงผ่านการทดสอบแล้วหรือยัง และไปถึงสภาพแวดล้อมใดแล้ว
- FeatValue บันทึกขั้นตอนสำคัญเป็นความคิดเห็นในประวัติของงาน
- คุณกำหนดได้ในแต่ละโครงการว่าลูกค้าจะเห็นข้อมูลส่วนใด
- คุณเริ่มจ็อบแบบ manual เช่น การเผยแพร่ ได้จาก FeatValue โดยตรง
ดูภาพรวมได้ที่หน้า การเชื่อมต่อ GitLab
ข้อกำหนด
- บัญชี FeatValue ของบริษัทคุณที่มีลูกค้าและโครงการอย่างน้อยหนึ่งรายการ (ดู สร้างโครงการ)
- GitLab บน gitlab.com หรือเป็นอินสแตนซ์ของคุณเอง ที่เข้าถึงได้ผ่าน https
- บทบาท Maintainer เป็นอย่างน้อยในโปรเจกต์ GitLab ที่คุณต้องการเชื่อม เพื่อให้ FeatValue สร้างเว็บฮุกได้
เชื่อมต่อ GitLab
-
เปิดแอป
คลิก
แอป ในแถบด้านซ้าย เลือก
GitLab แล้วคลิก
ติดตั้ง (ดู
เชื่อมต่อแอป) หน้า
เชื่อมต่อ GitLab จะปรากฏพร้อมคำถาม
GitLab ของคุณอยู่ที่ไหน?
-
gitlab.com
เลือก gitlab.com แล้วคลิก ต่อไป ลงชื่อเข้าใช้ GitLab และอนุญาตการเข้าถึง วิธีนี้ทำให้ FeatValue เข้าถึงโปรเจกต์ของคุณได้
-
อินสแตนซ์ GitLab ของคุณเอง
เลือก อินสแตนซ์ GitLab ของคุณเอง ป้อนที่อยู่ https ใน ที่อยู่อินสแตนซ์ เช่น https://gitlab.example.com และป้อนโทเค็นใน Personal access token แล้วคลิก ต่อไป
อินสแตนซ์ของตัวเองต้องใช้โทเค็นแบบไหน?
สร้างโทเค็นใน GitLab ที่ Preferences › Access tokens:
- Scope:
api scope แบบอ่านอย่างเดียว เช่น read_api ไม่เพียงพอ เพราะ FeatValue ต้องสร้างเว็บฮุกและเริ่มจ็อบแบบ manual
- Role: ผู้ใช้ของโทเค็นต้องมีบทบาท Maintainer ในโปรเจกต์เป็นอย่างน้อย
- Expiration date: เมื่อโทเค็นหมดอายุ จะไม่มีข้อมูลใหม่เข้ามา ให้สร้างโทเค็นใหม่แล้วเชื่อมต่อ GitLab อีกครั้ง
ควรใช้ผู้ใช้เฉพาะหรือโทเค็นของกลุ่มสำหรับการเชื่อมต่อนี้ จะได้ไม่ผูกกับบัญชีของคนใดคนหนึ่ง
เชื่อมรีโพสิทอรีกับโครงการ
แต่ละรีโพสิทอรีเป็นของโครงการ FeatValue เพียงโครงการเดียว เฉพาะรีโพสิทอรีที่เชื่อมแล้วเท่านั้นที่ส่งข้อมูลมายัง FeatValue
-
เปิดเชื่อมรีโพสิทอรี
-
ค้นหารีโพสิทอรี
รีโพสิทอรีของคุณแสดงอยู่ใต้ รีโพสิทอรีใน GitLab ใช้ ค้นหารีโพสิทอรี เพื่อกรองรายการ
-
เลือกโครงการแล้วเชื่อม
เลือก โปรเจกต์ FeatValue ข้างรีโพสิทอรี แล้วคลิก เชื่อม FeatValue จะสร้างเว็บฮุกใน GitLab และดึงข้อมูลย้อนหลังของไม่กี่วันที่ผ่านมา
การเชื่อมทั้งหมดแสดงอยู่ใต้ รีโพสิทอรีที่เชื่อมแล้ว คอลัมน์ การอัปเดต แสดง ทันทีผ่านเว็บฮุก หรือ ทุก 10 นาที ใช้ เปลี่ยน เพื่อเลือกโครงการอื่น และ เลิกเชื่อม เพื่อยกเลิกการเชื่อม จากนั้น FeatValue จะลบเว็บฮุกออกด้วย
การใช้รหัสงานให้ถูกต้อง
ทุกงานใน FeatValue มีรหัส เช่น abc123-4 คุณดูรหัสได้ในงาน ใส่รหัสนี้ในตำแหน่งใดตำแหน่งหนึ่งต่อไปนี้:
| ตำแหน่ง |
ตัวอย่าง |
| ชื่อแบรนช์ |
abc123-4-contact-form |
| ข้อความคอมมิต |
abc123-4 Make phone number required |
| ชื่อหรือคำอธิบายของ merge request |
Contact form: make phone number required (abc123-4) |
- ตัวพิมพ์ใหญ่หรือเล็กไม่มีผล และใส่
# นำหน้าได้
- หากรหัสอยู่ในชื่อแบรนช์ จะนับเฉพาะคอมมิตที่มีอยู่บนแบรนช์นี้เท่านั้น คอมมิตจากแบรนช์หลักที่ติดมาตอนแตกแบรนช์จะไม่แสดงในงาน
- คอมมิตบนแบรนช์อื่นจะแสดงก็ต่อเมื่อมีรหัสอยู่ในข้อความคอมมิต
- รหัสใช้ได้เฉพาะภายในโครงการที่เชื่อมไว้ FeatValue จะไม่จับคู่รีโพสิทอรีที่เชื่อมกับโครงการอื่นหรือไม่ได้เชื่อมเลย
- ไปป์ไลน์และการเผยแพร่เป็นของงานนั้น หากรันสำหรับแบรนช์ คอมมิต หรือ merge request ของงาน
สิ่งที่แสดงในงาน
งานจะแสดงส่วน การพัฒนา เป็นบรรทัดสั้น ๆ บรรทัดเดียว เช่น MR !12 รวมแล้ว · ไปป์ไลน์สำเร็จ · เผยแพร่บน Staging แล้ว คลิก แสดงรายละเอียด เพื่อขยาย:
- ไปป์ไลน์ พร้อมขั้นตอน จ็อบ และสถานะ
- สภาพแวดล้อม พร้อมลิงก์สำหรับเปิด เช่น Staging และ Production
- Merge request แบรนช์ และ คอมมิต
สิ่งที่แสดงในโครงการ
ในโครงการ ส่วน การพัฒนา แสดงสภาพแวดล้อมพร้อมการเผยแพร่ล่าสุด และไปป์ไลน์ล่าสุดบนแบรนช์หลัก คลิก แสดงไปป์ไลน์ทั้งหมด เพื่อดู ไปป์ไลน์ล่าสุด ที่นี่ยังมี การตั้งค่า ของโครงการด้วย
ลูกค้าเห็นอะไร?
ใน การตั้งค่า ของส่วน การพัฒนา ในโครงการ ให้เลือกที่ ลูกค้าเห็นอะไร?:
| การตั้งค่า |
สิ่งที่ลูกค้าเห็น |
| ไม่แสดง |
ไม่มีข้อมูลจาก GitLab |
| สถานะแบบย่อ |
ประโยคเดียวที่ไม่มีศัพท์เทคนิค: กำลังดำเนินการ เผยแพร่บน Staging แล้ว พร้อมลิงก์ ทดสอบที่นี่ หรือ ใช้งานจริงแล้ว พร้อมลิงก์ ดูตอนนี้ |
| รายละเอียด |
ส่วนที่คุณเลือกไว้ใน รายละเอียดสำหรับลูกค้า: คอมมิต แบรนช์ merge request ไปป์ไลน์ สภาพแวดล้อม และความคิดเห็นประวัติ |
คนในบริษัทของคุณที่แก้ไขโครงการได้สามารถเปลี่ยนการตั้งค่านี้ได้ ส่วนวิธีที่ลูกค้าทดสอบและรับงานอธิบายไว้ใน รีวิวและการยอมรับ
ตั้งค่าความคิดเห็นประวัติ
FeatValue บันทึกขั้นตอนสำคัญเป็นความคิดเห็นในประวัติของงาน ที่ ความคิดเห็นประวัติในงาน คุณเลือกได้ในแต่ละโครงการว่าเหตุการณ์ใดจะสร้างความคิดเห็น:
- Merge request ถูกรวมแล้ว
- ไปป์ไลน์สำเร็จ
- ไปป์ไลน์ล้มเหลว (พร้อมงานที่ล้มเหลว)
- ปรับใช้ไปยังสภาพแวดล้อมแล้ว
เหตุการณ์ที่ไม่ได้เลือกยังคงอัปเดตสถานะในงาน แต่จะไม่สร้างความคิดเห็น ลูกค้าจะเห็นความคิดเห็นหรือไม่ขึ้นอยู่กับการตั้งค่าที่ ลูกค้าเห็นอะไร?
เริ่มจ็อบจาก FeatValue
Starter
คุณเริ่มจ็อบแบบ manual ในไปป์ไลน์ เช่น deploy-production ได้ใน FeatValue โดยตรง ฟีเจอร์นี้ใช้ได้ตั้งแต่แพ็กเกจ Starter (ดู แผนราคา)
-
อนุญาตจ็อบ
ในโครงการ เปิด การตั้งค่า ของส่วน การพัฒนา ที่ เริ่มงานจาก FeatValue คุณจะเห็นจ็อบแบบ manual ที่ GitLab รายงานมาแล้ว ติ๊กจ็อบที่ต้องการให้แสดงใน FeatValue แล้วคลิก บันทึก
-
สำหรับลูกค้าด้วย
หากต้องการให้ลูกค้าเริ่มจ็อบที่เลือกได้ ให้ติ๊ก ลูกค้าก็เริ่มงานที่เลือกได้
-
เริ่มจ็อบ
เมื่อจ็อบที่อนุญาตไว้รอการเริ่มด้วยตนเอง จ็อบนั้นจะแสดงพร้อมปุ่ม เริ่ม หลังคลิก FeatValue จะแสดง เริ่มแล้ว และคุณติดตามความคืบหน้าต่อได้ที่ไปป์ไลน์
หากแสดง ยังไม่มีงานแบบด้วยตนเอง แปลว่ายังไม่มีไปป์ไลน์ที่มีจ็อบแบบ manual ทำงาน ทันทีที่ GitLab รายงานจ็อบเข้ามา คุณก็อนุญาตได้
ความปลอดภัย
- เฉพาะรีโพสิทอรีที่เชื่อมแล้ว: FeatValue อ่านเฉพาะรีโพสิทอรีที่คุณเชื่อมกับโครงการ และจับคู่รหัสงานเฉพาะภายในโครงการนั้น
- ไม่เก็บโค้ด: FeatValue ไม่เก็บไฟล์จากรีโพสิทอรีของคุณ เก็บเฉพาะข้อมูลเกี่ยวกับแบรนช์ คอมมิต merge request ไปป์ไลน์ และสภาพแวดล้อม
- เว็บฮุกที่ตรวจสอบแล้ว: แต่ละเว็บฮุกได้รับโทเค็นลับของตัวเอง FeatValue รับเฉพาะคำขอที่ส่งโทเค็นนี้มา
- สิทธิ์ของคุณใน GitLab: FeatValue ทำงานด้วยสิทธิ์ของการลงชื่อเข้าใช้หรือของโทเค็น และเริ่มได้เฉพาะจ็อบที่คุณอนุญาตไว้
- เลิกเชื่อมได้ทุกเมื่อ: เลิกเชื่อม ยกเลิกการเชื่อม และ FeatValue จะลบเว็บฮุก
การแก้ไขปัญหา
รีโพสิทอรีของฉันไม่อยู่ในรายการ
FeatValue แสดงเฉพาะรีโพสิทอรีที่คุณมีบทบาท Maintainer เป็นอย่างน้อย ตรวจสอบบทบาทของคุณใน GitLab หรือค้นหาชื่อด้วย ค้นหารีโพสิทอรี
สร้างเว็บฮุกไม่ได้
การเชื่อมจะแสดง ทุก 10 นาที แทน ทันทีผ่านเว็บฮุก ในกรณีนี้ FeatValue จะตรวจสอบ GitLab ทุก 10 นาที ข้อมูลจึงไม่หาย เพียงแต่มาช้าลง สาเหตุที่พบบ่อย: คุณไม่มีบทบาท Maintainer หรืออินสแตนซ์ GitLab ของคุณไม่ได้รับอนุญาตให้ส่งคำขอออกไปยังอินเทอร์เน็ต ตรวจสอบเรื่องนี้ แล้วคลิก เปลี่ยน และ เชื่อม อีกครั้ง
ไม่มีอะไรแสดงในงาน
- รีโพสิทอรีเชื่อมกับโครงการที่งานนี้อยู่หรือไม่?
- รหัสงานแบบเต็มอยู่ในชื่อแบรนช์ ข้อความคอมมิต หรือ merge request หรือไม่?
- หากไม่มีเว็บฮุก ข้อมูลใหม่อาจใช้เวลาถึง 10 นาทีจึงจะเข้ามา
GitLab ไม่ยอมรับโทเค็น
ตรวจสอบที่อยู่อินสแตนซ์ โทเค็น และ scope api โทเค็นต้องยังไม่หมดอายุ
เริ่มจ็อบไม่ได้
การเริ่มจ็อบใช้ได้ตั้งแต่แพ็กเกจ Starter นอกจากนี้จ็อบต้องได้รับอนุญาตในการตั้งค่าโครงการ และต้องกำลังรอการเริ่มด้วยตนเองอยู่ หากแสดง เริ่มไม่สำเร็จ ให้ตรวจสอบใน GitLab ว่าการลงชื่อเข้าใช้ยังมีสิทธิ์เริ่มจ็อบนั้นอยู่หรือไม่