SiSuHost

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, versionTên và phiên bản hiện ở màn hình Bản triển khai.
siteMã 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.
entryTệ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).
argsTham 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.
startTimeoutSecondsThời gian chờ bản mới lên trước khi coi là lỗi.
preflightTham 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.
overlapfalse = 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.
envBiến môi trường của gói.
persistThư mục giữ lại qua các lần đổi bản (đường dẫn tương đối trong gói).
databaseDatabase 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.
minHostPhiê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ã.