Construire AEos
Organisation du dépôt
branding/ identité visuelle (source unique : brand.env, logo SVG, modèles)
iso/ configuration live-build (paquets, hooks, fichiers système, Plymouth)
installer/ installeur (Calamares) aux couleurs d'AEos
shell/ AE Shell, le bureau (Electron)
assistant/ Aeon : service, interface compagnon, unités systemd, paquet
site/ site officiel, servi tel quel par Vercel (HTML, CSS, JS, fonctions api/)
docs/ cette documentation (Markdown), publiée sous /docs/
scripts/ construction du moteur local, du modèle, de l'ISO, QEMU
Intégration continue
| Workflow | Déclenchement | Rôle |
|---|---|---|
CI |
push / pull request | tests d'Aeon, d'AE Shell et des fonctions du site, shellcheck, site/ à jour |
Build ISO |
manuel ou tag v* |
ISO Desktop + CLI, deux appliances VirtualBox, puis publication |
Chaque build réussi publie une release : 0.1.0-build.N quand il est lancé à la main,
0.1.0 quand il est déclenché par un tag :
git tag v0.1.0
git push origin v0.1.0
Les ISO desktop-amd64 et cli-amd64, leurs appliances VirtualBox et SHA256SUMS (et
SHA256SUMS.asc si les secrets GPG_PRIVATE_KEY / GPG_PASSPHRASE sont définis)
sont joints à la release. Le workflow libère et met à zéro les blocs inutilisés avant
la conversion, puis emploie la compression maximale afin de publier de préférence
une OVA unique. GitHub impose toutefois une limite stricte de 2 Gio par fichier. Si
l'appliance optimisée dépasse encore cette limite, elle est découpée en volumes
.ova.xz.001, .002, etc. de 1 900 Mio maximum. Le site présente alors un bouton
pour chaque partie.
L'image VirtualBox est construite sans VirtualBox imbriqué : le workflow extrait le
système de l'ISO, vérifie le noyau et les outils GRUB communs aux éditions Desktop et
CLI, crée un disque GPT compatible BIOS/UEFI, installe les deux chargeurs, nettoie
l'espace libre, convertit le disque en VMDK puis l'emballe dans un OVF/OVA standard.
Il contrôle de nouveau GRUB après le nettoyage des paquets et vérifie la présence de
EFI/BOOT/BOOTX64.EFI avant la conversion. Cela évite de produire une appliance qui
ne démarre pas et reste fiable sur les runners GitHub hébergés.
Seuls les éléments réutilisables sont conservés : moteur d'inférence, modèle et cache
Debian stable. Les ISO et OVA sont publiées directement depuis leur runner, sans copie
dans le cache GitHub. Les petits caches servant au transfert des paquets .deb sont
supprimés après chaque exécution et les anciens caches temporaires sont purgés avant
la construction suivante.
Stockage Cloudflare R2 pour les fichiers de plus de 2 Gio
Le code, les sommes et la Release restent sur GitHub. Un fichier dépassant la limite
GitHub est envoyé dans un bucket R2 public et référencé par le manifeste
AEos-downloads.json. Le site valide ce manifeste puis redirige directement vers R2.
Créez un jeton limité au bucket et configurez ces secrets GitHub :
| Secret | Valeur |
|---|---|
R2_ACCOUNT_ID |
identifiant du compte Cloudflare |
R2_ACCESS_KEY_ID |
clé d'accès S3 du jeton R2 |
R2_SECRET_ACCESS_KEY |
clé secrète S3 |
R2_BUCKET |
nom du bucket |
R2_PUBLIC_URL |
domaine public HTTPS du bucket, sans chemin final |
Les cinq valeurs sont obligatoires ensemble. Une règle de cycle de vie R2 peut supprimer
les anciens préfixes releases/ afin de rester dans le palier gratuit. Si aucun fichier
ne dépasse 2 Gio, R2 n'est pas utilisé. Si un fichier dépasse la limite et que R2 n'est
pas configuré, le workflow s'arrête avec un message explicite au lieu de publier une
release incomplète.
Construire localement
Sur une machine Debian 13 (ou dans un conteneur debian:trixie --privileged) :
sudo apt install live-build librsvg2-bin fonts-inter nodejs npm cmake build-essential git zerofree
make test # tests
make iso # ISO complète dans build/release/
make virtualbox # ISO + appliance VirtualBox (root, loop devices)
make run-qemu # essai dans une machine virtuelle
Pour travailler uniquement sur le bureau :
cd shell && npm ci && npm start
Site web
Le dossier site/ contient le site final : Vercel le sert tel quel, sans
installation ni build.
| Réglage Vercel | Valeur |
|---|---|
| Adresse | a-eos.vercel.app |
| Root Directory | site |
| Framework Preset | Other (Build, Output et Install Command vides) |
| Variable d'environnement | AEOS_GITHUB_TOKEN (voir plus bas) |
| Deployment Protection | désactivée pour la production |
| Déploiements Git | branche main uniquement |
site/vercel.json ignore toute référence différente de main et désactive les autres
branches dans git.deploymentEnabled. Les pull requests et branches Dependabot passent
la CI sans consommer de Preview Deployment Vercel.
L'adresse du site est définie une seule fois, dans branding/brand.env (AEOS_HOME_URL).
La documentation est écrite en Markdown dans docs/content/. Après l'avoir
modifiée, régénérez site/docs/ et committez le résultat :
npm ci
npm run build # docs/content/*.md → site/docs/
La CI échoue si site/ n'est pas à jour.
Le dépôt de code étant privé, la page de téléchargement passe par deux fonctions
serveur (site/api/) :
| Route | Rôle |
|---|---|
/api/release |
métadonnées Desktop et CLI de la dernière release |
/api/download?file=iso|virtualbox|cli|cli-virtualbox|sums|sig |
redirige vers un lien GitHub signé |
Elles lisent les releases avec la variable d'environnement Vercel
AEOS_GITHUB_TOKEN (jeton GitHub à granularité fine, Contents : Read-only sur ce
seul dépôt). Le jeton ne quitte jamais le serveur et les images sont téléchargées
directement depuis GitHub.
Dépannage du téléchargement
Ouvrez https://a-eos.vercel.app/api/release dans un navigateur. Le champ reason
indique la cause :
reason |
Cause | Solution |
|---|---|---|
not_configured |
AEOS_GITHUB_TOKEN absent du déploiement |
Ajouter la variable dans Vercel, puis redéployer (une variable ne s'applique qu'aux nouveaux déploiements) |
bad_token |
Jeton expiré ou révoqué | Créer un nouveau jeton et remplacer la variable, puis redéployer |
no_repo_access |
Le jeton ne voit pas le dépôt | Jeton à granularité fine sur le dépôt AEos avec Contents : Read-only |
no_release |
Aucune release avec une ISO | Lancer Build ISO |
Personnaliser l'identité
Tout part de branding/brand.env (nom, signature, couleurs, modèle d'Aeon) et des
SVG de branding/. Les images de démarrage, de l'installeur et les icônes sont
régénérées à chaque build par branding/scripts/render-assets.sh.