4 releases 4 tags

RSS feed

• 0.2.0rc003 a73bf97697

  Compare

  0.2.0rc003 Pre-release

  syonad.bot released this 2026-10-04 17:56:42 +00:00 | -1 commits to main since this release

  Prerelease automatique générée par la CI

  Downloads

  • agent_linux_amd64
    3 downloads · 2026-10-04 18:09:36 +00:00 · 22 MiB
  • agent.service
    2 downloads · 2026-10-04 18:09:37 +00:00 · 162 B
  • dhcp_linux_amd64
    2 downloads · 2026-10-04 18:09:37 +00:00 · 7.7 MiB
  • dhcp@.service
    2 downloads · 2026-10-04 18:09:37 +00:00 · 176 B
  • dnsmasq@.service
    2 downloads · 2026-10-04 18:09:38 +00:00 · 215 B
  • metadata_linux_amd64
    2 downloads · 2026-10-04 18:09:38 +00:00 · 10 MiB
  • metadata@.service
    2 downloads · 2026-10-04 18:09:38 +00:00 · 161 B
  • run-dhcp-in-netns.sh
    2 downloads · 2026-10-04 18:09:39 +00:00 · 676 B
  • run-dnsmasq-in-netns.sh
    2 downloads · 2026-10-04 18:09:39 +00:00 · 522 B
  • SHA256SUMS
    3 downloads · 2026-10-04 18:09:36 +00:00 · 758 B
• 0.2.0rc002 8a04f6f7f6

  Compare

  0.2.0rc002 Pre-release

  syonad.bot released this 2026-09-08 19:49:33 +00:00 | 6 commits to main since this release

  Prerelease automatique générée par la CI

  Downloads

  • agent_linux_amd64
    4 downloads · 2026-09-08 22:13:11 +00:00 · 22 MiB
  • agent.service
    4 downloads · 2026-09-08 22:13:11 +00:00 · 162 B
  • dhcp_linux_amd64
    4 downloads · 2026-09-08 22:13:12 +00:00 · 7.7 MiB
  • dhcp@.service
    4 downloads · 2026-09-08 22:13:12 +00:00 · 176 B
  • dnsmasq@.service
    4 downloads · 2026-09-08 22:13:12 +00:00 · 215 B
  • metadata_linux_amd64
    4 downloads · 2026-09-08 22:13:12 +00:00 · 10 MiB
  • metadata@.service
    4 downloads · 2026-09-08 22:13:12 +00:00 · 161 B
  • run-dhcp-in-netns.sh
    4 downloads · 2026-09-08 22:13:12 +00:00 · 676 B
  • run-dnsmasq-in-netns.sh
    4 downloads · 2026-09-08 22:13:12 +00:00 · 522 B
  • SHA256SUMS
    5 downloads · 2026-09-08 22:13:11 +00:00 · 835 B
• 0.2.0rc001 e00f456610

  Compare

  0.2.0rc001 Pre-release

  syonad.bot released this 2026-09-05 21:17:59 +00:00 | 7 commits to main since this release

  Prerelease automatique générée par la CI

  Downloads

  • agent_linux_amd64
    1 download · 2026-09-05 21:24:00 +00:00 · 22 MiB
  • agent.service
    1 download · 2026-09-05 21:24:00 +00:00 · 162 B
  • dhcp_linux_amd64
    1 download · 2026-09-05 21:24:01 +00:00 · 7.7 MiB
  • dhcp@.service
    1 download · 2026-09-05 21:24:01 +00:00 · 176 B
  • dnsmasq@.service
    1 download · 2026-09-05 21:24:01 +00:00 · 215 B
  • metadata_linux_amd64
    1 download · 2026-09-05 21:24:01 +00:00 · 10 MiB
  • metadata@.service
    1 download · 2026-09-05 21:24:01 +00:00 · 161 B
  • run-dhcp-in-netns.sh
    1 download · 2026-09-05 21:24:01 +00:00 · 676 B
  • run-dnsmasq-in-netns.sh
    1 download · 2026-09-05 21:24:01 +00:00 · 522 B
  • SHA256SUMS
    6 downloads · 2026-09-05 21:24:00 +00:00 · 758 B
• 0.1.0 2fd4987bca

  Compare

  0.1.0 — Michael Stable

  syonad.bot released this 2026-08-25 22:21:30 +00:00 | 19 commits to main since this release

  Première version stable de syonad/two, orchestrateur réseau et VM mono-nœud.

  Fonctionnalités

  API et cycle de vie

  • API HTTP /vpcs, /subnets, /vms : création et suppression asynchrones (202 + état en base)
  • États unifiés pour les trois types de ressource : creating → running → deleting → deleted,
    avec error en cas d'échec d'exécution ; suppression autorisée depuis running et error
  • Migration au démarrage de l'agent : toute ressource restée dans un état transitoire est
    basculée en error, la file de travail étant en mémoire
  • Arrêt gracieux : serveurs HTTP, puis drainage des workers, puis fermeture de la base. Si le
    budget d'arrêt est dépassé, la base n'est pas fermée — la rejouer au démarrage suivant vaut
    mieux que de la fermer sous un écrivain concurrent

  Réseau

  • VPC isolés par network namespace, subnets en mode vxlan ou bridge
  • DHCP par subnet via instances dnsmasq@ dédiées, entrées ip→mac en base, fichier de baux propre
    à chaque instance
  • Toutes les routes sont distribuées par l'option 121 : route vers le serveur de metadata, route du
    VPC, et route par défaut. L'option 3 reste émise pour les clients qui n'implémentent pas la 121
  • default_route choisit le next-hop de la route par défaut : l'interface_ip du subnet par
    défaut, sinon la gateway fournie ou celle déduite de l'host
  • gateway optionnelle par subnet, non validée par l'agent
  • Isolation du DHCP par ebtables, redirection du service de metadata par iptables

  Machines virtuelles

  • Plusieurs interfaces réseau par VM, dans un même VPC. La position de l'interface détermine son
    slot PCI, donc son nom dans le guest ; exactement une interface est primaire et porte la route
    par défaut et le serveur de metadata
  • Démarrage QEMU/KVM avec plusieurs disques et ordre de démarrage explicite
  • Amorçage UEFI optionnel (OVMF), avec magasin de variables par VM
  • Serveur de metadata cloud-init par VM (metadata@), sans base de données dans le processus
  • Les VMs survivent à l'arrêt de l'agent : QEMU est lancé hors de son cgroup via systemd-run

  Metadata cloud-init

  • Objet metadata dans la création de VM : password, sshkey, user_data
  • user_data transmis en base64, ce qui autorise les charges gzip+base64 ; un encodage invalide est
    refusé en 400, jamais servi vide en silence
  • Un document fourni est servi verbatim, un document absent retombe sur le modèle par défaut, et
    un document explicitement vide est servi vide — les trois cas sont distincts
  • Le compte syonad n'est créé que si un mot de passe ou une clé est fourni, et reste verrouillé
    quand seule une clé l'est. L'agent n'impose aucune modification du compte root

  Exploitation

  • Watchdog de cohérence : vérifie périodiquement que les ressources running existent encore sur
    le système et signale les écarts. Lecture seule, il ne répare jamais. Désactivé par défaut,
    activé dans le fichier d'exemple
  • API d'administration en lecture seule sur la boucle locale, pour inspecter la base
  • Métriques Prometheus : nombre de VPC, subnets et VMs par état
  • deploy.sh avec profils d'host (kvm), préparation système déléguée à bootstrap_kvm.sh
  • Units systemd et scripts publiés comme assets de release, avec manifeste SHA256SUMS
    vérifié au déploiement

  Périmètre et limites connues

  • Un seul nœud : pas d'ordonnanceur ni de placement entre hyperviseurs
  • Pas de rollback en cas d'échec partiel d'une création — les ressources réseau orphelines
    ne sont pas nettoyées automatiquement
  • API destinée à un appelant logiciel : la validation de cohérence des entrées (CIDR, VXLAN
    ID, format des noms, joignabilité d'une gateway) est à la charge de l'appelant
  • Le mode de subnet public_ip est accepté par l'API et par la sélection des routes DHCP, mais sa
    mise en place réseau n'existe pas : créer un tel subnet échoue explicitement
  • Les interfaces multiples d'une VM doivent appartenir au même VPC
  • Le réseau des guests est configuré par le DHCP seul ; le network-config cloud-init servi est
    sans effet et ne doit pas être « corrigé » sans mesurer l'impact sur les VM existantes
  • Modifier les routes d'une VM déjà démarrée ne prend effet qu'au renouvellement du bail, soit
    jusqu'à six heures plus tard, ou à son redémarrage
  • vm/<name>/password contient un hash, stocké en clair en base et restitué par l'API
    d'administration ; celle-ci est désactivée par défaut et n'écoute que sur la boucle locale
  • L'API de l'agent n'a pas d'authentification : son exposition réseau doit être restreinte
  • Les packages internal/netns, netif, qemu, vm, iptables et ebtables ne
    fonctionnent que sous Linux

  Installation

  curl -O https://git.g3e.fr/syonad/two/raw/branch/main/scripts/deploy.sh
  bash ./deploy.sh -t 0.1.0 -i    # -i : préparation de l'host (paquets, kernel, bridges)
  

  deploy.sh se vérifie lui-même contre la branche et télécharge les binaires, les units et
  le manifeste depuis cette release.

  Downloads

  • agent_linux_amd64
    0 downloads · 2026-08-25 22:34:24 +00:00 · 22 MiB
  • agent.service
    0 downloads · 2026-08-25 22:34:24 +00:00 · 162 B
  • dnsmasq@.service
    0 downloads · 2026-08-25 22:34:24 +00:00 · 215 B
  • metadata_linux_amd64
    0 downloads · 2026-08-25 22:34:24 +00:00 · 10 MiB
  • metadata@.service
    0 downloads · 2026-08-25 22:34:24 +00:00 · 161 B
  • run-dnsmasq-in-netns.sh
    0 downloads · 2026-08-25 22:34:24 +00:00 · 522 B
  • SHA256SUMS
    0 downloads · 2026-08-25 22:34:23 +00:00 · 508 B