Giao diện
@digiforce-nc/plugin-environment-variables
Plugin biến môi trường từ UI — quản lý environment variables qua giao diện admin thay vì sửa file .env trên server.
Plugin này làm gì?
Thay đổi biến môi trường thường yêu cầu truy cập server, sửa file .env, rồi restart. Plugin cho phép admin quản lý environment variables qua giao diện web: thêm, sửa, xóa biến, và apply ngay lập tức hoặc khi restart.
Cơ chế hoạt động
Tính năng chính
| # | Tính năng | Mô tả |
|---|---|---|
| 1 | UI management | CRUD biến môi trường qua web |
| 2 | Encrypted values | Giá trị nhạy cảm được mã hóa trong DB |
| 3 | Hot reload | Một số biến apply ngay không cần restart |
| 4 | Categorization | Phân loại biến theo nhóm (database, email, storage...) |
| 5 | Override priority | DB vars override process.env (hoặc ngược lại) |
| 6 | History | Lịch sử thay đổi biến |
API endpoints
| Endpoint | Mô tả |
|---|---|
environmentVariables CRUD | Thêm, sửa, xóa, liệt kê biến |
environmentVariables:reload | Trigger hot reload |
Database
| Bảng | Mô tả |
|---|---|
environmentVariables | Biến (key, value, encrypted, category) |
Thành phần client
| Thành phần | Mô tả |
|---|---|
EnvVarList | Danh sách biến (ẩn value nhạy cảm) |
EnvVarForm | Form thêm/sửa biến |
EnvVarCategory | Tabs phân loại theo nhóm |
RestartNotice | Banner nhắc restart khi cần |
Dependencies
| Package | Vai trò |
|---|---|
@digiforce-nc/server | Server framework |
@digiforce-nc/database | Database ORM |
@digiforce-nc/client | Client UI framework |
@digiforce-nc/cache | Cache env vars |
Lưu ý triển khai
- Biến trong DB override file
.env— cẩn thận đặt tên trùng - Giá trị nhạy cảm (password, secret key) nên bật encrypted
- Không phải tất cả biến đều hot-reload được (VD: database connection cần restart)