v0.1.7

OS 初始化腳本

最後更新


本頁說明支援的作業系統版本、映像來源,以及新 VM 在初始化階段執行的 sh/<os>_<version>.sh。

支援版本與映像


osversion映像來源支援至(sh/pdvm_os.json)
debian11cloud.debian.org bullseye generic amd64June 2026
12cloud.debian.org bookworm generic amd64June 2028
13cloud.debian.org trixie generic amd64June 2030
ubuntu20.04mirror.twds.com.tw ubuntu-cloud-images server cloudimg amd64April 2030
22.04同上April 2032
24.04同上April 2036
rockylinux8dl.rockylinux.org GenericCloud-Base latest x86_64May 2029
9同上May 2032
10同上May 2035

其他組合在 getting OS image 步驟以 unsupported ... version 失敗。

執行方式


VM 第一次可 SSH 登入後,主節點以 Cloud-Init 使用者身分登入 VM 並執行:
  1. curl -fsSL http://<NODE_{MAIN_NODE}>:<PORT>/sh/<os>_<version>.sh | sudo bash -s <VM_ROOT_PASSWORD>

VM_ROOT_PASSWORD 為空時不帶參數,腳本改用內建值 0123456789。腳本輸出逐行轉成 SSE 事件,任一指令失敗(set -e)即視為 SSH 初始化失敗並清除 VM。

腳本內容


動作DebianUbuntuRocky Linux
設定 root 密碼✓✓✓
於 /etc/shadow 將 Cloud-Init 使用者密碼重設為 passwd,並授予 NOPASSWD sudo僅 13——
停用 passwd/chpasswd 並鎖定密碼期限✓✓✓
切換套件來源ftp.tw.debian.org(11/12);deb.debian.org deb822 格式,含 non-free/non-free-firmware(13)tw.archive.ubuntu.com啟用 EPEL
升級系統、安裝常用工具與 qemu-guest-agent✓✓✓
語系 en_US.UTF-8✓✓—
時區 Asia/Taipei✓✓✓
sysctl:忽略 ICMP echo、提高 inotify 上限✓✓✓
sysctl:net.core.somaxconn = 65535——僅 10
建立 2G /swapfile✓✓✓
安裝登入資訊腳本 sysinfo✓✓✓
清除套件快取、/tmp 與日誌✓✓✓

腳本完成後服務會重開 VM 以套用 GRUB 與核心參數。

客製化


直接修改 sh/ 下對應檔案即可,服務每次都以靜態檔案即時提供,不需重啟。新增版本則需同時修改 internal/service/osImage.go 的支援清單與映像網址。
EN