مرجع واجهة سطر الأوامر في Firebase

يوفّر واجهة سطر الأوامر في Firebase (GitHub) مجموعة متنوعة من الأدوات لإدارة مشاريع Firebase وعرضها ونشرها.

قبل استخدام واجهة سطر الأوامر في Firebase، يمكنك إعداد مشروع Firebase.

إعداد واجهة سطر الأوامر أو تحديثه

تثبيت واجهة سطر الأوامر في Firebase

يمكنك تثبيت واجهة سطر الأوامر في Firebase باستخدام طريقة تتوافق مع نظام التشغيل و/أو مستوى الخبرة و/أو حالة الاستخدام. وبغض النظر عن طريقة تثبيت واجهة سطر الأوامر، يمكنك الوصول إلى الوظائف نفسها والأمر firebase.

نظام التشغيل Windows macOS نظام التشغيل Linux

نظام التشغيل Windows

يمكنك تثبيت واجهة سطر الأوامر في Firebase لنظام التشغيل Windows باستخدام أحد الخيارات التالية:

الخيار الوصف إجراءات مقترَحة لـ...
برنامج ثنائي مستقل نزِّل البرنامج الثنائي المستقل لواجهة سطر الأوامر. بعد ذلك، يمكنك الوصول إلى الملف التنفيذي لفتح واجهة أوامر تتيح لك تنفيذ الأمر firebase. المطوّرون الجُدد

المطوِّرون الذين لا يستخدمون Node.js أو على دراية بها
دقيقة في الدقيقة استخدِم npm (أداة إدارة حزم العقدة) لتثبيت واجهة سطر الأوامر وتفعيل أمر firebase المتاح عالميًا. المطوّرون الذين يستخدمون Node.js

برنامج ثنائي مستقل

لتنزيل البرنامج الثنائي لواجهة سطر الأوامر في Firebase وتشغيله، اتبع الخطوات التالية:

  1. نزِّل برنامج Firebase CLI الثنائي لنظام التشغيل Windows.

  2. افتح البرنامج الثنائي لفتح واجهة مستخدم تتيح لك تنفيذ الأمر firebase.

  3. المتابعة إلى تسجيل الدخول واختبار واجهة سطر الأوامر

دورة في الدقيقة

لاستخدام npm (مدير حزم العقدة) لتثبيت واجهة سطر الأوامر بنظام Firebase، اتّبِع الخطوات التالية:

  1. ثبِّت Node.js باستخدام nvm-Windows (مدير إصدارات العقدة). يؤدي تثبيت Node.js إلى تثبيت أدوات أوامر npm تلقائيًا.

  2. ثبِّت واجهة سطر الأوامر لمنصّة Firebase من خلال npm من خلال تنفيذ الأمر التالي:

    npm install -g firebase-tools

    يفعِّل هذا الأمر الأمر firebase المتاح عالميًا.

  3. المتابعة إلى تسجيل الدخول واختبار واجهة سطر الأوامر

نظام التشغيل macOS أو Linux

يمكنك تثبيت واجهة سطر الأوامر في Firebase لنظام التشغيل macOS أو Linux باستخدام أحد الخيارات التالية:

الخيار الوصف إجراءات مقترَحة لـ...
نص التثبيت التلقائي شغِّل أمرًا واحدًا يكشف تلقائيًا عن نظام التشغيل، وينزِّل أحدث إصدار من واجهة سطر الأوامر، ثم يفعّل أمر firebase المتاح عالميًا. المطوّرون الجُدد

مطوّرو البرامج الذين لا يستخدمون Node.js أو على دراية بها

عمليات النشر المبرمَجة في بيئة CI/CD
برنامج ثنائي مستقل نزِّل البرنامج الثنائي المستقل لواجهة سطر الأوامر. بعد ذلك، يمكنك إعداد البرنامج الثنائي وتشغيله بما يتناسب مع سير عملك. عمليات سير عمل قابلة للتخصيص بالكامل باستخدام واجهة سطر الأوامر
دقيقة في الدقيقة استخدِم npm (أداة إدارة حزم العقدة) لتثبيت واجهة سطر الأوامر وتفعيل أمر firebase المتاح عالميًا. المطوّرون الذين يستخدمون Node.js

تثبيت تلقائي للنص البرمجي

لتثبيت واجهة سطر الأوامر في Firebase باستخدام النص البرمجي للتثبيت التلقائي، اتّبِع الخطوات التالية:

  1. شغِّل أمر cURL التالي:

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

    يرصد هذا النص البرمجي تلقائيًا نظام التشغيل، وينزّل أحدث إصدار من واجهة سطر الأوامر في Firebase، ثم يفعّل أمر firebase المتاح عالميًا.

  2. المتابعة إلى تسجيل الدخول واختبار واجهة سطر الأوامر

للاطّلاع على المزيد من الأمثلة والتفاصيل عن النص البرمجي للتثبيت التلقائي، يمكنك الرجوع إلى رمز مصدر النص البرمجي في firebase.tools.

برنامج ثنائي مستقل

لتنزيل البرنامج الثنائي وتشغيل واجهة سطر الأوامر الخاصة بـ Firebase والمخصص لنظام التشغيل لديك، اتبع الخطوات التالية:

  1. يمكنك تنزيل البرنامج الثنائي لواجهة سطر الأوامر في Firebase لنظام التشغيل الخاص بك: macOS | Linux

  2. (اختياري) يمكنك إعداد أمر firebase المتاح عالميًا.

    1. اجعل البرنامج الثنائي قابلاً للتنفيذ من خلال تشغيل chmod +x ./firebase_tools.
    2. أضِف مسار البرنامج الثنائي إلى PATH.

  3. المتابعة إلى تسجيل الدخول واختبار واجهة سطر الأوامر

دورة في الدقيقة

لاستخدام npm (مدير حزم العقدة) لتثبيت واجهة سطر الأوامر بنظام Firebase، اتّبِع الخطوات التالية:

  1. ثبِّت Node.js باستخدام nvm (مدير إصدارات العقدة).
    يؤدي تثبيت Node.js إلى تثبيت أدوات أوامر npm تلقائيًا.

  2. ثبِّت واجهة سطر الأوامر لمنصّة Firebase من خلال npm من خلال تنفيذ الأمر التالي:

    npm install -g firebase-tools

    يفعِّل هذا الأمر الأمر firebase المتاح عالميًا.

  3. المتابعة إلى تسجيل الدخول واختبار واجهة سطر الأوامر

سجِّل الدخول واختبِر واجهة سطر الأوامر (CLI) في Firebase.

بعد تثبيت واجهة سطر الأوامر، يجب إجراء المصادقة. بعد ذلك، يمكنك تأكيد المصادقة من خلال إدراج مشاريع Firebase.

  1. سجّل الدخول إلى Firebase باستخدام حساب Google عن طريق تنفيذ الأمر التالي:

    firebase login

    يربط هذا الأمر جهازك المحلي بمنصة Firebase ويمنحك إذن الوصول إلى مشاريع Firebase.

  2. تأكّد من تثبيت واجهة سطر الأوامر بشكل صحيح وأنّه يدخل إلى حسابك من خلال إدراج مشاريع Firebase. شغِّل الأمر التالي:

    firebase projects:list

    يجب أن تكون القائمة المعروضة مماثلة لمشاريع Firebase المدرَجة في وحدة تحكُّم Firebase.

التحديث إلى آخر إصدار من واجهة سطر الأوامر

وننصحك باستخدام أحدث إصدار من واجهة سطر الأوامر في Firebase بشكل عام.

تعتمد كيفية تحديث إصدار واجهة سطر الأوامر على نظام التشغيل وكيفية تثبيت واجهة سطر الأوامر.

شبابيك

نظام التشغيل macOS

  • نص التثبيت التلقائي: تشغيل curl -sL https://firebase.tools | upgrade=true bash
  • برنامج ثنائي مستقل: يمكنك تنزيل الإصدار الجديد، ثم استبداله على النظام
  • npm: تشغيل npm install -g firebase-tools

Linux

  • نص التثبيت التلقائي: تشغيل curl -sL https://firebase.tools | upgrade=true bash
  • برنامج ثنائي مستقل: يمكنك تنزيل الإصدار الجديد، ثم استبداله على النظام
  • npm: تشغيل npm install -g firebase-tools

استخدام واجهة سطر الأوامر مع أنظمة CI

يتطلّب واجهة سطر الأوامر في Firebase متصفّحًا لإكمال المصادقة، إلا أنّ واجهة سطر الأوامر تتوافق تمامًا مع واجهة CI وغيرها من البيئات التي بلا واجهة مستخدم رسومية.

  1. على جهاز مزوّد بمتصفّح، عليك تثبيت واجهة سطر الأوامر في Firebase.

  2. ابدأ عملية تسجيل الدخول من خلال تشغيل الأمر التالي:

    firebase login:ci

  3. انتقِل إلى عنوان URL المقدَّم، ثم سجِّل الدخول باستخدام حساب Google.

  4. اطبع رمزًا مميزًا جديدًا لإعادة التحميل. لن تتأثر جلسة CLI الحالية.

  5. خزِّن الرمز المميّز للإخراج بطريقة آمنة ولكن يسهل الوصول إليها في نظام CI.

  6. استخدِم هذا الرمز المميّز عند تشغيل أوامر firebase. يمكنك استخدام أي من الطريقتين التاليتين:

    • الخيار 1: تخزين الرمز المميّز كمتغيّر البيئة FIREBASE_TOKEN وسيستخدم نظامك الرمز المميّز تلقائيًا.

    • الخيار 2: يمكنك تنفيذ جميع أوامر firebase باستخدام علامة --token TOKEN في نظام CI.
      هذا هو ترتيب الأسبقية لتحميل الرمز المميّز: العلامة ومتغيّرات البيئة ومشروع Firebase المطلوب.

إعداد مشروع Firebase

تتطلب العديد من المهام الشائعة التي يتم تنفيذها باستخدام واجهة سطر الأوامر، مثل النشر في مشروع Firebase، دليل المشروع. يمكنك إنشاء دليل مشروع باستخدام الأمر firebase init. عادةً ما يكون دليل المشروع هو الدليل نفسه الموجود في جذر عنصر التحكم في المصدر، وبعد تشغيل firebase init، يحتوي الدليل على ملف إعداد firebase.json.

لإعداد مشروع جديد في Firebase، شغِّل الأمر التالي من داخل دليل تطبيقك:

firebase init

يوجِّهك الأمر firebase init خلال عملية إعداد دليل المشروع وبعض منتجات Firebase. أثناء تهيئة المشروع، يطلب منك واجهة سطر الأوامر في Firebase إكمال المهام التالية:

  • اختَر منتجات Firebase التي تريد إعدادها في مشروع Firebase.

    وتطلب منك هذه الخطوة ضبط عمليات ضبط لملفات محددة للمنتجات المحدّدة. لمعرفة المزيد من التفاصيل حول عمليات الضبط هذه، يمكنك الرجوع إلى مستندات المنتج المحدّد (على سبيل المثال، الاستضافة). يُرجى العِلم أنّه يمكنك دائمًا تشغيل firebase init لاحقًا لإعداد المزيد من منتجات Firebase.

  • اختَر مشروعًا تلقائيًا في Firebase.

    تربط هذه الخطوة دليل المشروع الحالي بمشروع Firebase بحيث يتم تشغيل الأوامر الخاصة بالمشروع (مثل firebase deploy) مقابل مشروع Firebase المناسب.

    من الممكن أيضًا ربط عدة مشاريع في Firebase (مثل مشروع مرحلي ومشروع إنتاج) بدليل المشروع نفسه.

في نهاية الإعداد، ينشئ Firebase تلقائيًا الملفين التاليَين في جذر دليل التطبيق المحلي:

الملف firebase.json

ينشئ الأمر firebase init ملف إعداد firebase.json في جذر دليل مشروعك.

يجب توفير الملف firebase.json لنشر مواد العرض باستخدام واجهة سطر الأوامر في Firebase لأنّه يحدّد الملفات والإعدادات من دليل المشروع التي سيتم نشرها في مشروع Firebase. ونظرًا لأنه يمكن تحديد بعض الإعدادات في دليل المشروع أو وحدة تحكُّم Firebase، احرص على حل أي تعارضات محتملة بشأن عمليات النشر.

يمكنك ضبط معظم خيارات "استضافة Firebase" مباشرةً في ملف firebase.json. وبالنسبة إلى خدمات Firebase الأخرى التي يمكن نشرها باستخدام واجهة سطر الأوامر في Firebase، ينشئ الأمر firebase init ملفات محدّدة يمكنك من خلالها ضبط إعدادات تلك الخدمات، مثل ملف index.js لوظائف السحابة الإلكترونية. يمكنك أيضًا إعداد عناصر الجذب المُسبقة أو النشرية في ملف firebase.json.

في ما يلي مثال على ملف firebase.json بالإعدادات التلقائية إذا اختَرت "استضافة Firebase" وCloud Firestore وCloud Functions for Firebase (مع تحديد مصدر TypeScript وخيارات Lint) أثناء الإعداد.

{
  "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 وملفات مصدر فهرس قاعدة البيانات بكل قاعدة بيانات. عدّل الملف باستخدام صفيفة 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 لتجاهلها. يمنع ذلك نشر الملفات غير الضرورية في الخلفية والتي قد تزيد من حجم بيانات عملية النشر.

في ما يلي قائمة بالملفات التي يتم تجاهلها تلقائيًا والتي يتم عرضها بتنسيق JSON:

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

إذا أضفت قيمك المخصّصة لـ ignore في firebase.json، احرص على الاحتفاظ بقائمة الملفات الموضّحة أعلاه (أو إضافتها، إذا كانت مفقودة).

إدارة الأسماء المستعارة للمشروع

يمكنك ربط عدة مشاريع في Firebase بدليل المشروع نفسه. على سبيل المثال، قد ترغب في استخدام مشروع Firebase للإعداد المرحلي وآخر للإنتاج. باستخدام بيئات مشروع مختلفة، يمكنك التحقق من التغييرات قبل النشر إلى الإنتاج. يتيح لك الأمر firebase use التبديل بين العناوين البديلة وإنشاء عناوين بديلة جديدة.

إضافة اسم مستعار للمشروع

عند اختيار مشروع Firebase أثناء إعداد المشروع، يتم تلقائيًا تخصيص الاسم المستعار default للمشروع. ومع ذلك، للسماح بتشغيل الأوامر الخاصة بالمشروع مع مشروع مختلف في Firebase مع الاستمرار في استخدام دليل المشروع نفسه، شغِّل الأمر التالي من داخل دليل المشروع:

firebase use --add

يطلب منك هذا الأمر اختيار مشروع آخر في Firebase وتعيين المشروع كاسم مستعار. تتم كتابة تعيينات الأسماء المستعارة إلى ملف .firebaserc داخل دليل مشروعك.

استخدام الأسماء المستعارة للمشروع

لاستخدام الأسماء المستعارة لمشروع Firebase التي تم تعيينها، شغِّل أيًا من الأوامر التالية من داخل دليل مشروعك.

الطلب الوصف
firebase use عرض قائمة بالأسماء المستعارة المحددة حاليًا لدليل مشروعك
firebase use \
PROJECT_ID|ALIAS		 يوجّه جميع الأوامر لتنفيذها في مشروع Firebase المحدّد.
يستخدم واجهة سطر الأوامر هذا المشروع باعتباره "المشروع النشط" حاليًا.
firebase use --clear يؤدي هذا الإجراء إلى محو المشروع النشط.

شغِّل firebase use PROJECT_ID|ALIAS لإعداد مشروع نشط جديد قبل تشغيل أوامر واجهة سطر الأوامر الأخرى.
firebase use \
--unalias PROJECT_ALIAS		 يزيل اسمًا مستعارًا من دليل المشروع.

يمكنك إلغاء ما يُستخدم كمشروع نشط حاليًا من خلال تمرير علامة --project باستخدام أي أمر CLI. على سبيل المثال: يمكنك ضبط واجهة سطر الأوامر ليعمل مع مشروع في Firebase سبق لك تخصيص عنوان staging إليه البديل. إذا كنت تريد تنفيذ أمر واحد على مشروع Firebase الذي خصّصته لـ prod البديل، يمكنك تشغيل firebase deploy --project=prod مثلاً.

التحكم في المصدر والأسماء المستعارة للمشروع

بشكل عام، عليك التحقّق من ملف .firebaserc في عنصر التحكّم في المصدر للسماح لفريقك بمشاركة الأسماء المستعارة للمشروع. أمّا بالنسبة إلى المشاريع مفتوحة المصدر أو نماذج المبتدئين، فيجب عدم التحقق بشكل عام من ملف .firebaserc.

إذا كان لديك مشروع تطوير مخصّص لك فقط، يمكنك إما تمرير علامة --project مع كل أمر، أو تشغيل firebase use PROJECT_ID بدون تعيين اسم مستعار لمشروع Firebase.

عرض مشروع Firebase واختباره محليًا

يمكنك عرض مشروع Firebase واختباره على عناوين URL المُستضافة محليًا قبل نشره في قناة الإصدار العلني. إذا كنت تريد اختبار ميزات محدّدة فقط، يمكنك استخدام قائمة مفصولة بفواصل في علامة ضمن الأمر firebase serve.

قم بتشغيل الأمر التالي من جذر دليل المشروع المحلي إذا كنت تريد القيام بأي من المهام التالية:

  • عرض المحتوى الثابت لتطبيقك المستضاف على Firebase.
  • يمكنك استخدام دوال Cloud من أجل إنشاء محتوى ديناميكي لاستضافة Firebase وإذا كنت تريد استخدام وظائف HTTP للإنتاج (المنشور) لمحاكاة "الاستضافة" على عنوان 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

يدير واجهة سطر الأوامر في Firebase عملية نشر الرموز والأصول في مشروع Firebase، بما في ذلك:

  • إصدارات جديدة من مواقع استضافة Firebase
  • وظائف السحابة الإلكترونية الجديدة أو المعدّلة أو الحالية لبرنامج Firebase
  • قواعد قاعدة بيانات Firebase في الوقت الفعلي
  • قواعد التخزين في السحابة الإلكترونية لبرنامج Firebase
  • قواعد Cloud Firestore
  • فهارس Cloud Firestore

للنشر إلى مشروع Firebase، شغِّل الأمر التالي من دليل المشروع:

firebase deploy

يمكنك اختياريًا إضافة تعليق إلى كل عملية من عمليات النشر. سيظهر هذا التعليق مع معلومات النشر الأخرى في صفحة "استضافة Firebase" الخاصة بمشروعك. على سبيل المثال:

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

عند استخدام الأمر firebase deploy، يجب الانتباه لما يلي:

  • لنشر الموارد من دليل مشروع، يجب أن يحتوي دليل المشروع على ملف firebase.json. ويتم إنشاء هذا الملف تلقائيًا لك باستخدام الأمر firebase init.

  • ينشئ firebase deploy تلقائيًا إصدارًا لجميع الموارد القابلة للنشر في دليل مشروعك. ولتفعيل خدمات أو ميزات Firebase محدَّدة، يمكنك استخدام النشر الجزئي.

تضاربات النشر لقواعد الأمان

بالنسبة إلى "قاعدة بيانات Firebase في الوقت الفعلي" وCloud Storage for Firebase وCloud Firestore، يمكنك تحديد قواعد الأمان إما في دليل المشروع المحلي أو في وحدة تحكُّم Firebase.

هناك خيار آخر لتجنُّب تعارض النشر، وهو استخدام النشر الجزئي وتحديد القواعد في وحدة تحكُّم Firebase فقط.

حصص النشر

ومن الممكن (على الرغم من عدم احتمال ذلك) تجاوز حصة تحدّ من معدل أو حجم عمليات نشر Firebase. على سبيل المثال، قد تظهر لك رسالة خطأ HTTP 429 Quota عند نشر عدد كبير جدًا من الدوال. لحل هذه المشاكل، جرِّب استخدام النشر الجزئي.

العودة إلى الإصدارات السابقة من عملية نشر

يمكنك العودة إلى الإصدار السابق من نشر "استضافة Firebase" من صفحة استضافة Firebase لمشروعك من خلال اختيار إجراء العودة للإصدار المطلوب.

لا يمكن حاليًا العودة إلى الإصدارات السابقة من قواعد الأمان في قاعدة بيانات Firebase في الوقت الفعلي أو Cloud Storage for Firebase أو Cloud Firestore.

تفعيل خدمات محددة في Firebase

إذا كنت تريد نشر ميزات أو خدمات معيّنة فقط في Firebase، يمكنك استخدام قائمة مفصولة بفواصل في علامة واردة في الأمر firebase deploy. على سبيل المثال، ينشر الأمر التالي محتوى "استضافة Firebase" وقواعد أمان Cloud Storage.

firebase deploy --only hosting,storage

يسرد الجدول التالي الخدمات والميزات المتاحة للنشر الجزئي. تتوافق الأسماء الواردة في العلامات مع المفاتيح في ملف إعداد firebase.json.

الإبلاغ عن بنية تم نشر خدمة أو ميزة
--only hosting استضافة المحتوى على Firebase
--only database قواعد قاعدة بيانات Firebase في الوقت الفعلي
--only storage قواعد التخزين في السحابة الإلكترونية لبرنامج Firebase
--only firestore قواعد Cloud Firestore وفهارس جميع قواعد البيانات التي تم إعدادها
--only functions وظائف السحابة الإلكترونية لبرنامج Firebase (يمكن استخدام إصدارات أكثر تحديدًا من هذه العلامة)

نشر دوال محددة

عند نشر الدوال، يمكنك استهداف وظائف محددة. على سبيل المثال:

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

ويمكنك أيضًا تجميع الدوال في مجموعات تصدير ضمن ملف /functions/index.js. تسمح لك دوال التجميع بنشر دوال متعددة باستخدام أمر واحد.

على سبيل المثال، يمكنك كتابة الدوال التالية لتحديد groupA وgroupB:

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

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

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

حذف الدوال

يتوافق واجهة سطر الأوامر في 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، ويمكن أن يُعلم عنصر الجذب التالي للنشر المشرفين بخصوص محتوى الموقع الإلكتروني الجديد الذي يتم نشره إلى "استضافة Firebase".

لإعداد عناصر الجذب المسبقة أو اللاحقة للنشر، أضِف نصوص bash البرمجية إلى ملف إعداد firebase.json. يمكنك تعريف نصوص برمجية مختصرة في ملف firebase.json مباشرةً، أو يمكنك الإشارة إلى ملفات أخرى في دليل مشروعك.

على سبيل المثال، النص البرمجي التالي هو التعبير firebase.json لمهمة postdeploy التي ترسل رسالة Slack عند النشر بنجاح إلى "استضافة Firebase".

"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، يمكنك استخدام أوامر النشر الجزئي.

يطبع كل من عنصر الجذب predeploy وpostdeploy تدفقات الإخراج العادية وأخطاء النصوص البرمجية في الوحدة الطرفية. بالنسبة إلى حالات الإخفاق، يجب ملاحظة ما يلي:

  • في حال تعذّر إكمال عنصر الجذب للنشر على النحو المتوقع، سيتم إلغاء النشر.
  • في حال تعذُّر النشر لأي سبب من الأسباب، لن يتم تشغيل عناصر الجذب لما بعد النشر.

متغيرات البيئة

ضمن النصوص البرمجية التي يتم تشغيلها في خطّافات قبل النشر وما بعد النشر، تتوفّر متغيرات البيئة التالية:

  • $GCLOUD_PROJECT: رقم تعريف المشروع النشط
  • $PROJECT_DIR: الدليل الجذري الذي يحتوي على الملف firebase.json
  • $RESOURCE_DIR: (للنصوص البرمجية hosting وfunctions فقط) موقع الدليل الذي يحتوي على موارد الاستضافة أو موارد الوظائف السحابية المطلوب نشرها

إدارة مثيلات قاعدة بيانات في الوقت الفعلي متعددة

يمكن أن يحتوي مشروع Firebase على مثيلات قاعدة بيانات Firebase في الوقت الفعلي متعددة. تتفاعل أوامر واجهة سطر الأوامر (CLI) تلقائيًا مع مثيل قاعدة البيانات الافتراضي.

مع ذلك، يمكنك التفاعل مع مثيل قاعدة بيانات غير تلقائي باستخدام علامة --instance DATABASE_NAME. تتوافق الأوامر التالية مع علامة --instance:

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

مرجع الطلب

أوامر واجهة سطر الأوامر (CLI) الإدارية

الطلب الوصف
مساعدة يعرض معلومات المساعدة حول واجهة سطر الأوامر أو أوامر محددة.
بدء ربط مشروع Firebase جديد وإعداده في الدليل الحالي. ينشئ هذا الأمر ملف إعداد firebase.json في الدليل الحالي.
login المصادقة على واجهة سطر الأوامر (CLI) بحسابك على Firebase يتطلب ذلك الوصول إلى متصفّح ويب.
لتسجيل الدخول إلى واجهة سطر الأوامر في البيئات البعيدة التي لا تسمح بالوصول إلى localhost، استخدِم علامة --no-localhost.
login:ci تنشئ رمزًا مميزًا للمصادقة لاستخدامه في البيئات غير التفاعلية.
تسجيل الخروج تسجيل الخروج من واجهة سطر الأوامر (CLI) من حسابك في Firebase
فتح يؤدي هذا الاختصار إلى فتح متصفّح لموارد المشروع ذات الصلة.
projects:list يسرد جميع مشاريع Firebase التي يمكنك الوصول إليها.
الاستخدام لضبط مشروع Firebase النشط لواجهة سطر الأوامر.
يدير الأسماء المستعارة للمشروع.

أوامر إدارة المشروعات

الطلب الوصف
إدارة مشاريع Firebase
projects:addfirebase لإضافة موارد Firebase إلى مشروع حالي على Google Cloud
projects:إنشاء ينشئ مشروعًا جديدًا على Google Cloud، ثم يضيف موارد Firebase إلى المشروع الجديد.
projects:list يسرد جميع مشاريع Firebase التي يمكنك الوصول إليها.
إدارة تطبيقات Firebase (لنظامي التشغيل iOS وAndroid والويب)
apps:إنشاء ينشئ تطبيقًا جديدًا في 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		 يؤدي هذا الإجراء إلى حذف تجزئة شهادة SHA المحدّدة من تطبيق Firebase المتوافق مع Android.
apps:android:sha:list \
FIREBASE_APP_ID		 يسرد تجزئات شهادة SHA لتطبيق Android المحدّد في Firebase.

النشر والتطوير المحلي

تتيح لك هذه الأوامر نشر موقع استضافة Firebase والتفاعل معه.

الطلب الوصف
النشر يتم نشر الرموز والأصول من دليل المشروع إلى المشروع النشط. لاستضافة Firebase، يجب توفير ملف إعداد firebase.json.
خدمة لبدء خادم ويب محلي بإعدادات "استضافة Firebase". لاستضافة Firebase، يجب توفير ملف إعداد firebase.json.

طلبات توزيع التطبيقات

الطلب الوصف
توزيع التطبيق:توزيع \
--التطبيق FIREBASE_APP_ID		 إتاحة الإصدار للمختبِرين
appdistribution:testers:add إضافة مختبِرين إلى المشروع
appdistribution:testers:remove لإزالة المختبِرين من المشروع

أوامر استضافة التطبيقات

الطلب الوصف
apphosting:backends:create \
--مشروع PROJECT_ID
--موقع REGION --تطبيق APP_ID 		تنشئ مجموعة من الموارد المُدارة المرتبطة بقاعدة رموز برمجية واحدة تتألّف من خلفية "استضافة التطبيقات". يمكنك تحديد تطبيق ويب حالي في Firebase من خلال رقم تعريف تطبيق Firebase.
apphosting:backends:get \ BACKEND_ID
--مشروع PROJECT_ID
--موقع REGION 		يسترد تفاصيل محددة، بما في ذلك عنوان URL العام للواجهة الخلفية.
apphosting:backends:list \
--مشروع PROJECT_ID 		لاسترداد قائمة بجميع الخلفيات النشطة المرتبطة بمشروع.
firebase apphosting:backends:delete \ BACKEND_ID
--مشروع PROJECT_ID
--موقع REGION 		لحذف واجهة خلفية من المشروع.
apphosting:secrets:set \
KEY --project PROJECT_ID
--location REGION --data-file Data file		 تخزين المواد السرية في Secret Manager يمكنك اختياريًا توفير مسار ملف يمكنك من خلاله قراءة البيانات السرية. يمكنك ضبط القيمة على _ لقراءة البيانات السرية من مصدر الإدخال العادي.
apphosting:secrets:grantaccess \
KEY --مشروع PROJECT_ID BACKEND_ID
--موقع REGION 		يمنح حساب خدمة الخلفية إذن الوصول إلى المفتاح السرّي المقدَّم حتى يمكن الوصول إليه من خلال "استضافة التطبيقات" في وقت الإصدار أو التشغيل.
apphosting:secrets:describe \
KEY --project PROJECT_ID 		يحصل على البيانات الوصفية للسر وإصداراته.
firebase apphosting:secrets:access \
KEY[@version]
--مشروع PROJECT_ID 		للوصول إلى قيمة سرية محدّدة المفتاح السرّي وإصداره. تتيح هذه السياسة الوصول إلى أحدث إصدار تلقائيًا.

أوامر المصادقة (إدارة المستخدمين)

الطلب الوصف
auth:export يؤدي هذا الخيار إلى تصدير حسابات المستخدمين في المشروع النشط إلى ملف JSON أو CSV. لمزيد من التفاصيل، راجِع صفحة auth:import وauth:export.
تفويض:استيراد لاستيراد حسابات المستخدمين من ملف JSON أو CSV إلى المشروع النشط. لمزيد من التفاصيل، راجِع صفحة auth:import وauth:export.

أوامر Cloud Firestore

الطلب الوصف
firestore:مواقع

سرد المواقع الجغرافية المتاحة لقاعدة بيانات Cloud Firestore

firestore:databases:إنشاء DATABASE_ID

يمكنك إنشاء مثيل قاعدة بيانات في الوضع الأصلي ضمن مشروع Firebase.

يأخذ الأمر العلامات التالية:

  • --location <region name> لتحديد موقع نشر قاعدة البيانات. تجدر الإشارة إلى أنّه يمكنك تشغيل firebase firestore: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:حذف DATABASE_ID

يجب حذف قاعدة بيانات في مشروع Firebase.
firestore:مؤشرات

أدرِج فهارس قاعدة بيانات في مشروع Firebase الخاص بك.

يأخذ الأمر العلامة التالية:

  • --database DATABASE_ID لتحديد اسم قاعدة البيانات التي يتم إدراج فهارسها. وإذا لم يتم توفيرها، يتم إدراج الفهارس لقاعدة البيانات التلقائية.
firestore:حذف

لحذف المستندات من قاعدة بيانات المشروع النشط. وباستخدام واجهة سطر الأوامر، يمكنك حذف جميع المستندات في المجموعة بشكل متكرر.

يُرجى العلم أنّ حذف بيانات Cloud Firestore باستخدام واجهة سطر الأوامر سيؤدي إلى تحمُّل تكاليف قراءة وحذف. لمزيد من المعلومات، يُرجى الاطّلاع على فهم الفوترة في Cloud Firestore.

يأخذ الأمر العلامة التالية:

  • --database DATABASE_ID لتحديد اسم قاعدة البيانات التي يتم حذف المستندات منها. وإذا لم يتم تحديده، فسيتم حذف المستندات من قاعدة البيانات التلقائية. هذه السمة اختيارية.

دوال السحابة الإلكترونية لأوامر Firebase

الطلب الوصف
الدوال:config:clone يستنسخ بيئة مشروع آخر في مشروع Firebase النشط.
الدوال:الضبط:get يسترد قيم الإعداد الحالية لدوال Cloud Functions في المشروع النشط.
الدوال:الضبط:set تخزين قيم إعداد وقت تشغيل دوال Cloud للمشروع النشط
الدوال:الضبط:غير محدَّد تتم إزالة القيم من إعدادات وقت تشغيل المشروع النشط.
الدوال:سجلّ يقرأ السجلات من دوال Cloud المنشورة.

لمزيد من المعلومات، راجِع مستندات ضبط البيئة.

أوامر Crashlytics

الطلب الوصف
crashlytics:mappingfile:generateid \
--resource-file=PATH/TO/ANDROID_RESOURCE.XML 		تنشئ هذه الدالة معرّفًا فريدًا لملف الربط في ملف XML محدّد لمورد Android.
crashlytics:mappingfile:upload \
--app=FIREBASE_APP_ID \
--resource-file=PATH/TO/ANDROID_RESOURCE.XML \
PATH/TO/MAPPING_FILE.TXT 		تعمل هذه السياسة على تحميل ملف تعيين (TXT) متوافق مع Proguard لهذا التطبيق، وربطه بمعرّف ملف الربط المُعرَّف في ملف XML (XML) لمورد Android المحدّد.
crashlytics:symbols:upload \
--app=FIREBASE_APP_ID \
PATH/TO/SYMBOLS		 تنشئ هذه الأداة ملف رموز متوافقًا مع Crashlytics لأعطال المكتبة الأصلية على نظام التشغيل Android وتحمّله إلى خوادم Firebase.

أوامر الإضافات

الطلب الوصف
إضافة يعرض معلومات عن كيفية استخدام أوامر إضافات Firebase.
يسرد النُسخ الافتراضية للإضافة التي تم تثبيتها في المشروع النشط.
ext:ضبط \
EXTENSION_INSTANCE_ID		 تؤدي إلى إعادة ضبط قيم المَعلمات لمثيل الإضافة في بيان الإضافة.
ext:info \
PUBLISHER_ID/EXTENSION_ID		 تطبع معلومات مفصّلة حول إحدى الإضافات.
ext:تثبيت \
PUBLISHER_ID/EXTENSION_ID		 تتيح هذه السمة إضافة مثيل جديد من إحدى الإضافات إلى بيان الإضافة.
ext:list يسرد جميع مثيلات الإضافات التي تم تثبيتها في مشروع Firebase.
تطبع رقم تعريف المثيل لكل إضافة.
ext:إلغاء التثبيت \
EXTENSION_INSTANCE_ID		 تزيل مثيل إضافة من بيان الإضافة.
ext:تعديل \
EXTENSION_INSTANCE_ID		 يعدِّل مثيل الإضافة إلى أحدث إصدار في بيان الإضافة.
ext:تصدير يصدِّر هذا المنتج جميع مثيلات الإضافات المثبَّتة من مشروعك إلى بيان الإضافة.

أوامر ناشر الإضافات

الطلب الوصف
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:disable

إيقاف عرض زيارات "استضافة Firebase" لمشروع Firebase النشط.

سيعرض عنوان URL للاستضافة الخاص بمشروعك رسالة "لم يتم العثور على الموقع الإلكتروني" بعد تشغيل هذا الأمر.

إدارة المواقع الإلكترونية المستضيفة
firebase Host:sites:create \
SITE_ID

يتم إنشاء موقع استضافة إلكتروني جديد في مشروع Firebase النشط باستخدام SITE_ID المحدّدة.

(اختياري) حدِّد تطبيق ويب حالي في Firebase لربطه بالموقع الجديد من خلال تمرير العلامة التالية: --app FIREBASE_APP_ID

firebase Host:sites:delete \
SITE_ID

يؤدي هذا الإجراء إلى حذف موقع الاستضافة الإلكتروني المحدّد.

يعرض CLI رسالة تأكيد قبل حذف الموقع الإلكتروني.

(اختياري) يمكنك تخطّي طلب التأكيد من خلال تمرير العلامة التالية: -f أو --force

firebase Host:sites:get \
SITE_ID

استرداد معلومات عن موقع الاستضافة الإلكتروني المحدّد
firebase Host:sites:list

إدراج جميع مواقع الاستضافة لمشروع Firebase النشط

إدارة قنوات المعاينة
firebase owner:channel:create \
CHANNEL_ID

تنشئ قناة معاينة جديدة في الإعداد التلقائي لموقع الاستضافة الإلكتروني باستخدام السمة CHANNEL_ID المحدّدة

لا يتم نشر هذا الأمر في القناة.
firebase Host:channel:delete \
CHANNEL_ID

لحذف قناة المعاينة المحدّدة

لا يمكنك حذف القناة المباشرة لموقع.
firebase Host:channel:deploy \
CHANNEL_ID

تنشر محتوى الاستضافة والإعدادات في قناة المعاينة المحدّدة.

في حال عدم توفّر قناة المعاينة بعد، ينشئ هذا الأمر القناة في الموقع الإلكتروني للاستضافة التلقائي قبل نشرها على القناة.

firebase Host:channel:list إدراج جميع القنوات (بما في ذلك القناة "المباشرة") في الموقع الإلكتروني المستضاف تلقائي
firebase Host:channel:open \
CHANNEL_ID		 يؤدي هذا الإجراء إلى فتح متصفّح للوصول إلى عنوان URL الخاص بالقناة المحدّدة أو عرض عنوان URL إذا تعذّر فتحه في متصفّح.
استنساخ النُسخ
firebase record:clone \
SOURCE_SITE_ID:SOURCE_CHANNEL_ID \
TARGET_SITE_ID:TARGET_CHANNEL_ID

يستنسخ أحدث إصدار تم نشره على قناة "المصدر" المحددة إلى القناة "المستهدفة" المحددة

يتم أيضًا نشر هذا الأمر إلى قناة "الهدف" المحددة. في حال عدم توفّر القناة "المستهدفة" بعد، يُنشئ هذا الأمر قناة معاينة جديدة في موقع الاستضافة الإلكتروني "المستهدف" قبل نشره على القناة.

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

يستنسخ الإصدار المحدد إلى قناة "الهدف" المحددة

يتم أيضًا نشر هذا الأمر إلى قناة "الهدف" المحددة. في حال عدم توفّر القناة "المستهدفة" بعد، يُنشئ هذا الأمر قناة معاينة جديدة في موقع الاستضافة الإلكتروني "المستهدف" قبل نشره على القناة.

يمكنك العثور على VERSION_ID في لوحة بيانات الاستضافة ضمن "وحدة تحكُّم Firebase".

أوامر قاعدة البيانات في الوقت الفعلي

يُرجى العِلم أنّه يمكنك إنشاء مثيل "قاعدة بيانات الوقت الفعلي" الأولي التلقائي في وحدة تحكُّم Firebase أو باستخدام سير العمل العام firebase init أو مسار firebase init database المحدَّد.

بعد إنشاء المثيلات، يمكنك إدارتها كما هو موضَّح في مقالة إدارة مثيلات قاعدة بيانات في الوقت الفعلي متعدّدة.

الطلب الوصف
database:get يجلب البيانات من قاعدة بيانات المشروع النشط ويعرضها على شكل JSON. تتيح إجراء طلبات بحث في البيانات المفهرَسة.
database:instances:create تنشئ مثيل قاعدة بيانات باسم مثيل محدد. تتيح هذه الميزة استخدام الخيار --location لإنشاء قاعدة بيانات في منطقة محدّدة. لكي يتم استخدام أسماء المناطق مع هذا الخيار، يمكنك الاطّلاع على اختيار المواقع الجغرافية لمشروعك. إذا لم يتوفّر مثيل قاعدة بيانات للمشروع الحالي، سيُطلب منك تشغيل مسار firebase init لإنشاء مثيل.
database:instances:list أدرِج جميع مثيلات قاعدة البيانات لهذا المشروع. تقبل الخيار --location لإدراج قواعد البيانات في منطقة محدّدة. لكي تتمكّن من استخدام أسماء المناطق مع هذا الخيار، راجِع اختيار المواقع الجغرافية لمشروعك.
database:الملف الشخصي ينشئ ملف تعريف للعمليات على قاعدة بيانات المشروع النشط. لمزيد من التفاصيل، راجِع أنواع عمليات قاعدة البيانات في الوقت الفعلي.
database:push لإرسال البيانات الجديدة إلى قائمة في موقع محدّد في قاعدة بيانات المشروع النشط. يتم الحصول على الإدخال من ملف أو STDIN أو وسيطة سطر أوامر.
database:إزالة يؤدي هذا الإجراء إلى حذف جميع البيانات في موقع محدّد ضمن قاعدة بيانات المشروع النشط.
database:set لاستبدال جميع البيانات في موقع محدد ضمن قاعدة بيانات المشروع النشط. يتم الحصول على الإدخال من ملف أو STDIN أو وسيطة سطر أوامر.
database:update يجري تعديلاً جزئيًا في موقع محدد ضمن قاعدة بيانات المشروع النشط. يتم الحصول على الإدخال من ملف أو STDIN أو وسيطة سطر أوامر.

أوامر "الإعداد عن بُعد"

الطلب الوصف
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		 يؤدي هذا الإجراء إلى إعادة نموذج "الإعداد عن بُعد" إلى رقم إصدار سابق محدّد أو الضبط التلقائي على الإصدار السابق المباشر (الإصدار الحالي -1). ما لم يتم تجاوز --force، ستظهر رسالة نعم/لا قبل المتابعة للعودة إلى الإصدار السابق.