Kết nối tài khoản GitHub của bạn bằng mã thông báo để các trang web của bạn triển khai từ kho lưu trữ

Lợi ích khi kết nối cho quý vị

Kết nối GitHub bằng mã thông báo cho phép một trang web triển khai từ một trong các kho lưu trữ của quý vị: đẩy mã lên nhánh và trang web sẽ cập nhật. Việc này cũng cho phép chúng tôi xuất bản lên GitHub Pages trên tài khoản của quý vị khi quý vị chọn đó làm máy chủ lưu trữ của trang web.

Nếu các kho lưu trữ của quý vị thuộc về một tổ chức, quý vị nên ưu tiên sử dụng ứng dụng Zinn® GitHub thay thế — hãy xem mục Cài đặt ứng dụng Zinn® GitHub. Mã thông báo thuộc về một cá nhân và sẽ ngừng hoạt động khi họ rời đi.

Trước khi bắt đầu

Một tài khoản GitHub có quyền truy cập vào các kho lưu trữ mà quý vị muốn triển khai. Nếu chúng thuộc về một tổ chức, chủ sở hữu có thể phải phê duyệt các mã thông báo chi tiết (fine-grained tokens) cho tổ chức đó.

1. Tạo khóa tại GitHub

Trên GitHub, hãy nhấp vào ảnh hồ sơ của quý vị, sau đó chọn Settings → Developer settings → Personal access tokens → Fine-grained tokens → Generate new token. Đặt tên cho khóa và chọn thời hạn hết hạn. Trong mục Repository access, chọn Only select repositories và chọn những kho lưu trữ mà quý vị triển khai — phạm vi truy cập hẹp nhất có thể hoạt động.

Trong mục Repository permissions, hãy cấp quyền Read and write cho:

• Contents
• Pages
• Administration

Nhấn Generate token và sao chép mã đó — GitHub chỉ hiển thị mã một lần duy nhất.

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

Mở Integrations trong bảng điều khiển của quý vị và chọn Connect an account. Chọn Code hosting làm nhóm và GitHub làm tài khoản, điền API token, rồi nhấn Connect account.

Chúng tôi sẽ kiểm tra nội dung quý vị dán trước khi lưu bất kỳ thứ gì. 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 vấn đề gì. Khóa hoạt động được lưu trữ mã hóa trong kho bảo mật của chúng tôi — không bao giờ nằm trong cơ sở dữ liệu — và sẽ không bao giờ hiển thị lại, kể 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 kho lưu trữ đó trên kết nối kho lưu trữ của trang web, chọn kho lưu trữ cùng nhánh, và thao tác đẩy mã sẽ tiến hành 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 từ 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 thể kết nối

Kho lưu trữ không xuất hiện. Quyền truy cập kho lưu trữ của mã thông báo không bao gồm kho đó. Hãy chỉnh sửa mã thông báo trên GitHub và thêm kho lưu trữ vào.

Từng hoạt động nhưng sau đó ngừng lại. Các mã thông báo chi tiết sẽ hết hạn vào ngày quý vị đã chọn. Hãy tạo một mã mới và kết nối lại; GitHub sẽ gửi email cho quý vị trước khi mã thông báo hết hạn.

Hệ thống báo khóa bị từ chối. Hầu như luôn là một trong ba nguyên nhân: có khoảng trắng hoặc dấu xuống dòng được sao chép cùng, khóa đã hết hạn, hoặc khóa đã bị thu hồi hay 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 thao tác sau đó thất bại. Khóa đã xác thực nhưng thiếu quyền mà thao tác yêu cầu. 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ở Integrations, tìm tài khoản và nhấn Disconnect. Thao tác này sẽ xóa ngay khóa đã lưu trữ. Bất kỳ thành phần 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ẽ thông báo rõ ràng thay vì âm thầm gặp 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, hoạt động triển khai hoặc cài đặt 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 bản thân khóa có thể đã bị lộ, 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 chứ không xóa bản sao của họ.