Aller au contenu
Documentation
Installation
Gestionnaires de paquets et binaires

Gestionnaires de paquets et binaires

Utilisez cette page pour les installations sans conteneur et les téléchargements manuels de binaires.

Outils d’exécution

Les images de conteneur incluent déjà ces outils. Les installations sans conteneur doivent les fournir sur l’hôte.

Rôle hôteOutils requis
ContrôleurCertificats CA, git.
Agentgit, Docker CLI, plugin Docker Buildx, plugin Docker Compose, accès au démon Docker.

Les paquets et archives Linux installent les binaires Composia et des unités systemd facultatives. Ils n’installent pas Docker, Docker Compose ou Git pour vous.

Debian et Ubuntu

Ajoutez le dépôt APT Forgejo :

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

Vous pouvez également télécharger le paquet .deb depuis la page des Releases et l’installer avec votre gestionnaire de paquets.

Vérifiez :

composia --version

Services système

Les paquets Linux installent des unités systemd inactives pour le contrôleur et l’agent. Les unités ne sont pas activées ni démarrées automatiquement.

Les unités empaquetées utilisent les chemins de configuration par défaut :

ServiceChemin de configuration
composia-controller.service/etc/composia/controller/config.yaml
composia-agent.service/etc/composia/agent/config.yaml

Les unités fournies utilisent les chemins de configuration par défaut, s’exécutent en tant que root et ne créent pas les fichiers de configuration, répertoires de données ou dépôts Git. Préparez-les avant d’activer les 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

Utilisez des chemins correspondants dans les deux fichiers de configuration :

/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"

Vérifiez la propriété, l’accès en écriture et l’initialisation Git :

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

Si vous ajoutez un complément systemd avec User=, attribuez plutôt ces chemins à cet utilisateur de service.

Après avoir créé les fichiers de configuration, activez les services explicitement :

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

Les archives Linux incluent les mêmes unités sous packaging/systemd/. Si vous installez les binaires d’archive sous /usr/local/bin, modifiez les chemins ExecStart avant de les activer.

Dernière modification • alexma233
Docker ComposeConfiguration