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ừ một kho lưu trữ

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

Kết nối GitHub bằng mã thông báo cho phép 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 cập nhật. Kết nối này cũng cho phép chúng tôi xuất bản lên GitHub Pages trong tài khoản của quý vị khi quý vị chọn đó làm máy chủ của trang web.

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

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

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 các kho lưu trữ đó thuộc về một tổ chức, chủ sở hữu có thể cần phê duyệt các mã thông báo chi tiết cho tổ chức đó.

1. Tạo khóa trên 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 gian hết hạn. Dưới mục Repository access, hãy chọn Only select repositories và chọn các kho lưu trữ mà quý vị triển khai — phạm vi truy cập hẹp nhất nhưng vẫn hoạt động được.

Dưới 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ã 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à GitHub làm tài khoản, điền vào mục API token, sau đó nhấn Connect account.

Chúng tôi kiểm tra nội dung quý vị 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ủa khóa đó. Khóa hoạt động sẽ được mã hóa và lưu trữ trong kho bảo mật của chúng tôi — chứ không phải trong cơ sở dữ liệu của chúng tôi — và sẽ không bao giờ hiển thị lại, ngay cả với quý vị.

Điều gì sẽ xảy ra tiếp theo

• 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ữ đó trong phần

kết nối kho lưu trữ của trang web, chọn kho lưu trữ và nhánh, sau đó thao tác đẩy mã 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, 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ủ 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

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 lưu trữ đó. Hãy chỉnh sửa mã thông báo trên GitHub và thêm kho lưu trữ vào.

Kết nối hoạt động rồi dừ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. Vui lòng tạo 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.

Thông báo khóa bị từ chối. Hầu như luôn do một trong ba nguyên nhân sau: có khoảng trắng hoặc ngắt dòng bị 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. Vui lòng tạo khóa mới và dán lại.

Kết nối thành công nhưng một tác vụ sau đó thất bại. Khóa được xác thực nhưng thiếu quyền mà tác vụ đó cần. Vui lòng tạo 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 khóa đã lưu trữ ngay lập tức. 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 thay vì lỗi ngầm.

Việc ngắt kết nối không hoàn tác những gì đã thực hiện — 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 quý vị vẫn được giữ nguyên. Nếu quý vị nghi ngờ khóa của mình có thể đã bị rò rỉ, vui lòng thu hồi khóa đó tại bên 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ọ.