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 một 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 phương thức phù hợp với hệ điều hành, trình độ kinh nghiệm và/hoặc trường hợp sử dụng của mình. Bất kể bạn cài đặt CLI theo cách nào, bạn đều có quyền sử dụng cùng một chức năng và lệnh firebase
.
Windows
Bạn có thể cài đặt CLI Firebase cho Windows 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 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 CLI Firebase, hãy làm theo các bước sau:
Tải tệp nhị phân Firebase CLI xuống 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) để cài đặt CLI Firebase, hãy làm theo các bước sau:
Cài đặt Node.js bằ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ụ dòng lệnh
npm
.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 cho phép dùng lệnh
firebase
có trên toàn cầu.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 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 duy nhất 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 cho phù hợp với quy trình làm việc của mình. | Quy trình công 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 Firebase CLI 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 Firebasexuố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.- Tạo tệp thực thi nhị phân bằng cách chạy
chmod +x ./firebase_tools
. - Thêm đường dẫn của tệp nhị phân vào PATH.
- Tạo tệp thực thi nhị phân bằng cách chạy
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) để 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).
Khi cài đặt Node.js, các công cụ dòng lệnhnpm
sẽ tự động được cài đặt.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 cho phép dùng lệnh
firebase
có trên toàn cầu.Tiếp tục đăng nhập và kiểm thử CLI.
Đăng nhập và kiểm thử CLI 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.
Đă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.
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ó trong bảng điều khiển 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 CLI Firebase mới nhất.
Cách 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 này trên hệ thống của bạn
- npm: Chạy
npm install -g firebase-tools
macOS
automatic install script: 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 này trên hệ thống của bạn
npm: Chạy
npm install -g firebase-tools
Linux
automatic install script: 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 này trên hệ thống của bạn
npm: Chạy
npm install -g firebase-tools
Sử dụng giao diện dòng lệnh với hệ thống CI
Bạn nên xác thực bằng Thông tin đăng nhập mặc định của ứng dụng khi sử dụng CLI với các hệ thống CI.
(Nên dùng) Sử dụng thông tin xác thực mặc định của ứng dụng
CLI Firebase sẽ phát hiện và sử dụng Thông tin xác thực mặc định của ứng dụng nếu bạn đặt thông tin xác thực này. Cách đơn giản nhất để xác thực CLI trong CI và các môi trường không có giao diện người dùng khác là thiết lập Thông tin đăng nhập mặc định của ứng dụng.
(Cũ) Sử dụng FIREBASE_TOKEN
Ngoài ra, bạn có thể xác thực bằng FIREBASE_TOKEN
. Cách này kém an toàn hơn so với Thông tin xác thực mặc định của ứng dụng và không còn được khuyến nghị nữa.
Trên một máy có trình duyệt, hãy cài đặt Firebase CLI.
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 trong hệ thống CI của bạn.
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 lựa 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 sẽ tự động sử dụng mã thông báo này.Lựa chọn 2: Chạy tất cả các lệnh
firebase
bằng 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 một 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 đến một dự án Firebase, yêu cầu phải có một thư mục dự án. Bạn thiết lập một thư mục dự án bằng lệnh firebase init
. Thư mục dự án thường là thư mục giống như thư mục gố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 ứng dụng của bạn:
firebase init
Lệnh firebase init
sẽ hướng dẫn bạn các bước thiết lập thư mục dự án và một số sản phẩm của 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 thao tác sau:
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 dàn dựng và dự án phát hành công khai) với cùng một thư mục dự án.
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 nhắc bạn thiết lập cấu hình cho các tệp cụ thể của sản phẩm đã chọn. Để biết thêm thông tin 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 của Firebase.
Khi kết thúc quá trình khởi chạy, Firebase sẽ tự động tạo 2 tệp sau ở gốc thư mục ứng dụng cục bộ của bạn:
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 dự án 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 phải có tệp firebase.json
để triển khai tài sả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ủa bạn được triển khai cho dự án Firebase. 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 Firebase, hãy nhớ 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 lựa chọn Firebase Hosting 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ể mà 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 lệnh gọi trước khi triển khai 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 nguồn TypeScript và các lựa chọn lint đượ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 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 Cloud Firestore Security Rules và khác nhau 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 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"
}
],
Cloud Functions tệp 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 một danh sách các tệp trong thư mục functions
để bỏ qua. Điều này ngăn việc triển khai các tệp thừa vào 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) là:
"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 đảm bảo rằng bạn giữ (hoặc thêm, nếu thiếu) danh sách tệp xuất hiện ở 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 cho giai đoạn dàn dựng và một dự án khác cho giai đoạn phát hành công khai. Bằng cách sử dụng các môi trường dự án khác nhau, 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 tạo dự án, dự án đó sẽ tự động được chỉ định 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 của bạn:
firebase use --add
Lệnh này 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 của bạn.
Sử dụng tên thay thế của dự án
Để sử dụng các bí danh dự án Firebase được chỉ định, hãy chạy một trong các lệnh sau 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 của bạn |
firebase use \ |
Chỉ đạo tất cả các lệnh chạy trên dự án Firebase được 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 \ |
Xoá một bí danh khỏi thư mục dự án. |
Bạn có thể ghi đè 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ể thiết lập 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 cho dự án Firebase mà bạn đã chỉ định bí danh prod
, thì bạn có thể chạy, ví dụ:
.
Kiểm soát nguồn và bí danh dự án
Nói 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ẻ các 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 tệp .firebaserc
.
Nếu có một dự án phát triển chỉ dành cho riêng bạn, bạn có thể truyền cờ --project
bằng mỗi lệnh hoặc chạy firebase use PROJECT_ID
mà không cần chỉ định một biệt hiệu cho dự án Firebase.
Phân phát và kiểm thử dự án Firebase của bạn trên cục bộ
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 cho bản phát hành 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 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 thao tác 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 sản xuất (đã 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 chức năng HTTP và lưu trữ để 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ử trên 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 trên 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
CLI Firebase 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:
- Bản phát hành mới của các trang web Firebase Hosting
- Cloud Functions for Firebase mới, được cập nhật hoặc hiện có
- Giản đồ và trình kết nối mới hoặc đượ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 của bạn:
firebase deploy
Bạn có thể tuỳ ý thêm nhận xét vào từng lượt 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 Firebase Hostingtrang 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ừ một thư mục dự án, thư mục dự án phải có một tệp
firebase.json
. Tệp này được lệnhfirebase init
tự động tạo cho bạn.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 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 khi triển khai 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.
, các quy tắc được xác định trong thư mục dự án sẽ ghi đè mọi quy tắc hiện có trong bảng điều khiển Firebase. Vì vậy, nếu bạn chọn xác định hoặc chỉnh sửa các quy tắc bảo mật bằng bảng điều khiển Firebase, hãy nhớ cập nhật cả các quy tắc được xác định trong thư mục dự án của bạn.Một lựa chọn khác để tránh xung đột khi triển khai là sử dụng chế độ 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ông chắc chắn) bạn có thể vượt quá một hạn mức giới hạn tốc độ hoặc số lượng các thao tác triển khai Firebase. Ví dụ: khi triển khai số lượng 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 quy trình triển khai từng phần.
Quay lại một đợt triển khai
Bạn có thể khôi phục một bản triển khai Firebase Hosting từ trang Firebase Hosting 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.
Bạn hiện không thể quay lại 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 một cờ trên lệnh firebase deploy
. Ví dụ: lệnh sau đây triển khai nội dung Firebase Hosting và các 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 cho việc triển khai một phần. Tên trong các cờ tương ứng với các 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 |
Firebase Realtime Database quy tắc |
--only dataconnect |
Firebase Data Connect giản đồ và trình kết nối |
--only storage |
Cloud Storage for Firebase quy tắc |
--only firestore |
Cloud Firestore quy tắc và chỉ mục cho tất cả cá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 các 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 lựa chọn khác là nhóm các hàm thành các nhóm xuất trong tệp /functions/index.js
. Các hàm nhó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 đây trong 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à lựa chọn sau để xoá các hàm đã triển khai trước đó:
Xoá tất cả các hàm có tên được 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 ở một khu vực không phải khu vực 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 chức năng được 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ụ có kịch bản trước khi triển khai 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ụ trước khi triển khai hoặc sau khi triển khai. Ví dụ: một tập lệnh tiền triển khai có thể chuyển mã TypeScript thành JavaScript và một lệnh gọi lại sau triển khai có thể thông báo cho quản trị viên về việc triển khai nội dung mới trên trang web vào Firebase Hosting.
Để thiết lập các lệnh gọi trước khi triển khai 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 các tập lệnh ngắn ngay trong tệp firebase.json
hoặc bạn có thể tham chiếu đến 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ụ postdeploy gửi thông báo Slack 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 lệnh gọi predeploy
và postdeploy
cho bất kỳ tài sản nào mà bạn có thể triển khai. Lưu ý rằng việc chạy firebase deploy
sẽ kích hoạt tất cả các tác vụ predeploy và postdeploy đượ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 lệnh gọi predeploy
và postdeploy
đều in đầu ra chuẩn và luồng lỗi của tập lệnh vào thiết bị đầu cuối. Đối với các trường hợp thất bại, hãy lưu ý những điều sau:
- Nếu một lệnh gọi trước khi triển khai 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 nào, các lệnh gọi lại postdeploy sẽ không được kích hoạt.
Biến môi trường
Trong các tập lệnh chạy trong các lệnh gọi trước khi triển khai 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ệpfirebase.json
$RESOURCE_DIR
: (Chỉ dành cho tập lệnhhosting
vàfunctions
) Vị trí của thư mục chứa các tài nguyên Hosting hoặc Cloud Functions sẽ được triển khai
Quản lý nhiều phiên bản Realtime Database
Một dự án Firebase có thể có nhiều phiên bản Firebase Realtime Database. Theo mặc định, các lệnh CLI sẽ tương tác với phiên bản 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 phải là thực thể mặc định bằng cách sử dụng cờ --instance DATABASE_NAME
--instance
:
firebase database:get
firebase database:profile
firebase database:push
firebase database:remove
firebase database:set
firebase database:update
Thông tin 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 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 bằng Tài khoản Google của bạn. Cần có 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 dùng cờ --no-localhost |
login:ci | Tạo mã thông báo xác thực để sử dụng trong các môi trường không tương tác. |
logout | Đăng xuất Tài khoản Google của bạn khỏi CLI. |
open | Mở một trình duyệt để xem 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 một dự án Google Cloud hiện có. | |
projects:create | Tạo một dự án Google Cloud mới, sau đó thêm các 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 ra cấu hình dịch vụ của Google cho 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 đã 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 của mình.
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 vào dự án đang hoạt động. Đối với Firebase Hosting, 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 Firebase Hosting.
Đối với Firebase Hosting, bạn 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 các 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 một phần phụ trợ App Hosting. Bạn có thể chỉ định một ứng dụng web Firebase hiện có theo 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 \ --project PROJECT_ID |
Truy xuất danh sách tất cả các 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. |
firebase apphosting:config:export \ --project PROJECT_ID \ --secrets ENVIRONMENT_NAME |
Xuất các khoá bí mật để sử dụng trong hoạt động mô phỏng ứng dụng. Mặc định là các bí mật được lưu trữ trong apphosting.yaml hoặc lấy --secrets để chỉ định mọi môi trường 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. Nếu muốn, bạn có thể chỉ định cam kết mới nhất cho một nhánh hoặc một cam kết cụ thể. Nếu không có lựa 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 Secret Manager. Bạn có thể cung cấp đường dẫn tệp để đọc dữ liệu bí mật. Đặt thành _ để đọc dữ liệu bí mật từ đầu vào tiêu 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á bí mật đó tại thời gian xây dựng hoặc thời gian chạy. |
apphosting:secrets:describe
KEY \ --project PROJECT_ID |
Lấy siêu dữ liệu cho một bí mật và các phiên bản của bí mật đó. |
firebase apphosting:secrets:access \ KEY[@version] \ --project PROJECT_ID |
Truy cập vào một giá trị bí mật khi biết khoá bí mật và phiên bản của khoá bí mật đó. 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 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 của bạn. Lệnh này lấy các cờ sau:
|
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ụ thể 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ụ thể trong dự án Firebase. Bạn phải chọn ít nhất một cờ. Lệnh này lấy các cờ sau:
|
firestore:databases:delete DATABASE_ID |
Xoá một 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 có cờ sau:
|
firestore:delete |
Xoá các tài liệu trong cơ sở dữ liệu của dự án đang hoạt động. Khi dùng CLI, bạn có thể xoá đệ quy tất cả tài liệu trong một bộ sưu tập. 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ề việc thanh toán Cloud Firestore. Lệnh này có cờ sau:
|
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 trong 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 trong 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ộ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 một 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ã nhận dạng 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 một 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 các 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 trình bày 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ả các dịch vụ Data Connect đã triển khai trong dự án Firebase của bạn. |
dataconnect:sql:diff \ SERVICE_ID |
Đối với dịch vụ đã chỉ định, hãy 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ơ 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 các SDK được nhập cho trình kết nối Data Connect của bạn. |
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 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ã nhận dạng phiên bản cho từng tiện ích. |
ext:uninstall \ EXTENSION_INSTANCE_ID |
Xoá một thực thể tiện ích khỏi tệp kê khai tiện ích. |
ext:update \ EXTENSION_INSTANCE_ID |
Cập nhật một phiên bản 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 Extensions dành cho nhà xuất bản
Lệnh | Mô tả |
---|---|
ext:dev:init | Khởi tạo một 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 do 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 |
Không dùng nữa các phiên bản tiện ích khớp với vị từ phiên bản. Một vị từ 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 có vị từ phiên bản nào được cung cấp, thì sẽ không 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 |
Huỷ ngừng sử dụng các phiên bản tiện ích khớp với vị từ phiên bản. Vị từ 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 có vị từ phiên bản nào được cung cấp, thì sẽ huỷ bỏ việc không dùng tất cả cá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 bạn chạy lệnh này. |
Quản lý Hosting trang web | |
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 (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:
|
firebase hosting:sites:delete \ SITE_ID |
Xoá trang web Hosting đã chỉ định CLI sẽ hiển thị một 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: |
firebase hosting:sites:get \ SITE_ID |
Truy xuất thông tin về trang web Hosting được chỉ định |
firebase hosting:sites:list |
Liệt kê tất cả cá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 mặc định Hosting bằng cách sử dụng Lệnh này không triển khai đến kênh. |
firebase hosting:channel:delete \ CHANNEL_ID |
Xoá kênh phát hành thử nghiệm đượ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 vào 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 mặc định Hosting trước khi triển khai đến kênh. |
firebase hosting:channel:list | Liệt kê tất cả các kênh (bao gồm cả kênh "live") trong trang web mặc định Hosting |
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 |
Sao chép 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 "mục tiêu" đã chỉ định Lệnh này cũng triển khai đến kênh "mục tiêu" đượ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 trong trang web "target" Hosting trước khi triển khai vào 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 sang kênh "mục tiêu" đã chỉ định Lệnh này cũng triển khai đến kênh "mục tiêu" đượ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 trong trang web "target" Hosting trước khi triển khai vào kênh. Bạn có thể tìm thấy |
Lệnh Realtime Database
Xin lưu ý rằng bạn có thể tạo phiên bản Realtime Database mặc định ban đầu trong bảng điều khiển Firebase hoặc bằng cách sử dụng quy trình 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ý chúng 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 lựa chọn --location để tạo cơ sở dữ liệu ở một khu vực cụ thể. Để biết tên khu vực cần sử dụng với lựa chọn này, hãy xem phần chọn vị trí cho dự án.
Nếu dự án hiện tại chưa có phiên bản cơ sở dữ liệu nào, bạn sẽ được nhắc chạy quy trình firebase init để tạo một phiên bản.
|
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 lựa chọn --location để liệt kê cơ sở dữ liệu ở một khu vực được chỉ định. Để biết tên khu vực cần sử dụng với lựa 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 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 Realtime Database. |
database:push | Đẩy dữ liệu mới vào danh sách tại một vị trí cụ thể 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 một đối số dòng lệnh. |
database:remove | Xoá tất cả dữ liệu tại một vị trí cụ thể 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í cụ thể 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 một đối số dòng lệnh. |
database:update | Thực hiện một bản cập nhật một phần tại một vị trí cụ thể 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 một đố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ả các phiên bản hiện có hoặc tuỳ ý truyền lựa 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 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ể ghi đầu ra 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ề một số phiên bản trước được chỉ định hoặc mặc định là phiên bản ngay trước đó (phiên bản hiện tại – 1). Trừ phi --force được truyền, nếu không, hệ thống sẽ nhắc Y/N trước khi tiếp tục khôi phục. |