CI/CD Pipeline¶

Vue d'ensemble¶

Chaque repo Essensys dispose de son propre pipeline GitHub Actions qui build et publie une image Docker sur GitHub Container Registry (ghcr.io).

graph LR
    subgraph GitHub
        RepoBackend[essensys-server-backend]
        RepoMCP[essensys-mcp]
        RepoFrontend[essensys-server-frontend]
        RepoCP[essensys-control-plane]
        RepoMonitor[essensys-monitor]

        CI[GitHub Actions]
        Registry[ghcr.io/essensys-hub]
    end

    subgraph Raspberry Pi
        Docker[Docker Daemon]
        CP[Control Plane]
    end

    RepoBackend -->|push tag| CI
    RepoMCP -->|push tag| CI
    RepoFrontend -->|push tag| CI
    RepoCP -->|push tag| CI
    RepoMonitor -->|push tag| CI

    CI -->|docker push| Registry

    CP -->|docker pull| Registry
    CP -->|docker compose up| Docker

    style CI fill:#e8f5e9
    style Registry fill:#e3f2fd
    style CP fill:#e8eaf6,stroke:#1a237e,stroke-width:2px
    style MCP fill:#fff3e0,stroke:#e65100,stroke-width:2px

Workflow type (GitHub Actions)¶

Voici le workflow pour le build multi-architecture d'une image Docker. Ce même pattern s'applique à chaque repo.

# .github/workflows/docker-build.yml
name: Build & Push Docker Image

on:
  push:
    tags:
      - 'V.*'
  workflow_dispatch:
    inputs:
      version:
        description: 'Version tag'
        required: true

permissions:
  contents: read
  packages: write

jobs:
  build:
    runs-on: ubuntu-latest
    steps:
      - name: Checkout
        uses: actions/checkout@v4

      - name: Set up QEMU
        uses: docker/setup-qemu-action@v3

      - name: Set up Docker Buildx
        uses: docker/setup-buildx-action@v3

      - name: Login to GitHub Container Registry
        uses: docker/login-action@v3
        with:
          registry: ghcr.io
          username: ${{ github.actor }}
          password: ${{ secrets.GITHUB_TOKEN }}

      - name: Extract version
        id: version
        run: |
          if [ "${{ github.event_name }}" = "workflow_dispatch" ]; then
            echo "tag=${{ github.event.inputs.version }}" >> "$GITHUB_OUTPUT"
          else
            echo "tag=${GITHUB_REF#refs/tags/}" >> "$GITHUB_OUTPUT"
          fi

      - name: Build and push
        uses: docker/build-push-action@v5
        with:
          context: .
          push: true
          platforms: linux/arm64,linux/amd64
          tags: |
            ghcr.io/essensys-hub/${{ github.event.repository.name }}:${{ steps.version.outputs.tag }}
            ghcr.io/essensys-hub/${{ github.event.repository.name }}:latest
          build-args: |
            VERSION=${{ steps.version.outputs.tag }}
            GIT_COMMIT=${{ github.sha }}
            BUILD_TIME=${{ github.event.head_commit.timestamp }}
          cache-from: type=gha
          cache-to: type=gha,mode=max

Points clés¶

Multi-architecture¶

Le build utilise docker buildx avec QEMU pour produire des images linux/arm64 (Raspberry Pi) et linux/amd64 (dev local, CI). Le Pi tire automatiquement l'image correspondant à son architecture.

Tagging¶

Cache¶

Le build utilise le cache GitHub Actions (type=gha) pour accélérer les builds incrémentaux. Seules les couches modifiées sont re-buildées.

Registry privé¶

ghcr.io est privé par défaut pour les repos privés. Le Pi a besoin d'un token d'accès :

# Sur le Pi, login au registry (une seule fois)
echo $GITHUB_TOKEN | docker login ghcr.io -u essensys-hub --password-stdin

Ce token peut être provisionné par Ansible ou par le Control Plane lors du setup initial.

Flux de release¶

sequenceDiagram
    participant Dev as Développeur
    participant GH as GitHub
    participant CI as GitHub Actions
    participant Reg as ghcr.io
    participant CP as Control Plane (Pi)
    participant Docker as Docker (Pi)

    Dev->>GH: git tag V.1.3.0 && git push --tags
    GH->>CI: Trigger workflow (tag push)
    CI->>CI: Build image arm64 + amd64
    CI->>Reg: docker push ghcr.io/essensys-hub/backend:V.1.3.0

    Note over CP: Check périodique (toutes les heures)
    CP->>Reg: GET /v2/.../tags/list
    Reg-->>CP: V.1.3.0 disponible

    alt Mode semi-auto
        CP->>CP: Notification admin (nouvelle version dispo)
        Note over CP: Admin valide dans l'UI
    end

    CP->>Docker: docker pull ghcr.io/essensys-hub/backend:V.1.3.0
    CP->>Docker: docker compose up -d essensys-backend
    CP->>Docker: Health check
    Docker-->>CP: OK
    CP->>CP: Log mise à jour réussie