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: 28 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 ứng dụng nháp dành riêng cho không gian làm việc cho một phiên bản GitLab Self-Managed hoặc GitLab Dedicated. Cung cấp tên máy chủ GitLab và thông tin xác thực ứng dụng OAuth, xem lại ứng dụng nháp 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ẽ dùng được trong cuộc trò chuyện ChatGPT và phiên Codex.

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

Nội dung bạn đang thiết lập

Bạn đang tạo một ứng dụng dành 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 đã đăng ký trên máy chủ GitLab Self-Managed hoặc GitLab Dedicated của bạn.

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

  • Các phạm vi 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à token.

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 trên 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 phiên bản đối với ứng dụng dùng trên toàn phiên bản.

  • Chỉ tên máy chủ GitLab, không có https://, cổng hoặc đường dẫn. Dùng máy chủ GitLab Self-Managed hoặc GitLab Dedicated, không dùng gitlab.com.

  • Quyết đị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 yêu cầu hợp nhất, quy trình vấn đề, chỉnh sửa tệp hoặc các quy trình Codex rộng hơn.

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

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.

  • Mã bí mật OAuth GitLab.

  • Phạm vi OAuth: sao chép các phạm vi 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 > Plugins.

  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ở 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 phiên bản hoặc ứng dụng thuộc sở hữu của nhóm. Lựa chọn này quyết định người 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 cấp quyền và các phạm vi OAuth đã cấp.

  3. Đối với ứng dụng dùng trên toàn phiên bản, hãy chuyển đến Quản trị > Ứng dụng. Đối với ứng dụng thuộc sở hữu của nhóm, hãy chuyển đến 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. Duy trì bật Bảo mật cho ứng dụng OAuth phía máy chủ này.

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

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

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

  3. Xem lại những người có thể quản lý ứng dụng và xác nhận rằng người dùng GitLab cấp quyền có các quyền thích hợp đối với nhóm và dự án.

  4. Lưu ứng dụng.

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

Mẫu yêu cầu các phạm vi 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 do ứng dụng cung cấp, bao gồm thao tác 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 đối với thông tin danh tính và tư cách thành viên 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à Mã bí mật. Hãy coi Mã bí mật là thông tin xác thực. Nếu mã bị lộ, hãy gia hạn mã trong GitLab và tạo một ứng dụng không gian làm việc mới.

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

  1. Quay lại thẻ 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 Mã bí mật GitLab vào Mã bí mật máy khách OAuth.

  4. Xác nhận rằ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ở thông tin chi tiết của ứng dụng nháp rồi xem lại Quyền truy cập theo vai trò và Định 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 ứng dụng nháp không tự động cung cấp ứng dụng cho các thành viên. Sau khi xem lại bản nháp:

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

  2. Chuyển đến Cài đặt không gian làm việc > Tiện ích và xác nhận rằng GitLab được cung cấp cho các vai trò mong muốn.

  3. Xem lại Quyền truy cập theo vai trò cho các vai trò cần sử dụng ứng dụng.

  4. Trong Định cấu hình thao tác, hãy xem lại các thao tác đọc và ghi hiện có.

  5. Trong Định cấu hình phê duyệt, chọn thời điểm 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. Yêu cầu một người dùng thử nghiệm có quyền truy cập mở GitLab từ Thư 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 Self-Managed của GitLab.

Các tùy chọn phê duyệt ứng dụng này áp dụng cho cuộc trò chuyện ChatGPT và luồng Codex.

Thiết lập hoạt động GitLab để Codex đánh giá mã

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

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

  2. Định cấu hình tài khoản dịch vụ của không gian làm việc. Cho phép Codex tạo tài khoản hoặc cung cấp token 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 mẹ của dự án.

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

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

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

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

  1. Với tư cách người dùng có quyền truy cập, hãy mở GitLab từ Thư mục tiện ích hoặc Cài đặt > Tiện ích. Chọn Cài đặt tiện ích, sau đó 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, hãy 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 thao tác ghi, hãy kiểm tra trong một dự án ít rủi ro và trong từng sản phẩm mà bạn định sử dụng trước khi triển khai rộng rãi.

Hành vi của tên máy chủ và OAuth

Ứng dụng dùng tên máy chủ để xác định các điểm cuối GitLab. Chỉ nhập máy chủ, chẳng hạn như gitlab.example.com. Không bao gồm 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. Đối với GitLab.com (SaaS), hãy dùng ứng dụng GitLab.

Khắc phục sự cố khi 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 ứng dụng nháp: Xác nhận rằng đã có tên máy chủ, ID ứng dụng, Mã bí mật và URI chuyển hướng.

  • Xác thực thành công nhưng lệnh gọi dự án thất bại: Xác nhận rằng người dùng GitLab cấp quyền có thể truy cập dự án và ứng dụng OAuth có các phạm vi 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 bao gồm các phạm vi bắt buộc của mẫu.

  • Không thể truy cập 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 phiên bản GitLab mong muốn 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?