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.