Kết nối tài khoản GitLab của bạn để các trang web của bạn triển khai từ một kho lưu trữ

Lợi ích của việc kết nối

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 quý vị, đồng thời cho phép chúng tôi phát hành lên GitLab Pages trên tài khoản của quý vị tại nơi quý vị chọn dịch vụ này làm máy chủ lưu trữ của trang web.

Trước khi quý vị bắt đầu

Một tài khoản GitLab có quyền truy cập vào các dự án mà quý vị 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 quý vị ở phía trên 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 mục này là Legacy token trong menu Generate token). Hãy đặt tên cho mã, thiết lập ngày hết hạn và đánh dấu vào các phạm vi (scopes) sau:

• api
• write_repository

Nhấn Generate token và sao chép mã — GitLab chỉ hiển thị mã này một lần.

2. Kết nối tại đây

Mở mục Integrations trong trang tổng quan của quý vị và chọn Connect an account. Chọn Code hosting làm nhóm và GitLab làm tài khoản, điền vào ô API token, sau đó nhấn Connect account.

Chúng tôi kiểm tra nội dung quý vị dán trước khi bất kỳ thông tin nào được lưu lại. Khóa không hoạt động sẽ không bao giờ được lưu trữ, và phản hồi sẽ cho biết khóa gặp phải lỗi gì. Khóa hoạt động tốt sẽ được giữ mã hóa trong kho bảo mật (secrets vault) của chúng tôi — không bao giờ nằm trong cơ sở dữ liệu của chúng tôi — và không bao giờ được hiển thị lại, ngay cả với quý vị.

Điều gì sẽ diễn ra tiếp theo

• Một trang web có thể triển khai trực tiếp từ một kho lưu trữ trên tài khoản này: hãy chọn tài khoản đó trong kết nối kho lưu trữ của trang web, chọn kho lưu trữ và nhánh, và mỗi lần đẩy mã (push) sẽ thực hiện triển khai.
• Mỗi nhánh khác đều có thể có bản xem trước riêng, nhờ đó quý vị có thể kiểm tra thay đổi trước khi đưa lên trang web chính thức.
• Các máy chủ lưu trữ tĩnh được xây dựng bằng Git như Render và Azure Static Web Apps sẽ sử dụng kết nối này làm nguồn mã nguồn của trang web.

Nếu không kết nối được

Khóa từng hoạt động nhưng sau đó dừng lại. Các mã thông báo GitLab luôn hết hạn — thường tối đa là một năm sau khi quý vị tạo — và GitLab sẽ gửi email cho quý vị trước khi điều đó diễn ra. Hãy tạo một mã mới và kết nối lại.

Thiếu một phạm vi (scope). Không thể thay đổi các phạm vi của mã thông báo sau khi mã đã được tạo; hãy tạo một mã thông báo mới với cả hai phạm vi được đánh dấu chọn.

Thông báo báo rằng khóa bị từ chối. Hầu như luôn là một trong ba nguyên nhân: khoảng trắng hoặc dấu xuống dòng được sao chép cùng với khóa, khóa đã hết hạn, hoặc khóa đã bị thu hồi hoặc tạo lại sau khi quý vị sao chép. Hãy tạo một khóa mới và dán lại.

Kết nối thành công, nhưng sau đó có thao tác bị lỗi. Khóa đã xác thực nhưng thiếu quyền mà tác vụ cần. Hãy tạo một khóa mới với các quyền được liệt kê ở trên, sau đó ngắt kết nối cũ và kết nối khóa mới.

Ngắt kết nối

Mở mục Integrations, tìm tài khoản và nhấn Disconnect. Thao tác đó sẽ xóa khóa đã lưu ngay lập tức. Bất kỳ tác vụ nào đang sử dụng khóa sẽ dừng lại ở hành động tiếp theo, và các màn hình phụ thuộc vào khóa sẽ thông báo rõ ràng thay vì âm thầm bị lỗi.

Việc ngắt kết nối không hoàn tác những gì đã được thực hiện — các bản ghi, 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 quý vị vẫn sẽ giữ nguyên. Nếu quý vị cho rằng chính khóa đó có thể đã bị rò rỉ, hãy thu hồi khóa đó tại nhà cung cấp; việc ngắt kết nối chỉ xóa bản sao của chúng tôi, không phải của họ.