部署
最後更新
本頁說明以 Release 執行檔或 systemd 常駐執行 QemuRun-pve 時,工作目錄需要具備哪些檔案。
工作目錄需求
服務所有相對路徑都以啟動時的工作目錄為基準:
| 路徑 | 用途 | 缺少時 |
|---|---|---|
.env | 環境變數 | 僅警告,改讀行程環境變數 |
sh/ | 以 /sh/* 對外提供 OS 初始化腳本 | /sh/* 回 404,curl -fsSL 交給 bash 的是空腳本;管線仍以 0 結束,VM 開機但未執行初始化腳本 |
.go_qemu_disabled | 停用清單 | VM 清單與狀態檢查全部失敗 |
.go_qemu_pubkey_admin | 額外注入的管理者公鑰 | 略過 |
.go_qemu_cpu_type | CPU 類型快取 | 首次建立 VM 時自動產生 |
新 VM 透過
http://<NODE_{MAIN_NODE}>:<PORT>/sh/<os>_<version>.sh 下載腳本,因此 VM 網段必須能連到主節點的 PORT。Release 執行檔
推送
v* tag 時,GitHub Actions 在 ubuntu-latest 以 Go 1.25 執行 go build -o app ./cmd/api,並將 app 打包為 QemuRun-pve@<tag>.tar.gz 附加到該 Release。- git clone https://github.com/pardnchiu/QemuRun-pve.git /opt/QemuRun-pve
- cd /opt/QemuRun-pve
- curl -fsSL -o release.tar.gz \
- "https://github.com/pardnchiu/QemuRun-pve/releases/download/<tag>/QemuRun-pve@<tag>.tar.gz"
- tar -xzf release.tar.gz
- cp .env.example .env
- touch .go_qemu_disabled
- ./app
clone 是為了取得
sh/ 腳本與 .env.example;執行檔本身不內嵌這些檔案。systemd 常駐
- [Unit]
- Description=QemuRun-pve API
- After=network-online.target
- [Service]
- User=root
- WorkingDirectory=/opt/QemuRun-pve
- ExecStart=/opt/QemuRun-pve/QemuRun-pve
- Restart=on-failure
- [Install]
- WantedBy=multi-user.target
- systemctl daemon-reload
- systemctl enable --now QemuRun-pve
- journalctl -u QemuRun-pve -f
ExecStart 這一行指向執行檔:自原始碼建置為
QemuRun-pve,從 Release 解壓為 app。工作目錄必須指向含 sh/ 與 .env 的目錄;User=root 是 qm/pvesh 與節點間 SSH 的前提。升級
- 取得新版執行檔(重新建置或下載新 Release)
git pull更新sh/腳本systemctl restart QemuRun-pve
節點硬體更換後刪除
.go_qemu_cpu_type,下次建立 VM 會重新偵測 CPU 基準。