Firebase Hosting cung cấp công cụ thông qua cả bảng điều khiển Firebase và CLI Firebase để quản lý các kênh, bản phát hành và phiên bản cho trang web Hosting.
Tổng quan về cơ sở hạ tầng Hosting
Việc tìm hiểu cơ sở hạ tầng Hosting sẽ giúp bạn hiểu được các tuỳ chọn quản lý được mô tả trên trang này.
Mỗi dự án Firebase đều có một trang web Hosting 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, hàm, 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ân phát nội dung cụ thể và cấu hình Hosting.
Hệ phân cấp Lưu trữ Firebase" />
Mỗi trang web Hosting đều có một kênh "trực tiếp" phân phát nội dung và cấu hình Hosting tại (1) các miền con do Firebase cung cấp của trang web (SITE_ID.web.app và SITE_ID.firebaseapp.com) và (2) mọi miền tuỳ chỉnh đã kết nối. Bạn cũng có thể tuỳ ý tạo các kênh "xem trước" phân phát nội dung và cấu hình của riêng chúng tại "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 phân phát được đóng gói vào một đối tượng phiên bản có giá trị nhận dạng duy nhất. Khi bạn triển khai cho trang web của mình, Firebase sẽ tạo một đối tượng bản 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ư người triển khai và thời điểm triển khai.
Trên trang tổng quan Hosting của dự án Firebase, bạn có thể xem toàn bộ nhật ký phát hành của kênh phát trực tiếp trong bảng Nhật ký phát hành. Nếu bạn có nhiều trang web Hosting, hãy nhấp vào Xem cho trang web mà bạn muốn để xem nhật ký phát hành của trang web đó. Nếu bạn có kênh xem trước, thì các kênh đó cũng sẽ xuất hiện trên trang tổng quan Hosting.
Quản lý chế độ cài đặt của kênh
Đối với mỗi kênh trên trang web, bạn có thể kiểm soát chế độ cài đặt của kênh đó. Một số chế độ cài đặt (chẳng hạn như thời gian hết hạn của kênh) chỉ áp dụng cho kênh xem trước.
Giới hạn số lượng bản phát hành cần giữ lại
Mỗi khi bạn triển khai cho một kênh (và tạo một bản phát hành), Hosting sẽ lưu giữ phiên bản liên kết với bản phát hành trước đó trong bộ nhớ 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 mỗi kênh trong dự án, cả kênh phát trực tiếp và kênh xem trước.
Tại sao Hosting giữ lại các bản phát hành trước đó?
Đối với kênh phát trực tiếp, 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, bạn chưa thể khôi phục.Tại sao giới hạn số lượng bản phát hành cần giữ lại?
Tính năng này có thể giúp bạn kiểm soát mức sử dụng của 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ể theo dõi bộ nhớ Hosting trong thẻ Bộ nhớ trên bảng điều khiển.Điều gì sẽ xảy ra khi bạn giới hạn số lượng bản phát hành cần giữ lại?
Khi bạn đặt giới hạn cho số lượng 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 bạn đặt sẽ được lên lịch xoá, bắt đầu từ các bản phát hành cũ nhất.
Sau đây là cách đặt giới hạn bộ nhớ cho bản phát hành của một kênh:
Trong bảng điều khiển Firebase, hãy truy cập vào hộp thoại cài đặt bộ nhớ phát hành:
Đối với kênh phát trực tiếp
Trong bảng Nhật ký 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 chứa kênh xem trước, hãy nhấp vào biểu tượng , rồi chọn Cài đặt kênh.
Nhập số lượng bản phát hành mà bạn muốn giữ lại, sau đó nhấp vào Lưu.
Đặt thời gian hết hạn cho 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 phát trực tiếp của trang web sẽ không bao giờ hết hạn.
Khi một 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 kết sẽ được lên lịch xoá trong vòng 24 giờ. URL xem trước được liên kết cũng bị huỷ kích hoạt. Trường hợp ngoại lệ đối với việc xoá 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 nhân bản 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 để kiểm soát thời điểm hết hạn của một kênh:
Bảng điều khiển Firebase
Trong hàng chứa kênh xem trước, hãy nhấp vào , rồi chọn Cài đặt kênh. Nhập ngày và giờ hết hạn.Firebase CLI
Khi bạn triển khai cho kênh xem trước, hãy truyền cờ--expires DURATION, ví dụ:firebase hosting:channel:deploy new-awesome-feature --expires 7d
Thời gian hết hạn có thể lên đến 30 ngày kể từ ngày triển khai. Sử dụng
hcho giờ,dcho ngày vàwcho tuần (ví dụ:12h,7d,2wtươ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 một phiên bản đã triển khai từ một kênh sang một kênh khác. Bạn có thể nhân bản trên các kênh phát trực tiếp hoặc xem trước, trên các trang web Hosting hoặc thậm chí trên các dự án Firebase.
Lệnh sao chép cũng triển khai cho kênh "đích" để nội dung và cấu hình Hosting được sao chép tự động phân phát 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 nội dung chính xác mà bạn đã xem và/hoặc thử nghiệm trên một kênh khác. Sau đây là một số ví dụ:
Sao chép từ kênh xem trước "Hỏi đáp" sang kênh phát trực tiếp của trang web (sẽ phát trực tiếp!)
Sao chép từ kênh trực tiếp của trang web sang kênh xem trước "gỡ lỗi" (chẳng hạn như trước khi khôi phục)
Sao chép từ một kênh trong dự án Firebase "thử nghiệm" sang một kênh xem trước trong dự án Firebase "phiên bản chính thức"
Để nhân bản 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 nội dung sau:
SOURCE_SITE_ID và TARGET_SITE_ID: Đây là mã nhận dạng của các trang web Hosting chứa các kênh.
- Đối với trang web Hosting mặc định, hãy sử dụng mã dự án Firebase.
- Bạn có thể chỉ định các trang web Hosting trong cùng một dự án Firebase hoặc thậm chí trong nhiều dự án Firebase.
SOURCE_CHANNEL_ID và TARGET_CHANNEL_ID: Đây là giá trị nhận dạng cho các kênh.
- Đối với kênh phát trực tiếp, hãy sử dụng
livelàm mã nhận dạng kênh. - Nếu kênh "đích" đã chỉ định chưa tồn tại, lệnh này sẽ tạo kênh trước khi triển khai kênh đó.
- Đối với kênh phát trực tiếp, hãy sử dụng
Khôi phục về phiên bản trước của trang web
Bạn có thể quay lại để phân phát phiên bản trước của kênh phát trực tiếp trên trang web. Thao tác này rất hữu ích nếu bản phát hành hiện tại của bạn gặp vấn đề và bạn muốn quay lại để phân phát phiên bản trang web đã biết là hoạt động. Hoặc có thể trang web của bạn đã phân phát nội dung tạm thời cho một ngày lễ hoặc sự kiện đặc biệt, nhưng giờ đây bạn muốn quay lại phân phát nội dung "thông thường".
Bằng cách khôi phục, bạn sẽ tạo một bản phát hành mới phân phát cùng một phiên bản nội dung như bản phát hành trước. Trong bảng Nhật ký phát hành, cả hai bản phát hành sẽ liệt kê cùng một giá trị nhận dạng phiên bản.
Sau đây là cách khôi phục:
Trong bảng điều khiển Firebase, trong bảng Nhật ký phát hành cho trang web của bạn, hãy di chuột qua mục bản phát hành trước đó mà bạn muốn quay lại.
Nhấp vào , rồi chọn Huỷ bỏ.
Xoá bản phát hành theo cách thủ công
Bạn có thể phải xoá bản phát hành khỏi kênh phát trực tiếp theo cách thủ công để giải phóng dung lượng lưu trữ Hosting cho dự án của mình. Bạn chỉ có thể xoá các bản phát hành trước đó, chứ không thể xoá bản phát hành đang được phân phát trên trang web đang hoạt động.
Khi xoá một bản phát hành, bạn thực sự đang xoá nội dung của bản phát hành đó. Nội dung này sẽ được lên lịch xoá trong vòng 24 giờ. Bản thân đối tượng phát hành vẫn được giữ lại để bạn vẫn có thể xem siêu dữ liệu của đối tượng đó (người triển khai và thời điểm triển khai).
Sau đây là cách xoá bản phát hành:
Trong bảng điều khiển Firebase, trong bảng Nhật ký 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 xoá.
Nhấp vào , rồi chọn Xoá.
Xoá tệp theo cách thủ công
Trong Firebase Hosting, cách chính để xoá các tệp đã chọn khỏi một trang web đã triển khai là xoá các tệp đó trên máy rồi triển khai lại.
Xoá 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 mà bạn muốn xem trước. Trong chế độ xem này, bạn có thể xem, xoá và huỷ các bản phát hành và lượt triển khai mới nhất liên kết với kênh cụ thể. Bạn có thể xoá kênh xem trước, nhưng không thể xoá kênh trực tiếp của trang web.
Khi bạn xoá một 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 kết sẽ được lên lịch xoá trong vòng 24 giờ. URL xem trước được liên kết cũng bị huỷ kích hoạt. Trường hợp ngoại lệ đối với việc xoá 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 nhân bản 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 xoá kênh dùng thử:
Bảng điều khiển Firebase
Trong hàng chứa kênh xem trước, hãy nhấp vào , sau đó chọn Xoá 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
Các lệnh dòng lệnh để xem trước kênh và nhân bản
Các lệnh cho kênh xem trước
Tất cả các lệnh cho kênh xem trước đều hỗ trợ các mục tiêu triển khai nếu bạn có nhiều trang web Hosting.
| Lệnh | Mô tả |
|---|---|
firebase hosting:channel:create CHANNEL_ID
|
Tạo một kênh xem trước mới trong trang web Hosting mặc định bằng cách sử dụng Lệnh này không triển khai cho kênh. |
firebase hosting:channel:delete CHANNEL_ID
|
Xoá kênh xem trước đã chỉ định Bạn không thể xoá kênh phát trực tiếp của một trang web. |
firebase hosting:channel:deploy CHANNEL_ID
|
Triển khai nội dung và cấu hình Hosting của bạn đến 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 web Hosting mặc định trước khi triển khai 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 Hosting mặc định |
firebase hosting:channel:open CHANNEL_ID
|
Mở trình duyệt đến 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 để sao chép phiên bản
| Lệnh | Mô tả |
|---|---|
firebase hosting:clone \
|
Sao chép phiên bản được triển khai gần đây nhất trên kênh "nguồn" đã chỉ định sang kênh "đích" đã chỉ định Lệnh này cũng triển khai cho kênh "đích" đã chỉ định. Nếu kênh "target" (mục tiêu) chưa tồn tại, lệnh này sẽ tạo một kênh xem trước mới trong trang web Hosting "target" (mục tiêu) trước khi triển khai kênh. |
firebase hosting:clone \
|
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 cho kênh "đích" đã chỉ định. Nếu kênh "target" (mục tiêu) chưa tồn tại, lệnh này sẽ tạo một kênh xem trước mới trong trang web Hosting "target" (mục tiêu) trước khi triển khai kênh. Bạn có thể tìm thấy |