Firebase App Hosting được thiết kế riêng để hỗ trợ hoạt động phát triển ứng dụng web hiện đại tập trung vào khung. Hãy dùng trang này làm tài liệu tham khảo về các công cụ và khung hình mà App Hosting hỗ trợ trực tiếp, cũng như là điểm khởi đầu để tìm hiểu về các khung hình và công cụ có liên quan.
Khung web và App Hosting
App Hosting cung cấp 2 cấp độ hỗ trợ chung cho các khung web hiện đại: hỗ trợ triển khai và tạo cấu hình sẵn, cũng như hỗ trợ ở cấp cộng đồng thông qua các đóng góp mã nguồn mở tuân thủ quy cách gói đầu ra. Trong cả hai trường hợp, thành phần bộ chuyển đổi khung cho phép tích hợp một khung cụ thể với App Hosting.
Các khung có hỗ trợ tạo và triển khai được định cấu hình sẵn
Với chế độ hỗ trợ tạo và triển khai được định cấu hình sẵn, Firebase sẽ xác định khung mà bạn đang dùng bằng cách kiểm tra tệp package-lock.json hoặc tệp khoá khác, đồng thời tối ưu hoá quy trình tạo và triển khai cho ứng dụng của bạn. Google cam kết duy trì chế độ hỗ trợ cho các khung này và nhóm hỗ trợ của Firebase có thể chấp nhận báo cáo vấn đề cũng như yêu cầu về tính năng.
Chúng tôi cung cấp cấp độ hỗ trợ này cho:
- Next.js
- Angular
Hãy xem lịch hỗ trợ để biết thông tin chi tiết về các phiên bản cụ thể và mức độ hỗ trợ.
Nếu bạn cố gắng triển khai một ứng dụng Node.js bị thiếu tệp khoá, thì App Hosting sẽ không thể tạo và chạy ứng dụng của bạn. Bạn có thể tạo package-lock.json bằng cách chạy npm install trong thư mục gốc.
Khung được cộng đồng hỗ trợ
Ngoài Next.js và Angular, App Hosting cũng hỗ trợ mọi khung web có thể cung cấp đầu ra bản dựng phù hợp với quy cách gói đầu ra của chúng tôi. Tác giả khung có thể tận dụng quy cách gói đầu ra để đảm bảo khung của họ được App Hosting hỗ trợ. Ví dụ: khung Nuxt phổ biến được nhóm Nitro hỗ trợ. Nhóm này đã tạo một bộ chuyển đổi Firebase để cho phép triển khai ứng dụng Nuxt trên App Hosting.
Nếu muốn xem các khung hình khác được App Hosting hỗ trợ, bạn có thể tạo một bộ chuyển đổi khung hình hoặc liên hệ với người duy trì khung hình để chuyển đổi đầu ra bản dựng sang định dạng App Hosting. Các bộ chuyển đổi Next.js và Angular là những ví dụ tham chiếu hữu ích cho bất kỳ ai tạo bộ chuyển đổi.
Bạn có thể xem thông tin về các khung được cộng đồng hỗ trợ trên Firebase Open Source. Các vấn đề và yêu cầu về tính năng đối với những khung hình được cộng đồng hỗ trợ cần được gửi đến cộng đồng nguồn mở hoặc tác giả của khung hình. Trong một số trường hợp, Google có thể hỗ trợ, nhưng cộng đồng là tuyến hỗ trợ đầu tiên cho những bộ chuyển đổi này.
App Hosting bộ chuyển đổi khung
Trong App Hosting, khả năng hỗ trợ cho cả khung được định cấu hình trước và khung do cộng đồng hỗ trợ được cung cấp thông qua các bộ chuyển đổi khung. Các bộ chuyển đổi khung App Hosting có hai vai trò chính:
- Chúng phân tích cú pháp mã nguồn và mọi tệp cấu hình dành riêng cho khung (chẳng hạn như
next.config.js) rồi tạo một gói đầu ra mà phần còn lại của cơ sở hạ tầng App Hosting có thể xử lý. - Các công cụ này chạy lệnh tạo của ứng dụng để tạo tài sản tĩnh và tạo một phiên bản được tối ưu hoá của ứng dụng cho bản phát hành công khai.
Bộ chuyển đổi khung sẽ tạo ứng dụng Node.js của bạn bằng npm run build, hoạt động hiệu quả nhất với các tập lệnh bản dựng mặc định cho từng khung: next build cho Next.js và ng build cho Angular. App Hosting sẽ cố gắng tạo bản dựng bằng các lệnh tạo bản dựng tuỳ chỉnh, nhưng không thể đảm bảo thành công một cách đáng tin cậy. Bạn có thể ghi đè tập lệnh bản dựng và tập lệnh chạy trong apphosting.yaml.
Nguồn cho bộ chuyển đổi Next.js và Angular có trong firebase-framework-tools.
Thời gian chạy cho App Hosting
Sau khi được App Hosting tạo và triển khai, ứng dụng Node.js của bạn sẽ chạy trong một bản sửa đổi Cloud Run. Theo đó, phiên bản thời gian chạy cho ứng dụng của bạn phải nằm trong cả phạm vi được hỗ trợ của Cloud Run và phạm vi của khung web mà bạn đã chọn. Đối với chế độ hỗ trợ được định cấu hình sẵn cho Angular và Next.js, điều này có nghĩa là các phiên bản Node.js sau đây được hỗ trợ:
- Next.js 13.5.x trở lên
- Angular 18.2.x trở lên
- Node.js 18 trở lên
App Hosting không tự động cung cấp dịch vụ hỗ trợ đang hoạt động cho các phiên bản khung mới phát hành. Các phiên bản mới hơn phiên bản "đang hoạt động" mà chúng tôi hiện chỉ định sẽ được coi là ở trạng thái "xem trước" cho đến khi chính thức được đánh dấu là "đang hoạt động" đối với App Hosting.
App Hosting hỗ trợ dài hạn (LTS) cho phiên bản phụ mới nhất của một bản phát hành chính trong một năm kể từ thời gian hỗ trợ đang hoạt động, miễn là bạn liên tục cập nhật lên các bản phát hành bản vá mới nhất trong phiên bản phụ đó. Hãy tham khảo các bảng sau để biết thông tin chi tiết về Next.js và Angular.
Lịch hỗ trợ Next.js
| Phiên bản | Trạng thái | Ngừng sử dụng |
|---|---|---|
| 13.5.x | lts | 2026-10-9 |
| 14.2.x | lts | 2026-10-9 |
| 15.0.x | hoạt động | không trước ngày 2025-10-9 |
| 15.1.x | hoạt động | không trước ngày 2025-10-9 |
| 15.2.x | hoạt động | - |
Lịch hỗ trợ Angular
| Phiên bản | Trạng thái | Ngừng sử dụng |
|---|---|---|
| 18.2.x | lts | 2026-10-9 |
| 19.0.x | hoạt động | không trước ngày 2025-10-9 |
| 19.1.x | hoạt động | không trước ngày 2025-10-9 |
| 19.2.x | hoạt động | - |
Trình quản lý gói
App Hosting sử dụng Cloud Native Buildpacks để thực thi quá trình cài đặt các phần phụ thuộc và tạo ứng dụng bằng npm, yarn hoặc pnpm. Các trình quản lý gói khác như JSR không được hỗ trợ.
NPM
- NPM là trình quản lý gói mặc định.
- Các phần phụ thuộc không phải là bản phát hành công khai sẽ bị cắt bớt sau khi bản dựng được tạo thành công.
- Bạn có thể chỉ định phần phiên bản npm bằng cách sử dụng trường
engines.npmtrong tệppackage.json.
Sợi
- Yarn sẽ được dùng thay thế khi bạn thêm tệp
yarn.lockvào dự án. - Bạn có thể chỉ định phiên bản yarn để sử dụng trong trường
engines.yarnhoặcpackageManagercủa tệppackage.json. - App Hosting hỗ trợ chế độ Yarn2 PnP.
Pnpm
- Pnpm sẽ được dùng thay thế khi bạn đưa tệp
pnpm-lock.yamlvào dự án. - Bạn có thể chỉ định một phiên bản pnpm trong trường
engines.pnpmhoặcpackageManagercủa tệppackage.json. - Để xem ví dụ minh hoạ, hãy xem sample-node-pnpm. ứng dụng.
Monorepo cho App Hosting
App Hosting hỗ trợ các ứng dụng dựa trên Nx. Hãy xem phần Sử dụng monorepo với App Hosting để biết hướng dẫn chi tiết.
Các phiên bản Nx sau đây được hỗ trợ:
| Phiên bản | Trạng thái | Ngừng sử dụng |
|---|---|---|
| 19.5.x | bảo trì | 2025-10-9 |
| 19.6.x | bảo trì | 2025-10-9 |
| 19.7.x | bảo trì | 2025-10-9 |
| 19.8.x | lts | 2026-10-9 |
| 20.0.x | hoạt động | không trước ngày 2025-10-9 |
| 20.1.x | hoạt động | không trước ngày 2025-10-9 |
| 20.2.x | hoạt động | không trước ngày 2025-10-9 |
| 20.3.x | hoạt động | không trước ngày 2025-10-9 |
| 20.4.x | hoạt động | không trước ngày 2025-10-9 |
| 20.5.x | hoạt động | không trước ngày 2025-10-9 |
| 20.6.x | hoạt động | không trước ngày 2025-10-9 |
| 20.7.x | hoạt động | — |
Nếu bạn cần được hỗ trợ cho các loại không gian làm việc monorepo khác, hãy cho chúng tôi biết tại Firebase UserVoice.