JSON إلى Kubernetes YAML
حوّل مخرجات kubectl بصيغة JSON وكائنات API إلى ملفات manifest نظيفة يمكنك مراجعتها وتطبيقها.
JSONالمدخلات
YAMLالمخرجات
كل سطر من الناتج، بالتنسيق الافتراضي، بجانب مسار القيمة التي يحملها. انقر على صف لنسخ المسار.
يعمل بالكامل داخل متصفحك: لا يُرفع أي شيء. تُطبَّق حدود الاستخدام العادل (5 MB لكل إدخال، وعدد محدود من عمليات التحويل) لمنع الرسائل المزعجة والبوتات.
من JSON الخاص بـ kubectl إلى ملف manifest نظيف
تحمل الكائنات المصدَّرة حقول الحالة والحقول الإدارية التي يضبطها العنقود بنفسه. أزلها أولًا ثم حوّل، فتصبح النتيجة قابلة للتطبيق في أي مكان.
# 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 ليست سلسلة نصية. والقيم التي تشبه القيم المنطقية أو الأعداد أو الإصدارات تُقتبس تلقائيًا.
{
"env": [
{
"name": "FEATURE_FLAG",
"value": "true"
},
{
"name": "PORT",
"value": "8080"
},
{
"name": "REGION",
"value": "no"
},
{
"name": "API_VERSION",
"value": "1.20"
}
]
} 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 وفعّل «متعدد المستندات» لتحصل على ملف واحد تفصل فيه --- بين الكائنات.
[
{
"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
}
]
}
}
] ---
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.
المحوّلات
التنسيق والتحقق
التحويل حسب الاستخدام
- Docker Compose أنشئ compose.yaml من JSON، بما في ذلك المنافذ ومتغيرات البيئة ووحدات التخزين.
- GitHub Actions اكتب ملفات سير العمل من JSON دون الوقوع في فخ on: / true.
- OpenAPI / Swagger حوّل مواصفات OpenAPI 3 وSwagger 2.0 بين JSON وYAML.
- CloudFormation حوّل قوالب AWS CloudFormation من JSON إلى YAML، بما في ذلك الدوال الجوهرية (intrinsic functions).
الأسئلة الشائعة
كيف أحوّل 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 من الحقول والأنواع دون تغيير أي شيء.