快速開始
最後更新
本頁帶你從編譯、設定到第一次用
podrun up 把 compose 專案部署到遠端 Podman。前置需求
| 需求 | 位置 | 說明 |
|---|---|---|
| Go 1.25.1+ | 編譯端 | 版本取自 go.mod |
C 編譯器(CGO_ENABLED=1) | 編譯端(API Server) | github.com/mattn/go-sqlite3 需要 cgo |
sshpass、rsync、ssh、curl、unzip | 本地(CLI) | 缺少時 CheckRelyPackages() 會自動安裝 |
| macOS 或 Linux | 本地(CLI) | 其他作業系統在缺套件時直接中止 |
| SSH 密碼登入 | 遠端主機 | CLI 以 sshpass 帶密碼連線 |
Podman + podman compose | 遠端主機 | 容器執行環境 |
rsync | 遠端主機 | rsync 經 SSH 傳輸時兩端都要有 |
/home/podrun 寫入權限 | 遠端主機 | 遠端專案目錄固定建立於此 |
安裝
- git clone https://github.com/pardnchiu/PodRun.git
- cd PodRun
- go build -o podrun ./cmd/cli
- CGO_ENABLED=1 go build -o podrun-api ./cmd/api
只需要 CLI 時可用
go install,產出的執行檔名稱為 cli(取自套件目錄名):- go install github.com/pardnchiu/PodRun/cmd/cli@latest
設定遠端連線
CLI 啟動時從當前工作目錄的
.env 讀取三個必填變數,缺任何一個都會中止:- PODRUN_SERVER=192.168.1.100
- PODRUN_USERNAME=podrun
- PODRUN_PASSWORD=yourpassword
完整變數見 設定。
啟動 API Server
API Server 以相對路徑讀取
sql/create.sql 建表,必須在 repo 根目錄執行;CLI 固定連往 localhost:8080,兩者要在同一台機器。- cd PodRun
- ./podrun-api
第一次部署
在含
docker-compose.yml 或 docker-compose.yaml 的專案目錄執行:- cd ~/projects/my-app
- podrun up -d
-d 模式完成後會印出各容器的 Port 對應、Pod ID/名稱與本機 Hostname/IP。之後可用維運指令:- podrun ps
- podrun logs -f
- podrun down
- podrun clear