Posted inPython

Quản lý Config Python “Chuẩn Pro” với Dynaconf: Từ File .env đến Redis/Vault

Python tutorial - IT technology blog
Python tutorial - IT technology blog

Nỗi khổ khi quản lý Config “thủ công”

Nếu bạn hay viết script Python để tự động hóa hoặc xây dựng hệ thống monitoring, chắc hẳn bạn đã nếm mùi “code chạy ngon ở local nhưng lên server là hẹo”. Tệ hơn nữa là vô tình để lộ API Key trên GitHub vì trót hardcode vào source code.

Trước đây, mình thường dùng python-dotenv cho các project nhỏ. Tuy nhiên, khi hệ thống phình to với khoảng 5-10 microservices và nhiều môi trường (Dev, Staging, Prod), file .env bắt đầu bộc lộ điểm yếu. Nó chỉ hỗ trợ kiểu string, không có cấu trúc lồng nhau, và việc quản lý hàng tá file .env.production rất dễ nhầm lẫn.

Sau 6 tháng đưa Dynaconf vào vận hành thực tế, mình tin đây là giải pháp quản lý cấu hình tốt nhất cho Python hiện nay. Nó xử lý mượt mà từ file tĩnh (TOML, YAML) đến các hệ thống động như Redis hay HashiCorp Vault.

So sánh các cách quản lý cấu hình phổ biến

Hãy nhìn lại các cách anh em thường làm để thấy tại sao Dynaconf lại đáng giá:

  • Hardcode trực tiếp: Cách nhanh nhất để tạo ra lỗ hổng bảo mật. Đừng bao giờ để password hay token trong code nếu không muốn lên bài trên các diễn đàn bảo mật.
  • Dùng os.environ: An toàn hơn nhưng code sẽ chi chít os.getenv("DB_URL", "localhost"). Khi dự án có trên 50 biến môi trường, việc quản lý sẽ trở thành ác mộng.
  • Parse JSON/YAML thủ công: Bạn phải tự viết logic để merge cấu hình giữa các môi trường. Việc này tốn thời gian và dễ phát sinh bug không đáng có.
  • Dynaconf: Tự động ép kiểu (số, list, boolean), hỗ trợ đa môi trường và ưu tiên giá trị theo thứ tự thông minh.

Tại sao mình chọn Dynaconf cho dự án thực tế?

Khi triển khai các deploy script phức tạp, mình cần một công cụ đủ thông minh để hiểu thứ tự ưu tiên. Ví dụ: Cấu hình mặc định nằm ở settings.toml, nhưng nếu có biến môi trường trên Server thì giá trị đó phải được ưu tiên cao nhất. Dynaconf xử lý việc này cực kỳ gọn gàng.

Điểm cộng lớn nhất là khả năng Validation. Bạn có thể ép kiểu dữ liệu hoặc bắt buộc một biến phải tồn tại. Nếu thiếu cấu hình, ứng dụng sẽ báo lỗi ngay khi khởi động thay vì crash bất ngờ khi đang xử lý dữ liệu của khách hàng.

Hướng dẫn triển khai Dynaconf chuyên nghiệp

1. Cài đặt

Cài đặt Dynaconf qua pip rất đơn giản. Mình khuyến khích cài thêm hỗ trợ YAML và TOML để tối ưu hóa trải nghiệm.

pip install dynaconf[yaml,toml]

2. Khởi tạo cấu trúc project

Đừng tạo file thủ công. Hãy dùng lệnh init để Dynaconf tự thiết lập cấu trúc chuẩn cho bạn:

dynaconf init -v TOML

Lệnh này tạo ra các file settings.toml, .secrets.toml và config.py. Cấu trúc thư mục của bạn sẽ như sau:

.
├── config.py
├── settings.toml
├── .secrets.toml
└── main.py

3. Thiết lập file cấu hình đa môi trường

Trong file settings.toml, bạn có thể định nghĩa các giá trị mặc định và ghi đè chúng theo từng môi trường cụ thể.

[default]
app_name = "My Automation Tool"
debug = false

[development]
debug = true
database = "localhost"

[production]
database = "prod-db-server"
port = 5432

Tại file config.py, chúng ta khởi tạo đối tượng settings như sau:

from dynaconf import Dynaconf

settings = Dynaconf(
    envvar_prefix="DYNACONF",
    settings_files=['settings.toml', '.secrets.toml'],
    environments=True,
    load_dotenv=True,
)

4. Sử dụng trong code

Bây giờ, bạn chỉ cần import settings vào bất kỳ file nào để sử dụng. Dynaconf sẽ tự hiểu bạn đang ở môi trường nào để lấy giá trị tương ứng.

from config import settings

print(f"Đang chạy: {settings.app_name}")
if settings.get("debug"):
    print("Chế độ Debug đang bật")

Chuyển đổi môi trường linh hoạt

Đây là tính năng “ăn tiền” nhất khi deploy. Để chuyển từ Dev sang Production, bạn không cần sửa một dòng code nào. Chỉ cần set biến môi trường trên Server:

export ENV_FOR_DYNACONF=production
python main.py

Ngay lập tức, Dynaconf sẽ bỏ qua các giá trị trong [development] và load cấu hình từ [production].

Nâng cấp: Hot-reload cấu hình với Redis

Với các hệ thống phân tán, việc thay đổi config mà không cần restart app (Hot reload) là một lợi thế lớn. Dynaconf hỗ trợ kết nối trực tiếp với Redis để lấy cấu hình động.

Đầu tiên, hãy cài đặt redis client:

pip install redis

Sau đó, cập nhật config.py để kết nối tới server Redis của bạn:

settings = Dynaconf(
    # ... giữ nguyên các config cũ ...
    redis_enabled=True,
    redis_host="localhost",
    redis_port=6379,
)

Khi bạn thay đổi giá trị trên Redis, ứng dụng sẽ cập nhật cấu hình mới mà không cần khởi động lại.

Kinh nghiệm thực tế khi dùng Dynaconf

Sau nhiều dự án, mình rút ra 3 lưu ý quan trọng để anh em tránh mất thời gian:

  1. Bảo mật là ưu tiên số 1: Luôn thêm .secrets.toml vào .gitignore. Tuyệt đối không commit file này lên Git.
  2. Sử dụng Validator: Hãy dùng settings.validators.register để kiểm tra các biến bắt buộc như DATABASE_URL. Nếu thiếu, app sẽ dừng ngay lập tức kèm thông báo lỗi rõ ràng.
  3. Nắm rõ thứ tự ưu tiên: Quy tắc là: Biến môi trường hệ thống > File .secrets > File settings. Nếu bạn set export DYNACONF_PORT=8080, nó sẽ ghi đè mọi giá trị port trong file config.

Từ khi chuyển sang Dynaconf, mình tiết kiệm được 30% thời gian mỗi khi cần setup môi trường mới. Hy vọng bài viết này giúp bạn chuẩn hóa quy trình quản lý cấu hình cho các dự án Python của mình.

Share:
Tags: