انتقل إلى المحتوى

CLI

يسجّل Rudel أوامره ضمن wp rudel. يرفض WP-CLI أي خيار لا يسرده الأمر هنا برسالة unknown --<name> parameter.

يمكنك إعادة تسمية الأمر الأساسي للاستخدام المضمّن بتعريف RUDEL_CLI_COMMAND في wp-config.php قبل تحميل الإضافة.

PHP
define( 'RUDEL_CLI_COMMAND', 'sandbox' );

يغيّر ذلك wp rudel create إلى wp sandbox create. ولا يتغير سلوك الأمر.

تعمل الأوامر على المضيف افتراضيًا. لتشغيل أي أمر WP-CLI آخر داخل بيئة عزل، عيّن RUDEL_ENVIRONMENT:

سطر الأوامر
RUDEL_ENVIRONMENT=alpha-3be7 wp option get blogname

إنشاء

سطر الأوامر
wp rudel create [--name=<name>] [--theme=<slug>] [--clone-from=<id>] [--owner=<owner>] [--labels=<labels>] [--purpose=<purpose>] [--protected] [--ttl-days=<days>] [--expires-at=<timestamp>] [--git=<remote>] [--type=<theme|plugin>] [--template=<label>]

ينشئ بيئة عزل ويطبع معرّفها.

الخيار المعنى
--name اسم مقروء. يتكوّن المعرّف من الاسم وأربعة أحرف سداسية عشرية. افتراضيًا، يُستخدم اسم المستودع مع --git، أو sandbox بدونه.
--theme القالب المراد نسخه إلى بيئة العزل. يجب أن يكون مثبّتًا على المضيف. افتراضيًا، يُستخدم القالب النشط للمضيف، أو قالب بيئة العزل المصدر مع --clone-from.
--clone-from استنساخ الجداول والقالب من بيئة عزل موجودة بدلًا من المضيف.
--owner، --labels، --purpose بيانات وصفية. تُفصل التسميات بفواصل.
--protected استبعاد بيئة العزل من التنظيف.
--ttl-days مدة انتهاء الصلاحية من وقت الإنشاء.
--expires-at طابع زمني صريح لانتهاء الصلاحية.
--git استنساخ مستودع بعيد إلى دليل بيئة العزل. راجع Git.
--type موضع استنساخ --git: theme (الافتراضي) أو plugin.
--template تسمية مخزنة في السجل، والافتراضي blank. ولا تحمّل قالبًا محفوظًا.

--clone-db و--clone-themes و--clone-plugins و--clone-uploads و--clone-all و--shared-plugins و--shared-uploads مهملة. ولا تغيّر سوى رسائل التقدم: تستنسخ كل بيئة عزل الجداول، وتنسخ قالبًا واحدًا، وتتشارك الإضافات والملفات المرفوعة.

ينتهي الأمر بتلميح يطلب منك الانتقال إلى دليل بيئة العزل باستخدام cd وتشغيل wp post list. يعمل ذلك على المضيف، لأن wp-cli.yml في دليل بيئة العزل يشير إلى URL الخاص بالمضيف. استخدم RUDEL_ENVIRONMENT بدلًا من ذلك.

قائمة

سطر الأوامر
wp rudel list [--format=<table|json|csv|yaml|count>]

يسرد بيئات العزل مع المعرّف والاسم والمالك والحماية وانتهاء الصلاحية والحالة وتسمية القالب ووقت الإنشاء وحجم الدليل.

معلومات

سطر الأوامر
wp rudel info <id> [--format=<table|json|yaml>]

يعرض سجل بيئة عزل واحدة، بما في ذلك بادئة الجدول والقالب والتسميات وبيانات الاستنساخ الوصفية وURL ومسار المحتوى.

تحديث

سطر الأوامر
wp rudel update <id> [--owner=<owner>] [--labels=<labels>] [--purpose=<purpose>] [--protected] [--unprotected] [--ttl-days=<days>] [--expires-at=<timestamp>] [--clear-expiry]

يحدّث البيانات الوصفية. تُحسب --ttl-days من الآن. ولا يغيّر محتوى موقع بيئة العزل.

إتلاف

سطر الأوامر
wp rudel destroy <id> [--force]

يحذف جداول بيئة العزل، ويزيل دليلها وأشجار العمل المرتبطة بها، ويحذف سجلها. يطلب الأمر تأكيدًا؛ ويتجاوز --force المطالبة. لا تمنع الحماية تنفيذ destroy؛ إذ تُدمّر بيئة العزل المحمية مثل غيرها.

الحالة

سطر الأوامر
wp rudel status

يطبع جدولًا يتضمن حالة التهيئة وبيئة العزل الحالية ودليل بيئات العزل وعددها وقيم rudel_config وما إذا كانت الأتمتة مجدولة. يطبع دائمًا جدولًا ويتجاهل --format.

تنظيف

سطر الأوامر
wp rudel cleanup [--dry-run] [--max-age-days=<days>] [--max-idle-days=<days>] [--merged]

من دون --merged، يزيل بيئات العزل غير المحمية التي انتهت صلاحيتها أو تجاوزت حد العمر أو الخمول. يتجاوز --max-age-days و--max-idle-days القيمة rudel_config لهذا التشغيل. ومع --merged، يزيل بيئات العزل التي دُمجت فروع أشجار عمل Git المرتبطة بها. تُستثنى بيئات العزل المحمية دائمًا. راجع التنظيف.

السجلات

سطر الأوامر
wp rudel logs <id> [--lines=<lines>] [--follow] [--clear]

يطبع الأسطر الأخيرة من debug.log الخاص ببيئة العزل (50 افتراضيًا). يشغّل --follow tail -f؛ ويفرغ --clear الملف. راجع تسجيل الأخطاء.

لقطة

سطر الأوامر
wp rudel snapshot <id> --name=<name>

ينشئ لقطة باسم محدد.

استعادة

سطر الأوامر
wp rudel restore <id> --snapshot=<name> [--force]

يستعيد لقطة. يطلب الأمر تأكيدًا؛ ويتجاوز --force المطالبة. راجع اللقطات.

قالب

سطر الأوامر
wp rudel template save <id> --name=<name> [--description=<description>]
wp rudel template list [--format=<table|json|csv|yaml|count>]
wp rudel template delete <name> [--force]

يحفظ نسخ القوالب ويسردها ويحذفها. لا ينشئ أي أمر بيئة عزل من قالب محفوظ. راجع القوالب.

دفع

سطر الأوامر
wp rudel push <id> [--git=<remote>] [--dir=<dir>] [--message=<message>]

يُجري commit وpush لنسخة عمل داخل دليل بيئة العزل إلى الفرع rudel/<id>.

الخيار المعنى
--git مستودع URL البعيد. لا يلزم إلا إذا لم يكن مخزنًا؛ ويُحفظ بعد أول عملية push ناجحة.
--dir دليل نسبةً إلى دليل بيئة العزل، مثل themes/my-theme. افتراضيًا، يُستخدم دليل النسخة المخزن، أو دليل بيئة العزل بأكمله.
--message رسالة الالتزام، والافتراضي Update from Rudel sandbox.

راجع Git.