cli edgeworkers

EdgeWorkers CLI

EdgeWorkers CLI تعمل واجهة سطر أوامر EdgeWorkers (CLI) على تسريع عملية تسجيل وتحميل وتنشيط واختبار وظائف EdgeWorkers على شبكة Akamai Edge.

انتقل إلى Akamai CLI لـ EdgeKV للحصول على معلومات حول كيفية إدارة قواعد بيانات EdgeKV واستدعاء EdgeKV API من سطر الأوامر.

متطلبات الإعداد الفني

لاستخدام هذه الأداة تحتاج إلى:

• تم تثبيت Akamai CLI.

• إذا لم يكن لديك واجهة سطر الأوامر (CLI) وكنت تستخدم Homebrew على جهاز Mac، فقم بتشغيل هذا الأمر: brew install akamai

• يمكنك أيضًا تنزيل ثنائيات CLI الخاصة بنظام التشغيل أو صورة Docker

• تم تكوين بيانات اعتماد EdgeGrid الصالحة عبر مركز التحكم Akamai (راجع بدء استخدام واجهات برمجة التطبيقات)

• إصدار العقدة 14 أو أعلى

تثبيت أو تحديث EdgeWorkers

• إذا لم تكن حزمة EdgeWorkers CLI مثبتة لديك، فاستخدم أمر Akamai CLI التالي لتثبيت أحدث حزمة EdgeWorkers CLI:

الاستخدام:
akamai install edgeworkers

• إذا كان لديك بالفعل واجهة سطر الأوامر مثبتة، فاستخدم أمر Akamai CLI التالي لتثبيت أحدث حزمة EdgeWorkers CLI التي تتضمن وظيفة EdgeKV:

الاستخدام:
akamai update edgeworkers

توفير خصائص التكوين الافتراضية

يتيح لك EdgeWorkers CLI تعيين القيم الافتراضية لخيارات الأمر. هناك طريقتان لإنشاء ملف التكوين:

1. قم بإنشاء ملف التكوين ~/.akamai-cli/ew-config ، وقم بتخزين الخصائص كما يلي:

 [تقصير]
edgeworkerName=testEW
معرف المجموعة=12345
معرف الإصدار=1-0-2

2. استخدم أمر config لتعيين الخصائص الافتراضية: akamai edgeworkers config set <key> <value>

يتم عرض أسماء الخصائص المتاحة هنا.

نظرة عامة على الأوامر

يمكّنك EdgeWorkers CLI من إدارة وظائف EdgeWorkers عن طريق استدعاء EdgeWorkers API.

الاتفاقيات:

• الوسائط الاختيارية []

• الوسائط المطلوبة <>

الاستخدام:
akamai edgeworkers [options] [command]

خيارات:

بناء الجملة	وصف
-V، - الإصدار	عرض رقم الإصدار لبرنامج EdgeWorkers CLI.
--debug	إظهار معلومات التصحيح.
--edgerc <path>	استخدم بيانات الاعتماد في ملف edgerc للأمر. (موقع الملف الافتراضي هو ~/.edgerc )
--القسم <name>	استخدم هذا القسم في ملف edgerc . (القسم الافتراضي هو [افتراضي] )
--configSection <configSection>	استخدم هذا القسم في ملف ew-config الذي يحتوي على مجموعة خصائص التكوين الافتراضية. (القسم الافتراضي هو [افتراضي] )
--مهلة <timeout>	يمكنك تحديد قيمة المهلة لأمر ما بالثواني لتجاوز القيمة الافتراضية البالغة دقيقتين. على سبيل المثال، إذا قمت بإضافة "--timeout 10" إلى أمر ما، فستنتهي المهلة إذا استغرق الخادم أكثر من 10 ثوانٍ للاستجابة.
--json [path]	اكتب مخرجات واجهة سطر الأوامر (CLI) بتنسيق JSON إلى المسار المتوفر اختياريًا. إذا لم يتم توفير المسار، فاكتب مخرجات JSON إلى الدليل الرئيسي لـ CLI
--jsonout	اكتب إخراج CLI كـ JSON إلى stdout.
-ح، --مساعدة	عرض معلومات الاستخدام لـ EdgeWorkers CLI.

الأوامر:

الأمر | الاسم المستعار	وصف
مساعدة [command]	عرض معلومات الاستخدام للأمر المحدد.
مجموعات القائمة | إل جي [group-identifier]	يمكن لمطوري العملاء العثور على مستوى وصول EdgeWorkers لكل مجموعة Luna Access Control Group.
معرفات القائمة | لي [options] [edgeworker-identifier]	قم بإدراج معرفات EdgeWorker المسجلة حاليًا.
سجل | معرف الإنشاء <group-identifier> <edgeworker-name>	قم بتسجيل معرف EdgeWorker جديد للرجوع إليه في سلوك إدارة الممتلكات.
معرف التحديث | واجهة المستخدم <edgeworker-identifier> <group-identifier> <edgeworker-name> [options]	يسمح لمطور العملاء بتحديث Luna ACG أو سمات الاسم الخاصة بمعرف EdgeWorker الحالي.
حذف المعرف | حذف المعرف [options] <edgeworker-identifier>	حذف معرف EdgeWorker الموجود نهائيًا.
إصدارات القائمة | lv <edgeworker-identifier> [version-identifier]	قائمة معلومات الإصدار لمعرف EdgeWorker المحدد.
تحميل | إنشاء الإصدار [options] <edgeworker-identifier>	ينشئ إصدارًا جديدًا من معرف EdgeWorker المحدد والذي يتضمن حزمة التعليمات البرمجية.
حذف النسخة | حذف الإصدار [options] <edgeworker-identifier> <version-identifier>	حذف إصدار موجود من معرف EdgeWorker المحدد نهائيًا.
تحميل | نسخة التنزيل [options] <edgeworker-identifier> <version-identifier>	قم بتنزيل حزمة التعليمات البرمجية لإصدار EdgeWorker.
تنزيل المراجعة | الدكتور [options] <edgeworker-identifier> <revision-identifier>	قم بتنزيل حزمة التعليمات البرمجية المجمعة التي تحتوي على التعليمات البرمجية والتبعيات التي ينفذها EdgeWorker.
الحالة | قائمة التنشيط [options] <edgeworker-identifier>	قائمة حالة التنشيط لمعرف EdgeWorker المحدد.
مراجعات القائمة | lr [options] <edgeworker-identifier>	قم بإدراج سجل المراجعة لمعرف EdgeWorker المحدد.
الحصول على المراجعة | gr <edgeworker-identifier> <revision-identifier>	الحصول على تفاصيل لمراجعة محددة.
مقارنة المراجعات | cr <edgeworker-identifier> <revision-identifier> <revision-identifier>	عرض اختلافات التبعية بين مراجعتين لنفس EdgeWorker.
تفعيل المراجعة | ع [options] <edgeworker-identifier> <revision-identifier>	قم بتنشيط مراجعة لمعرف EdgeWorker المحدد على شبكة Akamai.
مراجعة الدبوس [options] <edgeworker-identifier> <revision-identifier>	قم بتثبيت مراجعة نشطة لمعرف EdgeWorker المحدد.
إلغاء تثبيت المراجعة [options] <edgeworker-identifier> <revision-identifier>	قم بإلغاء تثبيت مراجعة مثبتة نشطة لمعرف EdgeWorker محدد.
الحصول على المراجعة بوم | غيغابايت [options] <edgeworker-identifier> <revision-identifier>	عرض تفاصيل مراجعة محددة للحزمة المركبة.
تنشيط مراجعة القائمة | lra [options] <edgeworker-identifier>	قم بإدراج حالة تنشيط المراجعة لمعرف EdgeWorker المحدد.
تفعيل | av <edgeworker-identifier> <network> <versionId>	قم بتنشيط إصدار لمعرف EdgeWorker محدد على شبكة Akamai.
تعطيل | deact <edgeworker-identifier> <network> <versionId>	قم بإلغاء تنشيط إصدار لمعرف EdgeWorker معين على شبكة Akamai.
التحقق من صحة | vv <bundlePath>	التحقق من صحة إصدار حزمة التعليمات البرمجية دون تحميل حزمة التعليمات البرمجية.
إنشاء رمز المصادقة | مصادقة [options] <hostName>	يُنشئ رمزًا مميزًا للمصادقة يمكن استخدامه للحصول على رؤوس استجابة تصحيح أخطاء EdgeWorker التفصيلية. تحتاج إلى الإصدار 1.7.1 على الأقل من EdgeWorkers CLI لتشغيل هذا الأمر.
استنساخ | استنساخ <edgeworker-identifier> <resourceTierId> [options]	استنساخ EdgeWorker من معرف EdgeWorker الموجود.
قائمة العقود | عقود لى [options]	قائمة معرفات العقود التي يمكن للمستخدم الوصول إليها.
خصائص القائمة | ليرة لبنانية <edgeworker-identifier> [options]	قائمة الخصائص المرتبطة بمعرف EdgeWorker المحدد.
حدود القائمة | حدود لى	اعرض الحدود المتنوعة التي يفرضها EdgeWorkers على عدد عمليات التنشيط ومعرفات EdgeWorkers والإصدارات التي يمكنك نشرها.
قائمة ريستيريس | لي ريستيرس [options]	قم بإدراج طبقات الموارد التي يمكن استخدامها لإنشاء معرف EdgeWorker أو استنساخه.
عرض ريستير | show-restier <edgeworker-identifier>	يمكن للعملاء الحصول على تفاصيل طبقة الموارد لمعرف EdgeWorker محدد.
الحصول على التقارير	احصل على قائمة بجميع تقارير EdgeWorkers المتاحة.
الحصول على التقرير <reportId> <edgeworker-identifier> [options]	احصل على تقرير EdgeWorkers لمعرف EdgeWorker محدد.
قائمة التكوين	احصل على كافة القيم في ملف التكوين.
الحصول على التكوين <key>	احصل على قيمة التكوين من قسم في ملف التكوين.
مجموعة التكوين <key> <value>	قم بتعيين قيمة التكوين في القسم.
حفظ التكوين -p <properties>	حفظ خصائص التكوين في القسم.
تم إلغاء ضبط التكوين <key>	قم بإلغاء تعيين قيمة التكوين في القسم.

قائمة مجموعات الأذونات مع الوصول إلى EdgeWorkers

يمكن لمطوري العملاء العثور على مستوى وصول EdgeWorkers لكل مجموعة Luna Access Control Group.

الاستخدام: akamai edgeworkers list-groups [options] [group-identifier]

خيار	وصف
-ح، --مساعدة	معلومات استخدام الإخراج

دعوى	وجود	وصف
معرف المجموعة	خياري	قيمة Luna Access Group (عادةً رقم) للتحقق من أذونات EdgeWorkers

التفاصيل الرئيسية

1. تتم تصفية الإخراج إلى مجموعات التحكم في الوصول إلى Luna التي تتمتع بإمكانية EdgeWorkers واحدة على الأقل.

2. يمكن أن تكون الإمكانات: VIEW،VIEW_VERSION،EDIT،VIEW_ACTIVATION،CREATE_VERSION،ACTIVATE

قم بإدراج معرفات EdgeWorker الموجودة

قم بإدراج معرفات EdgeWorker المسجلة حاليًا.

الاستخدام: akamai edgeworkers list-ids [options] [edgeworker-identifier]

خيار	وصف
-ح، --مساعدة	معلومات استخدام الإخراج
--groupId <groupId>	قم بتصفية قائمة معرفات EdgeWorker حسب مجموعة الأذونات
--resourceTierId <resourceTierId>	قم بتصفية معرف EdgeWorker حسب طبقة الموارد

دعوى	وجود	وصف
معرف عامل الحافة	خياري	مقبض عدد صحيح فريد لمثيل EdgeWorkers

قم بتسجيل معرف EdgeWorker الجديد

قم بتسجيل معرف EdgeWorker جديد للرجوع إليه في سلوك إدارة الممتلكات.

الاستخدام: akamai edgeworkers register [options] <group-identifier> <edgeworker-name>

خيار	وصف
--resourceTierId	معرف طبقة المورد الجديد الذي سيتم ربط EdgeWorker به.
-ح، --مساعدة	معلومات استخدام الإخراج

دعوى	وجود	وصف
معرف المجموعة	مطلوب	قيمة Luna Access Group (عادةً رقم) للتحقق من أذونات EdgeWorkers
اسم عامل الحافة	مطلوب	تسمية قصيرة يمكن قراءتها بواسطة الإنسان تصف مثيل EdgeWorkers

التفاصيل الرئيسية

1. سيتم توفير رأس استجابة الموقع بمعرف EdgeWorker الجديد.

2. سيتم تزويد نص استجابة تفاصيل معرف EdgeWorker (JSON) برمز استجابة 201.

3. لتعطيل المطالبات لغرض التشغيل الآلي، يمكن توفير "resourceTierId" كمدخل.

قم بتحديث معلومات معرف EdgeWorker

يسمح لمطور العملاء بتحديث Luna ACG أو سمات الاسم الخاصة بمعرف EdgeWorker الحالي.

الاستخدام: akamai edgeworkers update-id [options] <edgeworker-identifier> <group-identifier> <edgeworker-name>

خيار	وصف
--resourceTierId	معرف طبقة المورد الجديد الذي سيتم ربط EdgeWorker به
-ح، --مساعدة	معلومات استخدام الإخراج

دعوى	وجود	وصف
معرف عامل الحافة	مطلوب	مقبض عدد صحيح فريد لمثيل EdgeWorkers
معرف المجموعة	مطلوب	قيمة Luna Access Group (عادةً رقم) للتحقق من أذونات EdgeWorkers
اسم عامل الحافة	مطلوب	تسمية قصيرة يمكن قراءتها بواسطة الإنسان تصف مثيل EdgeWorkers

التفاصيل الرئيسية

1. تتطلب واجهة برمجة التطبيقات توفير معرف المجموعة والاسم حتى في حالة تغيير إحدى هذه السمات فقط.

2. سيتم تزويد نص استجابة تفاصيل معرف EdgeWorker (JSON) بـ 200 رمز استجابة.

3. يجب أن يكون معرف طبقة المورد المقدم هو نفس معرف EdgeWorker الموجود بالفعل. من أجل توفير معرف طبقة مورد مختلف، يرجى استخدام عملية النسخ.

حذف معرف EdgeWorker الموجود

قم بحذف معرف EdgeWorker الموجود نهائيًا.

الاستخدام: akamai edgeworkers delete-id [options] <edgeworker-identifier>

خيار	وصف
-ح، --مساعدة	معلومات استخدام الإخراج
--noPrompt	تخطي مطالبة تأكيد الحذف

دعوى	وجود	وصف
معرف عامل الحافة	مطلوب	مقبض عدد صحيح فريد لمثيل EdgeWorkers

التفاصيل الرئيسية

1. لا يمكن حذف معرف EdgeWorker إلا إذا لم يكن لديه أي إصدار نشط حاليًا أو تم تنشيطه على شبكة Akamai.

2. تأكد من عدم وجود خصائص نشطة مرتبطة بـ EdgeWorker قبل الحذف.

قائمة إصدارات EdgeWorker

قائمة معلومات الإصدار لمعرف EdgeWorker المحدد.

الاستخدام: akamai edgeworkers list-versions [options] <edgeworker-identifier> [version-identifier]

خيار	وصف
-ح، --مساعدة	معلومات استخدام الإخراج

دعوى	وجود	وصف
معرف عامل الحافة	مطلوب	مقبض عدد صحيح فريد لمثيل EdgeWorkers
معرف الإصدار	خياري	مؤشر عدد صحيح فريد لإصدار مثيل EdgeWorkers

التفاصيل الرئيسية

1. يتم فرز مجموعة النتائج حسب قيمة تسلسل التحميل التي لا يتم عرضها (عدد صحيح داخلي متزايد).

2. إصدارات EdgeWorker هي سلاسل محددة من قبل العميل.

تحميل الإصدار الجديد من EdgeWorker

ينشئ إصدارًا جديدًا من معرف EdgeWorker المحدد والذي يتضمن حزمة التعليمات البرمجية.

الاستخدام: akamai edgeworkers upload [options] <edgeworker-identifier>

خيار	وصف
-ح، --مساعدة	معلومات استخدام الإخراج
--حزمة <bundlePath>	المسار إلى ملف الحزمة بتنسيق tgz
--codeDir <workingDirectory>	دليل العمل الذي يتضمن ملفات main.js وbundle.json

دعوى	وجود	وصف
معرف عامل الحافة	مطلوب	مقبض عدد صحيح فريد لمثيل EdgeWorkers

التفاصيل الرئيسية

1. يجب توفير واحد من --bundle أو --codeDir (ولكن ليس كليهما).

2. يجب العثور على مسارات وملفات حزم التعليمات البرمجية في نظام الملفات المحلي.

3. --bundle يتوقع ملف tgz تم إنشاؤه بالفعل وفقًا لمواصفات EdgeWorkers.

4. --codeDir يتوقع مسار دليل يحتوي على كل من main.js (ملف الأحداث) وbundle.json (ملف البيان).

5. سيوفر خيار --codeDir التحقق من صحة تنسيق Bundle.json.

6. لا يقوم --codeDir بحزم أدلة أو تعليمات برمجية أخرى تتجاوز main.js وbundle.json.

7. سيقوم --codeDir بإنشاء ملف tarball (tgz) في حالة نجاح التحقق من صحة الملف.

8. ستقوم الخدمة بمقارنة المجموع الاختباري لكرات القطران الجديدة مع كرات القطران التي تم تحميلها مسبقًا لنفس معرف EdgeWorker ( ewId ). إذا تم العثور على تطابق، فلن يُسمح بإنشاء الإصدار الجديد.

9. يتم إنشاء versionId بواسطة العميل وسيتم سحبه من Bundle.json.

10. سيتم توفير رأس استجابة الموقع بمعرف إصدار EdgeWorker الجديد.

11. سيتم تزويد نص استجابة تفاصيل إصدار EdgeWorker (JSON) برمز استجابة 201.

حذف إصدار EdgeWorker الموجود

حذف إصدار موجود من معرف EdgeWorker المحدد نهائيًا.

الاستخدام: akamai edgeworkers delete-version [options] <edgeworker-identifier> <version-identifier>

خيار	وصف
-ح، --مساعدة	معلومات استخدام الإخراج
--noPrompt	تخطي مطالبة تأكيد الحذف

دعوى	وجود	وصف
معرف عامل الحافة	مطلوب	مقبض عدد صحيح فريد لمثيل EdgeWorkers
معرف الإصدار	مطلوب	مؤشر عدد صحيح فريد لإصدار مثيل EdgeWorkers

التفاصيل الرئيسية

1. لا يمكن حذف الإصدار إلا إذا لم يكن نشطًا حاليًا أو تم تنشيطه على شبكة Akamai.

2. إذا كان الإصدار نشطًا حاليًا، فيجب إلغاء تنشيطه قبل حذفه.

قم بتنزيل حزمة كود EdgeWorkers

قم بتنزيل حزمة التعليمات البرمجية لإصدار EdgeWorker.

الاستخدام: akamai edgeworkers download [options] <edgeworker-identifier> <version-identifier>

خيار	وصف
-ح، --مساعدة	معلومات استخدام الإخراج
--downloadPath <downloadPath>	مسار لتخزين ملف الحزمة الذي تم تنزيله؛ الإعدادات الافتراضية هي الدليل الرئيسي لـ CLI إذا لم يتم توفيرها.

دعوى	وجود	وصف
معرف عامل الحافة	مطلوب	مقبض عدد صحيح فريد لمثيل EdgeWorkers
معرف الإصدار	مطلوب	مؤشر عدد صحيح فريد لإصدار مثيل EdgeWorkers

التفاصيل الرئيسية

1. إذا لم يتم توفير --downloadPath أو لم يتم العثور عليه في نظام الملفات المحلي، فسيتم استخدام الدليل الفرعي لذاكرة التخزين المؤقت AkamaiCLI: <CLI_CACHE_PATH>/edgeworkers-cli/edgeworkers/<ewid>/

قم بتنزيل حزمة التعليمات البرمجية المجمعة لـ EdgeWorkers

قم بتنزيل حزمة التعليمات البرمجية المجمعة التي تحتوي على التعليمات البرمجية والتبعيات التي ينفذها EdgeWorker.

الاستخدام: akamai edgeworkers download-revision [options] <edgeworker-identifier> <revision-identifier>

خيار	وصف
-ح، --مساعدة	معلومات استخدام الإخراج
--downloadPath <downloadPath>	مسار لتخزين ملف الحزمة المدمج الذي تم تنزيله؛ الإعدادات الافتراضية هي الدليل الرئيسي لـ CLI إذا لم يتم توفيرها.

دعوى	وجود	وصف
معرف عامل الحافة	مطلوب	مقبض عدد صحيح فريد لمثيل EdgeWorkers
معرف المراجعة	مطلوب	معرف مراجعة فريد لمثيل EdgeWorkers محدد

التفاصيل الرئيسية

1. إذا لم يتم توفير --downloadPath أو لم يتم العثور عليه في نظام الملفات المحلي، فسيتم استخدام الدليل الفرعي لذاكرة التخزين المؤقت AkamaiCLI: <CLI_CACHE_PATH>/edgeworkers-cli/edgeworkers/<revid>/

قم بإدراج حالة تنشيط إصدار EdgeWorker

قائمة حالة التنشيط لمعرف EdgeWorker المحدد.

الاستخدام: akamai edgeworkers status [options] <edgeworker-identifier>

خيار	وصف
-ح، --مساعدة	معلومات استخدام الإخراج
--versionId <versionId>	معرف الإصدار
--activationId <activationId>	معرف التنشيط
--activeOnNetwork	يحد من عرض النتائج للإصدارات النشطة حاليًا فقط
--الشبكة <network>	يقتصر النتائج على الإصدارات التي تم تنشيطها على شبكة معينة (التدريج أو الإنتاج)

دعوى	وجود	وصف
معرف عامل الحافة	مطلوب	مقبض عدد صحيح فريد لمثيل EdgeWorkers

التفاصيل الرئيسية

1. لا يجوز لك تقديم معرفات الإصدار والتنشيط.

قائمة تاريخ مراجعة EdgeWorker

قم بإدراج سجل المراجعة لمعرف EdgeWorker المحدد.

الاستخدام: akamai edgeworkers list-revisions [options] <edgeworker-identifier>

خيار	وصف
-ح، --مساعدة	معلومات استخدام الإخراج
--versionId <versionId>	معرف الإصدار
--activationId <activationId>	معرف التنشيط
--مثبت فقط	يحد من عرض النتائج للمراجعات المثبتة حاليًا أو مسبقًا فقط
--مثبت حاليًا	يحد من النتائج لإظهار المراجعات المثبتة حاليًا فقط
--الشبكة <network>	يقتصر النتائج على الإصدارات التي تم تنشيطها على شبكة معينة (التدريج أو الإنتاج)

دعوى	وجود	وصف
معرف عامل الحافة	مطلوب	مقبض عدد صحيح فريد لمثيل EdgeWorkers

التفاصيل الرئيسية

1. يجب أن تكون الشبكة إما مرحلية أو إنتاجية. سيتم تطبيع الكتابة بالأحرف الكبيرة إلى الأحرف الكبيرة.

احصل على تفاصيل المراجعة الخاصة بـ EdgeWorker

احصل على تفاصيل لمراجعة محددة.

الاستخدام: akamai edgeworkers get-revision [options] <edgeworker-identifier> <revision-identifier>

خيار	وصف
-ح، --مساعدة	معلومات استخدام الإخراج

دعوى	وجود	وصف
معرف عامل الحافة	مطلوب	مقبض عدد صحيح فريد لمثيل EdgeWorkers
معرف المراجعة	مطلوب	معرف المراجعة

قارن بين تفاصيل المراجعة الخاصة بـ EdgeWorker

عرض اختلافات التبعية بين مراجعتين لنفس EdgeWorker.

الاستخدام: akamai edgeworkers compare-revisions [options] <edgeworker-identifier> <revision-identifier> <revision-identifier>

خيار	وصف
-ح، --مساعدة	معلومات استخدام الإخراج

دعوى	وجود	وصف
معرف عامل الحافة	مطلوب	مقبض عدد صحيح فريد لمثيل EdgeWorkers
معرف المراجعة	مطلوب	معرف المراجعة الأولى
معرف المراجعة	مطلوب	معرف المراجعة الثانية

التفاصيل الرئيسية

1. يجب أن تكون معرفات المراجعة مختلفة.

قم بتنشيط مراجعة EdgeWorker

قم بتنشيط مراجعة لمعرف EdgeWorker المحدد على شبكة Akamai.

الاستخدام: akamai edgeworkers activate-revision [options] <edgeworker-identifier> <revision-identifier>

خيار	وصف
-ح، --مساعدة	معلومات استخدام الإخراج
--ملحوظة	ملاحظة لتحديد سبب إعادة تنشيط المراجعة

دعوى	وجود	وصف
معرف عامل الحافة	مطلوب	مقبض عدد صحيح فريد لمثيل EdgeWorkers
معرف المراجعة	مطلوب	معرف المراجعة

التفاصيل الرئيسية

1. ستتم إعادة تنشيط المراجعة على نفس الشبكة (PRODUCTION أو STAGING) التي كانت نشطة عليها مسبقًا.

مراجعة الدبوس لـ EdgeWorker

قم بتثبيت مراجعة نشطة لمعرف EdgeWorker المحدد.

الاستخدام: akamai edgeworkers pin-revision [options] <edgeworker-identifier> <revision-identifier>

خيار	وصف
-ح، --مساعدة	معلومات استخدام الإخراج
--ملحوظة	ملاحظة لتحديد سبب تثبيت المراجعة

دعوى	وجود	وصف
معرف عامل الحافة	مطلوب	مقبض عدد صحيح فريد لمثيل EdgeWorkers
معرف المراجعة	مطلوب	معرف المراجعة

التفاصيل الرئيسية

1. يجب تفعيل المراجعة قبل التثبيت.

قم بإلغاء تثبيت مراجعة EdgeWorker

قم بإلغاء تثبيت مراجعة مثبتة نشطة لمعرف EdgeWorker محدد.

الاستخدام: akamai edgeworkers unpin-revision [options] <edgeworker-identifier> <revision-identifier>

خيار	وصف
-ح، --مساعدة	معلومات استخدام الإخراج
--ملحوظة	ملاحظة لتحديد سبب إزالة تثبيت المراجعة

دعوى	وجود	وصف
معرف عامل الحافة	مطلوب	مقبض عدد صحيح فريد لمثيل EdgeWorkers
معرف المراجعة	مطلوب	معرف المراجعة

التفاصيل الرئيسية

1. يجب تثبيت المراجعة قبل إلغاء التثبيت.

احصل على تفاصيل المراجعة الخاصة بـ EdgeWorker

عرض تفاصيل مراجعة محددة للحزمة المركبة.

الاستخدام: akamai edgeworkers get-revision-bom [options] <edgeworker-identifier> <revision-identifier>

خيار	وصف
-ح، --مساعدة	معلومات استخدام الإخراج
--activeVersions	تحديد النتائج لإظهار الإصدارات النشطة فقط
--currentlyPinnedRevisions	يعرض معلومات إضافية حول المراجعة المثبتة حاليًا

دعوى	وجود	وصف
معرف عامل الحافة	مطلوب	مقبض عدد صحيح فريد لمثيل EdgeWorkers
معرف المراجعة	مطلوب	معرف المراجعة

قم بإدراج عمليات تنشيط المراجعة الخاصة بـ EdgeWorker

قم بإدراج حالة تنشيط المراجعة لمعرف EdgeWorker المحدد.

الاستخدام: akamai edgeworkers list-revision-activations [options] <edgeworker-identifier>

خيار	وصف
-ح، --مساعدة	معلومات استخدام الإخراج
--versionId	معرف الإصدار
--activationId	معرف التنشيط
--شبكة	يقتصر النتائج على الإصدارات التي تم تنشيطها على شبكة معينة (التدريج أو الإنتاج)

دعوى	وجود	وصف
معرف عامل الحافة	مطلوب	مقبض عدد صحيح فريد لمثيل EdgeWorkers

التفاصيل الرئيسية

1. لا يجوز لك تقديم معرفات الإصدار والتنشيط.

2. يجب أن تكون الشبكة إما مرحلية أو إنتاجية. سيتم تطبيع الكتابة بالأحرف الكبيرة إلى الأحرف الكبيرة.

تفعيل EdgeWorker

قم بتنشيط إصدار لمعرف EdgeWorker محدد على شبكة Akamai.

الاستخدام: akamai edgeworkers activate [options] <edgeworker-identifier> <network> <version-identifier>

خيار	وصف
-ح، --مساعدة	معلومات استخدام الإخراج

دعوى	وجود	وصف
معرف عامل الحافة	مطلوب	مقبض عدد صحيح فريد لمثيل EdgeWorkers
شبكة	مطلوب	التسمية التي يجب إرسال تنشيط شبكة Akamai (التدريج أو الإنتاج) إليها
معرف الإصدار	مطلوب	مؤشر عدد صحيح فريد لإصدار مثيل EdgeWorkers

التفاصيل الرئيسية

1. يجب أن تكون الشبكة إما مرحلية أو إنتاجية. سيتم تطبيع الكتابة بالأحرف الكبيرة إلى الأحرف الكبيرة.

2. سيتم تزويد رأس استجابة الموقع بمعرف تنشيط EdgeWorker الجديد.

3. سيتم تزويد نص استجابة تفاصيل تنشيط EdgeWorker (JSON) برمز استجابة 201.

التحقق من صحة حزمة كود EdgeWorkers

التحقق من صحة إصدار حزمة التعليمات البرمجية دون تحميل حزمة التعليمات البرمجية

الاستخدام: akamai edgeworkers validate [options] <bundlePath>

خيار	وصف
-ح، --مساعدة	معلومات استخدام الإخراج

دعوى	وجود	وصف
packagePath	مطلوب	المسار إلى ملف الحزمة بتنسيق tgz

التفاصيل الرئيسية

1. يجب العثور على مسار حزمة التعليمات البرمجية في نظام الملفات المحلي.

2. تتوقع حزمة التعليمات البرمجية وجود ملف tgz تم إنشاؤه بالفعل وفقًا لمواصفات EdgeWorkers.

قم بإلغاء تنشيط EdgeWorker

قم بإلغاء تنشيط إصدار لمعرف EdgeWorker محدد على شبكة Akamai.

الاستخدام: akamai edgeworkers deactivate [options] <edgeworker-identifier> <network> <version-identifier>

خيار	وصف
-ح، --مساعدة	معلومات استخدام الإخراج

دعوى	وجود	وصف
معرف عامل الحافة	مطلوب	مقبض عدد صحيح فريد لمثيل EdgeWorkers
شبكة	مطلوب	التسمية التي يجب إرسال تنشيط شبكة Akamai (التدريج أو الإنتاج) إليها
معرف الإصدار	مطلوب	مؤشر عدد صحيح فريد لإصدار مثيل EdgeWorkers

التفاصيل الرئيسية

1. يجب أن تكون الشبكة إما مرحلية أو إنتاجية. سيتم تطبيع الكتابة بالأحرف الكبيرة إلى الأحرف الكبيرة.

2. سيتم تزويد رأس استجابة الموقع بمعرف تنشيط EdgeWorker الجديد.

3. سيتم تزويد نص استجابة تفاصيل تنشيط EdgeWorker (JSON) برمز استجابة 201.

قم بإنشاء رمز مصادقة EdgeWorkers

يُنشئ رمزًا مميزًا للمصادقة يمكن استخدامه للحصول على رؤوس استجابة تصحيح أخطاء EdgeWorker التفصيلية. تحتاج إلى الإصدار 1.7.1 على الأقل من EdgeWorkers CLI لتشغيل هذا الأمر. استخدم الخيار -V, --version لعرض رقم الإصدار الحالي لـ EdgeWorkers CLI.

الاستخدام: akamai edgeworkers create-auth-token [options] <hostName>

خيار	وصف
-ح، --مساعدة	معلومات استخدام الإخراج
- انتهاء الصلاحية <expiry>	مدة انتهاء الرمز المميز، بالدقائق.
--التنسيق <format>	التنسيق الذي سيتم طباعة الإخراج به

دعوى	وجود	وصف
اسم المضيف	اختياري	اسم المضيف للعقار. إذا لم يتم توفير اسم مضيف، فسيتم إنشاء الرمز المميز لجميع المضيفين ( /* ) ضمن الخاصية. على سبيل المثال: www.test.com، www.test1.com

التفاصيل الرئيسية

1. يجب أن تكون قيمة --expiry بين 1 و720 دقيقة (12 ساعة). الافتراضي هو 8 hours .

استنساخ معرف EdgeWorker

يسمح للعميل باستنساخ EdgeWorker من معرف EdgeWorker الموجود.

الاستخدام: akamai edgeworkers clone <edgeworker-identifier> <resourceTierId> [options]

خيار	وصف
-ح، --مساعدة	معلومات استخدام الإخراج
--ewName	اسم عامل الحافة
--groupId	معرف المجموعة

دعوى	وجود	وصف
ResourceTierId	مطلوب	معرف طبقة المورد الذي سيتم استنساخ EdgeWorker إليه.

التفاصيل الرئيسية

1. تسمح نقطة النهاية هذه للمستخدم بتحديد معرف طبقة مورد مختلف لمعرف EdgeWorker محدد عن طريق استنساخه. سوف يفشل الاستنساخ إلى نفس طبقة الموارد.

قائمة العقود

قائمة معرفات العقود التي يمكن للمستخدم الوصول إليها.

الاستخدام: akamai list-contracts

خيار	وصف
-ح، --مساعدة	معلومات استخدام الإخراج

خصائص القائمة

قائمة الخصائص المرتبطة بمعرف EdgeWorker محدد.

الاستخدام: akamai edgeworkers list-properties <edgeworker-identifier> [options]

خيار	وصف
-ح، --مساعدة	معلومات استخدام الإخراج
--activeOnly	إرجاع الخصائص النشطة فقط

دعوى	وجود	وصف
معرف عامل الحافة	مطلوب	معرف EdgeWorker

التفاصيل الرئيسية

1. لاحظ أن القيمة المنطقية التي تم إرجاعها LimitedAccessToProperties تكون صحيحة إذا لم يكن لدى المستخدم حق الوصول إلى مجموعة المستوى الأعلى ضمن الحساب، أو إذا لم يكن لديه دور المسؤول لهذه المجموعة.

حدود القائمة

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

الاستخدام: akamai edgeworkers list-limits [options]

خيار	وصف
-ح، --مساعدة	معلومات استخدام الإخراج

قم بإدراج طبقات الموارد لمعرف عقد محدد

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

الاستخدام: akamai list-restiers

خيار	وصف
--contractId	طبقات الموارد لمعرف العقد المحدد.
-ح، --مساعدة	معلومات استخدام الإخراج

التفاصيل الرئيسية

1. ستتم مطالبة المستخدم بقائمة معرفات العقود التي يمكن للمستخدم الوصول إليها. سيتم استخدام معرف العقد المحدد لجلب طبقة الموارد.

2. لتعطيل المطالبة لغرض التشغيل الآلي، يمكن توفير معرف العقد كمدخل.

قم بإحضار طبقة الموارد لمعرف EdgeWorker محدد

يمكن للعملاء الحصول على تفاصيل طبقة الموارد لمعرف EdgeWorker محدد.

الاستخدام: akamai show-restier <edgeworkerId>

خيار	وصف
-ح، --مساعدة	معلومات استخدام الإخراج

دعوى	وجود	وصف
معرف عامل الحافة	مطلوب	معرف EdgeWorker

احصل على أنواع تقارير EdgeWorkers المتوفرة

قم بإدراج أنواع التقارير المتاحة التي يمكن إنشاؤها لمعرف EdgeWorker.

الاستخدام: akamai get reports

خيار	وصف
-ح، --مساعدة	معلومات استخدام الإخراج

التفاصيل الرئيسية

1. سيتم منح المستخدم جدولاً يحتوي على معرفات التقارير ووصفًا لكل تقرير. استخدم معرف التقرير المحدد مع أمر get report للحصول على تقرير لـ EdgeWorker معين.

احصل على تقرير EdgeWorker

احصل على تقرير لمعرف EdgeWorker المحدد.

الاستخدام: akamai get report <reportId> <edgeworker-identifier>

خيار	وجود	وصف
-ح، --مساعدة	خياري	معلومات استخدام الإخراج
-s، --startDate <startDate>	مطلوب	يشير الطابع الزمني ISO 8601 إلى وقت بدء تقرير EdgeWorkers.
-e، --endDate <startDate>	خياري	يشير الطابع الزمني ISO 8601 إلى وقت انتهاء تقرير EdgeWorkers. إذا لم يتم تحديده، فسيتم تعيين وقت الانتهاء افتراضيًا على الوقت الحالي.
--الحالة <status>	خياري	سلسلة مفصولة بفواصل للتصفية حسب حالة EdgeWorkers. القيم: success ، genericError ، unknownEdgeWorkerId ، unimplementedEventHandler ، runtimeError ، executionError ، timeoutError ، resourceLimitHit ، cpuTimeoutError ، wallTimeoutError ، initCpuTimeoutError ، initWallTimeoutError .
--ev, --eventHandlers <eventHandlers>	خياري	سلسلة مفصولة بفواصل لتصفية EdgeWorkers حسب الحدث الذي يقوم بتشغيلها. القيم: onClientRequest ، onOriginRequest ، onOriginResponse ، onClientResponse ، responseProvider .

دعوى	وجود	وصف
معرف التقرير	مطلوب	نوع التقرير.
معرف عامل الحافة	مطلوب	معرف EdgeWorker

التفاصيل الرئيسية

1. للحصول على قائمة بمعرفات التقارير المتوفرة، استخدم أمر get reports .

2. يعد خيار startDate خيارًا مطلوبًا.

قم بإدراج كافة القيم الافتراضية للقسم في ملف التكوين

احصل على جميع الخصائص الافتراضية في قسم من ملف التكوين.

الاستخدام: akamai config list

خيار	وجود	وصف
-ح، --مساعدة	خياري	معلومات استخدام الإخراج

التفاصيل الرئيسية

1. قسم التكوين default . لاستخدام قسم مختلف، يجب على المستخدمين تحديد أمر akamai edgeworkers باستخدام الخيار --configSection <configSeciont> .

2. يجب أن ينطبق نفس النهج على أوامر config التالية.

احصل على القيمة الافتراضية للقسم في ملف التكوين

احصل على قيمة افتراضية محددة في قسم من ملف التكوين.

الاستخدام: akamai config get <key>

خيار	وجود	وصف
-ح، --مساعدة	خياري	معلومات استخدام الإخراج

دعوى	وجود	وصف
مفتاح	مطلوب	اسم الخاصية الافتراضية

تعيين/تحديث القيمة الافتراضية لقسم في ملف التكوين

يسمح للعملاء بتعيين/تحديث قيمة افتراضية محددة في قسم من ملف التكوين.

الاستخدام: akamai config set <key> <value>

خيار	وجود	وصف
-ح، --مساعدة	خياري	معلومات استخدام الإخراج

دعوى	وجود	وصف
مفتاح	مطلوب	اسم الخاصية الافتراضية
قيمة	مطلوب	قيمة الخاصية الافتراضية

قم بإلغاء تعيين القيمة الافتراضية لقسم في ملف التكوين

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

الاستخدام: akamai config unset <key>

خيار	وجود	وصف
-ح، --مساعدة	خياري	معلومات استخدام الإخراج

دعوى	وجود	وصف
مفتاح	مطلوب	اسم الخاصية الافتراضية

حفظ مجمع للخاصية الافتراضية للقسم في ملف التكوين

يسمح للعملاء بحفظ القيم الافتراضية بكميات كبيرة.

الاستخدام: akamai config save [options]

خيار	وجود	وصف
-ح، --مساعدة	خياري	معلومات استخدام الإخراج
-p، --خصائص	مطلوب	خصائص التكوين. استخدم التنسيق "مفتاح = قيمة" لتعيين خاصية ومساحة بيضاء لتقسيمها.

التفاصيل الرئيسية

1. إذا كان السياق يحتوي على عنصر غير صالح، فسيقوم الأمر بتخطي هذا العنصر والمتابعة.

عرض مستوى التسجيل الحالي لـ EdgeWorker

يسمح للعملاء بعرض تفاصيل تجاوزات مستوى التسجيل لعامل الحافة.

الاستخدام: akamai edgeworkers log-level get [options] <edgeworker-identifier> [logging-identifier]

خيار	وجود	وصف
-ح، --مساعدة	خياري	معلومات استخدام الإخراج

دعوى	وجود	وصف
معرف عامل الحافة	مطلوب	معرف EdgeWorker الذي سيتم عرض معلومات تجاوز مستوى التسجيل له.
معرف التسجيل	خياري	سيتم عرض معرف التسجيل الخاص بمستوى التسجيل.

التفاصيل الرئيسية

1. إذا لم يتم تحديد logging-identifier ، فسيتم عرض جميع تجاوزات مستوى التسجيل.

2. logging-identifier هو ثابت رقمي، يحدد تجاوز مستوى السجل. يمكن الحصول عليه أثناء إنشاء التجاوز، أو عن طريق سرد كافة التجاوزات دون توفير الوسيطة الاختيارية والبحث عن حقل loggingId التجاوز المحدد.

قم بتعيين مستوى التسجيل الحالي لـ EdgeWorker

يسمح للعملاء بتعيين مستوى التسجيل لـ EdgeWorker.

الاستخدام: akamai edgeworkers log-level set [options] <edgeworker-identifier> <network> <level>

خيار	وجود	وصف
-ح، --مساعدة	خياري	معلومات استخدام الإخراج
--انتهاء الصلاحية	خياري	يحدد المدة التي سيتم فيها تطبيق تجاوز مستوى التسجيل الخاص بالمستخدم. وبعد مروره، يعود مستوى التسجيل مرة أخرى إلى المستوى الافتراضي المحدد في الحزمة.
--ds2Id	خياري	معرف Datastream الذي سيتم استخدامه بجانب المعرف المحدد في ملف EdgeWorker's bundle.json .

دعوى	وجود	وصف
معرف عامل الحافة	مطلوب	معرف EdgeWorker الذي سيتم تغيير مستوى التسجيل له.
شبكة	مطلوب	الشبكة التي سيتم تطبيق مستوى التسجيل الجديد عليها. إما "الإنتاج" أو "التدريج".
مستوى	مطلوب	مستوى تسجيل جديد يمكن تطبيقه على EdgeWorker. للحصول على القيم المحتملة، راجع وثائق تسجيل العملاء.

التفاصيل الرئيسية

1. لا يسري إلا تجاوز مستوى السجل الذي تم إنشاؤه مؤخرًا.

2. عند انتهاء صلاحية التجاوز، تتم إعادة تعيين مستوى التسجيل إلى المستوى المحدد في ملف bundle.json الخاص بـ Edgeworker.

3. إذا نجح الأمر، فستتم طباعة تفاصيل تجاوز مستوى السجل، والتي تتضمن loggingId التجاوز. يمكن استخدام loggingId للحصول على هذه التفاصيل في أي وقت باستخدام الأمر الفرعي log-level get وتمريره إلى وسيطة اختيارية logging-identifier .

4. إذا لم يتم تحديد خيار --expires ، فإن الخيار الافتراضي هو ألا تنتهي صلاحية التجاوز أبدًا.

5. يدعم خيار --expires كلاً من إدخال اللغة الطبيعية والطوابع الزمنية القياسية. يرجى الرجوع إلى وثائق حزمة chrono للحصول على المواصفات الكاملة.

أمثلة

1. قم بتعيين تجاوز مستوى السجل على شبكة الإنتاج على مستوى المعلومات، والذي ستنتهي صلاحيته خلال ساعة واحدة.

./akamai-edgeworkers log-level set 654321 production info --expires 1h

2. قم بتعيين تجاوز مستوى السجل على الشبكة المرحلية لتتبع المستوى، والذي ستنتهي صلاحيته في الساعة 3 مساءً بتوقيت وسط أوروبا الصيفي (توقيت وسط أوروبا الصيفي) في 13 أغسطس 2024.

./akamai-edgeworkers log-level set 654321 staging trace --expires "2024-08-13T15:00+02:00"

موارد

لمزيد من المعلومات حول EdgeWorkers، راجع الموارد التالية:

• صفحة مطور EdgeWorkers

• دليل مستخدم EdgeWorkers

• دليل واجهة برمجة تطبيقات EdgeWorkers

قضايا الإبلاغ

لقد انتهيت تمامًا، برمجية سعيدة! إذا واجهت أية مشكلات مع EdgeWorkers CLI، فاطرحها كمشكلة github. لا تتردد في إنشاء طلب سحب مع الإصلاح أو الاقتراح.

المساهمة

نرحب بالمساهمات المقدمة من موظفي Akamai أو العملاء أو غيرهم. قبل فتح العلاقات العامة، يرجى التحقق مما يلي:

1. يرجى إضافة بعض حالات الاختبار لمرافقة العلاقات العامة الخاصة بك. يتحقق هذا من الوظيفة المضافة أو المعدلة في العلاقات العامة ويثبت للآخرين أن التعليمات البرمجية الخاصة بك تعمل :)

2. يرجى التأكد من اجتياز الكود الخاص بك لجميع عمليات التحقق المسبقة. يجب أن يتم إنشاء التعليمات البرمجية الخاصة بك بنجاح، واجتياز جميع اختبارات الوحدة، وعدم وجود مشكلات في الفحص.

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