Tệp mô tả gói sisuhost.json
Đặt ở gốc gói zip (cùng thư mục với tệp chạy). Mọi trường đều tùy chọn; không có tệp thì SiSuHost đọc web.config (gói publish cho IIS) hoặc tự dò tệp chạy. Cho phép chú thích và dấu phẩy cuối.
{
"name": "MyShop",
"version": "1.4.2",
"site": "shop",
"entry": "MyShop.dll",
"args": [],
"healthPath": "/health",
"startTimeoutSeconds": 60,
"preflight": ["--migrate-check"],
"overlap": true,
"env": { "ASPNETCORE_ENVIRONMENT": "Production" },
"persist": ["App_Data", "uploads"],
"database": { "mode": "single", "variable": "ConnectionStrings__Default" },
"minHost": "2026.11.20"
}
| Trường | Ý nghĩa |
|---|---|
name, version | Tên và phiên bản hiện ở màn hình Bản triển khai. |
site | Mã site đích – SiSuHost từ chối gói đưa lên site có mã khác. Bỏ trống = dùng cho site nào cũng được. |
entry | Tệp chạy tính từ gốc gói: MyApp.exe hoặc MyApp.dll (chạy bằng runtime .NET SiSuHost cấp). |
args | Tham số dòng lệnh; {port} được thay bằng cổng của khe. |
healthPath | Đường kiểm sống – có thì đòi trả 2xx; không có thì mã dưới 500 là sống. |
startTimeoutSeconds | Thời gian chờ bản mới lên trước khi coi là lỗi. |
preflight | Tham số chạy thử trước khi khởi động; mã thoát khác 0 thì dừng triển khai, bản cũ chạy tiếp. |
overlap | false = không cho hai bản chạy cùng lúc (dừng cũ → chạy mới) – cho ứng dụng giữ khóa tệp / cổng riêng. |
env | Biến môi trường của gói. |
persist | Thư mục giữ lại qua các lần đổi bản (đường dẫn tương đối trong gói). |
database | Database gói cần: single (một database, chuỗi kết nối ở variable) hoặc prefix (ứng dụng tự tạo nhiều database mang tiền tố của site). Chỉ áp khi site chưa có kết nối dữ liệu. |
minHost | Phiên bản SiSuHost tối thiểu chạy được gói. |
Ứng dụng biết mình chạy dưới SiSuHost
SiSuHost cấp cổng qua ASPNETCORE_URLS / PORT, thư mục dữ liệu ghi được qua SISUHOST_DATA, đường dẫn con qua ASPNETCORE_APPL_PATH (như ASP.NET Core Module của IIS) – ứng dụng không cần sửa mã.