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

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

Trước khi sử dụng Giao diện dòng lệnh (CLI) của Firebase, hãy thiết lập dự án Firebase.

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

Cài đặt Firebase CLI

Bạn có thể cài đặt Giao diện dòng lệnh (CLI) của Firebase bằng cách sử dụng 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ài đặt CLI bằng cách nào, bạn đều có quyền truy cập vào cùng một chức năng và lệnh firebase.

Windows macOS Linux

Máy tính Windows

Bạn có thể cài đặt Giao diện dòng lệnh (CLI) của Firebase dành cho Windows bằng một trong các cách sau:

Lựa chọn Nội dung mô tả Được đề xuất cho...
tệp nhị phân độc lập Tải tệp nhị phân độc lập xuống 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 Giao diện dòng lệnh (CLI) của Firebase, hãy làm theo các bước sau:

  1. Tải tệp nhị phân CLI của Firebase dành cho Windows.

  2. 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.

  3. Tiếp tục đăng nhập và kiểm tra CLI.

bước/phút

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

  1. Cài đặt Node.js bằng nvm-windows (Trình quản lý phiên bản nút). Khi bạn cài đặt Node.js, hệ thống sẽ tự động cài đặt các công cụ lệnh npm.

  2. Cài đặt Giao diện dòng lệnh (CLI) của Firebase 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.

  3. Tiếp tục đăng nhập và kiểm tra CLI.

macOS hoặc Linux

Bạn có thể cài đặt Giao diện dòng lệnh (CLI) của Firebase cho macOS hoặc Linux bằng một trong các lựa chọn sau:

Lựa chọn Nội dung mô tả Được đề xuất cho...
tập lệnh cài đặt tự động Chạy một lệnh sẽ 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 xuống cho CLI. Sau đó, bạn có thể định cấu hình và chạy tệp nhị phân sao 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 tự động cài đặt

Để cài đặt Giao diện dòng lệnh (CLI) của Firebase bằng tập lệnh cài đặt tự động, hãy làm theo các bước sau:

  1. Chạy lệnh cURL sau:

    curl -sL https://firebase.tools | bash

    Tập lệnh này sẽ tự động phát hiện hệ điều hành của bạn, tải bản phát hành Firebase CLI mới nhất xuống, sau đó bật lệnh firebase có sẵn trên toàn cầu.

  2. Tiếp tục đăng nhập và kiểm tra 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 Giao diện dòng lệnh (CLI) của 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:

  1. Tải tệp nhị phân CLI của Firebase xuống cho hệ điều hành của bạn: macOS | Linux

  2. (Không bắt buộc) Thiết lập lệnh firebase có sẵn trên toàn cầu.

    1. Làm cho 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 của bạn.
  3. Tiếp tục đăng nhập và kiểm tra CLI.

bước/phút

Nếu bạn muốn sử dụng npm (Trình quản lý gói nút) để cài đặt Giao diện dòng lệnh (CLI) của Firebase, hãy làm theo các bước sau:

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

  2. Cài đặt Giao diện dòng lệnh (CLI) của Firebase 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.

  3. Tiếp tục đăng nhập và kiểm tra CLI.

Đăng nhập và thử nghiệm Giao diện dòng lệnh (CLI) của Firebase

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

  1. Đă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 của mình.

  2. Hãy 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 của bạn. 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 của Firebase.

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

Thông thường, bạn nên sử dụng phiên bản Firebase CLI mới nhất.

Cách cập nhật phiên bản CLI phụ thuộc vào hệ điều hành của bạn 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 rồi thay thế phiên bản đó trên hệ thống của bạn
  • 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 rồi thay thế phiên bản đó trên hệ thống của bạn
  • 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 rồi thay thế phiên bản đó trên hệ thống của bạn
  • npm: Chạy npm install -g firebase-tools

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

Giao diện dòng lệnh (CLI) của Firebase yêu cầu một trình duyệt để hoàn tất quy 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.

  1. Trên máy có trình duyệt, hãy cài đặt Firebase CLI.

  2. Bắt đầu quá trình đăng nhập bằng cách chạy lệnh sau:

    firebase login:ci
  3. Truy cập vào URL được cung cấp, sau đó đăng nhập bằng Tài khoản Google.

  4. In mã làm mới mới. Phiên CLI hiện tại sẽ không bị ảnh hưởng.

  5. 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.

  6. Hãy 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 này.

    • Cách 2: Chạy tất cả các lệnh firebase có cờ --token TOKEN trong hệ thống CI.
      Đây là thứ tự ưu tiên để 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 thao tác phổ biến được thực hiện bằng CLI, chẳng hạn như triển khai cho dự án Firebase, đều cần có thư mục dự án. Bạn thiết lập một thư mục dự án bằng cách sử dụng lệnh firebase init. Thư mục dự án thường là thư mục gốc của chế độ kiểm soát nguồn và sau khi chạy firebase init, thư mục này sẽ chứa một 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 từ trong thư mục của ứng dụng:

firebase init

Lệnh firebase init 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, Giao diện dòng lệnh (CLI) của Firebase yêu cầu bạn hoàn thành các nhiệm vụ sau:

  • Chọn những sản phẩm Firebase mà bạn muốn để thiết lập trong dự án Firebase của mình.

    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 những 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ụ: Lưu trữ). Xin lưu ý rằng bạn luôn có thể chạy firebase init sau để thiết lập các sản phẩm Firebase khác.

  • 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 (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 tại gốc của thư mục ứng dụng cục bộ của bạn:

Tệp firebase.json

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

Bạn cần phải dùng tệp firebase.json để triển khai thành phần bằng Giao diện dòng lệnh (CLI) của Firebase vì tệp này chỉ định các tệp và chế độ cài đặt trong thư mục dự án được triển khai cho dự án Firebase của bạn. Vì bạn có thể xác định một số chế độ cài đặt trong thư mục dự án hoặc bảng điều khiển của Firebase, hãy đảm bảo rằng 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 Lưu trữ Firebase ngay trong tệp firebase.json. Tuy nhiên, đối với các dịch vụ Firebase khác có thể triển khai bằng Firebase CLI, 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 hook trước hoặc sau khi triển khai trong tệp firebase.json.

Sau đây là một tệp firebase.json mẫu có chế độ cài đặt mặc định nếu bạn chọn tính năng Lưu trữ Firebase, Cloud Firestore và Cloud Functions cho Firebase (đã chọn các lựa chọn về nguồn và tìm lỗi mã nguồn TypeScript) 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ể chuyển cờ --config PATH để chỉ định 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 Quy tắc bảo mật của Cloud Firestore và các tệp nguồn chỉ mục cơ sở dữ liệu với từng cơ sở dữ liệu. Sửa đổi tệp bằng một mảng JSON, với một mục nhập cho mỗi cơ sở dữ liệu.

      "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 tự động chỉ định danh sách các tệp trong thư mục functions cần bỏ qua. Điều này ngăn việc triển khai các tệp không liên quan phụ trợ, vốn có thể làm tăng kích thước dữ liệu cho hoạt động triển khai của bạn.

Danh sách các tệp bị bỏ qua theo mặc định (ở định dạng JSON):

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

Nếu bạn thêm giá trị tuỳ chỉnh của riêng mình cho ignore trong firebase.json, hãy đảm bảo rằng bạn giữ lại (hoặc thêm, nếu bị thiếu) danh sách các tệp nêu 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ể cần sử dụng một dự án Firebase để thử nghiệm và một dự án khác để phát hành chính thức. 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 phát hành công khai. Lệnh firebase use cho phép bạn chuyển đổi giữa các bí danh cũng như tạo các bí danh mới.

Thêm email đại diện cho 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 chỉ định bí danh của 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 một thư mục dự án, hãy chạy lệnh sau từ trong thư mục dự án của bạ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 bí danh được chỉ định sẽ được ghi vào tệp .firebaserc trong thư mục dự án của bạn.

Sử dụng email đại diện của 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 từ bên trong thư mục dự án của bạn.

Lệnh Mô tả
firebase use Xem danh sách email đại diện hiện được xác định cho thư mục dự án của bạn
firebase use \
PROJECT_ID|ALIAS
Chỉ dẫn tất cả các lệnh chạy dựa 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 để đặt một dự án đang hoạt động mới trước khi chạy các lệnh CLI khác.

firebase use \
--unalias PROJECT_ALIAS
Xoá một biệt hiệu khỏi thư mục dự án của bạ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 chuyể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 dự án Firebase mà bạn đã chỉ định đại diện staging. Nếu muốn chạy một lệnh duy nhất dựa trên dự án Firebase mà bạn đã chỉ định bí danh prod, thì bạn có thể chạy chẳng hạn như 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 ở chế độ kiểm soát nguồn để cho phép nhóm của bạn chia sẻ email đại diện của dự án. Tuy nhiên, đối với các dự án nguồn mở hoặc mẫu khởi đầu, bạn thường không nên kiểm tra tệp .firebaserc.

Nếu có một dự án phát triển chỉ dành cho mục đích sử dụng, bạn có thể chuyển cờ --project bằng 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à thử nghiệm cục bộ dự án Firebase của bạn

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

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

  • Xem nội dung tĩnh cho ứng dụng được lưu trữ trên Firebase.
  • Sử dụng chức năng đám mây để tạo nội dung động cho tính năng Lưu trữ Firebase và bạn muốn sử dụng các hàm HTTP thực tế (triển khai) để mô phỏng tính năng Lưu trữ 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 từ thư mục dự án để mô phỏng dự án của bạn bằng cách sử dụng các hàm HTTP cục bộ.

  • Để mô phỏng các hàm HTTP và tính năng lưu trữ nhằm kiểm thử trên URL cục bộ, hãy 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 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 của localhost. Điều này có nghĩa là bạn có thể truy cập vào nội dung được lưu trữ trên trình duyệt web của máy tính, chứ không phải 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 dự án Firebase

Firebase CLI quản lý việc triển khai mã và tài sản cho dự án Firebase của bạn, bao gồm:

  • Các bản phát hành mới của trang web Lưu trữ Firebase
  • Cloud Functions mới, đã cập nhật hoặc hiện có cho Firebase
  • Các quy tắc cho Cơ sở dữ liệu theo thời gian thực của Firebase
  • Các quy tắc đối với Cloud Storage cho Firebase
  • Các quy tắc cho Cloud Firestore
  • Chỉ số 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 của bạn:

firebase deploy

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

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

Khi bạn dùng lệnh firebase deploy, hãy lưu ý những điều sau:

  • Để triển khai tài nguyên từ một thư mục dự án, thư mục dự án phải có tệp firebase.json. Tệp này được tự động tạo 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 mọi tài nguyên có thể triển khai trong thư mục dự án của bạ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 các quy tắc bảo mật

Đối với Cơ sở dữ liệu theo thời gian thực của Firebase, Cloud Storage cho 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 của Firebase.

Một lựa chọn khác để tránh xung đột khi 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 của Firebase.

Hạn mức triển khai

Mặc dù ít khi xảy ra trường hợp bạn có thể vượt quá hạn mức làm giới hạn tốc độ hoặc số lượng hoạt động triển khai Firebase. Ví dụ: khi triển khai số lượng rất lớn 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.

Khôi phục quá trình triển khai

Bạn có thể khôi phục chế độ triển khai tính năng Lưu trữ Firebase từ trang Lưu trữ Firebase của dự án bằng cách chọn thao tác Khôi phục 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 của quy tắc bảo mật cho Cơ sở dữ liệu theo thời gian thực của Firebase, Cloud Storage cho Firebase hoặc Cloud Firestore.

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

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 Lưu trữ Firebase và các quy tắc bảo mật của 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ó thể sử dụng để triển khai một phần. Tên trong cờ tương ứng với các khoá trong tệp cấu hình firebase.json.

Cú pháp gắn cờ Đã triển khai dịch vụ hoặc tính năng
--only hosting Nội dung Lưu trữ Firebase
--only database Quy tắc Cơ sở dữ liệu theo thời gian thực của Firebase
--only storage Các quy tắc của Cloud Storage cho Firebase
--only firestore Quy tắc chỉ mục trong Cloud Firestore cho tất cả cơ sở dữ liệu đã định cấu hình
--only functions Cloud Functions cho Firebase (có thể sử dụng các phiên bản cụ thể hơn của cờ này)

Triển khai các chức năng cụ thể

Khi triển khai hàm, bạn có thể nhắm mục tiêu đến các chức năng 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 vào các nhóm xuất trong tệp /functions/index.js. Việc nhóm 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 groupAgroupB:

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

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');

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 mục tiêu 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

Giao diện dòng lệnh (CLI) của Firebase hỗ trợ các lệnh và tuỳ chọn sau để xoá các hàm đã triển khai trước đó:

  • Xoá mọi hàm khớp với tên đã chỉ định ở mọi khu vực:

    firebase functions:delete FUNCTION-1_NAME

  • Xoá một hàm được chỉ định đang chạy ở khu vực không phải vùng 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 nhiệm vụ theo tập lệnh trong quá trình triển khai trước và sau triển khai

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

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

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

"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 hook predeploypostdeploy cho mọi thành phần 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ả cá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ụ được 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 hook predeploypostdeploy đều in đầu ra chuẩn và luồng lỗi của các tập lệnh đến 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 quá trình triển khai trước không hoàn tất được 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 hook 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 tại các hook trước và sau triển khai, sẽ có 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 hostingfunctions) Vị trí của thư mục chứa các tài nguyên Lưu trữ hoặc Chức năng đám mây sẽ được triển khai

Quản lý nhiều phiên bản Cơ sở dữ liệu theo thời gian thực

Một dự án Firebase có thể có nhiều phiên bản Cơ sở dữ liệu theo thời gian thực Firebase. 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 của bạn.

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 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

Tham chiếu lệnh

Lệnh quản trị CLI

Lệnh Mô tả
trợ giúp Hiện 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 một dự án Firebase mới trong thư mục hiện tại. Lệnh này sẽ 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. Cần có quyền truy cập vào một 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ã xác thực để sử dụng trong các 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ở một trình duyệt tới 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 Thiết lập dự án Firebase đang hoạt động cho CLI.
Quản lý email đại diện.

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

Lệnh Mô tả
Quản lý dự án Firebase
projects:addfirebase Thêm các tài nguyên Firebase vào một dự án hiện có trên Google Cloud.
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ý các ứng dụng Firebase (iOS, Android, Web)
apps:tạo 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.
ứng dụng:sdkconfig In cấu hình các dịch vụ của Google của 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 các dịch vụ của Google của một Ứ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 được chỉ định vào Ứng dụng Android Firebase được chỉ định.
apps:android:sha:xoá \
FIREBASE_APP_ID SHA_HASH
Xoá hàm băm chứng chỉ SHA đã chỉ định khỏi Ứng dụng Android Firebase được 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 đã 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 Lưu trữ Firebase của mình.

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

Lệnh phân phối ứng dụng

Lệnh Mô tả
appphân phối:phân phối \
--ứng dụng FIREBASE_APP_ID
Cung cấp bản dựng cho người kiểm thử.
appphân phối: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 Lưu trữ ứng dụng

Lệnh Mô tả
apphosting:backends:create \
--project PROJECT_ID
--location REGION --app APP_ID
Tạo tập hợp các tài nguyên được quản lý liên kết với một cơ sở mã duy nhất tạo thành phần phụ trợ Lưu trữ ứng dụng. Nếu muốn, hãy chỉ định một ứng dụng web Firebase hiện có bằng mã ứng dụng Firebase.
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 \
--dự án 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á một phần phụ trợ khỏi dự án.
apphosting:secrets:set \
KEY --project PROJECT_ID
--location REGION --data-file Data file
Lưu trữ tài liệu bí mật trong Secret Manager. Bạn có thể cung cấp một đường dẫn tệp để đọc dữ liệu bí mật từ đó. Đặt thành _ để đọc dữ liệu bí mật từ phương thức nhập chuẩn.
apphosting:secrets:grantsaccess \
KEY --dự án PROJECT_ID BACKEND_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 được cung cấp để dịch vụ Lưu trữ ứng dụng có thể truy cập vào khoá bí mật này trong thời gian tạo hoặc chạy.
apphosting:secrets:describe \
KEY --project PROJECT_ID
Lấy siêu dữ liệu của một khoá bí mật và các phiên bản của khoá bí mật đó.
firebase apphosting:secrets:access \
KEY[@version]
--project PROJECT_ID
Truy cập vào một giá trị bí mật dựa vào giá trị bí mật và phiên bản của khoá bí mật đó. Mặc định truy cập vào phiên bản mới nhất.

Lệnh xác thực (quản lý người dùng)

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

Các lệnh trong Cloud Firestore

Lệnh Mô tả
firestore:locations

Liệt kê các vị trí hiện có cho cơ sở dữ liệu Cloud Firestore của bạn.

firestore:databases:create DATABASE_ID

Tạo một phiên bản cơ sở dữ liệu ở chế độ gốc trong dự án Firebase.

Lệnh này sẽ nhận các cờ sau:

  • --location <region name> để chỉ định vị trí triển khai cho cơ sở dữ liệu. 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 xóa cơ sở dữ liệu được 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 tại một thời điểm 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ác cơ sở dữ liệu trong dự án Firebase của bạn.

firestore:databases:get, DATABASE_ID

Nhận cấu hình cơ sở dữ liệu cho một cơ sở dữ liệu được chỉ định trong dự án Firebase của bạn.

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 được chỉ định trong dự án Firebase của bạn.

Yêu cầu ít nhất một cờ. Lệnh này sẽ nhận các cờ sau:

  • --delete-protection <deleteProtectionState> để cho phép hoặc ngăn chặn việc xóa cơ sở dữ liệu được 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 tại một thời điểm 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 của bạn.

firestore:indexes

Liệt kê các chỉ mục cho một cơ sở dữ liệu trong dự án Firebase của bạn.

Lệnh này sẽ có 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 không được 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á định kỳ tất cả tài liệu trong một tập hợp.

Xin lưu ý rằng việc xoá dữ liệu Cloud Firestore bằng CLI sẽ làm 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ề cách thanh toán trên Cloud Firestore.

Lệnh này sẽ có cờ sau:

  • --database DATABASE_ID để chỉ định tên của cơ sở dữ liệu mà tài liệu sẽ bị xoá. 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 cho Firebase

Lệnh Mô tả
functions:config:Nhân 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 các Hàm đám mây 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ừ các Chức năng đám mây được 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.

Các lệnh trong Crashlytics

Lệnh Mô tả
Crashlytics:mappingfile:generateid \
--resource-file=PATH/TO/ANDROID_RESOURCE.XML
Tạo một 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ạ tương thích với Proguard (TXT) lên cho ứng dụng này rồi liên kết tệp đó với mã nhận dạng tệp ánh xạ được khai báo trong tệp tài nguyên Android (XML) được chỉ định.
Crashlytics:symbols:tải lên \
--ứng dụng=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 rồi tải tệp đó lên máy chủ Firebase.

Các lệnh cho tiện ích

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

Lệnh của nhà xuất bản tiện ích

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:danh sách \
PUBLISHER_ID
In danh sách tất cả các tiện ích do nhà xuất bản tải lên.
ext:dev:đăng ký Đăng ký dự án Firebase dưới dạng 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 phiên bản.
Thuộc tính phiên bản có thể là một phiên bản (chẳng hạn như 1.0.0) hoặc một loạt phiên bản (chẳng hạn như >1.0.0).
Nếu không có thuộc tính phiên bản nào được cung cấp, hãy ngừng sử dụng tất cả các phiên bản của tiện ích đó.
ext:dev:undeprecate \
PUBLISHER_ID/EXTENSION_ID \
VERSION_PREDICATE
Các phiên bản tiện ích Undecatecates (Chưa chính thức) khớp với thuộc tính phiên bản.
Thuộc tính 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 loạt phiên bản (chẳng hạn như >1.0.0).
Nếu bạn không cung cấp thuộc tính phiên bản, thì mọi phiên bản của tiện ích đó sẽ ngừng hoạt động.
ext:dev:tải lên \
PUBLISHER_ID/EXTENSION_ID
Tải phiên bản tiện ích mới 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 lưu trữ

Lệnh Mô tả
hosting:disable

Ngừng phân phát lưu lượng truy cập Lưu trữ Firebase cho dự án Firebase đang hoạt động.

URL lưu trữ 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 Lưu trữ
firebase lưu trữ:sites:create \
SITE_ID

Tạo một trang web Lưu trữ mới trong dự án Firebase đang hoạt động bằng cách sử dụng SITE_ID được 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 chuyển cờ sau: --app FIREBASE_APP_ID

firebase lưu trữ:sites:delete \
SITE_ID

Xoá trang web Lưu trữ đã 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 chuyển các cờ sau: -f hoặc --force

firebase lưu trữ:sites:get \
SITE_ID

Truy xuất thông tin về trang web Lưu trữ được chỉ định

firebase lưu trữ:sites:list

Liệt kê tất cả trang web Lưu trữ cho dự án Firebase đang hoạt động

Quản lý kênh xem trước
firebase lưu trữ:channel:create \
CHANNEL_ID

Tạo một kênh xem trước mới trong trang web Lưu trữ mặc định bằng cách sử dụng CHANNEL_ID được chỉ định

Lệnh này không triển khai cho kênh.

firebase lưu trữ:channel:xoá \
CHANNEL_ID

Xoá kênh xem trước được chỉ định

Bạn không thể xoá kênh đang hoạt động của một trang web.

firebase lưu trữ:channel:Deploy \
CHANNEL_ID

Triển khai nội dung và cấu hình Lưu trữ của bạn cho 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 trên trang web Lưu trữ default trước khi triển khai cho kênh.

firebase lưu trữ: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 lưu trữ mặc định
firebase lưu trữ:channel:open \
CHANNEL_ID
Mở một trình duyệt đến URL của kênh đã chỉ định hoặc trả về URL đó nếu không mở được bằng trình duyệt
Sao chép phiên bản
firebase lưu trữ:sao chép \
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" được chỉ định sang kênh "mục tiêu" được chỉ định

Lệnh này cũng triển khai đến kênh "target" được chỉ định. Nếu kênh "target" chưa tồn tại, lệnh này sẽ tạo một kênh xem trước mới trên trang web Lưu trữ "target" trước khi triển khai cho kênh.

firebase lưu trữ:copy \
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" được chỉ định

Lệnh này cũng triển khai đến kênh "target" được chỉ định. Nếu kênh "target" chưa tồn tại, lệnh này sẽ tạo một kênh xem trước mới trên trang web Lưu trữ "target" trước khi triển khai cho kênh.

Bạn có thể tìm thấy VERSION_ID trong Trang tổng quan về việc lưu trữ của bảng điều khiển của Firebase.

Lệnh Cơ sở dữ liệu theo thời gian thực

Xin lưu ý rằng bạn có thể tạo bản sao Cơ sở dữ liệu theo thời gian thực mặc định ban đầu trong bảng điều khiển của Firebase hoặc bằng cách sử dụng quy trình công việc chung firebase init 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 bài viết Quản lý nhiều thực thể của Cơ sở dữ liệu theo thời gian thực.

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 đã 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ể đã chỉ định. Chấp nhận tuỳ chọn --location để tạo cơ sở dữ liệu ở một khu vực cụ thể. Để biết tên khu vực để sử dụng với lựa chọn này, hãy xem phần chọn vị trí cho dự án của bạ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 quy trình firebase init để tạo một thực thể.
database:instances:list Liệt kê tất cả thực thể cơ sở dữ liệu của dự án này. Chấp nhận tuỳ chọn --location để liệt kê các cơ sở dữ liệu trong một khu vực đã chỉ định. Để biết tên khu vực để sử dụng với tuỳ chọn này, hãy xem phần chọn vị trí cho dự án của bạn.
database:hồ sơ Xây dựng hồ sơ cho các thao tác 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 của Cơ sở dữ liệu theo thời gian thực.
database:push Đẩy dữ liệu mới vào một danh sách tại một vị trí được chỉ định trong cơ sở dữ liệu của dự án đang hoạt động. Lấy dữ liệu đầu vào từ một tệp, STDIN hoặc một đố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 ở một vị trí được chỉ định trong cơ sở dữ liệu của dự án đang hoạt động. Lấy dữ liệu đầu vào từ một tệp, STDIN hoặc một đố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í được chỉ định trong cơ sở dữ liệu của dự án đang hoạt động. Lấy dữ liệu đầu vào từ một tệp, STDIN hoặc một đối số dòng lệnh.

Lệnh Cấu hình từ xa

Lệnh Mô tả
remoteconfig:version:list \
--giới hạn NUMBER_OF_VERSIONS
Liệt kê 10 phiên bản gần đây nhất của mẫu này. Chỉ định 0 để trả về tất cả phiên bản hiện có hoặc 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, xuất FILENAME
Lấy mẫu theo phiên bản (mặc định là phiên bản mới nhất), đồng thời xuất các nhóm tham số, tham số, tên điều kiện và phiên bản vào một bảng. Bạn có thể tuỳ ý ghi đầu ra vào một tệp được chỉ định bằng -o, FILENAME.
remoteconfig:rollback \
--v, version_number VERSION_NUMBER
--force
Khôi phục mẫu Cấu hình từ xa về số phiên bản đã chỉ định trước đó hoặc đặt mặc định về phiên bản ngay trước đó (phiên bản hiện tại -1). Trừ phi --force được truyền, lời nhắc Y/N sẽ xuất hiện trước khi tiến hành khôi phục.