Install the Zinn® GitHub app so we can deploy without a long-lived token

Những lợi ích của việc kết nối

Việc cài đặt ứng dụng Zinn® GitHub cho phép một trang web triển khai từ các kho lưu trữ của quý vị — và bảng dự án luôn đồng bộ với GitHub — mà không cần giao mã thông báo cá nhân cho chúng tôi. Chúng tôi chỉ lưu giữ số cài đặt của ứng dụng, vốn vô dụng nếu đứng một mình, và tạo ra một mã thông báo có thời hạn một giờ mỗi khi chúng tôi cần. Đây là lựa chọn tốt hơn cho một tổ chức, vì mã thông báo này không thuộc về bất kỳ cá nhân nào và sẽ không ngừng hoạt động khi có nhân sự nghỉ việc.

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

Tài khoản GitHub, hoặc quyền sở hữu đối với tổ chức nơi quý vị muốn cài đặt ứng dụng. Các tổ chức cấm ứng dụng của bên thứ ba cần có chủ sở hữu cho phép; nếu điều đó là không thể, hãy sử dụng mã thông báo chi tiết (fine-grained token) thay thế (Kết nối tài khoản GitHub của quý vị).

1. Tạo khóa trên GitHub

Không có khóa nào cần tạo. Hãy cài đặt ứng dụng Zinn® GitHub trên tài khoản cá nhân hoặc tổ chức của quý vị, và chọn tất cả các kho lưu trữ hoặc chỉ những kho lưu trữ quý vị muốn chúng tôi triển khai.

Sau đó, tìm số cài đặt:

• Tài khoản cá nhân — Settings → Applications → Installed GitHub Apps, và chọn Configure bên cạnh ứng dụng Zinn®.
• Tổ chức — Your organizations → Settings → GitHub Apps, và chọn Configure bên cạnh ứng dụng Zinn®.

Con số ở cuối thanh địa chỉ trên trang đó — ví dụ github.com/settings/installations/12345678 — chính là số cài đặt.

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

Ứng dụng được chọn tại nơi sử dụng thay vì trên màn hình Tích hợp (Integrations):

• Trên kết nối kho lưu trữ của trang web, hãy chọn GitHub (app install).
• Trên liên kết GitHub của bảng dự án, hãy chọn The Zinn® GitHub app.

Dán Số cài đặt và tiếp tục. Chúng tôi kiểm tra quá trình cài đặt trước khi lưu bất kỳ thứ gì; số không thể truy cập sẽ không bao giờ được lưu trữ.

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

• Các kho lưu trữ quý vị cấp quyền cho ứng dụng sẽ xuất hiện để trang web triển khai, và một thao tác đẩy (push) sẽ tiến hành triển khai trang web đó.
• Mọi hành động chúng tôi thực hiện đều xuất hiện trong nhật ký kiểm toán (audit log) của bản cài đặt trên GitHub dưới tên của ứng dụng, chứ không phải tên của quý vị.
• Để cấp thêm kho lưu trữ cho chúng tôi, hãy thay đổi quyền truy cập kho lưu trữ của ứng dụng trên cùng trang Configure — không cần kết nối lại bất cứ thứ gì.

Nếu kết nối không thành công

Thiếu kho lưu trữ. Bản cài đặt chỉ bao gồm các kho lưu trữ quý vị đã chọn. Hãy mở Configure và thêm vào.

Số bị từ chối. Kiểm tra xem đó có phải là số cài đặt từ thanh địa chỉ hay không, chứ không phải ID của ứng dụng, đồng thời đảm bảo ứng dụng vẫn được cài đặt — ứng dụng đã gỡ cài đặt sẽ không có số cài đặt.

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

Kết nối thành công nhưng sau đó có lỗi xảy ra. Khóa được xác thực nhưng thiếu quyền mà hành động đó yêu cầu. Hãy 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

Hãy mở mục Integrations, tìm tài khoản và nhấn Disconnect. Thao tác đó 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 nó 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ị sẽ được giữ nguyên. Nếu quý vị cho rằng bản thân khóa có thể bị rò rỉ, hãy 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 của họ.