كيفية لصق مفتاح حساب خدمة JSON في سرّ GitHub Actions

نزّلت مفتاح JSON لحساب خدمة من Google Cloud، لصقته في سرّ GitHub Actions، شغّلت الـ workflow… وحصلت على SyntaxError: Unexpected token in JSON. المفتاح يبدو سليماً عند فتحه. ما المشكلة؟

لماذا تفسد أسرار GitHub ملفات JSON متعددة الأسطر

الملف المنزّل منسق على عدة أسطر. تلك الأسطر الهيكلية (بين أزواج "key": "value",) تبقى داخل قيمة السرّ، ثم يفسدها الـ runner أو الـ shell. عند قراءة process.env.MY_SECRET يصبح JSON غير قابل للتحليل.

تسلسلات \n داخل private_key ليست المشكلة — هي حرفان فقط وتمرّ بأمان. المشكلة هي الأسطر الفعلية من حولها.

الحل بنقرة واحدة

1. افتح منسق JSON.
2. الصق محتوى ملف حساب الخدمة بالكامل.
3. انقر "مضغوط (سطر واحد)".
4. تأكد من عدم وجود أخطاء.
5. انسخ الناتج.
6. في GitHub: Settings → Secrets and variables → Actions → New repository secret. الصق القيمة على سطر واحد.
7. أعد تشغيل الـ workflow.

لماذا هذا آمن

• JSON لا يغادر متصفحك. الأداة صفحة ثابتة تعمل محلياً.
• يتم التحقق أولاً. أي خطأ في JSON يظهر قبل النسخ.
• يحافظ على التهريب. الأسطر داخل private_key تبقى كـ \n.

أخطاء شائعة بعد اللصق

• لا تضع علامتي اقتباس حول القيمة.
• تأكد أن القيمة تنتهي بـ }.
• غيّر المفتاح إذا كنت قد لصقته في مكان غير آمن أثناء التصحيح.

افتح منسق JSON الآن وانقر "مضغوط (سطر واحد)".