Bắt đầu sử dụng tính năng Lưu trữ ứng dụng

Với ứng dụng Next.js hoặc Angular hiện có (Next.js phiên bản 13 trở lên hoặc Angular 17.2 trở lên) trong kho lưu trữ GitHub, bạn có thể bắt đầu sử dụng tính năng Lưu trữ ứng dụng đơn giản như việc tạo phần phụ trợ Lưu trữ ứng dụng rồi bắt đầu triển khai bằng cách đẩy đến nhánh trực tiếp. Nếu bạn chưa có ứng dụng, hãy dùng một trong các ứng dụng mẫu của chúng tôi để thực hiện các bước được mô tả trong hướng dẫn này.

Trước khi bắt đầu

Trước khi có thể thiết lập tính năng Lưu trữ ứng dụng Firebase, bạn cần tạo một dự án Firebase (nếu bạn chưa có) và nâng cấp lên Gói linh hoạt.

Cách tạo dự án:

  1. Trong bảng điều khiển của Firebase, hãy nhấp vào Thêm dự án.

    • Để thêm tài nguyên Firebase vào một dự án Google Cloud hiện có, hãy nhập tên dự án hoặc chọn dự án đó trên trình đơn thả xuống.

    • Để tạo dự án mới, hãy nhập tên dự án mà bạn muốn. Bạn cũng có thể tuỳ ý chỉnh sửa mã dự án xuất hiện bên dưới tên dự án.

  2. Nếu được nhắc, hãy xem xét và chấp nhận các điều khoản của Firebase.

  3. Nhấp vào Tiếp tục.

  4. (Không bắt buộc) Thiết lập Google Analytics cho dự án của bạn, giúp bạn có được trải nghiệm tối ưu khi sử dụng bất kỳ sản phẩm Firebase nào sau đây:

    Chọn một tài khoản Google Analytics hiện có hoặc tạo một tài khoản mới.

    Nếu bạn tạo một tài khoản mới, hãy chọn vị trí báo cáo Analytics, sau đó chấp nhận các chế độ cài đặt cách chia sẻ dữ liệu và các điều khoản của Google Analytics cho dự án của bạn.

  5. Nhấp vào Tạo dự án (hoặc Thêm Firebase, nếu bạn đang sử dụng một dự án hiện có trên Google Cloud).

Firebase tự động cấp phép các tài nguyên cho dự án Firebase của bạn. Khi quá trình này hoàn tất, bạn sẽ được đưa đến trang tổng quan cho dự án Firebase của mình trong bảng điều khiển của Firebase.

Bước 0 (không bắt buộc): Tạo kho lưu trữ GitHub và ứng dụng web

Nếu bạn chưa có một ứng dụng web nằm trong kho lưu trữ GitHub hoặc nếu bạn muốn thử quy trình này bằng một ứng dụng mẫu, hãy bắt đầu bằng cách khởi chạy một trong các mẫu của chúng tôi, cho Next.js hoặc Angular:

npm init @apphosting

Bạn có thể chạy ứng dụng mẫu cục bộ bằng next dev hoặc ng start. Để tiếp tục, hãy tạo một kho lưu trữ GitHub mới và đẩy mã mẫu mới khởi tạo vào kho lưu trữ đó.

Bước 1: Tạo phần phụ trợ Lưu trữ ứng dụng

Phần phụ trợ Lưu trữ ứng dụng là tập hợp tài nguyên được quản lý mà tính năng Lưu trữ ứng dụng tạo ra để xây dựng và chạy ứng dụng web của bạn. Bạn có thể tạo và liệt kê các phần phụ trợ Lưu trữ ứng dụng bằng bảng điều khiển của Firebase hoặc CLI của Firebase.

Bảng điều khiển của Firebase: Trên trình đơn Build (Tạo), hãy chọn App lưu trữ rồi chọn Get started (Bắt đầu).

CLI: (Phiên bản 3.9 trở lên) Để tạo một phần phụ trợ, hãy chạy lệnh sau từ gốc của thư mục dự án cục bộ:

firebase apphosting:backends:create --project PROJECT_ID --location us-central1

Đối với cả bảng điều khiển hoặc CLI, hãy làm theo lời nhắc để chỉ định tên cho phần phụ trợ, để thiết lập kết nối GitHub và định cấu hình các chế độ cài đặt triển khai cơ bản sau đây:

  • Đặt thư mục gốc của ứng dụng (mặc định là /)

    Đây thường là nơi lưu trữ tệp package.json.

  • Đặt nhánh trực tiếp

    Đây là 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 mà các nhánh tính năng hoặc nhánh phát triển được hợp nhất.

  • Chấp nhận hoặc từ chối chế độ phát hành tự động

    Tính năng tự động phát hành được bật theo mặc định. Sau khi hoàn tất quá trình tạo phần phụ trợ, bạn có thể chọn triển khai ứng dụng của mình cho tính năng Lưu trữ ứng dụng ngay lập tức.

Bước 2: Xem ứng dụng đã triển khai

Khi bạn tạo phần phụ trợ, Firebase sẽ cung cấp cho bạn một miền con không mất phí để người dùng cuối có thể truy cập vào Ứng dụng web của bạn. Định dạng của miền con là backend-id--project-id.us-central1.hosted.app.

Để xem URL của ứng dụng web, hãy kiểm tra bảng điều khiển của Firebase hoặc chạy lệnh CLI sau:

firebase apphosting:backends:get --project PROJECT_ID {BACKEND_ID} --location us-central1

Bước 3: Kích hoạt hoạt động phát hành bằng cách áp dụng một thay đổi

Sau khi phần phụ trợ được tạo và bạn có URL đang hoạt động, bạn có thể kích hoạt việc phát hành phiên bản mới của Ứng dụng web mỗi khi đẩy các thay đổi vào nhánh trực tiếp của kho lưu trữ GitHub. Để kiểm thử chế độ thiết lập Lưu trữ ứng dụng, hãy làm như sau:

  1. Trong GitHub, hãy đẩy một thay đổi vào nhánh trực tiếp của ứng dụng web.
  2. Mở thẻ Lưu trữ ứng dụng trong bảng điều khiển của Firebase rồi chọn Xem trang tổng quan cho phần phụ trợ của bạn. Danh sách bảng cho thấy một cam kết cụ thể liên quan đến hoạt động phát hành do thay đổi của bạn kích hoạt.

Các bước tiếp theo