Quản lý trực tiếp & xem trước kênh, bản phát hành và phiên bản cho trang web của bạn

Firebase Hosting cung cấp công cụ thông qua cả bảng điều khiển Firebase và Firebase CLI để quản lý các kênh, bản phát hành và phiên bản cho trang web Lưu trữ của bạn.

Tổng quan về cơ sở hạ tầng Hosting

Hiểu cơ sở hạ tầng Lưu trữ giúp bạn hiểu các tùy chọn quản lý được mô tả trên trang này.

Mỗi dự án Firebase đều có một trang Lưu trữ mặc định có quyền truy cập vào tất cả tài nguyên của dự án (cơ sở dữ liệu, xác thực, chức năng, v.v.). Một trang web chứa một hoặc nhiều kênh , trong đó mỗi kênh được liên kết với một URL phục vụ nội dung cụ thể và cấu hình Lưu trữ.

hình ảnh về hệ thống phân cấp của Firebase Hosting

Mỗi trang web Lưu trữ đều có kênh "trực tiếp" phục vụ nội dung và cấu hình Lưu trữ tại (1) tên miền phụ do Firebase cung cấp của trang web ( SITE_ID .web.appSITE_ID .firebaseapp.com ) và (2) mọi miền tùy chỉnh được kết nối . Bạn cũng có thể tùy ý tạo các kênh "xem trước" phục vụ nội dung và cấu hình của riêng chúng tại các "URL xem trước" tạm thời, có thể chia sẻ ( SITE_ID -- CHANNEL_ID - RANDOM_HASH .web.app ).

Nội dung và cấu hình do mỗi kênh cung cấp được đóng gói thành một đối tượng phiên bản có mã định danh duy nhất. Khi bạn triển khai đến trang web của mình, Firebase sẽ tạo một đối tượng phát hành trỏ đến một phiên bản cụ thể. Bản phát hành chứa siêu dữ liệu về quá trình triển khai, chẳng hạn như ai đã triển khai và thời điểm họ triển khai.

Từ trang tổng quan Lưu trữ của dự án Firebase, bạn có thể xem toàn bộ lịch sử các bản phát hành kênh trực tiếp của mình trong bảng Lịch sử phát hành . Nếu bạn có nhiều trang web Lưu trữ , hãy nhấp vào Xem đối với trang web mong muốn để xem lịch sử phát hành của trang web đó. Nếu bạn có bất kỳ kênh xem trước nào, chúng cũng được hiển thị trên bảng điều khiển Dịch vụ lưu trữ.

Quản lý cài đặt của kênh

Đối với mỗi kênh trên trang web của bạn, bạn có thể kiểm soát cài đặt của kênh đó. Một số cài đặt, như hết hạn kênh, chỉ áp dụng cho các kênh xem trước.

Giới hạn số lượng phát hành để giữ

Mỗi khi bạn triển khai lên một kênh (và tạo bản phát hành), Hosting sẽ giữ phiên bản được liên kết với bản phát hành trước đó trong bộ lưu trữ Hosting của dự án. Bạn có thể đặt số lượng bản phát hành cần giữ lại cho từng kênh trong dự án của mình, cả kênh trực tiếp và kênh xem trước.

  • Tại sao Hosting giữ các bản phát hành trước đó?
    Đối với kênh trực tiếp của bạn, việc giữ lại các bản phát hành trước đó cho phép bạn quay lại phiên bản trước của trang web nếu cần. Đối với các kênh xem trước của bạn, tính năng quay lại chưa khả dụng.

  • Tại sao lại giới hạn số lượng phát hành để giữ?
    Tính năng này có thể giúp bạn kiểm soát mức độ sử dụng bộ nhớ Hosting của dự án vì nội dung của các bản phát hành trước được lưu giữ trong bộ nhớ này. Bạn có thể giám sát bộ nhớ Hosting của mình từ tab Bộ nhớ trong bảng điều khiển.

  • Điều gì xảy ra khi bạn giới hạn việc giữ lại các bản phát hành?
    Khi bạn đặt giới hạn cho số bản phát hành cần giữ lại, nội dung của mọi bản phát hành vượt quá giới hạn đã đặt của bạn sẽ được lên lịch xóa, bắt đầu từ bản phát hành cũ nhất trước tiên .

Dưới đây là cách đặt giới hạn bộ nhớ phát hành cho một kênh:

  1. Trong bảng điều khiển Firebase , truy cập hộp thoại cài đặt bộ nhớ phát hành:

    • Dành cho kênh trực tiếp của bạn
      Trong bảng Lịch sử phát hành cho trang web của bạn, hãy nhấp vào , sau đó chọn Cài đặt bộ nhớ phát hành .

    • Đối với bất kỳ kênh xem trước nào
      Trong hàng dành cho kênh xem trước, hãy nhấp vào , sau đó chọn Cài đặt kênh .

  2. Nhập số lượng bản phát hành bạn muốn giữ lại, sau đó nhấp vào Lưu .

Đặt thời hạn của kênh xem trước

Theo mặc định, kênh xem trước sẽ hết hạn sau 7 ngày kể từ ngày tạo nhưng kênh trực tiếp trên trang web của bạn sẽ không bao giờ hết hạn.

Khi kênh xem trước hết hạn, kênh đó cùng với các bản phát hành và phiên bản liên quan sẽ được lên lịch xóa trong vòng 24 giờ. URL xem trước được liên kết cũng bị vô hiệu hóa. Một ngoại lệ đối với việc xóa phiên bản này là nếu một phiên bản được liên kết với một bản phát hành khác (ví dụ: điều này xảy ra nếu bạn sao chép một phiên bản từ kênh này sang kênh khác trong cùng một trang web ).

Dịch vụ lưu trữ hỗ trợ hai cách khác nhau để kiểm soát thời gian hết hạn của kênh:

  • Bảng điều khiển Firebase
    Trong hàng dành cho kênh xem trước, hãy nhấp vào , sau đó chọn Cài đặt kênh . Nhập ngày và giờ hết hạn.

  • Firebase CLI
    Ví dụ: khi bạn triển khai kênh xem trước của mình, hãy chuyển cờ --expires DURATION :

    firebase hosting:channel:deploy new-awesome-feature --expires 7d

    Thời hạn sử dụng có thể lên tới 30 ngày kể từ ngày triển khai. Sử dụng h cho giờ, d cho ngày và w cho tuần (ví dụ: 12h , 7d , 2w tương ứng).

Sao chép một phiên bản từ kênh này sang kênh khác

Bạn có thể sao chép phiên bản đã triển khai từ kênh này sang kênh khác. Bạn có thể sao chép trên các kênh trực tiếp hoặc xem trước, trên các trang web Lưu trữ hoặc thậm chí trên các dự án Firebase.

Lệnh nhân bản cũng triển khai đến kênh "đích" để nội dung và cấu hình Hosting nhân bản được tự động cung cấp tại URL liên kết của kênh "đích".

Tính năng này hữu ích cho việc theo dõi phiên bản hoặc nếu bạn muốn chắc chắn rằng mình đang triển khai chính xác nội dung mà bạn đã xem và/hoặc thử nghiệm trên một kênh khác. Dưới đây là một số ví dụ:

  • Sao chép từ kênh xem trước "QA" sang kênh trực tiếp trên trang web của bạn (phát trực tiếp!)

  • Sao chép từ kênh trực tiếp trên trang web của bạn sang kênh xem trước "gỡ lỗi" (như trước khi khôi phục)

  • Sao chép từ một kênh trong dự án Firebase "dàn dựng" của bạn sang kênh xem trước trong dự án Firebase "sản xuất" của bạn

Để sao chép một phiên bản, hãy chạy lệnh sau từ bất kỳ thư mục nào:

firebase hosting:clone SOURCE_SITE_ID:SOURCE_CHANNEL_ID TARGET_SITE_ID:TARGET_CHANNEL_ID

Thay thế từng phần giữ chỗ bằng phần sau:

  • SOURCE_SITE_IDTARGET_SITE_ID : Đây là ID của các trang web Lưu trữ có chứa các kênh.

    • Đối với trang web Lưu trữ mặc định của bạn, hãy sử dụng ID dự án Firebase của bạn.
    • Bạn có thể chỉ định các trang web Lưu trữ trong cùng một dự án Firebase hoặc thậm chí trong các dự án Firebase khác nhau.
  • SOURCE_CHANNEL_IDTARGET_CHANNEL_ID : Đây là số nhận dạng cho các kênh.

    • Đối với kênh trực tiếp, hãy sử dụng live làm ID kênh.
    • Nếu kênh "đích" được chỉ định chưa tồn tại, lệnh này sẽ tạo kênh trước khi triển khai vào kênh đó.

Quay lại phiên bản trước của trang web của bạn

Bạn có thể quay lại để phân phát phiên bản trước của kênh trực tiếp trên trang web của mình. Hành động này hữu ích nếu bản phát hành hiện tại của bạn gặp sự cố và bạn muốn quay lại để phân phát một phiên bản đang hoạt động đã biết của trang web của mình. Hoặc có thể trang web của bạn đã phân phối nội dung tạm thời cho một kỳ nghỉ hoặc sự kiện đặc biệt nhưng bây giờ bạn muốn quay lại để phân phát nội dung "thông thường" của mình.

Bằng cách quay lại, bạn tạo một bản phát hành mới phục vụ cùng một phiên bản nội dung như bản phát hành trước đó. Trong bảng Lịch sử phát hành của bạn, cả hai bản phát hành sẽ liệt kê cùng một mã nhận dạng phiên bản.

Đây là cách quay lại:

  1. Trong bảng điều khiển Firebase , trong bảng Lịch sử phát hành cho trang web của bạn, hãy di chuột qua mục phát hành trước đó mà bạn muốn quay lại.

  2. Nhấp vào , sau đó chọn Quay lại .

Xóa bản phát hành theo cách thủ công

Bạn có thể cần phải xóa bản phát hành khỏi kênh trực tiếp của mình theo cách thủ công để giải phóng bộ nhớ Lưu trữ cho dự án của mình. Bạn chỉ có thể xóa bản phát hành trước đó chứ không thể xóa bản phát hành hiện đang được phân phối trên trang web trực tiếp của bạn.

Khi bạn xóa một bản phát hành, thực tế là bạn đang xóa nội dung của bản phát hành đó, nội dung này được lên lịch xóa trong vòng 24 giờ. Bản thân đối tượng phát hành được lưu giữ để bạn vẫn có thể xem siêu dữ liệu của nó (ai đã triển khai và thời điểm họ triển khai).

Đây là cách xóa một bản phát hành:

  1. Trong bảng điều khiển Firebase , trong bảng Lịch sử phát hành cho trang web của bạn, hãy di chuột qua mục phát hành trước đó mà bạn muốn xóa.

  2. Nhấp vào , sau đó chọn Xóa .

Xóa kênh xem trước theo cách thủ công

Bạn có thể xem trước các kênh của mình bằng cách nhấp vào kênh bạn muốn xem trước. Từ chế độ xem này, bạn có thể xem, xóa và hoàn nguyên các bản phát hành và triển khai mới nhất được gắn với kênh cụ thể. Bạn có thể xóa kênh xem trước nhưng không thể xóa kênh trực tiếp trên trang web của mình.

Khi bạn xóa kênh xem trước, kênh đó cùng với các bản phát hành và phiên bản liên quan sẽ được lên lịch xóa trong vòng 24 giờ. URL xem trước được liên kết cũng bị vô hiệu hóa. Một ngoại lệ đối với việc xóa phiên bản là nếu một phiên bản được liên kết với một bản phát hành khác (ví dụ: điều này xảy ra nếu bạn sao chép một phiên bản từ kênh này sang kênh khác trong cùng một trang web ).

Hosting hỗ trợ hai cách khác nhau để xóa kênh xem trước:

  • Bảng điều khiển Firebase
    Trong hàng dành cho kênh xem trước, hãy nhấp vào , sau đó chọn Xóa kênh . Xác nhận việc xóa.

  • Firebase CLI
    Chạy lệnh sau từ bất kỳ thư mục nào:

    firebase hosting:channel:delete CHANNEL_ID

Lệnh CLI để xem trước kênh và sao chép

Các lệnh cho kênh xem trước

Tất cả các lệnh dành cho kênh xem trước đều hỗ trợ triển khai mục tiêu nếu bạn có nhiều trang web Lưu trữ .

Yêu cầu Sự miêu tả
firebase hosting:channel:create CHANNEL_ID

Tạo kênh xem trước mới trong trang web Lưu trữ mặc định bằng CHANNEL_ID được chỉ định

Lệnh này không triển khai tới kênh.

firebase hosting:channel:delete CHANNEL_ID

Xóa kênh xem trước đã chỉ định

Bạn không thể xóa kênh trực tiếp của trang web.

firebase hosting:channel:deploy CHANNEL_ID

Triển khai nội dung và cấu hình Lưu trữ của bạn tới kênh xem trước được chỉ định

Nếu kênh xem trước chưa tồn tại, lệnh này sẽ tạo kênh trong trang Lưu trữ mặc định trước khi triển khai lên kênh.

firebase hosting:channel:list Liệt kê tất cả các kênh (bao gồm cả kênh "trực tiếp") trong trang web Lưu trữ mặc định
firebase hosting:channel:open CHANNEL_ID Mở trình duyệt tới URL của kênh được chỉ định hoặc trả về URL nếu không thể mở trong trình duyệt

Các lệnh nhân bản phiên bản

Yêu cầu Sự miêu tả
firebase hosting:clone \
SOURCE_SITE_ID : SOURCE_CHANNEL_ID \
TARGET_SITE_ID : TARGET_CHANNEL_ID

Sao chép phiên bản được triển khai gần đây nhất trên kênh "nguồn" được chỉ định sang kênh "đích" được chỉ định

Lệnh này cũng triển khai tới kênh "đích" được chỉ định. Nếu kênh "đích" chưa tồn tại, lệnh này sẽ tạo kênh xem trước mới trong trang Lưu trữ "đích" trước khi triển khai lên kênh.

firebase hosting:clone \
SOURCE_SITE_ID :@ VERSION_ID \
TARGET_SITE_ID : TARGET_CHANNEL_ID

Sao chép phiên bản đã chỉ định vào kênh "đích" đã chỉ định

Lệnh này cũng triển khai tới kênh "đích" được chỉ định. Nếu kênh "đích" chưa tồn tại, lệnh này sẽ tạo kênh xem trước mới trong trang Lưu trữ "đích" trước khi triển khai lên kênh.

Bạn có thể tìm thấy VERSION_ID trong trang tổng quan Lưu trữ của bảng điều khiển Firebase.