البيئات والإعدادات والأسرار

طريقان إلى نفس الفكرة

قبل أن تبدأ

الفكرة الجوهرية

1إعدادات في مكان واحد

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

from dataclasses import dataclass

@dataclass(frozen=True)
class Settings:
    database_url: str
    debug: bool
    port: int

REQUIRED = ["DATABASE_URL"]

def load_settings(env):
    missing = [name for name in REQUIRED if not env.get(name)]
    if missing:
        raise SystemExit(f"missing settings: {', '.join(missing)}")
    return Settings(
        database_url=env["DATABASE_URL"],
        debug=env.get("DEBUG", "false").lower() == "true",
        port=int(env.get("PORT", "8000")),
    )

dev = {"DATABASE_URL": "postgresql://localhost/cafe", "DEBUG": "true"}
print(load_settings(dev))

try:
    load_settings({"PORT": "9000"})
except SystemExit as e:
    print("startup refused ->", e)

2ملفات .env

.env لجهازك فقط وفي .gitignore. و.env.example في المستودع يوثّق الأسماء بقيم وهمية، فيعرف الزميل الجديد ما يحتاجه:

# .env.example  (committed)
DATABASE_URL=postgresql://cafe:change-me@localhost:5432/cafe
DEBUG=false
PAYMENT_API_KEY=

# .gitignore
.env

3الأسرار في الإنتاج

منصات النشر وأدوات CI تخزّن الأسرار مشفرة وتحقنها كمتغيرات بيئة وقت التشغيل. لا تطبعها في السجلات، ولا ترسلها في رسائل الخطأ، وامنح كل خدمة أقل الصلاحيات التي تحتاجها.

مثال محلول

المسألة: التطبيق يعمل في الإنتاج ساعة ثم ينهار عند أول طلب دفع: KeyError: PAYMENT_API_KEY. التحليل: المتغير يُقرأ داخل دالة الدفع فقط، فلم يلاحظ أحد نقصه عند النشر. الحل: قراءة كل الإعدادات في Settings عند البدء. الآن النشر نفسه يفشل برسالة «missing settings: PAYMENT_API_KEY» قبل أن يصل أي مستخدم.

خرافة مقابل حقيقة

اختبر فهمك

بطاقات مراجعة سريعة

تحقق من فهمك