v0.1.7

部署

最後更新


本頁說明以 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_typeCPU 類型快取首次建立 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。
  1. git clone https://github.com/pardnchiu/QemuRun-pve.git /opt/QemuRun-pve
  2. cd /opt/QemuRun-pve
  3. curl -fsSL -o release.tar.gz \
  4. "https://github.com/pardnchiu/QemuRun-pve/releases/download/<tag>/QemuRun-pve@<tag>.tar.gz"
  5. tar -xzf release.tar.gz
  6. cp .env.example .env
  7. touch .go_qemu_disabled
  8. ./app

clone 是為了取得 sh/ 腳本與 .env.example;執行檔本身不內嵌這些檔案。

systemd 常駐


  1. [Unit]
  2. Description=QemuRun-pve API
  3. After=network-online.target
  4. [Service]
  5. User=root
  6. WorkingDirectory=/opt/QemuRun-pve
  7. ExecStart=/opt/QemuRun-pve/QemuRun-pve
  8. Restart=on-failure
  9. [Install]
  10. WantedBy=multi-user.target

  1. systemctl daemon-reload
  2. systemctl enable --now QemuRun-pve
  3. journalctl -u QemuRun-pve -f

ExecStart 這一行指向執行檔:自原始碼建置為 QemuRun-pve,從 Release 解壓為 app。工作目錄必須指向含 sh/ 與 .env 的目錄;User=root 是 qm/pvesh 與節點間 SSH 的前提。

升級


  1. 取得新版執行檔(重新建置或下載新 Release)
  2. git pull 更新 sh/ 腳本
  3. systemctl restart QemuRun-pve

節點硬體更換後刪除 .go_qemu_cpu_type,下次建立 VM 會重新偵測 CPU 基準。
EN