Aller au contenu

Packaging Aquila GOV V1

Cette page décrit les principes de packaging et de distribution d’Aquila GOV V1, indépendamment des spécificités de l’édition PRO.

Artefacts livrés

  • Code source Python (structure du dépôt).
  • Image Docker GOV (si buildée séparément).
  • Documentation technique (docs/).

L’édition PRO repose sur un packaging similaire, détaillé dans pro/packaging.md.

Installation via Docker

Exemple minimal d’exécution en Docker (sans exposition publique) :

docker run --rm \
  -p 8000:8000 \
  ghcr.io/<organisation>/aquila-gov:v1.6.0

Dans ce cas, les endpoints GOV (/health, /version, etc.) sont exposés sur http://localhost:8000.

Installation en environnement géré

En environnement géré (VM ou cluster), la mise en place suit généralement les étapes suivantes :

  1. Installation de Python et des dépendances (ou pull de l’image Docker).
  2. Déploiement de l’API Aquila derrière un reverse proxy HTTPS.
  3. Configuration de la supervision (sondes /health, métriques éventuelles).
  4. Intégration dans les scripts de démarrage de la plateforme (systemd, orchestrateur).

Bonnes pratiques de packaging

  • Ne pas embarquer de fichiers de configuration spécifiques à un client dans les images Docker.
  • Versionner clairement les tags Docker (v1.6.0, pro-v1.0.0, etc.).
  • Documenter les variables d’environnement supportées (ports, log level, URL DB pour PRO, etc.).
  • Tester systématiquement les images en pipeline CI (tests unitaires + tests d’API de base).