Triển khai cho trực tiếp & xem trước kênh thông qua yêu cầu lấy dữ liệu GitHub

Bạn có thể tích hợp các bản triển khai vào Firebase Hosting thông qua một Hành động trên GitHub. Sau đây là những việc mà Hành động GitHub này có thể làm cho bạn:

  • Tạo một kênh xem trước mới (và URL xem trước liên kết) cho mỗi yêu cầu thay đổi trên kho lưu trữ GitHub của bạn.

  • Thêm nhận xét vào yêu cầu xem xét kèm theo URL xem trước để bạn và mỗi người đánh giá có thể xem và kiểm thử các thay đổi của yêu cầu xem xét trong phiên bản "xem trước" của ứng dụng.

    hình ảnh bình luận về Hành động trên GitHub với URL xem trước

  • Cập nhật URL xem trước bằng các thay đổi từ mỗi lần cam kết bằng cách tự động triển khai đến kênh xem trước được liên kết. URL không thay đổi với mỗi cam kết mới.

  • (Không bắt buộc) Triển khai trạng thái hiện tại của kho lưu trữ GitHub vào kênh phát trực tiếp khi PR được hợp nhất.

Lưu ý: Khi sử dụng URL xem trước, ứng dụng của bạn sẽ tương tác với các tài nguyên phụ trợ thực tế của dự án Firebase.

Thiết lập Hành động GitHub để triển khai cho Firebase Hosting

  1. Tạo một kho lưu trữ GitHub (công khai hoặc riêng tư) hoặc sử dụng một kho lưu trữ hiện có. Bạn phải có quyền quản trị đối với kho lưu trữ.

  2. Trong phiên bản cục bộ của kho lưu trữ, hãy thiết lập Firebase Hosting bằng Lệnh firebase init.

    • Nếu bạn CHƯA thiết lập Hosting, hãy chạy phiên bản lệnh này từ thư mục gốc của thư mục cục bộ:

      firebase init hosting
    • Nếu ĐÃ thiết lập Hosting, thì bạn chỉ cần thiết lập phần Hành động GitHub của Hosting. Chạy phiên bản lệnh này từ thư mục gốc của thư mục cục bộ:

      firebase init hosting:github
  3. Làm theo lời nhắc CLI và lệnh sẽ tự động xử lý thiết lập GitHub Action:

    • Tạo một tài khoản dịch vụ trong dự án Firebase của bạn với quyền triển khai cho Firebase Hosting.

    • Mã hoá khoá JSON của tài khoản dịch vụ đó rồi tải khoá lên tệp được chỉ định Kho lưu trữ GitHub dưới dạng Bí mật GitHub.

    • Ghi các tệp cấu hình yaml trong quy trình công việc của GitHub tham chiếu đến khoá bí mật mới tạo. Các tệp này định cấu hình Hành động GitHub để triển khai cho Firebase Hosting.

  4. Trong GitHub, hãy tạo một nhánh mới và xác nhận các tệp yaml của quy trình công việc do CLI tạo.

  5. Xuất bản nhánh vào kho lưu trữ GitHub.

  6. Hợp nhất nhánh.

Tất cả chỉ có thế! Mọi PR sau này trong kho lưu trữ GitHub này sẽ tự động có "URL xem trước"!

Tìm hiểu thêm về GitHub Action

  • Firebase duy trì Hành động GitHub "Triển khai đến Firebase Hosting" dưới dạng một dự án nguồn mở. Xem mã nguồn.

  • Hành động GitHub "Triển khai đến Firebase Hosting" cho phép bạn định cấu hình thêm, chẳng hạn như tuỳ chỉnh ngày hết hạn cho kênh xem trước hoặc đặt kênh không trực tiếp để triển khai khi một yêu cầu phát hành được hợp nhất. Tìm hiểu về các tuỳ chọn cấu hình hiện có.

  • Tìm hiểu thêm về GitHub Actions nói chung.