Tính năng Lưu trữ ứng dụng xử lý một loạt các tác vụ phức tạp ở chế độ nền để đơn giản hoá quá trình triển khai ứng dụng. Trang này mô tả các phần chính của luồng tác vụ đó, cung cấp thông tin về các điểm mà bạn có thể muốn tuỳ chỉnh luồng tuỳ thuộc vào nhu cầu của ứng dụng.
Hỗ trợ khung
Dịch vụ Lưu trữ ứng dụng cung cấp bản dựng không cần cấu hình và hỗ trợ triển khai các ứng dụng web được phát triển trong các khung sau:
- Next.js 13 trở lên
- Góc 17.2 trở lên
Tính năng Lưu trữ ứng dụng xác định khung bạn đang sử dụng bằng cách kiểm tra tệp package-lock.json hoặc tệp khoá khác trong kho lưu trữ của bạn. Nếu bạn cố gắng triển khai một ứng dụng Node.js đang thiếu tệp khoá, thì tính năng Lưu trữ ứng dụng 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.
Bộ chuyển đổi khung Lưu trữ ứng dụng có hai vai trò chính:
- Các trình này 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) để hiểu hành vi được định cấu hình của ứng dụng. - Chúng chạy lệnh bản dựng của ứng dụng để tạo thành phần tĩnh và tạo một phiên bản ứng dụng được tối ưu hoá để phát hành công khai.
Bộ chuyển đổi khung sẽ tạo ứng dụng Node.js bằng npm run build. Bộ chuyển đổi khung này hoạt động tốt nhất
với các tập lệnh bản dựng mặc định cho mỗi khung: next build cho Next.js và
ng build cho Angular. Dịch vụ Lưu trữ ứng dụng sẽ cố gắng tạo các bản dựng bằng các lệnh 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.
Cách hoạt động của tính năng tích hợp kho lưu trữ ứng dụng Lưu trữ ứng dụng
Mối kết nối quan trọng giữa kho lưu trữ GitHub và phần phụ trợ của tính năng Lưu trữ ứng dụng do Developer Connect (Kết nối nhà phát triển) xử lý. Đây là nền tảng kết nối của Google Cloud dành cho các công cụ DevOps bên ngoài. Trong quá trình tạo phần phụ trợ Lưu trữ ứng dụng, quy trình làm việc trên giao diện người dùng của Developer Connect sẽ hướng dẫn bạn cài đặt ứng dụng Firebase GitHub. Các bước chính trong quy trình này là:
- Bạn cấp cho Developer Connect vai trò Quản trị viên trình quản lý bí mật. Điều này cho phép hệ thống lưu trữ thông tin xác thực một cách an toàn dưới dạng "bí mật" trong Cloud Secret Manager (Trình quản lý bí mật của đám mây).
- Bạn cho phép ứng dụng Firebase GitHub truy cập vào kho lưu trữ GitHub của bạn.
- Developer Connect lưu trữ một mã thông báo uỷ quyền GitHub chuyên dụng trong kho lưu trữ bí mật của người quản lý dự án; không được sửa đổi hoặc xoá mã thông báo này.
Ngoài ra, tính năng Lưu trữ ứng dụng còn tích hợp với API kiểm tra GitHub để cung cấp quy trình kiểm tra cho bản phát hành. Bước kiểm tra này giúp bạn xem trạng thái phát hành trong GitHub và gỡ lỗi quá trình triển khai nếu xảy ra lỗi.
Tích hợp với Firebase và các dịch vụ khác của Google
Tính năng Lưu trữ ứng dụng thiết lập cả môi trường bản dựng và môi trường thời gian chạy để bạn có thể khởi động SDK quản trị Firebase bằng Thông tin xác thực mặc định của ứng dụng Google. Bằng cách đó, phần phụ trợ của bạn có thể giao tiếp với các sản phẩm khác của Firebase trong cả quá trình xây dựng và triển khai.
Tài khoản dịch vụ phụ trợ của tính năng Lưu trữ ứng dụng
Trong quá trình tạo bản dựng và trong thời gian chạy, phần phụ trợ của tính năng Lưu trữ ứng dụng sẽ xác thực với các dịch vụ khác của Google bằng một tài khoản dịch vụ. Tài khoản dịch vụ mặc định cho những mục đích này sẽ được tạo khi bạn bật tính năng Lưu trữ ứng dụng trong dự án Firebase lần đầu tiên:
firebase-app-hosting-compute@PROJECT ID.iam.gserviceaccount.com
Theo mặc định, tài khoản dịch vụ này áp dụng cho tất cả các phần phụ trợ và có một nhóm quyền tối thiểu để cho phép bạn tạo, chạy và giám sát ứng dụng. Ngoài ra, tài khoản này còn có quyền xác thực SDK dành cho quản trị viên bằng Thông tin xác thực mặc định của ứng dụng để thực hiện các thao tác như tải dữ liệu từ Cloud Firestore. Xem các vai trò Lưu trữ ứng dụng Firebase.
Nếu ứng dụng của bạn cần tương tác với các dịch vụ bổ sung của Google tại thời điểm xây dựng hoặc từ một phần phụ trợ đang chạy, thì bạn có thể tuỳ chỉnh tài khoản dịch vụ mặc định bằng cách thêm vai trò. Ví dụ: nếu ứng dụng của bạn yêu cầu quyền cho Vertex AI, thì bạn có thể cần thêm roles/aiplatform.user hoặc một số vai trò liên quan.
Các thuật ngữ và định nghĩa chính
- Phần phụ trợ: Tập hợp các tài nguyên được quản lý do tính năng Lưu trữ ứng dụng tạo ra để tạo và chạy ứng dụng web của bạn.
- Phát hành: Một phiên bản cụ thể của ứng dụng đang hoạt động, được liên kết với một git cam kết.
- Nhánh trực tiếp: Nhánh của kho lưu trữ GitHub được triển khai cho URL đang hoạt động. Thông thường, đó là nhánh có các nhánh tính năng hoặc nhánh phát triển được hợp nhất.
Các vấn đề và hạn chế đã biết
Bản xem trước Lưu trữ ứng dụng có một số hạn chế đã biết:
- Chưa thể tối ưu hoá hình ảnh.
- Trong một số trường hợp, phần phụ trợ Lưu trữ ứng dụng có thể trả về thông báo
Intermittent connection errortại URL của ứng dụng. Chúng tôi sẽ cung cấp bản sửa lỗi trong bản phát hành sau này. - Các tiêu đề bộ nhớ đệm được sửa đổi để giới hạn bộ nhớ đệm CDN ở mức 60 giây. Trong tương lai, khi tính năng Lưu trữ ứng dụng có thể nhanh chóng xoá hoàn toàn bộ nhớ đệm khi triển khai, giới hạn này sẽ được gỡ bỏ.
- Các tệp tĩnh không được lưu vào bộ nhớ đệm được phân phát ngoài Cloud Run. Trong các bản phát hành sau này, những tệp này sẽ được lưu trữ và phân phát từ nguồn gốc Lưu trữ ứng dụng để có hiệu suất tốt hơn.
- Miền con ký tự đại diện dưới dạng miền tuỳ chỉnh sẽ được cung cấp trong bản phát hành sau này.
- Các SKU lưu trữ ứng dụng có thể sẽ không xuất hiện trên trang sử dụng phụ trợ trong bảng điều khiển của Firebase. Những nội dung này sẽ có trong bản phát hành sau này.
- Bảng điều khiển của Firebase có thể liên tục hiển thị lỗi "không tìm thấy bản dựng và không hợp lệ" khi tạo phần phụ trợ.
- Các dự án có tệp
package.jsonlồng nhau hiện không được hỗ trợ, bất kểroot\_directoryđược định cấu hình bằng bảng điều khiển của Firebase hay CLI. Chúng tôi sẽ cung cấp bản sửa lỗi trong bản phát hành sau này. - Hiện tại, tất cả phần phụ trợ trong cùng một dự án đều dùng chung một tổ chức/tài khoản GitHub. Các tài khoản này có thể được kết nối với nhiều kho lưu trữ thuộc tổ chức/tài khoản đó. Để tạo các phần phụ trợ được kết nối với nhiều tài khoản GitHub, hãy đặt các phần phụ trợ đó vào những dự án riêng biệt.
- Hiện tại, chúng tôi chỉ hỗ trợ khu vực
us-central1.