Tổng quan

Sử dụngMẫu ứng dụng GitLab tự quản lýtạo một ứng dụng nháp dành riêng cho không gian làm việc cho một instance GitLab Tự Quản lý hoặc GitLab Dành Riêng. Cung cấp tên máy chủ GitLab và thông tin xác thực ứng dụng OAuth, xem xét ứng dụng nháp, và sau đó xuất bản nó cho các thành viên không gian làm việc đủ điều kiện. Sau khi xuất bản, các hành động được bật của ứng dụng sẽ có sẵn trong các cuộc trò chuyện ChatGPT và các phiên Codex.

Để có tổng quan về hành vi được GitLab hỗ trợ, tính khả dụng, quyền hạn, sử dụng dữ liệu và các yêu cầu mạng, xem:Kết nối GitLab với ChatGPT và Codex.

Những gì 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 này 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.

• OAuth của GitLabID Ứng DụngvàBí mậtđể xác thực người dùng.

• Các phạm vi OAuth cần thiết: 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, xác thực và token.

Trước khi bạn bắt đầu

Bạn cần:

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

• Quyền GitLab để tạo ứng dụng OAuth: quyền truy cập Chủ sở hữu nhóm cho ứng dụng thuộc sở hữu nhóm, hoặc quyền truy cập quản trị viên của instance cho ứng dụng trên toàn instance.

• Chỉ tên máy chủ GitLab, không bao gồm https://, cổng hoặc đường dẫn. Sử dụng máy chủ GitLab Tự Quản lý hoặc GitLab Dành riêng, không sử dụng gitlab.com.

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

Giữ ChatGPT và GitLab mở trong các tab riêng biệt. Sao chép chính xácURI chuyển hướngđược hiển thị trong ChatGPT; không tạo hoặc chỉnh sửa nó.

Để mởỨng dụngtrang 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 mở rộng, và chọnQuả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 điều này từ quy trình thiết lập mẫu ChatGPT.

• GitLab OAuthID Ứng Dụng.

• GitLab OAuthBí mật.

• Phạm vi OAuth: sao chép những cái này từ quy trình thiết lập mẫu ChatGPT.

Bắt đầu thiết lập mẫu trong ChatGPT

1. Trong ChatGPT, chuyển sang không gian làm việc nơi ứng dụng nên có sẵn.

2. Đi đếnCài đặt không gian làm việc > Ứng dụng.

3. TrongThư mục, tìmGitLab, mở nóMẫu ứng dụng GitLab tự quản lý, và chọnBật.

4. Nhập tên và mô tả ứng dụng rõ ràng.

5. Nhập tên máy chủ GitLab, chẳng hạn như gitlab.example.com.

6. Sao chépURI chuyển hướngđược hiển thị trong ChatGPT, và giữ tab này mở.

Ví dụ: https://chatgpt.com/connector/oauth/<redirect_id>. Không xóa ID chuyển hướng, không thêm dấu gạch chéo cuối, và không thay thế URI bằng URL ChatGPT chung.

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 một ứng dụng trên toàn bộ phiên bản hay một ứng dụng thuộc sở hữu nhóm. Lựa chọn này xác định ai sẽ quản lý ứng dụng; quyền truy cập dự án vẫn tuân theo quyền của người dùng được ủy quyền trong GitLab và các phạm vi OAuth được cấp.

3. Để áp dụng cho toàn bộ phiên bản, hãy đếnQuản trị viên > Ứng dụng. Đối với một ứng dụng thuộc sở hữu nhóm, hãy truy cập vào nhómCài đặt > Ứng dụng.

Thêm chi tiết ứng dụng

1. ChọnỨng dụng mớihoặcThê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. TrongURI chuyển hướng, dán URI chính xác đã sao chép từ ChatGPT.

4. GiữBảo mậtđược 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. Đối với một ứng dụng trên toàn bộ phiên bản, GitLab khuyến nghị chọnĐáng tin cậy. Điều này bỏ qua lời nhắc xác thực người dùng.

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

3. Xem lại ai có thể quản lý ứng dụng, và xác nhận rằng những người dùng GitLab được ủy quyền có các quyền nhóm và dự án phù hợp.

4. Lưu ứng dụng.

Yêu cầu phạm vi OAuth

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

• api: cần thiết cho các thao tác API GitLab được ứng dụng cung cấp, bao gồm yêu cầu hợp nhất, vấn đề và các hành động CI/CD.

• write_repository: yêu cầu để thực hiện các thao tác ghi lên kho lưu trữ qua Git.

• openid: yêu cầu để có thông tin định danh và thành viên của OpenID Connect.

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

Trong ứng dụng GitLab đã lưu, sao chépID Ứng DụngvàBí mật. Xử lýBí mậtnhư một chứng chỉ. Nếu nó bị lộ, hãy gia hạn nó trong GitLab và tạo một ứng dụng không gian làm việc mới.

Hoàn tất cài đặt trong ChatGPT

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

2. Dán GitLabID Ứng DụngvàoID khách hàng OAuth.

3. Dán GitLabBí mậtvàoBí mật client 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ọnTạo bản nháp.

6. Mở chi tiết ứng dụng bản nháp và xem xét quyền truy cập vai trò và cấu hình các hành động.

Xuất bản và quản lý ứng dụng cho ChatGPT và Codex

Tạo ứng dụng bản nháp không tự động làm cho nó có sẵn cho các thành viên. Sau khi xem xét bản nháp:

1. ChọnXuất bảncho ứng dụng dự thảo.

2. Đi đếnBả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 mở rộng, sau đó xác nhận rằngGitLabcó sẵn cho các vai trò dự định.

3. Đánh giáQuyền truy cập vai tròcho các vai trò nên sử dụng ứng dụng.

4. TrongCấu hình các hành động, xem lại các hành động đọc và ghi có sẵn.

5. TrongCấu hình phê duyệt, chọn khi nào người dùng phải phê duyệt một hành động trước khi ChatGPT hoặc Codex sử dụng ứng dụng.

6. Hỏi một người dùng thử có quyền truy cập vào openGitLabtừThư mục pluginhoặcCài đặt > Tiện ích. Xác nhận rằng người dùng có thể cài đặt plugin và kết nối với ứng dụng được tạo từGitLabMẫu tự quản lý.

Các cài đặt phê duyệt ứng dụng này áp dụng cho các cuộc trò chuyện ChatGPT và các chủ đề Codex.

Thiết lập hoạt động GitLab cho việc xem xét mã Codex

Sau khi ứng dụng được xuất bản, hãy cấu hình hoạt động GitLab trong Codex nếu bạn dự định sử dụng đánh giá mã Codex. Cài đặt 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 kết nối Codex.

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

3. BậtHoạt động GitLabcho dự án hoặc một trong các nhóm cha mẹ của nó.

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

Ứng dụng GitLab sử dụng OAuth của người dùng để đọc và thực hiện các hành động được bật trong ChatGPT và Codex. Đối với việc ghi đánh giá Codex 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ý xác định danh tính và các dự án mà Codex có thể bình luận hoặc phản ứng.

Đọc thêm:Xem xét các yêu cầu hợp nhất GitLab với Codex.

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

1. Là người dùng có quyền truy cập, mởGitLabtừThư mục pluginhoặcCài đặt > Tiện ích. ChọnCài đặt plugin, và sau đó chọnKết nối.

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

3. Ủy quyền ứng dụng GitLab OAuth khi được yêu cầu.

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

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

Tên máy chủ và hành vi OAuth

Ứng dụng sử 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, hoặc gitlab.com. Mẫu này dành cho GitLab Tự Quản lý hoặc GitLab Cấp Dành Riêng. Đối với GitLab.com (SaaS), hãy sử dụng ứng dụng GitLab.

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

• Sai khớp URI chuyển hướng:Xác nhận rằng URI Chuyển hướng của ứng dụng GitLab OAuth 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 tên máy chủ, ID Ứng dụng, Bí mật và URI Chuyển hướng đều có mặt.

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

• API trả về 403 hoặc quyền truy cập không đủ:Xác nhận rằng tài khoản GitLab được kết nối có quyền dự án hoặc nhóm cần thiết và rằng ứng dụng OAuth bao gồm các phạm vi mẫu cần thiết.

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

Tài liệu GitLab liên quan

• Tài liệu GitLab: Cấu hình GitLab như một nhà cung cấp định danh OAuth 2.0

• Tài liệu GitLab: Phạm vi của mã truy cập

• Tài liệu GitLab: API nhà cung cấp danh tính OAuth 2.0

• Tài liệu GitLab: Mã truy cập cá nhân

• Tài liệu GitLab: Vai trò và quyền hạn

• Tài liệu GitLab: Webhooks