Hãy cài đặt ứng dụng GitHub của Zinn® để chúng tôi có thể triển khai mà không cần mã thông báo tồn tại lâu dài

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

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à một 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ỉ giữ số cài đặt của ứng dụng, vốn vô hại khi đứng riêng lẻ, và tạo một mã thông báo có hiệu lực trong 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, bởi vì nó không thuộc về bất kỳ cá nhân nào và không ngừng hoạt động khi có người rời đi.

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

Cần có tài khoản GitHub hoặc quyền chủ sở hữu đối với tổ chức mà quý vị muốn cài đặt ứng dụng. Các tổ chức cấm ứng dụng 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) để thay thế (Kết nối tài khoản GitHub của quý vị).

1. Tạo khóa tại 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ị, rồi chọn tất cả các kho lưu trữ hoặc chỉ những kho lưu trữ mà 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 nó được sử dụng thay vì trên màn hình Tích hợp:

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

Dán Số cài đặt và tiếp tục. Chúng tôi sẽ kiểm tra quá trình cài đặt trước khi lưu bất kỳ thứ gì; số mà chúng tôi 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ữ mà quý vị đã cấp quyền cho ứng dụng sẽ xuất hiện để trang web triển khai từ đó, và một lệnh push sẽ triển khai nó.
• Mọi hành động chúng tôi thực hiện đều xuất hiện trong nhật ký kiểm tra của bản cài đặt trên GitHub dưới tên của ứng dụng, không phải tên của quý vị.
• Để cấp cho chúng tôi thêm các kho lưu trữ, 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 không kết nối được

Thiếu kho lưu trữ. Bản cài đặt chỉ bao gồm các kho lưu trữ mà 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 chính ứng dụng, và đảm bảo ứng dụng vẫn được cài đặt — ứng dụng đã gỡ cài đặt sẽ không có bản cài đặt nào.

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

Đã kết nối, nhưng sau đó xảy ra lỗi. Khóa đã xác thực nhưng thiếu quyền mà hành động đó 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ở 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ỳ thứ gì đang sử dụng nó sẽ dừng lại ở hành động tiếp theo, và các màn hình phụ thuộc vào nó sẽ thông báo điều đó 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 mà chúng tôi đã thay đổi trên tài khoản của quý vị vẫn giữ nguyên như hiện tại. Nếu quý vị cho rằng chính khóa đó có thể đã bị rò rỉ, hãy thu hồi nó 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 phải của họ.