JSON إلى Kubernetes YAML

حوّل مخرجات kubectl بصيغة JSON وكائنات API إلى ملفات manifest نظيفة يمكنك مراجعتها وتطبيقها.

خيارات المخرجات

JSONالمدخلات

فارغ

YAMLالمخرجات

تظهر مخرجات YAML هنا

يعمل بالكامل داخل متصفحك: لا يُرفع أي شيء. تُطبَّق حدود الاستخدام العادل (5 MB لكل إدخال، وعدد محدود من عمليات التحويل) لمنع الرسائل المزعجة والبوتات.

تحميل من URL

يجلب متصفحك الملف مباشرةً، لذا يجب أن يسمح الخادم بالطلبات عبر المصادر (cross-origin).

اختصارات لوحة المفاتيح

Ctrl / ⌘ + Enter التحويل الآن
Ctrl / ⌘ + S تنزيل المخرجات
Alt + Shift + C نسخ المخرجات
Alt + Shift + F إصلاح مدخلات JSON وتنسيقها
Alt + Shift + S تبديل الاتجاه
Alt + Shift + T التبديل بين عرض الشيفرة والشجرة والخريطة
Ctrl / ⌘ + Z تراجع، بما في ذلك «تنسيق» و«إصلاح» و«مسح»
Esc الخروج من ملء الشاشة
حجم النص في المحرّر

من JSON الخاص بـ kubectl إلى ملف manifest نظيف

تحمل الكائنات المصدَّرة حقول الحالة والحقول الإدارية التي يضبطها العنقود بنفسه. أزلها أولًا ثم حوّل، فتصبح النتيجة قابلة للتطبيق في أي مكان.

bash
# Export a live object as JSON and strip the fields the cluster manages
kubectl get deployment web -o json \
  | jq 'del(.status, .metadata.uid, .metadata.resourceVersion,
            .metadata.creationTimestamp, .metadata.generation,
            .metadata.managedFields)' > web.json

الصق web.json أعلاه، أو ارفعه.

قيم البيئة تبقى سلاسل نصية

يرفض خادم API أي قيمة env ليست سلسلة نصية. والقيم التي تشبه القيم المنطقية أو الأعداد أو الإصدارات تُقتبس تلقائيًا.

JSON
{
  "env": [
    {
      "name": "FEATURE_FLAG",
      "value": "true"
    },
    {
      "name": "PORT",
      "value": "8080"
    },
    {
      "name": "REGION",
      "value": "no"
    },
    {
      "name": "API_VERSION",
      "value": "1.20"
    }
  ]
}
YAML
env:
  - name: FEATURE_FLAG
    value: 'true'
  - name: PORT
    value: '8080'
  - name: REGION
    value: 'no'
  - name: API_VERSION
    value: '1.20'

أوقف آمن لـ YAML 1.1 لترى القيم التي سيُسيء محلّل YAML 1.1 قراءتها.

كائن واحد في كل مستند

الصق مصفوفة items من List في kubectl وفعّل «متعدد المستندات» لتحصل على ملف واحد تفصل فيه --- بين الكائنات.

items (JSON)
[
  {
    "apiVersion": "v1",
    "kind": "ConfigMap",
    "metadata": {
      "name": "web-config"
    },
    "data": {
      "LOG_LEVEL": "info"
    }
  },
  {
    "apiVersion": "v1",
    "kind": "Service",
    "metadata": {
      "name": "web"
    },
    "spec": {
      "selector": {
        "app": "web"
      },
      "ports": [
        {
          "port": 80
        }
      ]
    }
  }
]
manifests.yaml
---
apiVersion: v1
kind: ConfigMap
metadata:
  name: web-config
data:
  LOG_LEVEL: info
---
apiVersion: v1
kind: Service
metadata:
  name: web
spec:
  selector:
    app: web
  ports:
    - port: 80

مزيد من الأدوات

محوّلات ومدقّقات وأدلة خطوة بخطوة لكل موضع يلتقي فيه JSON وYAML.

الأسئلة الشائعة

كيف أحوّل JSON الخاص بـ Kubernetes إلى YAML؟

الصق كائن JSON في المحرّر، مثل مخرجات kubectl get deployment web -o json. يظهر ملف manifest بصيغة YAML في لوحة المخرجات. أزل الحقول التي يديرها العنقود، مثل status وmetadata.managedFields، قبل تطبيقه على عنقود آخر.

كيف أحوّل List من kubectl إلى ملفات manifest منفصلة؟

يُرجع kubectl get مع عدة كائنات {"kind": "List", "items": [...]}. الصق مصفوفة items وحدها وفعّل «متعدد المستندات»: يصبح كل كائن مستندًا مستقلًا تفصله ---، وهو التخطيط المعتاد لملف manifests.

لماذا تُقتبس بعض قيم متغيرات البيئة؟

يشترط Kubernetes أن تكون قيم env سلاسل نصية. ودون اقتباس، ستُقرأ true أو 8080 أو no على أنها قيمة منطقية أو عدد، وسيرفض خادم API ملف manifest. يقتبس المحوّل كل سلسلة قد يُساء فهمها، فيعني YAML تمامًا ما كان يعنيه JSON.

هل يستطيع kubectl تطبيق JSON مباشرةً؟

نعم، يقبل kubectl apply -f صيغة JSON كما يقبل YAML. ومع ذلك تحوّل الفرق إلى YAML لأنه أسهل في المراجعة ضمن طلبات الدمج (pull requests)، ويدعم التعليقات، وهو ما تتوقعه مخططات Helm وطبقات Kustomize.

هل يفحص المحوّل ملف manifest الخاص بي وفق Kubernetes API؟

لا، فهو يحوّل الصياغة فقط. شغّل kubectl apply --dry-run=server -f manifest.yaml ليتحقق خادم API من الحقول والأنواع دون تغيير أي شيء.