يحوّل هذا JSON إلى YAML قائم على الإزاحة. تختفي الأقواس المعقوصة ومعظم علامات الاقتباس، ما يجعل صيانة النتيجة يدويًا كملف إعدادات أسهل، ويبقى ترتيب المفاتيح تمامًا كما في JSON المصدر.
يفيد حين تنقل موردًا جلبته بـ kubectl get -o json إلى manifest، أو تلصق إعدادات تلقيتها من API في docker-compose.yml أو application.yml أو workflow في GitHub Actions.
JSON. الصيغة غير الصالحة تُظهر JSON parsing failed في النتيجة؛ مرّره أولًا عبر مدقق JSON عند الحاجة.النتيجة. الإزاحة مسافتان.{
"services": {
"web": {
"image": "nginx:1.27",
"ports": ["8080:80"],
"environment": { "FEATURE_FLAG": "on", "GREETING": "hello\nworld" }
}
}
}services:
web:
image: nginx:1.27
ports:
- 8080:80
environment:
FEATURE_FLAG: "on"
GREETING: |-
hello
world
تحتفظ السلسلة "on" بعلامتي الاقتباس: لو كُتبت مجردة على شكل on لقرأها محلّل YAML 1.1 كقيمة منطقية true. ويحوي GREETING سطرًا جديدًا، فيُخرج ككتلة |- تُظهر كل سطر كما كُتب.
yes وno وon وoff وy وn و~ وnull، وما يشبهها مثل "0777" أو "1.0" أو "2024-01-01"، تُقتبس حتى يقرأ PyYAML (1.1) والمحللات الحديثة 1.2 القيمة نفسها.22:22، التي قد يقرؤها YAML 1.1 كعدد بالأساس 60، تُقتبس أيضًا، ما يجنّب خطأً كلاسيكيًا في ربط المنافذ في docker-compose.|- حرفية.[] و{}.حوّل Deployment أو ConfigMap مسحوبًا من الـ cluster بصيغة JSON، واحذف حقولًا مثل status وmetadata.uid، فيصبح لديك manifest جاهز لـ Git.
كتلة الخصائص التي تلقيتها كـ JSON من خادم إعدادات أو من الوثائق تصبح هرمية YAML، فلا تضطر إلى إزاحة مفاتيح مثل spring.datasource.url يدويًا.
&) ولا aliases (*)؛ والكائن المكرر في JSON يتكرر في YAML.---، حوّل كل مورد واجمعها بنفسك.لا تُضاف علامات الاقتباس إلا حيث كانت القيمة المجردة ستُقرأ كنوع آخر. nginx:1.27 سلسلة نصية في الحالتين، لكن on و010 و22:22 تتحول إلى قيم منطقية أو أرقام في بعض المحللات، فتُقتبس.
البنية صالحة كما هي. لكن مخرجات kubectl get -o json تحمل حقولًا يملؤها الخادم مثل status وresourceVersion وmanagedFields، ومن الأفضل حذفها قبل التطبيق.
لا يوجد خيار لذلك؛ فهي ثابتة على مسافتين، وهو الاصطلاح المستخدم في وثائق Kubernetes وdocker-compose وGitHub Actions.