محلّل ومحوّل Dotenv (.env)

كيفية قراءة الأسطر

تبدأ التعليقات التي تسبقها # في بداية السطر أو بعد مسافة، لذلك تحتفظ KEY=abc#1 بالقيمة abc#1، بينما تمنح KEY=abc #note القيمة abc. تُزال علامات الاقتباس حول القيمة، وتتحول \n إلى فاصل أسطر داخل علامات الاقتباس المزدوجة فقط. لا يمكن أن تمتد القيمة على عدة أسطر، وتتجاوز قيمة مفتاح مكرر لاحق قيمة المفتاح السابقة. تُنسخ المراجع مثل ${HOME} كما هي: إذ لا توسّعها Node's dotenv أيضًا، بينما تفعل أدوات مثل Docker Compose ذلك. كل قيمة سلسلة نصية، لذلك تصبح PORT=3000 هي "3000".

Kubernetes ومخرجات shell

يُستخدم ConfigMap للإعدادات، وليس لكلمات المرور أو مفاتيح API. لهذه القيم، أنشئ Secret، إذ ينفذ kubectl create secret generic app-env --from-env-file=.env ذلك مباشرةً؛ لكن قيمه مشفّرة بترميز Base64 فقط، لذا قيّد من يمكنه قراءتها. يجب أن يتكون اسم ConfigMap من أحرف صغيرة وأرقام و- و..

في shell script، توجد كل قيمة بين علامتي اقتباس مفردتين، لذلك لا توسّع shell أي شيء عند تحميل الملف: تصل كلمة مرور مثل pa$word أو قيمة تحتوي على backticks دون تغيير. تُكتب علامة الاقتباس المفردة داخل القيمة على هيئة '\''، إذ تُغلق علامة الاقتباس، وتُضاف علامة اقتباس مهروبة، ثم تُفتح العلامة مجددًا. حمّل البرنامج النصي باستخدام source أو .؛ أما تشغيله كعملية منفصلة فيضبط المتغيرات داخل تلك العملية فقط.

طريقة الاستخدام

1. الصق محتوى ملف .env.
2. اختر تنسيق الإخراج: JSON أو export أو ConfigMap.
3. انسخ الإعدادات المنسّقة.

الخصوصية والقيود

تبقى الأسرار ومفاتيح البيئة داخل المتصفح strictly ولا تغادره.