Aller au contenu
imglife

Installation

Prérequis

Section intitulée « Prérequis »
Prérequis Version Notes
Docker CLI toute version récente Requis pour les opérations build et sync
Package Registry GitLab / Gitea / S3 Stocke les métadonnées de build ; GitLab par défaut
Go ≥ 1.26 Uniquement pour la compilation depuis les sources

imglife est un binaire statique sans dépendances runtime.

Installer un binaire pré-compilé

Section intitulée « Installer un binaire pré-compilé »

Des binaires pré-compilés sont publiés à chaque release dans le GitLab Generic Package Registry.

Terminal window
curl -LO https://gitlab.com/imglife-project/imglife/-/releases/permalink/latest/downloads/imglife-linux-amd64
chmod +x imglife-linux-amd64
mv imglife-linux-amd64 ~/.local/bin/imglife

Assurez-vous que le répertoire d’installation est dans votre PATH. Pour ~/.local/bin :

Terminal window
export PATH="$HOME/.local/bin:$PATH"
# Ajoutez cette ligne dans ~/.bashrc ou ~/.zshrc pour la persistance

Compiler depuis les sources

Section intitulée « Compiler depuis les sources »

  1. Cloner le dépôt

    Terminal window
    git clone https://gitlab.com/imglife-project/imglife.git
    cd imglife

  2. Compiler le binaire

    Terminal window
    make build

    Compile ./imglife à la racine du projet avec la version Git courante intégrée.

  3. Installer (optionnel)

    Terminal window
    make install
    # Installe dans $HOME/.local/bin par défaut
    # Pour changer : make install INSTALL_DIR=/usr/local/bin

Utiliser l’image Docker

Section intitulée « Utiliser l’image Docker »

imglife est aussi distribué comme une image Docker Alpine minimaliste (~20 Mo) :

Terminal window
docker pull registry.gitlab.com/imglife-project/imglife:latest


# Exécuter une commande
docker run --rm \
  -v "$PWD/imglife.yaml:/app/imglife.yaml:ro" \
  -e GITLAB_TOKEN \
  registry.gitlab.com/imglife-project/imglife:latest \
  sync --dry-run

C’est l’image utilisée dans les jobs GitLab CI. Voir Images de base — GitLab CI pour un exemple complet de pipeline.

Vérifier l’installation

Section intitulée « Vérifier l’installation »
Terminal window
imglife version

Sortie attendue :

imglife v0.8.0 (commit: abc1234, built: 2026-04-01T10:00:00Z)

Valider un fichier de configuration

Section intitulée « Valider un fichier de configuration »
Terminal window
imglife --config imglife.yaml --check

Le flag --check analyse et valide la configuration sans exécuter aucune opération. Utile dans les pipelines CI et en développement local.

Auto-complétion shell

Section intitulée « Auto-complétion shell »
Terminal window
imglife completion bash > /etc/bash_completion.d/imglife
# Ou pour un seul utilisateur :
imglife completion bash >> ~/.bash_completion

Étapes suivantes

Section intitulée « Étapes suivantes »