查看 2022 年 Google I/O 大会上介绍的 Firebase 新动态。了解详情

Trang này được dịch bởi Cloud Translation API.

Tài liệu tham khảo về Firebase CLI

CLI Firebase (GitHub) cung cấp nhiều công cụ để quản lý, xem và triển khai cho các dự án Firebase.

Trước khi sử dụng CLI Firebase, hãy thiết lập dự án Firebase.

Thiết lập hoặc cập nhật CLI

Cài đặt CLI Firebase

Bạn có thể cài đặt CLI Firebase bằng một phương thức phù hợp với hệ điều hành, cấp độ kinh nghiệm và/hoặc trường hợp sử dụng của bạn. Bất kể cách bạn cài đặt CLI, bạn đều có quyền sử dụng cùng một chức năng và lệnh firebase.

Windows macOS Linux

Windows

Bạn có thể cài đặt CLI Firebase cho Windows bằng một trong các tuỳ chọn sau:

Tuỳ chọn	Nội dung mô tả	Đề xuất cho...
tệp nhị phân độc lập	Tải tệp nhị phân độc lập cho CLI. Sau đó, bạn có thể truy cập vào tệp thực thi để mở một shell nơi bạn có thể chạy lệnh `firebase`.	Nhà phát triển mới Nhà phát triển không sử dụng hoặc không quen thuộc với Node.js
npm	Sử dụng npm (Trình quản lý gói nút) để cài đặt CLI và bật lệnh `firebase` có sẵn trên toàn cầu.	Nhà phát triển sử dụng Node.js

tệp nhị phân độc lập

Để tải xuống và chạy tệp nhị phân cho CLI Firebase, hãy làm theo các bước sau:

Tải tệp nhị phân Firebase CLI cho Windows.
Truy cập vào tệp nhị phân để mở một shell nơi bạn có thể chạy lệnh firebase.
Tiếp tục đăng nhập và kiểm thử CLI.

npm

Để sử dụng npm (Trình quản lý gói nút) nhằm cài đặt CLI Firebase, hãy làm theo các bước sau:

Cài đặt Node.js bằng cách sử dụng nvm-windows (Trình quản lý phiên bản nút). Việc cài đặt Node.js sẽ tự động cài đặt các công cụ lệnh npm.

Lưu ý: CLI Firebase yêu cầu Node.js phiên bản 18.0.0 trở lên. Một số tính năng của Firebase có thể yêu cầu các phiên bản Node.js cụ thể. Vì vậy, hãy kiểm tra trang bắt đầu của từng sản phẩm Firebase để biết mọi yêu cầu cụ thể về Node.js.
Cài đặt CLI Firebase thông qua npm bằng cách chạy lệnh sau:
```
npm install -g firebase-tools
```
Lệnh này bật lệnh firebase có sẵn trên toàn cầu.

Lưu ý: Nếu lệnh npm install -g firebase-tools không thành công, bạn có thể cần phải thay đổi quyền npm.
Tiếp tục đăng nhập và kiểm thử CLI.

macOS hoặc Linux

Bạn có thể cài đặt CLI Firebase cho macOS hoặc Linux bằng một trong các tuỳ chọn sau:

Tuỳ chọn	Nội dung mô tả	Đề xuất cho...
tập lệnh cài đặt tự động	Chạy một lệnh tự động phát hiện hệ điều hành của bạn, tải bản phát hành CLI mới nhất xuống, sau đó bật lệnh `firebase` có sẵn trên toàn cầu.	Nhà phát triển mới Nhà phát triển không sử dụng hoặc không quen thuộc với Node.js Triển khai tự động trong môi trường CI/CD
tệp nhị phân độc lập	Tải tệp nhị phân độc lập cho CLI. Sau đó, bạn có thể định cấu hình và chạy tệp nhị phân cho phù hợp với quy trình làm việc của mình.	Quy trình làm việc có thể tuỳ chỉnh hoàn toàn bằng CLI
npm	Sử dụng npm (Trình quản lý gói nút) để cài đặt CLI và bật lệnh `firebase` có sẵn trên toàn cầu.	Nhà phát triển sử dụng Node.js

tập lệnh cài đặt tự động

Để cài đặt CLI Firebase bằng tập lệnh cài đặt tự động, hãy làm theo các bước sau:

Chạy lệnh cURL sau:
```
curl -sL https://firebase.tools | bash
```
Tập lệnh này tự động phát hiện hệ điều hành của bạn, tải bản phát hành CLI Firebase mới nhất xuống, sau đó bật lệnh firebase có sẵn trên toàn cầu.
Tiếp tục đăng nhập và kiểm thử CLI.

Để biết thêm ví dụ và thông tin chi tiết về tập lệnh cài đặt tự động, hãy tham khảo mã nguồn của tập lệnh tại firebase.tools.

tệp nhị phân độc lập

Để tải xuống và chạy tệp nhị phân cho CLI Firebase dành riêng cho hệ điều hành của bạn, hãy làm theo các bước sau:

Tải tệp nhị phân CLI Firebase xuống cho hệ điều hành của bạn: macOS | Linux
(Không bắt buộc) Thiết lập lệnh firebase có sẵn trên toàn cầu.
1. Tạo tệp nhị phân có thể thực thi bằng cách chạy chmod +x ./firebase_tools.
2. Thêm đường dẫn của tệp nhị phân vào PATH.
Lưu ý: Nếu chọn không thiết lập lệnh firebase, bạn sẽ cần truy cập vào tệp nhị phân mỗi khi muốn chạy lệnh CLI Firebase.
Tiếp tục đăng nhập và kiểm thử CLI.

npm

Để sử dụng npm (Trình quản lý gói nút) nhằm cài đặt CLI Firebase, hãy làm theo các bước sau:

Cài đặt Node.js bằng nvm (Trình quản lý phiên bản Node).
Việc cài đặt Node.js sẽ tự động cài đặt các công cụ lệnh npm.

Lưu ý: CLI Firebase yêu cầu Node.js phiên bản 18.0.0 trở lên. Một số tính năng của Firebase có thể yêu cầu các phiên bản Node.js cụ thể. Vì vậy, hãy kiểm tra trang bắt đầu của từng sản phẩm Firebase để biết mọi yêu cầu cụ thể về Node.js.
Cài đặt CLI Firebase thông qua npm bằng cách chạy lệnh sau:
```
npm install -g firebase-tools
```
Lệnh này bật lệnh firebase có sẵn trên toàn cầu.

Lưu ý: Nếu lệnh npm install -g firebase-tools không thành công, bạn có thể cần phải thay đổi quyền npm.
Tiếp tục đăng nhập và kiểm thử CLI.

Sau khi cài đặt CLI, bạn phải xác thực. Sau đó, bạn có thể xác nhận việc xác thực bằng cách liệt kê các dự án Firebase của mình.

Đăng nhập vào Firebase bằng Tài khoản Google của bạn bằng cách chạy lệnh sau:
```
firebase login
```
Lệnh này kết nối máy cục bộ của bạn với Firebase và cấp cho bạn quyền truy cập vào các dự án Firebase.

Lưu ý: Lệnh firebase login sẽ mở một trang web kết nối với localhost trên máy của bạn. Nếu bạn đang sử dụng máy từ xa và không có quyền truy cập vào localhost, hãy chạy lệnh bằng cờ --no-localhost.
Lưu ý: Bạn cũng có thể sử dụng CLI Firebase với các hệ thống CI.
Kiểm tra để đảm bảo CLI được cài đặt đúng cách và truy cập vào tài khoản của bạn bằng cách liệt kê các dự án Firebase. Chạy lệnh sau:
```
firebase projects:list
```
Danh sách hiển thị phải giống với các dự án Firebase được liệt kê trong bảng điều khiển Firebase.

Cập nhật lên phiên bản CLI mới nhất

Nhìn chung, bạn nên sử dụng phiên bản CLI Firebase mới nhất.

Cách bạn cập nhật phiên bản CLI tuỳ thuộc vào hệ điều hành và cách bạn cài đặt CLI.

Windows

tệp nhị phân độc lập: Tải phiên bản mới xuống, sau đó thay thế phiên bản đó trên hệ thống
npm: Chạy npm install -g firebase-tools

macOS

tập lệnh cài đặt tự động: Chạy curl -sL https://firebase.tools | upgrade=true bash
tệp nhị phân độc lập: Tải phiên bản mới xuống, sau đó thay thế phiên bản đó trên hệ thống
npm: Chạy npm install -g firebase-tools

Linux

tập lệnh cài đặt tự động: Chạy curl -sL https://firebase.tools | upgrade=true bash
tệp nhị phân độc lập: Tải phiên bản mới xuống, sau đó thay thế phiên bản đó trên hệ thống
npm: Chạy npm install -g firebase-tools

Sử dụng CLI với các hệ thống CI

CLI Firebase yêu cầu trình duyệt để hoàn tất quá trình xác thực, nhưng CLI hoàn toàn tương thích với CI và các môi trường không có giao diện người dùng khác.

Trên máy có trình duyệt, hãy cài đặt CLI Firebase.
Bắt đầu quy trình đăng nhập bằng cách chạy lệnh sau:
```
firebase login:ci
```
Truy cập vào URL được cung cấp, sau đó đăng nhập bằng Tài khoản Google.
In một mã làm mới mới. Phiên CLI hiện tại sẽ không bị ảnh hưởng.
Lưu trữ mã thông báo đầu ra theo cách an toàn nhưng có thể truy cập được trong hệ thống CI.
Sử dụng mã thông báo này khi chạy các lệnh firebase. Bạn có thể sử dụng một trong hai tuỳ chọn sau:
- Cách 1: Lưu trữ mã thông báo dưới dạng biến môi trường FIREBASE_TOKEN. Hệ thống của bạn sẽ tự động sử dụng mã thông báo.
- Cách 2: Chạy tất cả lệnh firebase bằng cờ --token TOKEN trong hệ thống CI.
  Đây là thứ tự ưu tiên khi tải mã thông báo: cờ, biến môi trường, dự án Firebase mong muốn.

Khởi chạy dự án Firebase

Nhiều tác vụ phổ biến được thực hiện bằng CLI, chẳng hạn như triển khai cho một dự án Firebase, yêu cầu một thư mục dự án. Bạn thiết lập thư mục dự án bằng lệnh firebase init. Thư mục dự án thường là cùng thư mục với thư mục gốc của công cụ kiểm soát nguồn và sau khi chạy firebase init, thư mục này sẽ chứa tệp cấu hình firebase.json.

Để khởi chạy một dự án Firebase mới, hãy chạy lệnh sau trong thư mục của ứng dụng:

firebase init

Lệnh firebase init sẽ hướng dẫn bạn thiết lập thư mục dự án và một số sản phẩm Firebase. Trong quá trình khởi chạy dự án, CLI Firebase sẽ yêu cầu bạn hoàn thành các nhiệm vụ sau:

Chọn các sản phẩm Firebase mà bạn muốn thiết lập trong dự án Firebase.

Bước này sẽ nhắc bạn thiết lập cấu hình cho các tệp cụ thể cho các sản phẩm đã chọn. Để biết thêm thông tin chi tiết về các cấu hình này, hãy tham khảo tài liệu của sản phẩm cụ thể (ví dụ: Hosting). Xin lưu ý rằng bạn luôn có thể chạy firebase init sau để thiết lập thêm các sản phẩm Firebase.
Chọn một dự án Firebase mặc định.

Bước này liên kết thư mục dự án hiện tại với một dự án Firebase để các lệnh dành riêng cho dự án (chẳng hạn như firebase deploy) chạy trên dự án Firebase thích hợp.

Bạn cũng có thể liên kết nhiều dự án Firebase (chẳng hạn như dự án thử nghiệm và dự án chính thức) với cùng một thư mục dự án.

Khi kết thúc quá trình khởi chạy, Firebase sẽ tự động tạo 2 tệp sau đây ở thư mục gốc của thư mục ứng dụng cục bộ:

Tệp cấu hình firebase.json liệt kê cấu hình dự án của bạn.
Tệp .firebaserc lưu trữ bí danh của dự án.

Tệp `firebase.json`

Lệnh firebase init sẽ tạo một tệp cấu hình firebase.json ở gốc thư mục dự án.

Bạn cần có tệp firebase.json để triển khai thành phần bằng CLI Firebase vì tệp này chỉ định những tệp và chế độ cài đặt nào trong thư mục dự án được triển khai cho dự án Firebase. Vì một số chế độ cài đặt có thể được xác định trong thư mục dự án hoặc bảng điều khiển Firebase, hãy đảm bảo bạn giải quyết mọi xung đột triển khai tiềm ẩn.

Bạn có thể định cấu hình hầu hết các tuỳ chọn Firebase Hosting trực tiếp trong tệp firebase.json. Tuy nhiên, đối với các dịch vụ Firebase khác có thể được triển khai bằng CLI Firebase, lệnh firebase init sẽ tạo các tệp cụ thể để bạn có thể xác định chế độ cài đặt cho các dịch vụ đó, chẳng hạn như tệp index.js cho Cloud Functions. Bạn cũng có thể thiết lập các trình bổ trợ triển khai trước hoặc sau khi triển khai trong tệp firebase.json.

Sau đây là ví dụ về tệp firebase.json có chế độ cài đặt mặc định nếu bạn chọn Firebase Hosting, Cloud Firestore và Cloud Functions for Firebase (với các tuỳ chọn nguồn TypeScript và tìm lỗi mã nguồn được chọn) trong quá trình khởi chạy.

{
  "hosting": {
    "public": "public",
    "ignore": [
      "firebase.json",
      "**/.*",
      "**/node_modules/**"
    ]
  },
  "firestore": {
      "rules": "firestore.rules",
      "indexes": "firestore.indexes.json"
  },
  "functions": {
    "predeploy": [
      "npm --prefix \"$RESOURCE_DIR\" run lint",
      "npm --prefix \"$RESOURCE_DIR\" run build"
    ]
  }
}

Mặc dù firebase.json được sử dụng theo mặc định, nhưng bạn có thể truyền cờ --config PATH để chỉ định một tệp cấu hình thay thế.

Cấu hình cho nhiều cơ sở dữ liệu Cloud Firestore

Khi bạn chạy firebase init, tệp firebase.json sẽ chứa một khoá firestore duy nhất tương ứng với cơ sở dữ liệu mặc định của dự án, như minh hoạ ở trên.

Nếu dự án của bạn chứa nhiều cơ sở dữ liệu Cloud Firestore, hãy chỉnh sửa tệp firebase.json để liên kết các tệp nguồn chỉ mục cơ sở dữ liệu và Cloud Firestore Security Rules khác nhau với từng cơ sở dữ liệu. Sửa đổi tệp bằng một mảng JSON, trong đó mỗi cơ sở dữ liệu có một mục.

      "firestore": [
        {
          "database": "(default)",
          "rules": "firestore.default.rules",
          "indexes": "firestore.default.indexes.json"
        },
        {
          "database": "ecommerce",
          "rules": "firestore.ecommerce.rules",
          "indexes": "firestore.ecommerce.indexes.json"
        }
      ],

Các tệp Cloud Functions cần bỏ qua khi triển khai

Tại thời điểm triển khai hàm, CLI sẽ tự động chỉ định danh sách các tệp trong thư mục functions cần bỏ qua. Điều này giúp ngăn việc triển khai các tệp không liên quan ở phần phụ trợ có thể làm tăng kích thước dữ liệu của quá trình triển khai.

Danh sách các tệp bị bỏ qua theo mặc định, hiển thị ở định dạng JSON, bao gồm:

"ignore": [
  ".git",
  ".runtimeconfig.json",
  "firebase-debug.log",
  "firebase-debug.*.log",
  "node_modules"
]

Nếu bạn thêm các giá trị tuỳ chỉnh của riêng mình cho ignore trong firebase.json, hãy nhớ giữ lại (hoặc thêm nếu thiếu) danh sách tệp hiển thị ở trên.

Quản lý bí danh dự án

Bạn có thể liên kết nhiều dự án Firebase với cùng một thư mục dự án. Ví dụ: bạn có thể muốn sử dụng một dự án Firebase để tạo bản dựng và một dự án khác để phát hành công khai. Bằng cách sử dụng nhiều môi trường dự án, bạn có thể xác minh các thay đổi trước khi triển khai vào môi trường sản xuất. Lệnh firebase use cho phép bạn chuyển đổi giữa các bí danh cũng như tạo bí danh mới.

Thêm bí danh dự án

Khi bạn chọn một dự án Firebase trong quá trình khởi chạy dự án, dự án sẽ tự động được gán bí danh là default. Tuy nhiên, để cho phép các lệnh dành riêng cho dự án chạy trên một dự án Firebase khác nhưng vẫn sử dụng cùng thư mục dự án, hãy chạy lệnh sau trong thư mục dự án:

firebase use --add

Lệnh này sẽ nhắc bạn chọn một dự án Firebase khác và chỉ định dự án đó làm bí danh. Các chỉ định bí danh được ghi vào tệp .firebaserc bên trong thư mục dự án.

Sử dụng bí danh dự án

Để sử dụng các bí danh dự án Firebase đã chỉ định, hãy chạy bất kỳ lệnh nào sau đây trong thư mục dự án của bạn.

Lệnh	Mô tả
`firebase use`	Xem danh sách các bí danh hiện được xác định cho thư mục dự án
`firebase use \ PROJECT_ID\|ALIAS`	Chỉ định tất cả các lệnh chạy trên dự án Firebase đã chỉ định. CLI sử dụng dự án này làm "dự án đang hoạt động".
`firebase use --clear`	Xoá dự án đang hoạt động. Chạy `firebase use PROJECT_ID\|ALIAS` để thiết lập một dự án mới đang hoạt động trước khi chạy các lệnh CLI khác.
`firebase use \ --unalias PROJECT_ALIAS`	Xoá một bí danh khỏi thư mục dự án.

Bạn có thể ghi đè dự án đang được sử dụng làm dự án đang hoạt động bằng cách truyền cờ --project bằng bất kỳ lệnh CLI nào. Ví dụ: Bạn có thể đặt CLI để chạy trên một dự án Firebase mà bạn đã chỉ định bí danh staging. Nếu muốn chạy một lệnh duy nhất đối với dự án Firebase mà bạn đã chỉ định bí danh prod, thì bạn có thể chạy, ví dụ: firebase deploy --project=prod.

Kiểm soát nguồn và bí danh dự án

Nhìn chung, bạn nên kiểm tra tệp .firebaserc trong phần kiểm soát nguồn để cho phép nhóm của bạn chia sẻ bí danh dự án. Tuy nhiên, đối với các dự án nguồn mở hoặc mẫu khởi động, bạn thường không nên kiểm tra trong tệp .firebaserc.

Nếu có một dự án phát triển chỉ dành cho bạn sử dụng, bạn có thể truyền cờ --project với mỗi lệnh hoặc chạy firebase use PROJECT_ID mà không cần chỉ định bí danh cho dự án Firebase.

Phân phát và kiểm thử dự án Firebase trên máy

Bạn có thể xem và kiểm thử dự án Firebase trên các URL được lưu trữ cục bộ trước khi triển khai công khai. Nếu chỉ muốn kiểm thử một số tính năng, bạn có thể sử dụng danh sách được phân tách bằng dấu phẩy trong cờ trên lệnh firebase serve.

Chạy lệnh sau từ gốc thư mục dự án cục bộ nếu bạn muốn thực hiện một trong hai nhiệm vụ sau:

Xem nội dung tĩnh cho ứng dụng được lưu trữ trên Firebase.
Sử dụng Cloud Functions để tạo nội dung động cho Firebase Hosting và bạn muốn sử dụng các hàm HTTP chính thức (đã triển khai) để mô phỏng Hosting trên một URL cục bộ.

firebase serve --only hosting

Mô phỏng dự án bằng các hàm HTTP cục bộ

Chạy bất kỳ lệnh nào sau đây trong thư mục dự án để mô phỏng dự án bằng các hàm HTTP cục bộ.

Để mô phỏng các hàm HTTP và lưu trữ để kiểm thử trên URL cục bộ, hãy sử dụng một trong các lệnh sau:
```
firebase serve
```
```
firebase serve --only functions,hosting // uses a flag
```
Để chỉ mô phỏng các hàm HTTP, hãy sử dụng lệnh sau:
```
firebase serve --only functions
```

Kiểm thử từ các thiết bị cục bộ khác

Theo mặc định, firebase serve chỉ phản hồi các yêu cầu từ localhost. Điều này có nghĩa là bạn sẽ có thể truy cập vào nội dung được lưu trữ từ trình duyệt web của máy tính nhưng không thể truy cập từ các thiết bị khác trên mạng của bạn. Nếu bạn muốn kiểm thử từ các thiết bị cục bộ khác, hãy sử dụng cờ --host, như sau:

firebase serve --host 0.0.0.0  // accepts requests to any host

Triển khai cho một dự án Firebase

Giao diện dòng lệnh Firebase quản lý việc triển khai mã và tài sản cho dự án Firebase, bao gồm:

Bản phát hành mới của các trang web Firebase Hosting
Cloud Functions for Firebase mới, đã cập nhật hoặc hiện có
Giản đồ và trình kết nối mới hoặc đã cập nhật cho Firebase Data Connect
Quy tắc cho Firebase Realtime Database
Quy tắc cho Cloud Storage for Firebase
Quy tắc cho Cloud Firestore
Chỉ mục cho Cloud Firestore

Để triển khai cho một dự án Firebase, hãy chạy lệnh sau từ thư mục dự án:

firebase deploy

Bạn có thể tuỳ ý thêm nhận xét vào từng lần triển khai. Bình luận này sẽ xuất hiện cùng với thông tin triển khai khác trên trang Firebase Hosting của dự án. Ví dụ:

firebase deploy -m "Deploying the best new feature ever."

Khi sử dụng lệnh firebase deploy, hãy lưu ý những điều sau:

Để triển khai tài nguyên từ thư mục dự án, thư mục dự án phải có tệp firebase.json. Tệp này được tạo tự động cho bạn bằng lệnh firebase init.
Theo mặc định, firebase deploy sẽ tạo một bản phát hành cho tất cả tài nguyên có thể triển khai trong thư mục dự án. Để triển khai các dịch vụ hoặc tính năng cụ thể của Firebase, hãy sử dụng tính năng triển khai một phần.

Xung đột triển khai đối với quy tắc bảo mật

Đối với Firebase Realtime Database, Cloud Storage for Firebase và Cloud Firestore, bạn có thể xác định các quy tắc bảo mật trong thư mục dự án cục bộ hoặc trong bảng điều khiển Firebase.

Một cách khác để tránh xung đột triển khai là sử dụng tính năng triển khai một phần và chỉ xác định các quy tắc trong bảng điều khiển Firebase.

Hạn mức triển khai

Có thể (mặc dù khó xảy ra) bạn sẽ vượt quá hạn mức giới hạn tốc độ hoặc số lượng hoạt động triển khai Firebase. Ví dụ: khi triển khai rất nhiều hàm, bạn có thể nhận được thông báo lỗi HTTP 429 Quota. Để giải quyết những vấn đề như vậy, hãy thử sử dụng tính năng triển khai một phần.

Quay lại một bản triển khai

Bạn có thể quay lại một lượt triển khai Firebase Hosting từ trang Firebase Hosting của dự án bằng cách chọn thao tác Rollback (Huỷ bỏ) cho bản phát hành mong muốn.

Hiện tại, bạn không thể khôi phục các bản phát hành quy tắc bảo mật cho Firebase Realtime Database, Cloud Storage for Firebase hoặc Cloud Firestore.

Triển khai các dịch vụ cụ thể của Firebase

Nếu chỉ muốn triển khai các dịch vụ hoặc tính năng cụ thể của Firebase, bạn có thể sử dụng danh sách được phân tách bằng dấu phẩy trong cờ trên lệnh firebase deploy. Ví dụ: lệnh sau đây triển khai nội dung Firebase Hosting và quy tắc bảo mật Cloud Storage.

firebase deploy --only hosting,storage

Bảng sau đây liệt kê các dịch vụ và tính năng có sẵn để triển khai một phần. Tên trong cờ tương ứng với khoá trong tệp cấu hình firebase.json.

Cú pháp cờ	Dịch vụ hoặc tính năng đã được triển khai
`--only hosting`	Nội dung Firebase Hosting
`--only database`	Quy tắc Firebase Realtime Database
`--only dataconnect`	giản đồ và trình kết nối Firebase Data Connect
`--only storage`	Quy tắc Cloud Storage for Firebase
`--only firestore`	Quy tắc Cloud Firestore và chỉ mục cho tất cả cơ sở dữ liệu đã định cấu hình
`--only functions`	Cloud Functions for Firebase (có thể có các phiên bản cụ thể hơn của cờ này)

Triển khai các hàm cụ thể

Khi triển khai hàm, bạn có thể nhắm đến các hàm cụ thể. Ví dụ:

firebase deploy --only functions:function1

firebase deploy --only functions:function1,functions:function2

Một cách khác là nhóm các hàm thành nhóm xuất trong tệp /functions/index.js. Việc nhóm các hàm cho phép bạn triển khai nhiều hàm bằng một lệnh duy nhất.

Ví dụ: bạn có thể viết các hàm sau để xác định groupA và groupB:

var functions = require('firebase-functions/v1');

exports.groupA = {
  function1: functions.https.onRequest(...),
  function2: functions.database.ref('\path').onWrite(...)
}
exports.groupB = require('./groupB');

Trong ví dụ này, một tệp functions/groupB.js riêng biệt chứa các hàm bổ sung xác định cụ thể các hàm trong groupB. Ví dụ:

var functions = require('firebase-functions/v1');

exports.function3 = functions.storage.object().onChange(...);
exports.function4 = functions.analytics.event('in_app_purchase').onLog(...);

Trong ví dụ này, bạn có thể triển khai tất cả các hàm groupA bằng cách chạy lệnh sau từ thư mục dự án:

firebase deploy --only functions:groupA

Hoặc bạn có thể nhắm đến một hàm cụ thể trong một nhóm bằng cách chạy lệnh sau:

firebase deploy --only functions:groupA.function1,groupB.function4

Xoá hàm

CLI Firebase hỗ trợ các lệnh và tuỳ chọn sau để xoá các hàm đã triển khai trước đó:

Xoá tất cả hàm khớp với tên đã chỉ định ở tất cả các khu vực:
```
firebase functions:delete FUNCTION-1_NAME
```
Xoá một hàm được chỉ định đang chạy trong một vùng không phải mặc định:
```
firebase functions:delete FUNCTION-1_NAME --region REGION_NAME
```

Xoá nhiều hàm:

firebase functions:delete FUNCTION-1_NAME FUNCTION-2_NAME

Xoá một nhóm hàm đã chỉ định:
```
firebase functions:delete GROUP_NAME
```

Bỏ qua lời nhắc xác nhận:

firebase functions:delete FUNCTION-1_NAME --force

Thiết lập các tác vụ theo tập lệnh trước và sau khi triển khai

Bạn có thể kết nối tập lệnh shell với lệnh firebase deploy để thực hiện các tác vụ triển khai trước hoặc sau khi triển khai. Ví dụ: tập lệnh triển khai trước có thể chuyển đổi mã TypeScript thành JavaScript và trình bổ trợ triển khai sau có thể thông báo cho quản trị viên về việc triển khai nội dung trang web mới đến Firebase Hosting.

Để thiết lập các trình bổ trợ triển khai trước hoặc sau khi triển khai, hãy thêm tập lệnh bash vào tệp cấu hình firebase.json. Bạn có thể xác định tập lệnh ngắn trực tiếp trong tệp firebase.json hoặc tham chiếu các tệp khác trong thư mục dự án.

Ví dụ: tập lệnh sau đây là biểu thức firebase.json cho một tác vụ sau khi triển khai, tác vụ này sẽ gửi thông báo Slack sau khi triển khai thành công đến Firebase Hosting.

"hosting": {
  // ...

  "postdeploy": "./messageSlack.sh 'Just deployed to Firebase Hosting'",
  "public": "public"
}

Tệp tập lệnh messageSlack.sh nằm trong thư mục dự án và có dạng như sau:

curl -X POST -H 'Content-type: application/json' --data '{"text":"$1"}'
     \https://SLACK_WEBHOOK_URL

Bạn có thể thiết lập các trình bổ trợ predeploy và postdeploy cho bất kỳ thành phần nào mà bạn có thể triển khai. Xin lưu ý rằng việc chạy firebase deploy sẽ kích hoạt tất cả tác vụ triển khai trước và sau khi triển khai được xác định trong tệp firebase.json. Để chỉ chạy những tác vụ liên kết với một dịch vụ Firebase cụ thể, hãy sử dụng các lệnh triển khai một phần.

Cả hai trình nối predeploy và postdeploy đều in luồng đầu ra và lỗi chuẩn của tập lệnh vào thiết bị đầu cuối. Đối với các trường hợp không thành công, hãy lưu ý những điều sau:

Nếu một trình bổ trợ triển khai trước không hoàn tất như dự kiến, thì quá trình triển khai sẽ bị huỷ.
Nếu quá trình triển khai không thành công vì bất kỳ lý do gì, thì các trình bổ trợ sau khi triển khai sẽ không được kích hoạt.

Biến môi trường

Trong các tập lệnh chạy trong trình bổ trợ triển khai trước và sau khi triển khai, bạn có thể sử dụng các biến môi trường sau:

$GCLOUD_PROJECT: Mã dự án của dự án đang hoạt động
$PROJECT_DIR: Thư mục gốc chứa tệp firebase.json
$RESOURCE_DIR: (Chỉ dành cho tập lệnh hosting và functions) Vị trí của thư mục chứa tài nguyên Hosting hoặc Cloud Functions cần triển khai

Quản lý nhiều thực thể Realtime Database

Một dự án Firebase có thể có nhiều thực thể Firebase Realtime Database. Theo mặc định, các lệnh CLI tương tác với thực thể cơ sở dữ liệu mặc định.

Tuy nhiên, bạn có thể tương tác với một thực thể cơ sở dữ liệu không phải mặc định bằng cách sử dụng cờ --instance DATABASE_NAME. Các lệnh sau đây hỗ trợ cờ --instance:

firebase database:get
firebase database:profile
firebase database:push
firebase database:remove
firebase database:set
firebase database:update

Tài liệu tham khảo về lệnh

Lệnh quản trị CLI

Lệnh	Mô tả
trợ giúp	Hiển thị thông tin trợ giúp về CLI hoặc các lệnh cụ thể.
init	Liên kết và thiết lập dự án Firebase mới trong thư mục hiện tại. Lệnh này tạo một tệp cấu hình `firebase.json` trong thư mục hiện tại.
login	Xác thực CLI với tài khoản Firebase của bạn. Yêu cầu quyền truy cập vào trình duyệt web. Để đăng nhập vào CLI trong các môi trường từ xa không cho phép truy cập vào `localhost`, hãy sử dụng cờ `--no-localhost`.
login:ci	Tạo mã thông báo xác thực để sử dụng trong môi trường không tương tác.
đăng xuất	Đăng xuất CLI khỏi tài khoản Firebase của bạn.
mở	Mở trình duyệt đến các tài nguyên dự án có liên quan.
projects:list	Liệt kê tất cả dự án Firebase mà bạn có quyền truy cập.
sử dụng	Đặt dự án Firebase đang hoạt động cho CLI. Quản lý bí danh dự án.

Lệnh quản lý dự án

Lệnh	Mô tả
Quản lý dự án Firebase
projects:addfirebase	Thêm tài nguyên Firebase vào dự án Google Cloud hiện có.
projects:create	Tạo một dự án Google Cloud mới, sau đó thêm tài nguyên Firebase vào dự án mới.
projects:list	Liệt kê tất cả dự án Firebase mà bạn có quyền truy cập.
Quản lý ứng dụng Firebase (iOS, Android, Web)
apps:create	Tạo một Ứng dụng Firebase mới trong dự án đang hoạt động.
apps:list	Liệt kê các Ứng dụng Firebase đã đăng ký trong dự án đang hoạt động.
apps:sdkconfig	In cấu hình dịch vụ của Google cho một Ứng dụng Firebase.
setup:web	*Không dùng nữa. Thay vào đó, hãy sử dụng `apps:sdkconfig` và chỉ định `web` làm đối số nền tảng.* In cấu hình dịch vụ của Google cho Ứng dụng web Firebase.
Quản lý hàm băm chứng chỉ SHA (chỉ dành cho Android)
apps:android:sha:create \ `FIREBASE_APP_ID` `SHA_HASH`	Thêm hàm băm chứng chỉ SHA đã chỉ định vào Ứng dụng Android Firebase đã chỉ định.
apps:android:sha:delete \ `FIREBASE_APP_ID` `SHA_HASH`	Xoá hàm băm chứng chỉ SHA đã chỉ định khỏi Ứng dụng Android Firebase đã chỉ định.
apps:android:sha:list \ `FIREBASE_APP_ID`	Liệt kê các hàm băm chứng chỉ SHA cho ứng dụng Android Firebase được chỉ định.

Triển khai và phát triển cục bộ

Các lệnh này cho phép bạn triển khai và tương tác với trang web Firebase Hosting.

Lệnh	Mô tả
triển khai	Triển khai mã và tài sản từ thư mục dự án của bạn sang dự án đang hoạt động. Đối với Firebase Hosting, bạn bắt buộc phải có tệp cấu hình `firebase.json`.
phân phát	Khởi động máy chủ web cục bộ bằng cấu hình Firebase Hosting. Đối với Firebase Hosting, bạn bắt buộc phải có tệp cấu hình `firebase.json`.

Lệnh App Distribution

Lệnh	Mô tả
appdistribution:distribute \ --app `FIREBASE_APP_ID`	Cung cấp bản dựng cho người kiểm thử.
appdistribution:testers:add	Thêm người kiểm thử vào dự án.
appdistribution:testers:remove	Xoá người kiểm thử khỏi dự án.

Lệnh App Hosting

Lệnh	Mô tả
apphosting:backends:create \ --project `PROJECT_ID` \ --location `REGION` --app `APP_ID`	Tạo tập hợp tài nguyên được quản lý liên kết với một cơ sở mã duy nhất bao gồm phần phụ trợ App Hosting. Chỉ định một ứng dụng web Firebase hiện có theo mã ứng dụng Firebase (không bắt buộc).
apphosting:backends:get \ `BACKEND_ID` \ --project `PROJECT_ID` \ --location `REGION`	Truy xuất thông tin chi tiết cụ thể, bao gồm cả URL công khai, của một phần phụ trợ.
apphosting:backends:list \ --project `PROJECT_ID`	Truy xuất danh sách tất cả phần phụ trợ đang hoạt động được liên kết với một dự án.
firebase apphosting:backends:delete \ `BACKEND_ID` \ --project `PROJECT_ID` \ --location `REGION`	Xoá phần phụ trợ khỏi dự án.
firebase apphosting:config:export \ --project `PROJECT_ID` \ --secrets `ENVIRONMENT_NAME`	Xuất thông tin bí mật để sử dụng trong quá trình mô phỏng ứng dụng. Theo mặc định, các thông tin bảo mật được lưu trữ trong `apphosting.yaml` hoặc lấy `--secrets` để chỉ định bất kỳ môi trường nào có tệp `apphosting.ENVIRONMENT_NAME.yaml` tương ứng.
firebase apphosting:rollouts:create \ `BACKEND_ID` \ --git_branch `BRANCH_NAME` \ --git_commit `COMMIT_ID`	Tạo một bản phát hành được kích hoạt theo cách thủ công. Chỉ định thay đổi mới nhất cho một nhánh hoặc một thay đổi cụ thể (không bắt buộc). Nếu không có tuỳ chọn nào được cung cấp, hãy nhắc chọn trong danh sách các nhánh.
apphosting:secrets:set `KEY` --project `PROJECT_ID` \ --location `REGION` \ --data-file `DATA_FILE_PATH`	Lưu trữ tài liệu bí mật trong Trình quản lý bí mật. Cung cấp đường dẫn tệp để đọc dữ liệu bí mật (không bắt buộc). Đặt thành `_` để đọc dữ liệu bí mật từ dữ liệu đầu vào chuẩn.
apphosting:secrets:grantaccess `KEY` `BACKEND_ID` \ --project `PROJECT_ID` \ --location `REGION`	Cấp cho tài khoản dịch vụ phụ trợ quyền truy cập vào khoá bí mật đã cung cấp để App Hosting có thể truy cập vào khoá đó tại thời điểm tạo bản dựng hoặc chạy.
apphosting:secrets:describe `KEY` \ --project `PROJECT_ID`	Lấy siêu dữ liệu cho một khoá bí mật và các phiên bản của khoá đó.
firebase apphosting:secrets:access \ `KEY[@version]` \ --project `PROJECT_ID`	Truy cập vào một giá trị bí mật dựa trên khoá bí mật và phiên bản của khoá đó. Mặc định là truy cập vào phiên bản mới nhất.

Lệnh Authentication (quản lý người dùng)

Lệnh	Mô tả
auth:export	Xuất tài khoản người dùng của dự án đang hoạt động sang tệp JSON hoặc CSV. Để biết thêm thông tin chi tiết, hãy tham khảo trang auth:import và auth:export.
auth:import	Nhập tài khoản người dùng từ tệp JSON hoặc CSV vào dự án đang hoạt động. Để biết thêm thông tin chi tiết, hãy tham khảo trang auth:import và auth:export.

Lệnh Cloud Firestore

Lệnh	Mô tả
firestore:locations	Liệt kê các vị trí có sẵn cho cơ sở dữ liệu Cloud Firestore.
firestore:databases:create `DATABASE_ID`	Tạo một thực thể cơ sở dữ liệu ở chế độ gốc trong dự án Firebase. Lệnh này có các cờ sau: --location <region name> để chỉ định vị trí triển khai cho cơ sở dữ liệu. Xin lưu ý rằng bạn có thể chạy firebase firestore:locations để liệt kê các vị trí có sẵn. Bắt buộc. --delete-protection <deleteProtectionState> để cho phép hoặc ngăn chặn việc xoá cơ sở dữ liệu đã chỉ định. Các giá trị hợp lệ là `ENABLED` hoặc `DISABLED`. Giá trị mặc định là `DISABLED`. --point-in-time-recovery <PITRState> để đặt xem có bật tính năng khôi phục về một thời điểm nhất định hay không. Các giá trị hợp lệ là `ENABLED` hoặc `DISABLED`. Giá trị mặc định là `DISABLED`. Không bắt buộc.
firestore:databases:list	Liệt kê cơ sở dữ liệu trong dự án Firebase.
firestore:databases:get `DATABASE_ID`	Lấy cấu hình cơ sở dữ liệu cho một cơ sở dữ liệu đã chỉ định trong dự án Firebase.
firestore:databases:update `DATABASE_ID`	Cập nhật cấu hình cơ sở dữ liệu của một cơ sở dữ liệu đã chỉ định trong dự án Firebase. Bạn phải chọn ít nhất một cờ. Lệnh này có các cờ sau: --delete-protection <deleteProtectionState> để cho phép hoặc ngăn chặn việc xoá cơ sở dữ liệu đã chỉ định. Các giá trị hợp lệ là `ENABLED` hoặc `DISABLED`. Giá trị mặc định là `DISABLED`. --point-in-time-recovery <PITRState> để đặt xem có bật tính năng khôi phục về một thời điểm nhất định hay không. Các giá trị hợp lệ là `ENABLED` hoặc `DISABLED`. Giá trị mặc định là `DISABLED`. Không bắt buộc.
firestore:databases:delete `DATABASE_ID`	Xoá cơ sở dữ liệu trong dự án Firebase.
firestore:indexes	Liệt kê các chỉ mục cho cơ sở dữ liệu trong dự án Firebase. Lệnh này sẽ sử dụng cờ sau: --database `DATABASE_ID` để chỉ định tên của cơ sở dữ liệu cần liệt kê chỉ mục. Nếu bạn không cung cấp, các chỉ mục sẽ được liệt kê cho cơ sở dữ liệu mặc định.
firestore:delete	Xoá tài liệu trong cơ sở dữ liệu của dự án đang hoạt động. Khi sử dụng CLI, bạn có thể xoá tất cả tài liệu trong một bộ sưu tập theo đệ quy. Xin lưu ý rằng việc xoá dữ liệu Cloud Firestore bằng CLI sẽ phát sinh chi phí đọc và xoá. Để biết thêm thông tin, hãy xem bài viết Tìm hiểu về tính năng thanh toán Cloud Firestore. Lệnh này sẽ sử dụng cờ sau: --database `DATABASE_ID` để chỉ định tên của cơ sở dữ liệu mà bạn muốn xoá tài liệu. Nếu bạn không chỉ định, các tài liệu sẽ bị xoá khỏi cơ sở dữ liệu mặc định. Không bắt buộc.

Lệnh Cloud Functions for Firebase

Lệnh	Mô tả
functions:config:clone	Sao chép môi trường của một dự án khác vào dự án Firebase đang hoạt động.
functions:config:get	Truy xuất các giá trị cấu hình hiện có của Cloud Functions của dự án đang hoạt động.
functions:config:set	Lưu trữ các giá trị cấu hình thời gian chạy của Cloud Functions của dự án đang hoạt động.
functions:config:unset	Xoá các giá trị khỏi cấu hình thời gian chạy của dự án đang hoạt động.
functions:log	Đọc nhật ký từ Cloud Functions đã triển khai.

Để biết thêm thông tin, hãy tham khảo tài liệu về cấu hình môi trường.

Lệnh Crashlytics

Lệnh	Mô tả
crashlytics:mappingfile:generateid \ --resource-file=`PATH/TO/ANDROID_RESOURCE.XML`	Tạo mã nhận dạng tệp ánh xạ duy nhất trong tệp tài nguyên Android (XML) được chỉ định.
crashlytics:mappingfile:upload \ --app=`FIREBASE_APP_ID` \ --resource-file=`PATH/TO/ANDROID_RESOURCE.XML` \ `PATH/TO/MAPPING_FILE.TXT`	Tải tệp ánh xạ (TXT) tương thích với Proguard lên cho ứng dụng này và liên kết tệp đó với mã tệp ánh xạ được khai báo trong tệp tài nguyên Android (XML) đã chỉ định.
crashlytics:symbols:upload \ --app=`FIREBASE_APP_ID` \ `PATH/TO/SYMBOLS`	Tạo tệp biểu tượng tương thích với Crashlytics cho các sự cố thư viện gốc trên Android và tải tệp đó lên máy chủ Firebase.

Lệnh Data Connect

Các lệnh này và trường hợp sử dụng của chúng được đề cập chi tiết hơn trong Hướng dẫn tham khảo về CLI Data Connect.

Lệnh	Mô tả
dataconnect:services:list	Liệt kê tất cả dịch vụ Data Connect đã triển khai trong dự án Firebase.
dataconnect:sql:diff \ `SERVICE_ID`	Đối với dịch vụ đã chỉ định, hiển thị sự khác biệt giữa giản đồ Data Connect cục bộ và giản đồ cơ sở dữ liệu Cloud SQL.
dataconnect:sql:migrate \ --force \ `SERVICE_ID`	Di chuyển giản đồ của cơ sở dữ liệu Cloud SQL để khớp với giản đồ Data Connect cục bộ.
dataconnect:sql:grant\ --role=`ROLE` \ --email=`EMAIL` \ `SERVICE_ID`	Cấp vai trò SQL cho email của người dùng hoặc tài khoản dịch vụ được chỉ định. Đối với cờ `--role`, vai trò SQL cần cấp là một trong các vai trò sau: `owner`, `writer` hoặc `reader`. Đối với cờ `--email`, hãy cung cấp địa chỉ email của người dùng hoặc tài khoản dịch vụ để cấp vai trò.
dataconnect:sdk:generate	Tạo SDK đã nhập cho các trình kết nối Data Connect.

Lệnh Extensions

Lệnh	Mô tả
ext	Hiển thị thông tin về cách sử dụng các lệnh Firebase Extensions. Liệt kê các thực thể tiện ích được cài đặt trong dự án đang hoạt động.
ext:configure \ `EXTENSION_INSTANCE_ID`	Định cấu hình lại các giá trị tham số của một thực thể tiện ích trong tệp kê khai tiện ích.
ext:info \ `PUBLISHER_ID/EXTENSION_ID`	In thông tin chi tiết về một tiện ích.
ext:install \ `PUBLISHER_ID/EXTENSION_ID`	Thêm một thực thể mới của một tiện ích vào tệp kê khai tiện ích.
ext:list	Liệt kê tất cả các thực thể tiện ích được cài đặt trong một dự án Firebase. In mã nhận dạng thực thể cho mỗi tiện ích.
ext:uninstall \ `EXTENSION_INSTANCE_ID`	Xoá một thực thể mở rộng khỏi tệp kê khai mở rộng.
ext:update \ `EXTENSION_INSTANCE_ID`	Cập nhật một thực thể tiện ích lên phiên bản mới nhất trong tệp kê khai tiện ích.
ext:export	Xuất tất cả các thực thể tiện ích đã cài đặt từ dự án của bạn sang tệp kê khai tiện ích.

Lệnh nhà xuất bản Extensions

Lệnh	Mô tả
ext:dev:init	Khởi chạy cơ sở mã khung cho một tiện ích mới trong thư mục hiện tại.
ext:dev:list \ `PUBLISHER_ID`	In danh sách tất cả các tiện ích mà nhà xuất bản đã tải lên.
ext:dev:register	Đăng ký một dự án Firebase làm dự án nhà xuất bản tiện ích.
ext:dev:deprecate \ `PUBLISHER_ID/EXTENSION_ID` \ `VERSION_PREDICATE`	Ngừng sử dụng các phiên bản tiện ích khớp với thuộc tính nhận dạng phiên bản. Một thuộc tính nhận dạng phiên bản có thể là một phiên bản duy nhất (chẳng hạn như `1.0.0`) hoặc một dải phiên bản (chẳng hạn như `>1.0.0`). Nếu không cung cấp thuộc tính nhận dạng phiên bản, hãy ngừng sử dụng tất cả phiên bản của tiện ích đó.
ext:dev:undeprecate \ `PUBLISHER_ID/EXTENSION_ID` \ `VERSION_PREDICATE`	Huỷ ngừng sử dụng các phiên bản tiện ích khớp với thuộc tính phiên bản. Một thuộc tính nhận dạng phiên bản có thể là một phiên bản duy nhất (chẳng hạn như `1.0.0`) hoặc một dải phiên bản (chẳng hạn như `>1.0.0`). Nếu không cung cấp thuộc tính nhận dạng phiên bản, hãy ngừng sử dụng tất cả phiên bản của tiện ích đó.
ext:dev:upload \ `PUBLISHER_ID/EXTENSION_ID`	Tải phiên bản mới của một tiện ích lên.
ext:dev:usage \ `PUBLISHER_ID`	Hiển thị số lượt cài đặt và chỉ số sử dụng cho các tiện ích do nhà xuất bản tải lên.

Lệnh Hosting

Lệnh	Mô tả
hosting:disable	Ngừng phân phát lưu lượng truy cập Firebase Hosting cho dự án Firebase đang hoạt động. URL Hosting của dự án sẽ hiển thị thông báo "Không tìm thấy trang web" sau khi chạy lệnh này.
Quản lý trang web Hosting
firebase hosting:sites:create \ `SITE_ID`	Tạo một trang web Hosting mới trong dự án Firebase đang hoạt động bằng cách sử dụng `SITE_ID` đã chỉ định (Không bắt buộc) Chỉ định một Ứng dụng web Firebase hiện có để liên kết với trang web mới bằng cách truyền cờ sau: `--app FIREBASE_APP_ID`
firebase hosting:sites:delete \ `SITE_ID`	Xoá trang web Hosting đã chỉ định CLI sẽ hiển thị lời nhắc xác nhận trước khi xoá trang web. (Không bắt buộc) Bỏ qua lời nhắc xác nhận bằng cách truyền các cờ sau: `-f` hoặc `--force`
firebase hosting:sites:get \ `SITE_ID`	Truy xuất thông tin về trang web Hosting đã chỉ định
firebase hosting:sites:list	Liệt kê tất cả trang web Hosting cho dự án Firebase đang hoạt động
Quản lý kênh xem trước
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 `CHANNEL_ID` đã chỉ định 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
Nhân bản phiên bản
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" đã 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 \ `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 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 `VERSION_ID` trong trang tổng quan Hosting của bảng điều khiển Firebase.

Lệnh Realtime Database

Xin lưu ý rằng bạn có thể tạo thực thể Realtime Database ban đầu, mặc định trong bảng điều khiển Firebase hoặc bằng cách sử dụng quy trình công việc firebase init chung hoặc quy trình firebase init database cụ thể.

Sau khi tạo các thực thể, bạn có thể quản lý các thực thể đó như đã thảo luận trong phần Quản lý nhiều thực thể Realtime Database.

Lệnh	Mô tả
database:get	Tìm nạp dữ liệu từ cơ sở dữ liệu của dự án đang hoạt động và hiển thị dữ liệu đó dưới dạng JSON. Hỗ trợ truy vấn trên dữ liệu được lập chỉ mục.
database:instances:create	Tạo một thực thể cơ sở dữ liệu có tên thực thể được chỉ định. Chấp nhận tuỳ chọn `--location` để tạo cơ sở dữ liệu trong một khu vực được chỉ định. Để biết tên khu vực cần sử dụng với tuỳ chọn này, hãy xem phần chọn vị trí cho dự án. Nếu không có thực thể cơ sở dữ liệu nào cho dự án hiện tại, bạn sẽ được nhắc chạy luồng `firebase init` để tạo một thực thể.
database:instances:list	Liệt kê tất cả các phiên bản cơ sở dữ liệu cho dự án này. Chấp nhận tuỳ chọn `--location` để liệt kê cơ sở dữ liệu trong một khu vực được chỉ định. Để biết tên khu vực cần sử dụng với tuỳ chọn này, hãy xem phần chọn vị trí cho dự án.
database:profile	Tạo hồ sơ về các hoạt động trên cơ sở dữ liệu của dự án đang hoạt động. Để biết thêm thông tin chi tiết, hãy tham khảo các loại thao tác Realtime Database.
database:push	Đẩy dữ liệu mới vào danh sách ở một vị trí đã chỉ định trong cơ sở dữ liệu của dự án đang hoạt động. Nhận dữ liệu đầu vào từ một tệp, STDIN hoặc đối số dòng lệnh.
database:remove	Xoá tất cả dữ liệu tại một vị trí đã chỉ định trong cơ sở dữ liệu của dự án đang hoạt động.
database:set	Thay thế tất cả dữ liệu tại một vị trí đã chỉ định trong cơ sở dữ liệu của dự án đang hoạt động. Nhận dữ liệu đầu vào từ một tệp, STDIN hoặc đối số dòng lệnh.
database:update	Thực hiện cập nhật một phần tại một vị trí đã chỉ định trong cơ sở dữ liệu của dự án đang hoạt động. Nhận dữ liệu đầu vào từ một tệp, STDIN hoặc đối số dòng lệnh.

Lệnh Remote Config

Lệnh	Mô tả
remoteconfig:versions:list \ --limit `NUMBER_OF_VERSIONS`	Liệt kê 10 phiên bản gần đây nhất của mẫu. Chỉ định `0` để trả về tất cả phiên bản hiện có hoặc tuỳ ý truyền tuỳ chọn `--limit` để giới hạn số lượng phiên bản được trả về.
remoteconfig:get \ --v, version_number `VERSION_NUMBER` --o, output `FILENAME`	Lấy mẫu theo phiên bản (mặc định là phiên bản mới nhất) và xuất các nhóm thông số, thông số, tên điều kiện và phiên bản vào một bảng. Bạn có thể ghi kết quả vào một tệp đã chỉ định bằng `-o, FILENAME` (không bắt buộc).
remoteconfig:rollback \ --v, version_number `VERSION_NUMBER` --force	Khôi phục mẫu Remote Config về số phiên bản trước được chỉ định hoặc mặc định là phiên bản trước đó (phiên bản hiện tại -1). Trừ phi `--force` được truyền, hãy nhắc Y/N trước khi tiếp tục quay lại.

Tài liệu tham khảo về Firebase CLI

Thiết lập hoặc cập nhật CLI

Cài đặt CLI Firebase

Windows

tệp nhị phân độc lập

npm

macOS hoặc Linux

tập lệnh cài đặt tự động

tệp nhị phân độc lập

npm

Đăng nhập và kiểm thử CLI Firebase

Cập nhật lên phiên bản CLI mới nhất

Windows

macOS

Linux

Sử dụng CLI với các hệ thống CI

Khởi chạy dự án Firebase

Tệp firebase.json

Cấu hình cho nhiều cơ sở dữ liệu Cloud Firestore

Các tệp Cloud Functions cần bỏ qua khi triển khai

Quản lý bí danh dự án

Thêm bí danh dự án

Sử dụng bí danh dự án

Kiểm soát nguồn và bí danh dự án

Phân phát và kiểm thử dự án Firebase trên máy

Mô phỏng dự án bằng các hàm HTTP cục bộ

Kiểm thử từ các thiết bị cục bộ khác

Triển khai cho một dự án Firebase

Xung đột triển khai đối với quy tắc bảo mật

Hạn mức triển khai

Quay lại một bản triển khai

Triển khai các dịch vụ cụ thể của Firebase

Triển khai các hàm cụ thể

Xoá hàm

Thiết lập các tác vụ theo tập lệnh trước và sau khi triển khai

Biến môi trường

Quản lý nhiều thực thể Realtime Database

Tài liệu tham khảo về lệnh

Lệnh quản trị CLI

Lệnh quản lý dự án

Triển khai và phát triển cục bộ

Lệnh App Distribution

Lệnh App Hosting

Lệnh Authentication (quản lý người dùng)

Lệnh Cloud Firestore

Lệnh Cloud Functions for Firebase

Lệnh Crashlytics

Lệnh Data Connect

Lệnh Extensions

Lệnh nhà xuất bản Extensions

Lệnh Hosting

Lệnh Realtime Database

Lệnh Remote Config

Tệp `firebase.json`