فاحص المسافات البادئة وصياغة YAML مع أرقام الأسطر
اكتشف أخطاء البنية التي تفسد ملف YAML: في العينة يعطي المفتاح port المكرر في السطر 4 بعد السطر 3، وعلامة جدولة في السطر 5، ملاحظتين، لكل منهما سطرها وشرح واضح. مجاناً في متصفحك.
- مجاني
- يعمل في متصفحك
- دون تسجيل
- بياناتك لا تغادر جهازك
شغّل الأداة مجانًا
مثال محلول
- النص
- service: name: api port: 8080 port: 9090 debug: true
- عدد الأخطاء
- 2
يكشف فاحص المسافات البادئة وصياغة YAML الأخطاء الهيكلية الصغيرة التي تجعل ملفات الإعداد غير موثوقة، مثل علامات الجدولة المخفية في بداية السطر، والتغير غير المتوقع في عمق المسافات، وتكرار المفاتيح داخل التعيين نفسه. يتضمن كل اكتشاف رقم سطر المصدر، لتنتقلوا مباشرة إلى الإعداد المعيب. ويرفض الفاحص كذلك النص الذي يتعذر تفسيره كملف YAML، وبذلك يفصل بوضوح بين الإدخال المشوه والمستند الصحيح الذي لا يحتوي إلا على ملاحظات lint.
اقرؤوا تقريرا مركزا بدلا من تتبع رسائل المحلل
ألصقوا مستند YAML كاملا في حقل النص ثم شغلوا الفحص. توضح النتيجة نجاح المستند، وعدد الاكتشافات، وتسرد كل مشكلة برقم سطر يبدأ من 1 ونوع ثابت وشرح. يلائم هذا الشكل الموجز الشخص الذي يراجع ملف نشر والبرنامج الذي يفحص إعدادا مولدا.
يركز الفاحص على ثلاثة مخاطر شائعة: علامات الجدولة في الفراغ البادئ لأن المحررات تعرضها بعروض مختلفة، وتغيرات المسافات التي لا تتبع بنية العقد الأعلى، والمفاتيح المكررة ضمن النطاق نفسه. ويمكن للاسم ذاته أن يظهر في كائنات منفصلة. لا تربك التعليقات والأسطر الفارغة مراجع الأسطر.
وعندما تكون النتيجة سليمة، تحتوي على مصفوفة أخطاء فارغة بدلا من قيم نائبة، لذلك يسهل اعتمادها كبوابة ناجحة في عملية بناء أو في سير عمل يسبق تثبيت التغييرات.
ميزوا بين ملاحظات lint والإدخال غير الصالح
تصف ملاحظة lint نصا ما زال قابلا للفحص بصورة مفيدة رغم خطورة بنيته. لذلك تؤدي علامة الجدولة في المسافة البادئة أو المفتاح المكرر إلى نتيجة عادية تتضمن السطر المعني. أما فشل التحليل فيعني أن المستند ناقص أو مشوه إلى حد يمنع مواصلة التحليل الهيكلي الموثوق.
تؤدي علامات الاقتباس غير المغلقة، وفواصل المجموعات غير المتطابقة، ومفاتيح التعيين الفارغة، والسطر العادي حيث يلزم تعيين أو تسلسل إلى خطأ إدخال غير صالح. يفيد فصل النتيجتين في الأتمتة؛ إذ يمكن لتكاملكم عرض كل الملاحظات القابلة للإصلاح معا، بينما يوقف فشل التحليل خط المعالجة ويطلب إصلاح المصدر. الفحص حتمي ولا يعيد كتابة المستند، ولا يختار قيمة مكررة، ولا يخمن التداخل المقصود.
إن تغيير معنى الإعداد بصمت أسوأ غالبا من رفض الملف. أصلحوا أول فشل تحليل، وأعيدوا الفحص، ثم عالجوا الملاحظات المتبقية ذات أرقام الأسطر.
استخدموا الفاحص بأمان في المحررات وخطوط التسليم
أرسلوا نص المصدر الدقيق بدلا من كائن محلل، لأن المسافات البادئة والمفاتيح المكررة تختفي عندما تحول محللات كثيرة YAML إلى بيانات عادية. احتفظوا بنهايات الأسطر والتعليقات إذا أردتم تطابق مواضع التقرير مع الملف في المحرر. يمكن لخط عملي تشغيل الفحص بعد تطبيق القوالب وقبل حقن الأسرار، ثم الإخفاق عندما تكون valid مساوية لـ false أو عندما يعيد الطلب خطأ إدخال غير صالح.
تظل الاستجابة ثابتة للنص نفسه؛ فلا تستخدم شبكة أو عشوائية أو ساعة أو حالة خاصة بالبيئة. كما تمنع حدود حجم الإدخال وعدد الأسطر العمل غير المحدود. هذا فحص هيكلي أساسي عن قصد، وليس مدقق مخطط.
فهو لا يعرف إن كان حقل Kubernetes أو خاصية سير عمل أو خيار تطبيق مسموحا. اجمعوه مع مدقق مخطط النظام المستهدف عندما تكون الصحة الدلالية مهمة.
حالات الاستخدام
فحص إعدادات النشر
اكتشفوا التداخل المزاح وعلامات الجدولة والإعدادات المكررة قبل أن تفسر أداة النشر الملف.
التحقق من YAML المولد
افحصوا مخرجات القوالب أثناء البناء واحصلوا على أرقام أسطر قابلة للتنفيذ عند توليد بنية مشوهة.
مراجعة تغييرات الإعداد
أضيفوا فحصا هيكليا سريعا إلى مراجعة الشفرة كي لا تختبئ أخطاء الفراغات الدقيقة داخل فرق كبير.
الأسئلة الشائعة
ما تكلفة عملية الفحص؟
ويمكن استخدام نسخة المتصفح مباشرة في هذه الصفحة.
هل يعدل الفاحص ملف YAML؟
لا. فهو يبلغ عن الاكتشافات فقط، ولا يعيد كتابة المسافات أو يحذف المفاتيح أو يختار بين القيم المكررة.
هل يسمح بالمفاتيح المتشابهة في كائنات مختلفة؟
نعم. لا يبلغ عن المفتاح إلا عند تكراره في نطاق التعيين نفسه، ويمكن ظهوره في كائنات متداخلة منفصلة.
لماذا يبلغ عن علامات الجدولة حين يبدو الملف متراصفا؟
قد تعرض المحررات علامات الجدولة بعروض مختلفة، ولذلك قد يتغير تداخل YAML عند نقله بين الأدوات.
هل هذه أداة للتحقق من مخطط Kubernetes أو سير العمل؟
لا. إنها تفحص بنية YAML العامة وصياغته الأساسية، لا أسماء الحقول أو الأنواع أو السياسات الخاصة بمنتج معين.
أدوات ذات صلة
للمطوّرين — الوصول عبر API
كل ما في هذه الصفحة متاح برمجيًا. هذا القسم موجّه للفرق التقنية التي تريد ربط الأداة بأنظمتها الخاصة؛ بقية المستخدمين يمكنهم استخدام الأداة أعلاه مباشرة دون الحاجة لقراءة ما يلي.
الـEndpoint
صادِق على طلبك بترويسة Bearer، وأرسل طلب POST واحدًا لتدخل مهمتك قائمة التنفيذ فورًا؛ ثم تستلم النتيجة عبر webhook أو رابط موقّع.
استدعِ الخدمة من بيئتك
curl -X POST https://api.kit.forhosting.com/dev2/yaml-lint-basic \
-H "Authorization: Bearer $KIT_KEY" \
-H "Content-Type: application/json" \
-d '{"text":"service:\n name: api\n ports:\n - 8080\n - 8081"}'const res = await fetch("https://api.kit.forhosting.com/dev2/yaml-lint-basic", {
method: "POST",
headers: {
"Authorization": `Bearer ${process.env.KIT_KEY}`,
"Content-Type": "application/json"
},
body: JSON.stringify({
"text": "service:\n name: api\n ports:\n - 8080\n - 8081"
})
});
const { task_id } = await res.json();import os, requests
res = requests.post(
"https://api.kit.forhosting.com/dev2/yaml-lint-basic",
headers={"Authorization": f"Bearer {os.environ['KIT_KEY']}"},
json={
"text": "service:\n name: api\n ports:\n - 8080\n - 8081"
},
)
task_id = res.json()["task_id"]<?php
$res = file_get_contents("https://api.kit.forhosting.com/dev2/yaml-lint-basic", false, stream_context_create([
"http" => [
"method" => "POST",
"header" => "Authorization: Bearer " . getenv("KIT_KEY") . "\r\nContent-Type: application/json",
"content" => '{"text":"service:\\n name: api\\n ports:\\n - 8080\\n - 8081"}',
],
]));
$task = json_decode($res, true);body := bytes.NewBufferString(`{"text":"service:\n name: api\n ports:\n - 8080\n - 8081"}`)
req, _ := http.NewRequest("POST", "https://api.kit.forhosting.com/dev2/yaml-lint-basic", body)
req.Header.Set("Authorization", "Bearer "+os.Getenv("KIT_KEY"))
req.Header.Set("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)مثال على الطلب
{
"text": "service:\n name: api\n ports:\n - 8080\n - 8081"
}مثال على الاستجابة
{
"task_id": "tsk_a1b2c3d4e5f6a1b2c3d4e5f6",
"type": "dev2.yaml_lint_basic",
"status": "queued",
"_links": {
"result": "/tasks/tsk_…/result"
}
}الواجهة غير متزامنة: تستلم task_id فور الإرسال، ويمكنك الاستعلام عن الحالة بمعدل طلب واحد في الثانية.
الأسعار
السعر معلن كما تراه: لا tokens ولا نظام نقاط؛ وإن فشلت المهمة فلن تُحاسَب عليها.
الأخطاء
| HTTP | الرمز | المعنى |
|---|---|---|
401 | unauthorized | مفتاح الوصول مفقود أو غير صالح؛ تحقق من ترويسة Bearer في طلبك. |
402 | insufficient_balance | رصيدك لا يكفي لتنفيذ هذه المهمة؛ أعد شحن الرصيد ثم أعد المحاولة. |
404 | unknown_type | نوع المهمة المطلوب غير موجود في الكتالوج — راجع الاسم المرسل في الطلب. |
429 | rate_limited | تجاوزت الحد المسموح من الطلبات؛ انتظر قليلًا ثم أعد المحاولة. |
ملاحظات تقنية
استخدموا الفاحص بأمان في المحررات وخطوط التسليم
صممت نقطة النهاية للفحص السريع قبل وصول YAML إلى أداة نشر أو ناشر حزم أو مهمة تكامل مستمر أو بدء تطبيق.