ภาพรวม

ใช้เทมเพลตแอป GitLab Self-Managed เพื่อสร้างแอปฉบับร่างเฉพาะเวิร์กสเปซสำหรับอินสแตนซ์ GitLab Self-Managed หรือ GitLab Dedicated ระบุชื่อโฮสต์ GitLab และข้อมูลรับรองของแอปพลิเคชัน OAuth ตรวจสอบแอปฉบับร่าง แล้วเผยแพร่ให้สมาชิกเวิร์กสเปซที่มีสิทธิ์ใช้งาน หลังจากเผยแพร่แล้ว การดำเนินการที่เปิดใช้งานของแอปจะพร้อมใช้งานในบทสนทนาของ ChatGPT และเซสชันของ Codex

ดูภาพรวมการทำงานของ GitLab ที่รองรับ ความพร้อมใช้งาน สิทธิ์ การใช้ข้อมูล และข้อกำหนดด้านเครือข่ายได้ที่: การเชื่อมต่อ GitLab กับ ChatGPT และ Codex

สิ่งที่คุณกำลังตั้งค่า

คุณกำลังสร้างแอปเฉพาะเวิร์กสเปซจากเทมเพลตแอป GitLab Self-Managed แอปใช้สิ่งต่อไปนี้:

• แอปพลิเคชัน GitLab OAuth ที่ลงทะเบียนบนโฮสต์ GitLab Self-Managed หรือ GitLab Dedicated ของคุณ

• ID แอปพลิเคชันและข้อมูลลับของ GitLab OAuth สำหรับการให้สิทธิ์โดยผู้ใช้

• ขอบเขตสิทธิ์ OAuth ที่จำเป็น: api, write_repository และ openid

• ชื่อโฮสต์ GitLab ของคุณ เช่น gitlab.example.com เพื่อกำหนดเอนด์พอยต์สำหรับเว็บ, API, การให้สิทธิ์ และโทเค็น

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

สิ่งที่คุณต้องมี:

• สิทธิ์ผู้ดูแลระบบหรือเจ้าของเวิร์กสเปซ ChatGPT

• สิทธิ์ใน GitLab สำหรับสร้างแอปพลิเคชัน OAuth: สิทธิ์เจ้าของกลุ่มสำหรับแอปที่กลุ่มเป็นเจ้าของ หรือสิทธิ์ผู้ดูแลระบบอินสแตนซ์สำหรับแอปที่ใช้ทั่วทั้งอินสแตนซ์

• เฉพาะชื่อโฮสต์ GitLab โดยไม่ใส่ https://, พอร์ต หรือพาธ ใช้โฮสต์ GitLab Self-Managed หรือ GitLab Dedicated ไม่ใช่ gitlab.com

• ข้อสรุปว่า ChatGPT และ Codex ควรรองรับการดำเนินการใดใน GitLab เช่น การค้นหา Repository, เวิร์กโฟลว์คำขอผสานโค้ด, เวิร์กโฟลว์การจัดการปัญหา, การแก้ไขไฟล์ หรือเวิร์กโฟลว์ Codex ที่ครอบคลุมมากขึ้น

เปิด ChatGPT และ GitLab ไว้คนละแท็บ คัดลอก URI สำหรับเปลี่ยนเส้นทาง ตามที่แสดงใน ChatGPT ทุกประการ อย่าสร้างหรือแก้ไข URI เอง

หากต้องการเปิดหน้า แอป จากคอนโซลผู้ดูแลระบบ ให้เลือกเวิร์กสเปซ ChatGPT ที่ต้องการ เปิด ปลั๊กอิน แล้วเลือก จัดการแอปรุ่นเดิม

ค่าที่ต้องเตรียม

• ชื่อโฮสต์ GitLab: เช่น gitlab.example.com

• URI สำหรับเปลี่ยนเส้นทาง: คัดลอกค่านี้จากขั้นตอนการตั้งค่าเทมเพลตใน ChatGPT

• ID แอปพลิเคชันของ GitLab OAuth

• ข้อมูลลับของ GitLab OAuth

• ขอบเขตสิทธิ์ OAuth: คัดลอกค่าเหล่านี้จากขั้นตอนการตั้งค่าเทมเพลตใน ChatGPT

Start the template setup in ChatGPT

1. In ChatGPT, switch to the workspace where the app should be available.

2. Go to Workspace settings > Apps.

3. In Directory, find GitLab, open its GitLab Self-Managed app template, and select Enable.

4. Enter a clear app name and description.

5. Enter the GitLab hostname, such as gitlab.example.com.

6. Copy the Redirect URI shown in ChatGPT, and keep this tab open.

Example: https://chatgpt.com/connector/oauth/<redirect_id>. Do not remove the redirect ID, add a trailing slash, or replace the URI with a generic ChatGPT URL.

สร้างแอปพลิเคชัน GitLab OAuth ใน GitLab

เลือกตำแหน่งที่จะสร้างแอปพลิเคชัน

1. เปิดโฮสต์ GitLab ของคุณ เช่น https://gitlab.example.com

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

3. สำหรับแอปพลิเคชันที่ใช้ทั่วทั้งอินสแตนซ์ ให้ไปที่ ผู้ดูแลระบบ > แอปพลิเคชัน สำหรับแอปพลิเคชันที่กลุ่มเป็นเจ้าของ ให้ไปที่ การตั้งค่า > แอปพลิเคชัน ของกลุ่ม

เพิ่มรายละเอียดแอปพลิเคชัน

1. เลือก แอปพลิเคชันใหม่ หรือ เพิ่มแอปพลิเคชันใหม่

2. ป้อนชื่อแอปที่สื่อความหมายชัดเจน เช่น GitLab Self-Managed หรือ GitLab Dedicated

3. ในช่อง URI สำหรับเปลี่ยนเส้นทาง ให้วาง URI ที่คัดลอกจาก ChatGPT โดยไม่เปลี่ยนแปลง

4. เปิดใช้ตัวเลือก เป็นความลับ ไว้สำหรับแอปพลิเคชัน OAuth ฝั่งเซิร์ฟเวอร์นี้

กำหนดค่าการเข้าถึงและบันทึก

1. สำหรับแอปพลิเคชันที่ใช้ทั่วทั้งอินสแตนซ์ GitLab แนะนำให้เลือก เชื่อถือได้ การตั้งค่านี้จะข้ามขั้นตอนการขออนุญาตจากผู้ใช้

2. เลือกขอบเขตสิทธิ์ api, write_repository และ openid

3. ตรวจสอบว่าใครสามารถจัดการแอปพลิเคชันได้ และยืนยันว่าผู้ใช้ GitLab ที่ให้สิทธิ์แอปมีสิทธิ์ในกลุ่มและโปรเจกต์อย่างเหมาะสม

4. บันทึกแอปพลิเคชัน

ข้อกำหนดขอบเขตสิทธิ์ OAuth

เทมเพลตจะขอขอบเขตสิทธิ์ OAuth ต่อไปนี้สำหรับการดำเนินการ GitLab ที่เปิดใช้งานใน ChatGPT และ Codex:

• api: จำเป็นสำหรับการดำเนินการผ่าน GitLab API ที่แอปรองรับ รวมถึงการดำเนินการเกี่ยวกับคำขอผสานโค้ด ปัญหา และ CI/CD

• write_repository: จำเป็นสำหรับการเขียนข้อมูลลง Repository ผ่าน Git

• openid: จำเป็นสำหรับข้อมูลประจำตัวและข้อมูลสมาชิกผ่าน OpenID Connect

คัดลอกข้อมูลรับรอง GitLab OAuth

ในแอปพลิเคชัน GitLab ที่บันทึกไว้ ให้คัดลอก ID แอปพลิเคชัน และ ข้อมูลลับ เก็บรักษาข้อมูลลับอย่างปลอดภัยเช่นเดียวกับข้อมูลรับรอง หากข้อมูลลับรั่วไหล ให้สร้างค่าใหม่ใน GitLab และสร้างแอปเวิร์กสเปซใหม่

ตั้งค่าใน ChatGPT ให้เสร็จสมบูรณ์

1. กลับไปที่แท็บการตั้งค่าเทมเพลตใน ChatGPT

2. วางID แอปพลิเคชันของ GitLab ลงในช่อง ID ไคลเอนต์ OAuth

3. วางข้อมูลลับของ GitLab ลงในช่อง ข้อมูลลับไคลเอนต์ OAuth

4. ตรวจสอบว่าช่องชื่อโฮสต์ GitLab มีเฉพาะชื่อโฮสต์ เช่น gitlab.example.com

5. เลือก สร้างฉบับร่าง

6. เปิดรายละเอียดแอปฉบับร่าง แล้วตรวจสอบส่วนการเข้าถึงตามบทบาทและกำหนดค่าการดำเนินการ

เผยแพร่และจัดการแอปสำหรับ ChatGPT และ Codex

การสร้างแอปฉบับร่างไม่ได้ทำให้สมาชิกใช้งานแอปได้โดยอัตโนมัติ หลังจากตรวจสอบฉบับร่างแล้ว:

1. เลือก เผยแพร่ สำหรับแอปฉบับร่าง

2. ไปที่คอนโซลผู้ดูแลระบบ เลือกเวิร์กสเปซ ChatGPT ที่ต้องการ แล้วเปิด ปลั๊กอิน จากนั้นตรวจสอบว่าบทบาทที่ต้องการสามารถใช้งาน GitLab ได้

3. ตรวจสอบการเข้าถึงตามบทบาทสำหรับบทบาทที่ควรใช้งานแอปได้

4. ในส่วน กำหนดค่าการดำเนินการ ให้ตรวจสอบการดำเนินการอ่านและเขียนที่พร้อมใช้งาน

5. ในส่วน กำหนดค่าการอนุมัติ ให้เลือกว่าผู้ใช้ต้องอนุมัติการดำเนินการเมื่อใด ก่อนที่ ChatGPT หรือ Codex จะใช้แอป

6. ขอให้ผู้ใช้ทดสอบที่มีสิทธิ์เข้าถึงเปิด GitLab จากไดเรกทอรีปลั๊กอิน หรือ การตั้งค่า > ปลั๊กอิน ตรวจสอบว่าผู้ใช้สามารถติดตั้งปลั๊กอินและเชื่อมต่อกับแอปที่สร้างจากเทมเพลต GitLab Self-Managed ได้

การตั้งค่าการอนุมัติแอปเหล่านี้มีผลกับบทสนทนาของ ChatGPT และเธรดของ Codex

ตั้งค่ากิจกรรม GitLab สำหรับการรีวิวโค้ดด้วย Codex

หลังจากเผยแพร่แอปแล้ว ให้กำหนดค่ากิจกรรม GitLab ใน Codex หากคุณวางแผนจะใช้ Codex รีวิวโค้ด การตั้งค่ากิจกรรมนี้จะกำหนดค่าเหตุการณ์เว็บฮุกที่จำเป็น

1. เปิดการตั้งค่าตัวเชื่อมต่อ Codex

2. กำหนดค่าบัญชีบริการของเวิร์กสเปซ ให้ Codex สร้างบัญชี หรือระบุโทเค็นการเข้าถึงส่วนบุคคลของบัญชีบริการที่มีอยู่

3. เปิดใช้งาน กิจกรรม GitLab สำหรับโปรเจกต์หรือกลุ่มระดับบนกลุ่มใดกลุ่มหนึ่งของโปรเจกต์

4. หาก Codex จำเป็นต้องทำงานเขียนโค้ดหรือใช้การตั้งค่าเฉพาะโปรเจกต์ ให้สร้างสภาพแวดล้อมของโปรเจกต์

แอป GitLab ใช้ OAuth ของผู้ใช้สำหรับการอ่านข้อมูลและการดำเนินการที่เปิดใช้งานใน ChatGPT และ Codex สำหรับการเขียนข้อมูลรีวิวโดย Codex บน GitLab Self-Managed หรือ GitLab Dedicated โทเค็นของบัญชีบริการที่เวิร์กสเปซจัดการจะเป็นตัวกำหนดตัวตนที่ Codex ใช้ รวมถึงโปรเจกต์ที่ Codex สามารถแสดงความคิดเห็นหรือแสดงความรู้สึกได้

อ่านเพิ่มเติม: รีวิวคำขอผสานโค้ดใน GitLab ด้วย Codex

เชื่อมต่อและทดสอบแอป GitLab

1. ใช้บัญชีผู้ใช้ที่มีสิทธิ์เข้าถึงเพื่อเปิด GitLab จากไดเรกทอรีปลั๊กอิน หรือ การตั้งค่า > ปลั๊กอิน เลือก ติดตั้งปลั๊กอิน แล้วเลือก เชื่อมต่อ

2. หากเวิร์กสเปซของคุณมีแอป GitLab มากกว่าหนึ่งแอป ให้เลือกแอปสำหรับโฮสต์ GitLab Self-Managed หรือ GitLab Dedicated นี้

3. ให้สิทธิ์แอปพลิเคชัน GitLab OAuth เมื่อมีข้อความขออนุญาต

4. เริ่มจากลองอ่านข้อมูลเล็กน้อยใน ChatGPT หรือ Codex เช่น แสดงรายการโปรเจกต์ที่เข้าถึงได้ หรือดึงคำขอผสานโค้ดที่ทราบอยู่แล้ว

5. หากเปิดใช้งานการดำเนินการเขียน ให้ทดสอบในโปรเจกต์ที่มีความเสี่ยงต่ำและในแต่ละผลิตภัณฑ์ที่คุณวางแผนจะใช้งาน ก่อนเปิดใช้ในวงกว้าง

ชื่อโฮสต์และการทำงานของ OAuth

แอปใช้ชื่อโฮสต์เพื่อกำหนดเอนด์พอยต์ของ GitLab ป้อนเฉพาะชื่อโฮสต์ เช่น gitlab.example.com อย่าใส่ https://, พาธของ API หรือ Repository, พอร์ต หรือ gitlab.com เทมเพลตนี้ใช้สำหรับ GitLab Self-Managed หรือ GitLab Dedicated สำหรับ GitLab.com (SaaS) ให้ใช้แอป GitLab

การแก้ไขปัญหาการตั้งค่าแอป GitLab Self-Managed

• URI สำหรับเปลี่ยนเส้นทางไม่ตรงกัน: ตรวจสอบว่า URI สำหรับเปลี่ยนเส้นทางของแอปพลิเคชัน GitLab OAuth ตรงกับ URI สำหรับเปลี่ยนเส้นทางที่แสดงใน ChatGPT ทุกประการ

• ChatGPT ไม่สามารถสร้างหรือบันทึกแอปฉบับร่างได้: ตรวจสอบว่าได้ระบุชื่อโฮสต์, ID แอปพลิเคชัน, ข้อมูลลับ และ URI สำหรับเปลี่ยนเส้นทางครบแล้ว

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

• API ส่งคืนรหัส 403 หรือแจ้งว่าสิทธิ์ไม่เพียงพอ: ตรวจสอบว่าบัญชี GitLab ที่เชื่อมต่อมีสิทธิ์ในโปรเจกต์หรือกลุ่มตามที่จำเป็น และแอปพลิเคชัน OAuth มีขอบเขตสิทธิ์ที่เทมเพลตกำหนด

• ไม่สามารถเข้าถึงโปรเจกต์ใดได้: ตรวจสอบว่าผู้ใช้มีสิทธิ์เข้าถึงโปรเจกต์ เชื่อมต่อกับอินสแตนซ์ GitLab ที่ต้องการ และเลือกแอป GitLab ที่ถูกต้องใน ChatGPT หรือ Codex แล้ว

เอกสาร GitLab ที่เกี่ยวข้อง

• เอกสาร GitLab: กำหนดค่า GitLab เป็นผู้ให้บริการข้อมูลประจำตัว OAuth 2.0

• เอกสาร GitLab: ขอบเขตสิทธิ์ของโทเค็นการเข้าถึง

• เอกสาร GitLab: API ของผู้ให้บริการข้อมูลประจำตัว OAuth 2.0

• เอกสาร GitLab: โทเค็นการเข้าถึงส่วนบุคคล

• เอกสาร GitLab: บทบาทและสิทธิ์

• เอกสาร GitLab: เว็บฮุก