OpenAI
Trang này được dịch bằng máy học. Xem bài viết gốc bằng tiếng Anh.

Thiết lập mẫu ứng dụng GitLab Self-Managed cho ChatGPT và Codex

Tìm hiểu cách quản trị viên không gian làm việc dùng ứng dụng OAuth GitLab của tổ chức để định cấu hình mẫu ứng dụng GitLab Self-Managed cho một phiên bản GitLab Self-Managed hoặc GitLab Dedicated.

Đã cập nhật: 4 days ago

GitLab trong ChatGPT và Codex hiện đang ở giai đoạn beta.

Tổng quan

Dùng mẫu ứng dụng GitLab Self-Managed để tạo bản nháp ứng dụng riêng cho không gian làm việc, kết nối với một hệ thống GitLab Self-Managed hoặc GitLab Dedicated. Cung cấp tên máy chủ GitLab và thông tin xác thực của ứng dụng OAuth, kiểm tra bản nháp ứng dụng, rồi phát hành cho các thành viên đủ điều kiện trong không gian làm việc. Sau khi phát hành, các thao tác đã bật của ứng dụng sẽ khả dụng trong cuộc trò chuyện trên ChatGPT và phiên làm việc trên Codex.

Để tìm hiểu tổng quan về các chức năng GitLab được hỗ trợ, phạm vi cung cấp, quyền, cách sử dụng dữ liệu và yêu cầu mạng, hãy xem: Kết nối GitLab với ChatGPT và Codex.

Nội dung bạn sẽ thiết lập

Bạn sẽ tạo ứng dụng riêng cho không gian làm việc từ mẫu ứng dụng GitLab Self-Managed. Ứng dụng sử dụng:

  • Một ứng dụng OAuth GitLab được đăng ký trên máy chủ GitLab Self-Managed hoặc GitLab Dedicated của bạn.

  • ID ứng dụng và Khóa bí mật OAuth GitLab để người dùng cấp quyền.

  • Các phạm vi quyền OAuth bắt buộc: api, write_repository và openid.

  • Tên máy chủ GitLab của bạn, chẳng hạn như gitlab.example.com, để xác định các điểm cuối web, API, cấp quyền và mã thông báo.

Trước khi bắt đầu

Bạn cần:

  • Quyền quản trị viên hoặc chủ sở hữu không gian làm việc ChatGPT.

  • Quyền tạo ứng dụng OAuth trong GitLab: quyền Chủ sở hữu nhóm đối với ứng dụng thuộc sở hữu của nhóm, hoặc quyền quản trị viên hệ thống đối với ứng dụng dùng trên toàn hệ thống.

  • Chỉ tên máy chủ GitLab, không kèm https://, cổng hoặc đường dẫn. Sử dụng máy chủ GitLab Self-Managed hoặc GitLab Dedicated, không phải gitlab.com.

  • Xác định những thao tác GitLab mà ChatGPT và Codex cần hỗ trợ, chẳng hạn như tìm kiếm kho lưu trữ, quy trình xử lý yêu cầu hợp nhất, quy trình xử lý vấn đề, chỉnh sửa tệp hoặc các quy trình Codex có phạm vi rộng hơn.

Mở sẵn ChatGPT và GitLab trong các tab riêng biệt. Sao chép chính xác URI chuyển hướng hiển thị trong ChatGPT; không tự tạo hoặc chỉnh sửa URI này.

Để mở trang Ứng dụng từ Bảng điều khiển quản trị, chọn không gian làm việc ChatGPT mong muốn, mở Tiện ích, rồi chọn Quản lý ứng dụng cũ.

Các giá trị cần chuẩn bị

  • Tên máy chủ GitLab: ví dụ, gitlab.example.com.

  • URI chuyển hướng: sao chép giá trị này từ quy trình thiết lập mẫu trong ChatGPT.

  • ID ứng dụng OAuth GitLab.

  • Khóa bí mật OAuth GitLab.

  • Phạm vi quyền OAuth: sao chép các giá trị này từ quy trình thiết lập mẫu trong 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.

Tạo ứng dụng OAuth GitLab trong GitLab

Chọn nơi tạo ứng dụng

  1. Mở địa chỉ máy chủ GitLab của bạn, chẳng hạn như https://gitlab.example.com.

  2. Chọn tạo ứng dụng dùng trên toàn hệ thống hoặc ứng dụng thuộc sở hữu của nhóm. Lựa chọn này quyết định ai quản lý ứng dụng; quyền truy cập dự án vẫn tuân theo quyền GitLab của người dùng thực hiện cấp quyền và các phạm vi quyền OAuth đã cấp.

  3. Với ứng dụng dùng trên toàn hệ thống, hãy vào Quản trị > Ứng dụng. Với ứng dụng thuộc sở hữu của nhóm, hãy vào Cài đặt > Ứng dụng của nhóm.

Thêm thông tin ứng dụng

  1. Chọn Ứng dụng mới hoặc Thêm ứng dụng mới.

  2. Nhập tên ứng dụng rõ ràng, chẳng hạn như GitLab Self-Managed hoặc GitLab Dedicated.

  3. Trong URI chuyển hướng, dán chính xác URI đã sao chép từ ChatGPT.

  4. Giữ tùy chọn Bảo mật ở trạng thái bật cho ứng dụng OAuth phía máy chủ này.

Cấu hình quyền truy cập và lưu

  1. Với ứng dụng dùng trên toàn hệ thống, GitLab khuyên bạn nên chọn Đáng tin cậy. Tùy chọn này bỏ qua lời nhắc yêu cầu người dùng cấp quyền.

  2. Chọn các phạm vi quyền api, write_repository và openid.

  3. Kiểm tra ai có thể quản lý ứng dụng và xác nhận rằng người dùng GitLab thực hiện cấp quyền có các quyền phù hợp đối với nhóm và dự án.

  4. Lưu ứng dụng.

Yêu cầu về phạm vi quyền OAuth

Mẫu yêu cầu các phạm vi quyền OAuth sau cho những thao tác GitLab được bật trong ChatGPT và Codex:

  • api: bắt buộc đối với các thao tác API GitLab mà ứng dụng cung cấp, bao gồm thao tác với yêu cầu hợp nhất, vấn đề và CI/CD.

  • write_repository: bắt buộc đối với các thao tác ghi vào kho lưu trữ qua Git.

  • openid: bắt buộc để lấy thông tin danh tính và tư cách thành viên qua OpenID Connect.

Sao chép thông tin xác thực OAuth GitLab

Trong ứng dụng GitLab đã lưu, sao chép ID ứng dụng và Khóa bí mật. Bảo vệ Khóa bí mật như thông tin xác thực. Nếu khóa bị lộ, hãy tạo lại khóa trong GitLab và tạo ứng dụng mới cho không gian làm việc.

Hoàn tất thiết lập trong ChatGPT

  1. Quay lại tab thiết lập mẫu trong ChatGPT.

  2. Dán ID ứng dụng GitLab vào ID máy khách OAuth.

  3. Dán Khóa bí mật GitLab vào Khóa bí mật máy khách OAuth.

  4. Xác nhận rằng trường tên máy chủ GitLab chỉ chứa tên máy chủ, chẳng hạn như gitlab.example.com.

  5. Chọn Tạo bản nháp.

  6. Mở phần chi tiết bản nháp ứng dụng và kiểm tra các mục Quyền truy cập theo vai trò và Cấu hình thao tác.

Phát hành và quản lý ứng dụng cho ChatGPT và Codex

Việc tạo bản nháp ứng dụng không tự động cho phép thành viên sử dụng ứng dụng đó. Sau khi kiểm tra bản nháp:

  1. Chọn Phát hành cho bản nháp ứng dụng.

  2. Truy cập Bảng điều khiển quản trị, chọn không gian làm việc ChatGPT mong muốn và mở Tiện ích, rồi xác nhận rằng các vai trò dự kiến có thể sử dụng GitLab.

  3. Kiểm tra Quyền truy cập theo vai trò đối với các vai trò cần sử dụng ứng dụng.

  4. Trong Cấu hình thao tác, kiểm tra các thao tác đọc và ghi có sẵn.

  5. Trong Cấu hình phê duyệt, chọn những trường hợp người dùng phải phê duyệt thao tác trước khi ChatGPT hoặc Codex sử dụng ứng dụng.

  6. Nhờ một người dùng thử nghiệm có quyền truy cập mở GitLab từ Danh mục tiện ích hoặc Cài đặt > Tiện ích. Xác nhận rằng người dùng có thể cài đặt tiện ích và kết nối với ứng dụng được tạo từ mẫu GitLab Self-Managed.

Các cài đặt phê duyệt ứng dụng này áp dụng cho cuộc trò chuyện trên ChatGPT và luồng hội thoại trên Codex.

Thiết lập hoạt động GitLab để rà soát mã bằng Codex

Sau khi phát hành ứng dụng, hãy cấu hình hoạt động GitLab trong Codex nếu bạn dự định dùng tính năng rà soát mã của Codex. Việc thiết lập hoạt động này sẽ cấu hình các sự kiện webhook cần thiết.

  1. Mở Cài đặt trình kết nối Codex.

  2. Cấu hình tài khoản dịch vụ cho không gian làm việc. Để Codex tạo tài khoản hoặc cung cấp mã truy cập cá nhân cho một tài khoản dịch vụ hiện có.

  3. Bật Hoạt động GitLab cho dự án hoặc một trong các nhóm cấp trên của dự án.

  4. Nếu Codex cần chạy tác vụ lập trình hoặc sử dụng thiết lập riêng của dự án, hãy tạo môi trường dự án.

Ứng dụng GitLab dùng OAuth của người dùng để thực hiện thao tác đọc và các thao tác đã bật trong ChatGPT và Codex. Đối với các thao tác ghi khi Codex rà soát mã trên GitLab Self-Managed hoặc GitLab Dedicated, mã thông báo của tài khoản dịch vụ do không gian làm việc quản lý quyết định danh tính được sử dụng và những dự án mà Codex có thể bình luận hoặc bày tỏ cảm xúc.

Đọc thêm: Rà soát yêu cầu hợp nhất GitLab bằng Codex.

Kết nối và kiểm thử ứng dụng GitLab

  1. Với tư cách người dùng có quyền truy cập, mở GitLab từ Danh mục tiện ích hoặc Cài đặt > Tiện ích. Chọn Cài đặt tiện ích, rồi chọn Kết nối.

  2. Nếu không gian làm việc của bạn có nhiều ứng dụng GitLab, hãy chọn ứng dụng dành cho máy chủ GitLab Self-Managed hoặc GitLab Dedicated này.

  3. Cấp quyền cho ứng dụng OAuth GitLab khi được nhắc.

  4. Trước tiên, chạy một thao tác đọc nhỏ trong ChatGPT hoặc Codex, chẳng hạn như liệt kê các dự án có thể truy cập hoặc truy xuất một yêu cầu hợp nhất đã biết.

  5. Nếu đã bật các thao tác ghi, hãy kiểm thử chúng trên một dự án ít rủi ro và trong từng sản phẩm mà bạn dự định sử dụng trước khi triển khai rộng hơn.

Tên máy chủ và cách OAuth hoạt động

Ứng dụng dùng tên máy chủ để xác định các điểm cuối GitLab. Chỉ nhập tên máy chủ, chẳng hạn như gitlab.example.com. Không nhập https://, đường dẫn API hoặc kho lưu trữ, cổng hay gitlab.com. Mẫu này dành cho GitLab Self-Managed hoặc GitLab Dedicated. Với GitLab.com (SaaS), hãy dùng ứng dụng GitLab.

Khắc phục sự cố thiết lập ứng dụng GitLab Self-Managed

  • URI chuyển hướng không khớp: Xác nhận rằng URI chuyển hướng của ứng dụng OAuth GitLab khớp chính xác với URI chuyển hướng hiển thị trong ChatGPT.

  • ChatGPT không thể tạo hoặc lưu bản nháp ứng dụng: Xác nhận rằng bạn đã nhập đầy đủ tên máy chủ, ID ứng dụng, Khóa bí mật và URI chuyển hướng.

  • Xác thực thành công nhưng lệnh gọi đến dự án thất bại: Xác nhận rằng người dùng GitLab thực hiện cấp quyền có thể truy cập dự án và ứng dụng OAuth có các phạm vi quyền của mẫu.

  • API trả về lỗi 403 hoặc không đủ quyền: Xác nhận rằng tài khoản GitLab đã kết nối có các quyền cần thiết đối với dự án hoặc nhóm, và ứng dụng OAuth có các phạm vi quyền mà mẫu yêu cầu.

  • Không truy cập được dự án nào: Xác nhận rằng người dùng có quyền truy cập dự án, đã kết nối với đúng hệ thống GitLab và đã chọn đúng ứng dụng GitLab trong ChatGPT hoặc Codex.

Tài liệu GitLab liên quan

Bài viết này có hữu ích không?