跳至內容
文件
安裝
套件管理器與二進位檔

套件管理器與二進位檔

此頁面用於非容器的安裝和手動二進位檔下載。

執行時期工具

容器映像檔已包含這些工具。非容器安裝必須在主機上提供它們。

主機角色必要工具
控制器CA 憑證、git。
代理git、Docker CLI、Docker Buildx 外掛、Docker Compose 外掛、對 Docker 守護程序的存取。

Linux 套件和壓縮檔會安裝 Composia 二進位檔與可選的 systemd 單元檔。它們不會為您安裝 Docker、Docker Compose 或 Git。

Debian 與 Ubuntu

加入 Forgejo APT 存放庫：

sudo install -d -m 0755 /etc/apt/keyrings
sudo curl https://forgejo.alexma.top/api/packages/alexma233/debian/repository.key \
  -o /etc/apt/keyrings/composia.asc

echo "deb [signed-by=/etc/apt/keyrings/composia.asc] https://forgejo.alexma.top/api/packages/alexma233/debian stable main" \
  | sudo tee /etc/apt/sources.list.d/composia.list

sudo apt update
sudo apt install composia

您也可以從發行版本頁面下載 .deb 套件並使用您的套件管理器安裝。

驗證：

composia --version

系統服務

Linux 套件會安裝未啟用的 controller 與 agent systemd 單元。套件不會自動啟用或啟動這些服務。

打包的單元使用預設設定路徑：

服務設定路徑
composia-controller.service/etc/composia/controller/config.yaml
composia-agent.service/etc/composia/agent/config.yaml

The packaged units use the default config paths, run as root as shipped, and do not create config files, data directories, or Git repositories for you. Bootstrap them before enabling services:

sudo install -d -m 0755 /etc/composia/controller /etc/composia/agent
sudo install -d -m 0750 \
  /var/lib/composia/controller/repo \
  /var/lib/composia/controller/state \
  /var/lib/composia/controller/logs \
  /var/lib/composia/agent/repo \
  /var/lib/composia/agent/state
sudo chown -R root:root /etc/composia /var/lib/composia
sudo git -C /var/lib/composia/controller/repo init
sudo git -C /var/lib/composia/agent/repo init

Use matching paths in the two config files:

/etc/composia/controller/config.yaml
controller:
  repo_dir: "/var/lib/composia/controller/repo"
  state_dir: "/var/lib/composia/controller/state"
  log_dir: "/var/lib/composia/controller/logs"
/etc/composia/agent/config.yaml
agent:
  repo_dir: "/var/lib/composia/agent/repo"
  state_dir: "/var/lib/composia/agent/state"

Verify ownership, write access, and Git initialization:

stat -c '%U:%G %a %n' \
  /var/lib/composia/controller/repo \
  /var/lib/composia/controller/state \
  /var/lib/composia/controller/logs \
  /var/lib/composia/agent/repo \
  /var/lib/composia/agent/state
sudo test -w /var/lib/composia/controller/repo
sudo test -w /var/lib/composia/agent/repo
sudo git -C /var/lib/composia/controller/repo rev-parse --is-inside-work-tree
sudo git -C /var/lib/composia/agent/repo rev-parse --is-inside-work-tree

If you add a systemd drop-in with User=, chown these paths to that service user instead.

建立設定檔後，明確啟用服務：

sudo systemctl enable --now composia-controller.service
sudo systemctl enable --now composia-agent.service

Linux 壓縮檔也會在 packaging/systemd/ 下包含同一組單元檔。如果您將壓縮檔中的二進位檔安裝到 /usr/local/bin，請先修改單元檔中的 ExecStart 路徑再啟用。

最後更新於 • Renovate Bot
Docker Compose設定