מסמך עזר של Firebase CLI

ה-CLI של Firebase (GitHub) מספק מגוון כלים לניהול, לצפייה ולפריסה של פרויקטים ב-Firebase.

לפני שמשתמשים ב-CLI של Firebase, להגדיר פרויקט ב-Firebase.

הגדרה או עדכון של ה-CLI

התקנת ה-CLI של Firebase

אפשר להתקין את ה-CLI של Firebase באמצעות שיטה שתואמת לפעילות שלך המערכת, רמת הניסיון ו/או תרחיש לדוגמה. ללא קשר לאופן ההתקנה של CLI, יש לכם גישה לאותה פונקציונליות ולפקודה firebase.

Windows macOS Linux

Windows

אפשר להתקין את ה-CLI של Firebase ל-Windows באחת מהאפשרויות הבאות:

אפשרות תיאור מומלץ עבור...
קובץ בינארי עצמאי מורידים את קובץ הבינארי העצמאי של ה-CLI. לאחר מכן תוכלו לגשת את קובץ ההפעלה כדי לפתוח מעטפת שבה ניתן להריץ את הפקודה firebase. מפתחים חדשים

מפתחים שלא משתמשים ב-Node.js או לא מכירים אותו
npm משתמשים ב-npm (מנהל החבילות של Node) כדי להתקין את ה-CLI ולהפעיל את הפקודה firebase שזמינה בכל העולם. מפתחים שמשתמשים ב-Node.js

בינארית עצמאית

כדי להוריד ולהפעיל את הקובץ הבינארי עבור ה-CLI של Firebase, פועלים לפי השלבים הבאים:

  1. מורידים את Firebase קוד בינארי של CLI עבור Windows

  2. ניגשים לקובץ הבינארי כדי לפתוח מעטפת שבה אפשר להריץ את הפקודה firebase.

  3. ממשיכים להתחבר ולבדוק את ה-CLI.

npm

כדי להשתמש ב-npm (מנהל החבילות של Node) כדי להתקין את ה-CLI של Firebase, מבצעים את השלבים הבאים:

  1. מתקינים את Node.js באמצעות חלונות NVM (מנהל גרסאות הצומת). התקנת Node.js מתבצעת באופן אוטומטי עם כלי הפקודה npm.

  2. מתקינים את ה-CLI של Firebase דרך npm על ידי הפעלת הפקודה הבאה:

    npm install -g firebase-tools

    הפקודה הזו מפעילה את הפקודה firebase שזמינה בכל העולם.

  3. ממשיכים להתחבר ולבדוק את CLI.

macOS או Linux

אפשר להתקין את ה-CLI של Firebase ל-macOS או ל-Linux באחת מהאפשרויות הבאות:

אפשרות תיאור מומלץ ל...
סקריפט להתקנה אוטומטית להריץ פקודה אחת שמאתרת באופן אוטומטי את מערכת ההפעלה, יוריד את הגרסה האחרונה של ה-CLI, ואז יפעיל את הפקודה firebase. מפתחים חדשים

מפתחים שלא משתמשים בהם או לא מכירים אותם Node.js

פריסות אוטומטיות במסגרת CI/CD סביבה
קובץ בינארי עצמאי מורידים את קובץ הבינארי העצמאי של ה-CLI. לאחר מכן תוכלו להגדיר ולהריץ את קובץ הבינארי בהתאם לתהליך העבודה שלכם. תהליכי עבודה שניתן להתאים אישית באופן מלא באמצעות ה-CLI
NPM השתמשו ב-npm (מנהל חבילות הצמתים) כדי להתקין את ה-CLI ולהפעיל הפקודה firebase שזמינה בכל העולם. מפתחים שמשתמשים ב-Node.js

סקריפט להתקנה אוטומטית

כדי להתקין את ה-CLI של Firebase באמצעות סקריפט ההתקנה האוטומטי:

  1. מריצים את פקודת ה-cURL הבאה:

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

    הסקריפט מזהה אוטומטית את מערכת ההפעלה, מוריד את הגרסה האחרונה של ה-CLI של Firebase, ולאחר מכן מאפשרת את ההפצה בכל העולם הפקודה firebase.

  2. ממשיכים להתחבר ולבדוק את CLI.

דוגמאות נוספות ופרטי מידע נוספים על סקריפט ההתקנה האוטומטי זמינים בקוד המקור של הסקריפט בכתובת firebase.tools.

קובץ בינארי עצמאי

כדי להוריד ולהריץ את קובץ ה-binary של CLI של Firebase שספציפי למערכת ההפעלה שלכם:

  1. מורידים את הקובץ הבינארי של ה-CLI של Firebase למערכת ההפעלה שלכם: macOS | Linux

  2. (אופציונלי) מגדירים את הפקודה firebase שזמינה בכל העולם.

    1. יוצרים את קובץ ההפעלה הבינארי על ידי הרצת chmod +x ./firebase_tools.
    2. מוסיפים את הנתיב של הקובץ הבינארי למשתנה PATH.
  3. ממשיכים להתחבר ולבדוק את ה-CLI.

NPM

כדי להשתמש ב-npm (מנהל חבילות הצמתים) להתקנת ה-CLI של Firebase, יש לבצע את השלבים הבאים:

  1. מתקינים את Node.js באמצעות nvm (מנהל הגרסאות של Node).
    התקנת Node.js מתקינה באופן אוטומטי את כלי הפקודה npm.

  2. מתקינים את ה-CLI של Firebase דרך npm על ידי הפעלת הפקודה הבאה:

    npm install -g firebase-tools

    הפקודה הזו מפעילה את הפקודה firebase שזמינה בכל העולם.

  3. ממשיכים להתחבר ולבדוק את ה-CLI.

התחברות לבדיקה של ה-CLI של Firebase

אחרי התקנת ה-CLI, צריך לבצע אימות. לאחר מכן תוכלו לאשר את האימות על ידי הצגת הפרויקטים ב-Firebase.

  1. מתחברים ל-Firebase באמצעות חשבון Google על ידי הפעלת הפקודה הבאה:

    firebase login

    הפקודה הזו מקשרת את המחשב המקומי ל-Firebase ומעניקה לכם גישה לפרויקטים ב-Firebase.

  2. כדי לבדוק אם ה-CLI מותקן כמו שצריך ויש לו גישה לחשבון, תוכלו להציג את רשימת הפרויקטים ב-Firebase. מריצים את הפקודה הבאה:

    firebase projects:list

    הרשימה שמוצגת צריכה להיות זהה לפרויקטים ב-Firebase שמפורטים ב- מסוף Firebase.

עדכון לגרסה האחרונה של CLI

באופן כללי, רצוי להשתמש בגרסת ה-CLI העדכנית ביותר של Firebase.

האופן שבו מעדכנים את גרסת ה-CLI תלוי במערכת ההפעלה ובאופן שבו התקנתם את ה-CLI.

Windows

macOS

  • סקריפט להתקנה אוטומטית: מריצים את curl -sL https://firebase.tools | upgrade=true bash
  • קובץ בינארי עצמאי: הורדת הקובץ החדש version, ואז החלפה במערכת שלך
  • npm: מריצים את הפקודה npm install -g firebase-tools

Linux

  • סקריפט להתקנה אוטומטית: מריצים את curl -sL https://firebase.tools | upgrade=true bash
  • קובץ בינארי עצמאי: הורדת הקובץ החדש version, ואז החלפה במערכת שלך
  • npm: הפעלה של npm install -g firebase-tools

שימוש ב-CLI עם מערכות CI

ה-CLI של Firebase דורש דפדפן כדי להשלים את האימות, אבל CLI תואם באופן מלא ל-CI ולסביבות אחרות ללא דפדפן GUI.

  1. במחשב עם דפדפן, מתקינים את ה-CLI של Firebase.

  2. כדי להתחיל את תהליך הכניסה, מריצים את הפקודה הבאה:

    firebase login:ci
  3. עוברים לכתובת ה-URL שצוינה ולאחר מכן מתחברים באמצעות חשבון Google.

  4. מדפיסים אסימון רענון חדש. הסשן הנוכחי ב-CLI לא יושפע.

  5. מאחסנים את אסימון הפלט באופן מאובטח אבל נגיש במערכת ה-CI.

  6. משתמשים באסימון הזה כשמריצים פקודות firebase. אפשר להשתמש באחת משתי האפשרויות הבאות:

    • אפשרות 1: שומרים את האסימון כמשתנה הסביבה FIREBASE_TOKEN. המערכת תשתמש בטוקן באופן אוטומטי.

    • אפשרות 2: מריצים את כל הפקודות של firebase עם הדגל --token TOKEN במערכת ה-CI.
      זוהי סדר העדיפויות לטעינת האסימון: דגל, משתנה סביבה, פרויקט Firebase הרצוי.

איך מפעילים פרויקט Firebase

משימות נפוצות רבות שמבוצעות באמצעות ה-CLI, כמו פריסה ב-Firebase צריך ליצור ספריית פרויקט. אתם יוצרים ספריית פרויקט באמצעות הפקודה firebase init. ספריית פרויקט היא בדרך כלל זהה בתור השורש של פקד המקור, ולאחר הרצת firebase init, הספרייה מכילה הגדרה של firebase.json חדש.

כדי לאתחל פרויקט חדש ב-Firebase, מריצים את הפקודה הבאה מתוך הספרייה של האפליקציה:

firebase init

הפקודה firebase init תנחה אתכם בהגדרה של ספריית הפרויקט וחלק מהמוצרים של Firebase. במהלך האיפוס של הפרויקט, תתבקשו לבצע את המשימות הבאות ב-CLI של Firebase:

  • בוחרים את מוצרי Firebase שרוצים להגדיר בפרויקט Firebase.

    בשלב הזה תתבקשו להגדיר הגדרות לקובצי ספציפיים של המוצרים שנבחרו. לפרטים נוספים על ההגדרות האישיות האלה, אפשר לעיין בתיעוד של מוצר ספציפי (לדוגמה, Hosting). שימו לב: תמיד יכול להריץ את הפקודה firebase init מאוחר יותר כדי להגדיר עוד מוצרים של Firebase.

  • בוחרים פרויקט ברירת מחדל ב-Firebase.

    השלב הזה משיייך את ספריית הפרויקט הנוכחית לפרויקט Firebase, כדי שאפשר יהיה להריץ פקודות ספציפיות לפרויקט (כמו firebase deploy) בפרויקט Firebase המתאים.

    אפשר גם לשייך כמה פרויקטים של Firebase (למשל פרויקט Staging ופרויקט ייצור) לאותה ספריית פרויקטים.

בסוף האתחול, מערכת Firebase יוצרת באופן אוטומטי את שני הסוגים הבאים ברמה הבסיסית (root) של ספריית האפליקציות המקומית:

  • קובץ תצורה firebase.json שכולל רשימה את ההגדרות האישיות של הפרויקט.

  • קובץ .firebaserc שמאחסן את הפרויקט כינויים.

הקובץ firebase.json

הפקודה firebase init יוצרת קובץ התצורה firebase.json בתיקייה הבסיסית (root) של ספריית הפרויקט.

הקובץ firebase.json נדרש כדי לפרוס נכסים באמצעות ה-CLI Firebase כי הוא מציין אילו קבצים והגדרות מספריית הפרויקט פרוסים פרויקט Firebase. מכיוון שניתן לקבוע הגדרות מסוימות בפרויקט למאגר או במסוף Firebase, צריך להקפיד לפתור כל אפשרות התנגשויות פריסה.

אפשר להגדיר את רוב האפשרויות של Firebase Hosting ישירות בקובץ firebase.json. עם זאת, לשירותי Firebase אחרים שאפשר לפרוס באמצעות ה-CLI של Firebase, הפקודה firebase init יוצרת קבצים ספציפיים שבהם אפשר להגדיר את ההגדרות של השירותים האלה, כמו קובץ index.js ל-Cloud Functions. אפשר בנוסף, צריך להגדיר הוקים (hooks) לפריסה או פריסה לאחר הפריסה בקובץ firebase.json.

הקובץ הבא הוא דוגמה לקובץ firebase.json עם הגדרות ברירת המחדל אם בוחרים ב-Firebase Hosting, ב-Cloud Firestore וב-Cloud Functions for Firebase (עם אפשרויות המקור והניפוי של TypeScript שנבחרו) במהלך האיפוס.

{
  "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"
    ]
  }
}

אמנם נעשה שימוש ב-firebase.json כברירת מחדל, אבל אפשר להעביר את דגל --config PATH כדי לציין קובץ תצורה.

הגדרה למספר מסדי נתונים של Cloud Firestore

בהרצת firebase init, הקובץ firebase.json יכיל מפתח firestore שתואם למסד הנתונים שמוגדר כברירת מחדל בפרויקט, כמו שמוצג למעלה.

אם הפרויקט מכיל כמה מסדי נתונים של Cloud Firestore, צריך לערוך את firebase.json לשיוך של Cloud Firestore Security Rules של קובצי המקור לאינדקס של מסד נתונים עם כל מסד נתונים. משנים את הקובץ באמצעות מערך JSON, עם רשומה אחת לכל מסד נתונים.

      "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 קבצים שאפשר להתעלם מהם בפריסה

בזמן הפריסה של הפונקציה, ה-CLI מציין באופן אוטומטי רשימה של קבצים להתעלמות מהספרייה functions. הזה ומונעת פריסה של קבצים מיותרים בקצה העורפי הגדלת נפח הנתונים של הפריסה.

כברירת מחדל, רשימת הקבצים שהמערכת מתעלמת מהם, מוצגת בפורמט JSON:

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

אם מוסיפים ערכים מותאמים אישית משלכם ל-ignore ב-firebase.json, חשוב לשמור (או להוסיף, אם היא חסרה) את רשימת הקבצים שמוצגת למעלה.

ניהול כתובות אימייל חלופיות של פרויקטים

אפשר לשייך כמה פרויקטים של Firebase לאותה ספריית פרויקט. לדוגמה, כדאי להשתמש בפרויקט Firebase אחד לסביבת Staging ובפרויקט אחר בסביבת ייצור. באמצעות שימוש בסביבות פרויקט שונות, אפשר לאמת את השינויים לפני הפריסה בסביבת הייצור. הפקודה firebase use מאפשרת להחליף בין הכינויים וגם ליצור כינויים חדשים.

הוספת כינוי לפרויקט

כשאתם בוחרים פרויקט ב-Firebase במהלך הפעלת הפרויקט, הפרויקט מקבל באופן אוטומטי את הכינוי default. אבל כדי לאפשר פקודות ספציפיות לפרויקט פועלים מול פרויקט Firebase אחר אבל עדיין משתמשים באותו פרויקט מריצים את הפקודה הבאה מתוך ספריית הפרויקט:

firebase use --add

הפקודה הזו מנחה אתכם לבחור פרויקט אחר של Firebase ולהקצות את התפקיד את הפרויקט ככינוי. הקצאות של כינויים נכתבות בקובץ .firebaserc שנמצא בתוך של ספריית הפרויקט.

שימוש בכינויים של פרויקטים

כדי להשתמש בכתובות החלופיות שהוקצו לפרויקטים ב-Firebase, מריצים כל אחת מהפקודות הבאות מ- בספריית הפרויקט.

פקודה תיאור
firebase use הצגת רשימה של כינויים שהוגדרו כרגע לספריית הפרויקט
firebase use \
PROJECT_ID|ALIAS
מנחה את כל הפקודות לרוץ מול פרויקט Firebase שצוין.
ה-CLI משתמש בפרויקט הזה בתור ה'פרויקט הפעיל' הנוכחי.
firebase use --clear ניקוי הפרויקט הפעיל.

מריצים את הפקודה firebase use PROJECT_ID|ALIAS כדי להגדיר פרויקט פעיל חדש לפני שמריצים פקודות אחרות ב-CLI.

firebase use \
--unalias PROJECT_ALIAS
הסרת כתובת אימייל חלופית מספריית הפרויקט.

כדי לשנות את הפרויקט הפעיל הנוכחי, אפשר להעביר את הדגל --project עם כל פקודה ב-CLI. לדוגמה: אפשר להגדיר את ה-CLI כך שיפעל בפרויקט Firebase שהקציתם לו את הכינוי staging. אם רוצים להריץ פקודה אחת בפרויקט Firebase שהוקצה לו הכינוי prod, אפשר להריץ, לדוגמה, את הפקודה firebase deploy --project=prod.

בקרת מקור וכינויים של פרויקטים

באופן כללי, עליך לבדוק את קובץ .firebaserc בבקרת המקור כדי תאפשר לצוות שלך לשתף כתובות אימייל חלופיות של פרויקטים. עם זאת, בפרויקטים בקוד פתוח או בתבניות להתחלה, בדרך כלל לא צריך להוסיף את הקובץ .firebaserc למערכת בקרת הגרסאות.

אם יש לכם פרויקט פיתוח לשימוש עצמי בלבד, תוכלו להעביר את הדגל --project עם כל פקודה או להריץ את firebase use PROJECT_ID בלי להקצות כינוי לפרויקט Firebase.

הצגה ובדיקה של פרויקט Firebase באופן מקומי

אפשר להציג ולבדוק את פרויקט Firebase בכתובות URL שמתארחות באופן מקומי לפני בפריסה לסביבת הייצור. אם רוצים לבדוק רק תכונות נבחרות, אפשר להשתמש ברשימת תכונות מופרדות בפסיקים בדגל של הפקודה firebase serve.

מריצים את הפקודה הבאה מהשורש של ספריית הפרויקט המקומית כדי לבצע אחת מהמשימות הבאות:

  • הצגת התוכן הסטטי של האפליקציה שמתארחת ב-Firebase.
  • השתמש ב-Cloud Functions כדי ליצור תוכן דינמי עבור Firebase Hosting ושאתם רוצים להשתמש פונקציות HTTP בייצור (פריסה) כדי לאמולציה של Hosting בכתובת URL מקומית.
firebase serve --only hosting

אמולציה של הפרויקט באמצעות פונקציות HTTP מקומיות

מריצים כל אחת מהפקודות הבאות מספריית הפרויקט כדי לבצע אמולציה של לפרויקט באמצעות פונקציות HTTP מקומיות.

  • כדי לבצע אמולציה של פונקציות HTTP ואירוח לצורך בדיקה בכתובות URL מקומיות, משתמשים באחת מהאפשרויות הבאות של הפקודות הבאות:

    firebase serve
    firebase serve --only functions,hosting // uses a flag
  • כדי ליצור אמולציה של פונקציות HTTP בלבד, משתמשים בפקודה הבאה:

    firebase serve --only functions

בדיקה ממכשירים מקומיים אחרים

כברירת מחדל, firebase serve מגיב רק לבקשות מ-localhost. כלומר, תוכלו לגשת לתוכן המתארח מהדפדפן האינטרנט של המחשב, אבל לא ממכשירים אחרים ברשת. אם רוצים לבצע בדיקה במכשירים מקומיים אחרים, משתמשים בדגל --host, כך:

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

פריסה בפרויקט Firebase

ה-CLI של Firebase מנהל את פריסת הקוד והנכסים ב-Firebase פרויקט, כולל:

  • גרסאות חדשות של האתרים שלכם ב-Firebase Hosting
  • Cloud Functions for Firebase חדש, מעודכן או קיים
  • סכימות ומחברים חדשים או מעודכנים עבור Firebase Data Connect
  • כללים לגבי Firebase Realtime Database
  • כללים ל-Cloud Storage for Firebase
  • כללים ל-Cloud Firestore
  • מדדים של Cloud Firestore

כדי לפרוס בפרויקט Firebase, מריצים את הפקודה הבאה מהפרויקט ספרייה:

firebase deploy

אפשר גם להוסיף הערה לכל אחת מהפריסות. התגובה הזו יחד עם פרטי הפריסה האחרים של הפרויקט Firebase Hosting . לדוגמה:

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

כשמשתמשים בפקודה firebase deploy, חשוב לשים לב לדברים הבאים:

  • כדי לפרוס משאבים מתיקיית פרויקט, צריך שתהיה בתיקיית הפרויקט קובץ firebase.json. הקובץ הזה נוצר באופן אוטומטי באמצעות הפקודה firebase init.

  • כברירת מחדל, הפקודה firebase deploy יוצרת גרסה לכל המשאבים שניתנים לפריסה בתיקיית הפרויקט. כדי לפרוס שירותים או תכונות ספציפיים של Firebase: להשתמש בפריסה חלקית.

התנגשויות בפריסה של כללי אבטחה

ב-Firebase Realtime Database, ב-Cloud Storage for Firebase וב-Cloud Firestore, אפשר להגדיר כללי אבטחה בספריית הפרויקט המקומית או במסוף Firebase.

אפשרות נוספת למניעת התנגשויות בפריסה היא להשתמש בפריסה חלקית ולהגדיר כללים רק במסוף Firebase.

מכסות לפריסה

יכול להיות (אבל לא סביר) שתחרגו ממכסה שמגבילה את הקצב או את הנפח של פעולות הפריסה ב-Firebase. לדוגמה, כשפורסים מספר גדול מאוד של פונקציות, עשויה להופיע הודעת השגיאה HTTP 429 Quota. כדי לפתור בעיות כאלה, אפשר לנסות באמצעות פריסה חלקית.

ביטול פריסה

אפשר להחזיר פריסה של Firebase Hosting לגרסה קודמת של הפרויקט Firebase Hosting על ידי בחירה פעולת Rollback של הגרסה הרצויה.

בשלב זה אי אפשר לבטל גרסאות של כללי אבטחה ל-Firebase Realtime Database, ל-Cloud Storage for Firebase או ל-Cloud Firestore.

פריסה של שירותים ספציפיים של Firebase

אם רוצים לפרוס רק תכונות או שירותים ספציפיים של Firebase, אפשר להשתמש רשימה שמופרדת בפסיקים בדגל בפקודה firebase deploy. לדוגמה, הפקודה הבאה פורסת את כללי האבטחה Firebase Hosting והתוכן Cloud Storage.

firebase deploy --only hosting,storage

בטבלה הבאה מפורטים השירותים והתכונות שזמינים לפריסה חלקית. השמות בדגלים תואמים למפתחות קובץ תצורה של firebase.json.

תחביר הדגל שירות או תכונה שנפרסו
--only hosting תוכן בFirebase Hosting
--only database כללי Firebase Realtime Database
--only dataconnect Firebase Data Connect סכמות ומחברים
--only storage Cloud Storage for Firebase כללים
--only firestore כללי Cloud Firestore וגם אינדקסים לכל מסדי הנתונים שהוגדרו
--only functions Cloud Functions for Firebase (יש גרסאות ספציפיות יותר של הדגל הזה)

פריסת פונקציות ספציפיות

כשפורסים פונקציות, אפשר לטרגט פונקציות ספציפיות. לדוגמה:

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

אפשרות אחרת היא לקבץ פונקציות לקבוצות ייצוא בקובץ /functions/index.js. קיבוץ פונקציות מאפשר לפרוס כמה פונקציות באמצעות פקודה אחת.

לדוגמה, אפשר לכתוב את הפונקציות הבאות כדי להגדיר groupA ו groupB:

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

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

בדוגמה הזו, קובץ functions/groupB.js נפרד מכיל פונקציות נוספות שמגדירות באופן ספציפי את הפונקציות ב-groupB. לדוגמה:

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

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

בדוגמה הזו אפשר לפרוס את כל הפונקציות של groupA על ידי הרצת בפקודה הבאה מספריית הפרויקט:

firebase deploy --only functions:groupA

אפשר גם לטרגט פונקציה ספציפית בתוך קבוצה באמצעות הפקודה הבאה: הפקודה:

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

מחיקת פונקציות

ב-CLI של Firebase יש תמיכה בפקודות ובאפשרויות הבאות למחיקת פונקציות שפרסמתם בעבר:

  • מחיקת כל הפונקציות שתואמות לשם שצוין בכל האזורים:

    firebase functions:delete FUNCTION-1_NAME

  • מחיקה של פונקציה ספציפית שפועלת באזור שאינו אזור ברירת המחדל:

    firebase functions:delete FUNCTION-1_NAME --region REGION_NAME

  • מחיקה של יותר מפונקציה אחת:

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

  • מחיקה של קבוצת פונקציות שהוגדרה:

    firebase functions:delete GROUP_NAME

  • עקיפה של בקשת האישור:

    firebase functions:delete FUNCTION-1_NAME --force

הגדרת משימות בסקריפט לפני הפריסה ואחרי הפריסה

אפשר לקשר סקריפטים של מעטפת לפקודה firebase deploy כדי לבצע משימות לפני הפריסה או אחרי הפריסה. לדוגמה, סקריפט לפריסה מראש יכול להעביר קוד TypeScript ל-JavaScript, והוק (hook) לאחר פריסה יכול להודיע האדמינים של תוכן אתר חדש פורסים ל-Firebase Hosting.

כדי להגדיר הוק לפני פריסה או אחרי פריסה, מוסיפים סקריפטים של bash לקובץ התצורה firebase.json. אפשר להגדיר סקריפטים קצרים ישירות בקובץ firebase.json, או שאפשר להפנות הקבצים שנמצאים בספריית הפרויקט שלכם.

לדוגמה, הסקריפט הבא הוא הביטוי firebase.json עבור משימה לאחר הפריסה ששולחת הודעת Slack, אחרי שהפריסה בוצעה בהצלחה Firebase Hosting.

"hosting": {
  // ...

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

קובץ הסקריפט messageSlack.sh נמצא בספריית הפרויקט ונראה כך:

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

אפשר להגדיר הוקים של predeploy ו-postdeploy לכל אחד מהנכסים שאפשר לפרוס. הערה: הרצת הפקודה firebase deploy מפעילה את כל המשימות לפני הפריסה ואחריה שהוגדרו קובץ firebase.json. כדי להריץ רק את המשימות שמשויכות לשירות Firebase ספציפי, משתמשים בפקודות פריסת חלקית.

ההוקים (hooks) predeploy ו-postdeploy מדפיסים את הפלט והשגיאה הרגילים של הסקריפטים לטרמינל. במקרים של כשלים, חשוב לשים לב לנקודות הבאות:

  • אם ה-hook של הפריסה מראש לא מסתיים כצפוי, הפריסה מבוטלת.
  • אם הפריסה נכשלת מסיבה כלשהי, ה-hooks לאחר הפריסה לא יופעלו.

משתני סביבה

בסקריפטים שפועלים ב-predeploy וב-postdeploy hooks, משתני הסביבה הבאים זמינים:

  • $GCLOUD_PROJECT: מזהה הפרויקט הפעיל
  • $PROJECT_DIR: תיקיית השורש שמכילה את הקובץ firebase.json
  • $RESOURCE_DIR: (לסקריפטים hosting ו-functions בלבד) מיקום הספרייה שמכילה את Hosting או Cloud Functions משאבים לפריסה

ניהול כמה מופעים של Realtime Database

לפרויקט Firebase יכול להיות מספר מופעים של Firebase Realtime Database. כברירת מחדל, פקודות ה-CLI פועלות עם מכונה של מסד נתונים שמוגדרת כברירת מחדל.

עם זאת, אפשר לבצע פעולות במכונה של מסד נתונים שאינה ברירת המחדל באמצעות הדגל --instance DATABASE_NAME. הפקודות הבאות תומכות בדגל --instance:

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

הפניות לפקודות

פקודות ניהוליות ב-CLI

פקודה תיאור
עזרה הצגת מידע עזרה על ה-CLI או על פקודות ספציפיות.
init שיוך והגדרה של פרויקט Firebase חדש בספרייה הנוכחית. הפקודה הזו יוצרת firebase.json בקובץ התצורה בספרייה הנוכחית.
login אימות ה-CLI לחשבון Firebase. נדרשת גישה לדפדפן אינטרנט.
להתחבר ל-CLI בסביבות מרוחקות שלא מאפשרות גישה אל localhost, יש להשתמש ב---no-localhost לסמן.
login:ci יוצר אסימון אימות לשימוש בממשק לא אינטראקטיבי בסביבות שונות.
התנתקות יוצאים מהחשבון ב-Firebase.
פתיחה פתיחת דפדפן עם משאבי הפרויקט הרלוונטיים.
projects:list בתיבת הדו-שיח הזו מפורטים כל הפרויקטים ב-Firebase שיש לך גישה אליהם.
שימוש הגדרת פרויקט Firebase הפעיל עבור ה-CLI.
ניהול כינויים של פרויקטים.

פקודות לניהול פרויקטים

פקודה תיאור
ניהול פרויקטים ב-Firebase
projects:addfirebase הוספה של משאבי Firebase לפרויקט Google Cloud קיים.
projects:create יצירת פרויקט Google Cloud חדש ולאחר מכן הוספת משאבי Firebase אל בפרויקט החדש.
projects:list כאן מפורטים כל הפרויקטים ב-Firebase שיש לכם גישה אליהם.
ניהול של אפליקציות Firebase (iOS, Android, אינטרנט)
apps:create יצירת אפליקציית Firebase חדשה בפרויקט הפעיל.
apps:list רשימה של אפליקציות Firebase הרשומים בפרויקט הפעיל.
apps:sdkconfig הדפסת תצורת שירותי Google של אפליקציית Firebase.
setup:web התכונה הוצאה משימוש. במקום זאת, צריך להשתמש ב-apps:sdkconfig ולציין את web כארגומנטים של הפלטפורמה.
הדפסה של ההגדרות של שירותי Google באפליקציית אינטרנט של Firebase.
ניהול גיבובים של אישורי SHA (ב-Android בלבד)
apps:android:sha:create \
FIREBASE_APP_ID SHA_HASH
הוספת גיבוב האישור של SHA שצוין לאפליקציית Firebase ל-Android שצוינה.
apps:android:sha:delete \
FIREBASE_APP_ID SHA_HASH
מחיקת הגיבוב (hash) של אישור ה-SHA שצוין מהפרמטר שצוין אפליקציית Firebase ל-Android.
apps:android:sha:list \
FIREBASE_APP_ID
הצגת גרסאות הגיבוב של אישורי ה-SHA של אפליקציית Firebase ל-Android שצוינה.

פריסה ופיתוח מקומי

הפקודות האלה מאפשרות לפרוס את האתר של Firebase Hosting ולבצע בו פעולות.

פקודה תיאור
לפרוס פריסת קוד ונכסים מספריית הפרויקט לספריית הפרויקט פרויקט. עבור Firebase Hosting, firebase.json נדרש קובץ תצורה.
serve הפעלת שרת אינטרנט מקומי עם ההגדרות של Firebase Hosting. עבור Firebase Hosting, firebase.json נדרש קובץ תצורה.

פקודות App Distribution

פקודה תיאור
appdistribution:distribution \
--app FIREBASE_APP_ID
ה-build יהיה זמין לבודקים.
appdistribution:testers:add הוספת בודקים לפרויקט.
appdistribution:testers:remove הסרת הבודקים מהפרויקט.

פקודות App Hosting

פקודה תיאור
apphosting:backends:create \
--project PROJECT_ID \
--location REGION --app APP_ID
יצירת אוסף של משאבים מנוהלים שמקושרים ל-codebase אחד שמרכיבים קצה עורפי של App Hosting. אופציונלי: אפשר לציין שם משתמש קיים אפליקציית האינטרנט של Firebase לפי המזהה שלה ב-Firebase.
apphosting:backends:get \
BACKEND_ID \
--project PROJECT_ID \
--מיקום REGION
אחזור פרטים ספציפיים, כולל כתובת ה-URL הציבורית, של קצה עורפי.
apphosting:backends:list \
--project PROJECT_ID
אחזור רשימה של כל הקצוות העורפיים הפעילים שמשויכים לפרויקט.
firebase apphosting:backends:delete \
BACKEND_ID \
--project PROJECT_ID \
--מיקום REGION
מחיקת קצה עורפי מהפרויקט.
Firebase apphosting:rollouts:create \
BACKEND_ID \
--git_branch BRANCH_NAME \
--git_commit COMMIT_ID
יצירת השקה שמופעל באופן ידני.
אפשר לציין את ההתחייבות האחרונה להסתעפות או לשמירה ספציפית. אם לא צוינו אפשרויות, תוצג בקשה לבחירה מתוך רשימת ההסתעפויות.
apphosting:secrets:set KEY --project PROJECT_ID \
--location REGION \
--data-file DATA_FILE_PATH
אחסון חומרים סודיים ב-Secret Manager.
אפשר לציין נתיב לקובץ שממנו יקראו את הנתונים הסודיים. הגדרה לערך _ כדי לקרוא נתונים סודיים מקלט רגיל.
apphosting:secrets:grantaccess KEY BACKEND_ID \
--project PROJECT_ID \
--location REGION
מעניק לחשבון השירות לקצה העורפי גישה לסוד שסופק, כדי ש-App Hosting יוכל לגשת אליו בזמן ה-build או זמן הריצה.
apphosting:secrets:describe KEY \
--project PROJECT_ID
אחזור המטא-נתונים של סוד והגרסאות שלו.
firebase apphosting:secrets:access \
KEY[@version] \
--project PROJECT_ID
גישה לערך סוד בהתאם לסוד ולגרסה שלו. ברירת המחדל היא הגרסה העדכנית ביותר.

פקודות Authentication (ניהול משתמשים)

פקודה תיאור
auth:export מייצאת את חשבונות המשתמשים של הפרויקט הפעיל לקובץ JSON או CSV. עבור לקבלת פרטים נוספים, אפשר לקרוא auth:Import ו-auth:export .
auth:import ייבוא חשבונות המשתמשים מקובץ JSON או CSV לפרויקט הפעיל. פרטים נוספים זמינים בדף auth:import ו-auth:export.

פקודות Cloud Firestore

פקודה תיאור
firestore:locations

הצגת רשימה של המיקומים הזמינים למסד הנתונים Cloud Firestore.

firestore:databases:create DATABASE_ID

יוצרים מכונה של מסד נתונים במצב נייטיב בפרויקט Firebase.

הפקודה משתמשת בדגלים הבאים:

  • ‎--location <region name> כדי לציין את מיקום הפריסה של מסד הנתונים. הערה שאפשר להפעיל firebasestore:locations לרשימה זמינה מיקומים. חובה.
  • --delete-protection <deleteProtectionState> כדי לאפשר או למנוע מחיקה של מסד הנתונים שצוין. ערכים חוקיים הם ENABLED או DISABLED. ברירת המחדל היא DISABLED.
  • --point-in-time-recovery <PITRState> מגדירים אם שחזור הנתונים מנקודה מסוימת בזמן מופעל. הערכים החוקיים הם ENABLED או DISABLED. ברירת המחדל היא DISABLED. זה שינוי אופציונלי.
firestore:databases:list

הצגת רשימה של מסדי נתונים בפרויקט Firebase.

firestore:databases:get DATABASE_ID

קבלת תצורה של מסד נתונים עבור מסד נתונים ספציפי פרויקט Firebase.

firestore:databases:update DATABASE_ID

עדכון ההגדרות של מסד נתונים מסוים בפרויקט Firebase.

יש צורך בסימון אחד לפחות. הפקודה כוללת את הדגלים הבאים:

  • --delete-protection <deleteProtectionState> כדי לאפשר או למנוע מחיקה של מסד הנתונים שצוין. הערכים החוקיים הם ENABLED או DISABLED. ברירת המחדל היא DISABLED
  • ‎--point-in-time-recovery <PITRState> כדי להגדיר אם שחזור מערכת מנקודה מסוימת בזמן מופעל. הערכים החוקיים הם: ENABLED או DISABLED. ברירת המחדל היא DISABLED זה שינוי אופציונלי.
firestore:databases:delete DATABASE_ID

מחיקה של מסד נתונים בפרויקט Firebase.

firestore:indexes

הצגת רשימה של אינדקסים למסד נתונים בפרויקט Firebase.

הפקודה כוללת את הדגל הבא:

  • --database DATABASE_ID עד לציין את שם מסד הנתונים שעבורו יש להציג את רשימת האינדקסים. אחרת שצוינו, האינדקסים רשומים עבור מסד הנתונים המוגדר כברירת מחדל.
firestore:delete

מחיקה של מסמכים במסד הנתונים של הפרויקט הפעיל. באמצעות ה-CLI, אפשר למחוק באופן רקורסיבי את כל המסמכים באוסף.

חשוב לזכור שמחיקת נתוני Cloud Firestore באמצעות ה-CLI כרוכה בעלויות קריאה ומחיקה. מידע נוסף זמין במאמר הסבר על חיוב ב-Cloud Firestore.

הפקודה כוללת את הדגל הבא:

  • --database DATABASE_ID כדי לציין את שם מסד הנתונים שממנו המסמכים נמחקים. אם לא מציינים את השדה, המסמכים נמחקים ממסד הנתונים שמוגדר כברירת מחדל. זה שינוי אופציונלי.

פקודות Cloud Functions for Firebase

פקודה תיאור
functions:config:clone העתקה (cloning) של הסביבה של פרויקט אחר לפרויקט הפעיל ב-Firebase.
functions:config:get אחזור של ערכי ההגדרות הקיימים של Cloud Functions בפרויקט הפעיל.
functions:config:set מאגר הערכים של הגדרות זמן הריצה של Cloud Functions בפרויקט הפעיל.
functions:config:unset הסרת ערכים מהגדרות זמן הריצה של הפרויקט הפעיל.
functions:log קריאת יומנים מפריסת Cloud Functions.

למידע נוסף, אפשר לעיין בקטע סביבה מדריכים בנושא הגדרות אישיות.

פקודות Crashlytics

פקודה תיאור
crashlytics:mappingfile:generateid \
--resource-file=PATH/TO/ANDROID_RESOURCE.XML
יוצר מזהה קובץ מיפוי ייחודי במשאב Android שצוין (XML).
crashlytics:mappingfile:upload \
---app=FIREBASE_APP_ID \
--resource-file=PATH/TO/ANDROID_RESOURCE.XML \
PATH/TO/MAPPING_FILE.TXT
מעלה קובץ מיפוי תואם ProGuard (TXT) לאפליקציה הזו, ומשייך אותו למזהה קובץ המיפוי שהוצהר קובץ של משאב Android (XML).
crashlytics:symbols:upload \
--app=FIREBASE_APP_ID \
PATH/TO/SYMBOLS
הכלי יוצר קובץ סמלים תואם ל-Crashlytics לקריסות בספרייה ילידית ב-Android, ומעלה אותו לשרתים של Firebase.

פקודות Data Connect

אפשר לקרוא מידע נוסף על הפקודות האלה ועל התרחישים לדוגמה שלהן Data Connect מדריך עזר ל-CLI.

פקודה תיאור
dataconnect:services:list רשימה של כל שירותי Data Connect שנפרסו ב-Firebase פרויקט.
dataconnect:sql:diff \
SERVICE_ID
עבור השירות שצוין, מציג את ההבדלים בין סכימת Data Connect וסכימת מסד הנתונים של Cloud SQL.
dataconnect:sql:migrate \
--force \
SERVICE_ID
מעביר את הסכימה של מסד הנתונים ב-Cloud SQL כדי להתאים לערך המקומי סכימה אחת (Data Connect).
dataconnect:sql:grant\
--role=ROLE \
--email=EMAIL \
SERVICE_ID
התפקיד ב-SQL משויך לכתובת האימייל של המשתמש או של חשבון השירות שצוינו.
בדגל --role, תפקיד ה-SQL שצריך להקצות הוא: owner, writer או reader.
עבור הדגל --email, יש לציין את כתובת האימייל של משתמש או חשבון שירות כדי להקצות להם את התפקיד.
dataconnect:sdk:generate יצירת ערכות SDK מוגדרות לסוגים למחברים של Data Connect.

פקודות Extensions

פקודה תיאור
תוספים מציג מידע על אופן השימוש בפקודות Firebase Extensions.
רשימת המופעים של התוסף שמותקנים בפרויקט הפעיל.
ext:configure \
EXTENSION_INSTANCE_ID
מגדיר מחדש את ערכי הפרמטרים של מופע של תוסף מניפסט של תוסף.
ext:info \
PUBLISHER_ID/EXTENSION_ID
הדפסת מידע מפורט על תוסף.
ext:install \
PUBLISHER_ID/EXTENSION_ID
הוספת מופע חדש של תוסף אל מניפסט של תוסף.
ext:list הצגת רשימה של כל המופעים של התוסף שמותקנים בפרויקט Firebase.
הדפסת מזהה המכונה של כל תוסף.
ext:uninstall \
EXTENSION_INSTANCE_ID
הסרה של מופע של תוסף ממניפסט התוסף.
ext:update \
EXTENSION_INSTANCE_ID
מעדכנת מכונה של תוסף לגרסה האחרונה במניפסט של התוסף.
ext:export מייצאת את כל המופעים של התוספים המותקנים מהפרויקט אל מניפסט של תוסף.

פקודות של בעלי תוכן דיגיטלי ב-Extensions

פקודה תיאור
ext:dev:init הפונקציה מפעילה את יצירת קוד השלד של תוסף חדש בספרייה הנוכחית.
ext:dev:list \
PUBLISHER_ID
מדפיסה רשימה של כל התוספים שהועלו על ידי בעל התוכן הדיגיטלי.
ext:dev:register רישום פרויקט Firebase בתור תוספים לפרויקט של בעל התוכן הדיגיטלי.
ext:dev:deprecate \
PUBLISHER_ID/EXTENSION_ID \
VERSION_PREDICATE
הוצאה משימוש של גרסאות התוסף שתואמות לתנאי לגבי הגרסה.
תנאי גרסה יכול להיות גרסה אחת (כמו 1.0.0) או טווח גרסאות (כמו >1.0.0).
אם לא צוין תנאי גרסה, יבוטל השימוש בכל הגרסאות של התוסף.
ext:dev:undeprecate \
PUBLISHER_ID/EXTENSION_ID \
VERSION_PREDICATE
מבטלים את ההוצאה משימוש של גרסאות התוסף שתואמות לתנאי לגבי הגרסה.
פרדיקט של גרסה יכול להיות גרסה יחידה (למשל 1.0.0), או טווח של גרסאות (כמו >1.0.0).
אם לא סופקו פרדיקט גרסה, מוציא משימוש את כל הגרסאות של התוסף הזה.
ext:dev:upload \
PUBLISHER_ID/EXTENSION_ID
העלאת גרסה חדשה של תוסף.
ext:dev:usage \
PUBLISHER_ID
מציגה ספירת התקנות ומדדי שימוש של תוספים שהועלו על ידי בעל אפליקציה.

פקודות Hosting

פקודה תיאור
hosting:disable

הפסקת הצגת תנועה מ-Firebase Hosting בפרויקט הפעיל ב-Firebase.

אחרי שתפעילו את הפקודה הזו, תוצג ההודעה 'האתר לא נמצא' בכתובת ה-URL Hosting של הפרויקט.

ניהול של Hosting אתרים
firebase:sites:create \
SITE_ID

יצירת אתר Hosting חדש בפרויקט Firebase הפעיל באמצעות ציינת SITE_ID

(אופציונלי) מציינים אפליקציית אינטרנט קיימת ב-Firebase לשיוך עם האתר החדש, על ידי העברת הדגל הבא: --app FIREBASE_APP_ID

firebase:sites:delete \
SITE_ID

מחיקת האתר Hosting שצוין

ה-CLI מציג בקשת אישור לפני מחיקת האתר.

(אופציונלי) כדי לדלג על הודעת האישור, מעבירים את הדגלים הבאים: -f או --force

firebase hosting:sites:get \
SITE_ID

אחזור מידע על האתר שצוין ב-Hosting

firebase:sites:list

רשימה של כל Hosting האתרים של פרויקט Firebase הפעיל

ניהול של ערוצי תצוגה מקדימה
firebase hosting:channel:create \
CHANNEL_ID

יצירת ערוץ תצוגה מקדימה חדש באתר Hosting שמוגדר כברירת מחדל באמצעות CHANNEL_ID שצוין

הפקודה הזו לא נפרסת בערוץ.

firebase:channel:delete \
CHANNEL_ID

מחיקת הערוץ לתצוגה המקדימה שצוין

אי אפשר למחוק ערוץ פעיל של אתר.

firebase:channel:deploy \
CHANNEL_ID

פריסת התוכן וההגדרות של Hosting בערוץ התצוגה המקדימה שצוין

אם ערוץ התצוגה המקדימה עדיין לא קיים, הפקודה הזו יוצרת את הערוץ באתר Hosting שמוגדר כברירת מחדל לפני הפריסה בערוץ.

firebase hosting:channel:list מפרט את כל הערוצים (כולל הערוץ ה"בשידור חי") ברירת מחדל אתר Hosting
firebase hosting:channel:open \
CHANNEL_ID
פתיחת דפדפן לכתובת ה-URL של הערוץ שצוין או החזרת כתובת ה-URL אם לא ניתן לפתוח בדפדפן
יצירת עותקים מקודמים של גרסאות
firebase:clone \
SOURCE_SITE_ID:SOURCE_CHANNEL_ID \
TARGET_SITE_ID:TARGET_CHANNEL_ID

שכפול הגרסה האחרונה שנפרסה ב'מקור' שצוין ערוץ ל"יעד" שצוין ערוץ

הפקודה הזו גם פורסת בערוץ 'target' שצוין. אם "target" הערוץ עדיין לא קיים, הפקודה הזו יוצרת קובץ חדש תצוגה מקדימה של הערוץ ב"יעד" אתר אחד (Hosting) לפני פריסה אל את הערוץ.

firebase hosting:clone \
SOURCE_SITE_ID:@VERSION_ID \
TARGET_SITE_ID:TARGET_CHANNEL_ID

הכלי יוצר עותק (clone) של הגרסה שצוינה בערוץ 'target' שצוין

הפקודה הזו גם נפרסת ב-"target" שצוין . אם הערוץ 'target' עדיין לא קיים, הפקודה הזו יוצרת ערוץ תצוגה מקדימה חדש באתר Hosting של היעד לפני הפריסה בערוץ.

אפשר למצוא את VERSION_ID במרכז הבקרה Hosting של מסוף Firebase.

פקודות Realtime Database

שימו לב שאפשר ליצור את המכונה הראשונית של Realtime Database כברירת מחדל במסוף Firebase, או באמצעות תהליך העבודה הכללי של firebase init או תהליך העבודה הספציפי של firebase init database.

אחרי שיוצרים את המכונות, אפשר לנהל אותן כפי שמתואר במאמר ניהול מכונות Realtime Database מרובות.

פקודה תיאור
database:get אחזור נתונים ממסד הנתונים של הפרויקט הפעיל והצגתם כ-JSON. ניתן לשלוח שאילתות לגבי נתונים שנוספו לאינדקס.
database:instances:create יצירת מכונה של מסד נתונים עם שם מכונה שצוין. מקבל האפשרות --location ליצירת מסד נתונים אזור. כדי לקרוא על שמות של אזורים שאפשר להשתמש בהם באפשרות הזו: בוחרים מיקומים לפרויקט. אם לא קיים מכונה של מסד נתונים בפרויקט הנוכחי, תתבקשו להריץ את התהליך firebase init כדי ליצור מכונה.
database:instances:list הצגת רשימה של כל מכונות מסדי הנתונים בפרויקט הזה. מקבל אפשרות של --location להצגת מסדי נתונים בטווח שצוין אזור. שמות האזורים שאפשר להשתמש בהם עם האפשרות הזו מפורטים בקטע בחירת מיקומים לפרויקט.
database:profile יצירת פרופיל של פעולות במסד הנתונים של הפרויקט הפעיל. למידע נוסף, ראו סוגי הפעולות של Realtime Database.
database:push דחיפה של נתונים חדשים לרשימה במיקום מסוים במסד הנתונים של הפרויקט הפעיל. מקבל קלט מקובץ, מ-STDIN או משורת פקודה ארגומנט.
database:remove מחיקה של כל הנתונים במיקום מסוים במסד הנתונים של הפרויקט הפעיל.
database:set החלפת כל הנתונים במיקום מסוים במסד הנתונים של הפרויקט הפעיל. הפונקציה מקבלת קלט מקובץ, מ-STDIN או מארגומנט בשורת הפקודה.
database:update ביצוע עדכון חלקי במיקום מסוים במסד הנתונים של הפרויקט הפעיל. מקבל קלט מקובץ, מ-STDIN או משורת פקודה ארגומנט.

פקודות Remote Config

פקודה תיאור
remoteconfig:versions:list \
--limit NUMBER_OF_VERSIONS
רשימה של עשר הגרסאות האחרונות של התבנית. מציינים את הערך 0 כדי להציג את כל הגרסאות הקיימות, או מעבירים את האפשרות --limit כדי להגביל את מספר הגרסאות שיוחזרו.
remoteconfig:get \
--v, version_number VERSION_NUMBER
--o, פלט FILENAME
הפונקציה מקבלת את התבנית לפי גרסה (ברירת המחדל היא הגרסה האחרונה) ומפיקה טבלה עם שמות וגרסת הקבוצות, הפרמטרים והתנאים של הפרמטרים. אפשר גם לכתוב את הפלט בקובץ מסוים באמצעות -o, FILENAME.
remoteconfig:rollback \
--v, version_number VERSION_NUMBER
--force
החזרת התבנית Remote Config לגרסה קודמת מסוימת, או הגדרת ברירת המחדל לגרסה הקודמת (הגרסה הנוכחית -1). אם לא מעבירים את הערך --force, תוצג ההודעה Y/N לפני שתמשיכו בחזרה לאחור.