Lợi ích mang lại cho bạn
Việc kết nối GitLab cho phép một trang web triển khai từ một trong các kho lưu trữ GitLab của bạn, đồng thời cho phép chúng tôi xuất bản lên GitLab Pages trên tài khoản của bạn khi bạn chọn làm máy chủ của trang web.
Trước khi bạn bắt đầu
Tài khoản GitLab có quyền truy cập vào các dự án bạn muốn triển khai.
1. Tạo khóa tại GitLab
Trong GitLab, hãy chọn ảnh đại diện của bạn ở góc trên cùng bên phải, sau đó chọn Edit profile → Access → Personal access tokens, và tạo một mã thông báo mới (GitLab có thể dán nhãn đây là Legacy token trong menu Generate token). Đặt tên cho mã thông báo, thiết lập ngày hết hạn và chọn các phạm vi sau:
Nhấn Generate token và sao chép mã thông báo — GitLab chỉ hiển thị mã này một lần.
2. Kết nối tại đây
Mở phần Integrations trong bảng điều khiển của bạn và chọn Connect an account. Chọn Code hosting làm nhóm và GitLab làm tài khoản, điền API token, sau đó nhấn Connect account.
Chúng tôi kiểm tra nội dung bạn dán trước khi lưu bất kỳ thông tin nào. Khóa không hoạt động sẽ không bao giờ được lưu trữ và thông báo phản hồi sẽ cho biết lỗi cụ thể. Khóa hoạt động được lưu giữ ở trạng thái mã hóa trong kho lưu trữ bí mật của chúng tôi — tuyệt đối không lưu trong cơ sở dữ liệu — và sẽ không bao giờ hiển thị lại, kể cả đối với bạn.
Điều gì xảy ra tiếp theo
- Một trang web có thể triển khai trực tiếp từ kho lưu trữ trên tài khoản này: hãy chọn kho lưu trữ đó trong phần kết nối kho lưu trữ của trang web, chọn kho lưu trữ và nhánh, và thao tác đẩy (push) sẽ kích hoạt triển khai.
- Mọi nhánh khác đều có thể có bản xem trước riêng, giúp bạn kiểm tra thay đổi trước khi đưa lên trang web chính thức.
- Các máy chủ tĩnh được xây dựng bằng Git như Render và Azure Static Web Apps sử dụng kết nối này làm mã nguồn của trang web.
Nếu kết nối không thành công
Kết nối thành công rồi sau đó dừng lại. Các mã thông báo GitLab luôn có thời hạn sử dụng — thường là tối đa một năm kể từ khi bạn tạo — và GitLab sẽ gửi email thông báo trước khi hết hạn. Hãy tạo mã thông báo mới và kết nối lại.
Thiếu phạm vi quyền. Phạm vi quyền của mã thông báo không thể thay đổi sau khi đã tạo; vui lòng tạo mã thông báo mới với cả hai phạm vi đã được chọn.
Hệ thống thông báo khóa bị từ chối. Hầu như luôn bắt nguồn từ một trong ba nguyên nhân: sao chép nhầm dấu cách hoặc dấu ngắt dòng, khóa đã hết hạn, hoặc khóa đã bị thu hồi hoặc tạo lại sau khi bạn sao chép. Hãy tạo khóa mới và dán lại.
Kết nối thành công nhưng các thao tác sau đó thất bại. Khóa xác thực thành công nhưng thiếu quyền cần thiết để thực hiện hành động. Hãy tạo khóa mới với các quyền liệt kê ở trên, sau đó ngắt kết nối cũ và kết nối bằng khóa mới.
Ngắt kết nối
Mở phần Integrations, tìm tài khoản và nhấn Disconnect. Thao tác này sẽ xóa ngay lập tức khóa đã lưu trữ. Bất kỳ tính năng nào đang sử dụng khóa đó sẽ dừng lại ở thao tác tiếp theo, và các màn hình phụ thuộc vào khóa sẽ hiển thị thông báo lỗi thay vì thất bại âm thầm.
Việc ngắt kết nối không hoàn tác những gì đã thực hiện trước đó — hồ sơ, bản triển khai hoặc cài đặt mà chúng tôi đã thay đổi trên tài khoản của bạn sẽ được giữ nguyên. Nếu bạn nghi ngờ khóa có thể đã bị rò rỉ, vui lòng thu hồi khóa đó tại bên cung cấp; ngắt kết nối chỉ xóa bản sao của chúng tôi chứ không xóa bản của họ.