Retour à l’aperçu de l’actualité

Incus 6.13 est maintenant disponible¶

30 mai 2025

Introduction¶

L’équipe d’Incus est heureuse d’annoncer la sortie d’Incus 6.13 !

Cette version apporte BEAUCOUP de nouvelles fonctionnalités de toutes tailles et pour tous les cas d’utilisation, donc tout le monde devrait être servi !

Comme d’habitude, vous pouvez l’essayer vous-même en ligne : https://linuxcontainers.org/incus/try-it/

Nouvelles fonctionnalités¶

Agent pour les VM Windows¶

La logique de l’agent Incus pour les VM a été refactorisée pour que celui-ci soit construit pour des systèmes d’exploitation autres que Linux, et une première implémentation pour Windows a été réalisée.

Il s’agit encore d’un travail préliminaire, puisque Windows ne possède pas de driver VirtIO signé pour vsock, qu’Incus utilise normalement pour communiquer avec son agent.

Cependant, le protocole que nous utilisons par-dessus vsock est HTTPS, donc nous nous en sommes contentés pour nous connecter (via le réseau donc) à l’agent Windows. Cela ne peut fonctionner que si Incus connaît l’adresse IP de la VM, et que celle-ci est directement joignable depuis l’hôte. Nous avons pour espoir de remplacer cette solution par une connexion vsock native dans le futur.

Cet agent permet de lancer des commandes avec incus exec, d’obtenir les détails de l’OS avec incus info et de transférer des fichiers avec incus file.

Pour que l’agent fonctionne, il faut attacher un disque avec source=agent:config à la VM Windows, qui se présente à l’OS comme un CD-ROM content l’agent Windows (s’il a été packagé dans la distribution de l’hôte) ainsi que les fichiers de configuration nécessaires.

À partir de là, vous pouvez démarrer l’agent manuellement ou le configurer comme un service système.

Nous aimerions des retours de personnes ayant de l’expérience dans les systèmes Windows pour améliorer l’utilisabilité de l’agent, par exemple en fournissant un script d’installation dans le CD-ROM, ou encore en y incluant les fonctionnalités qui manquent par rapport à l’agent Linux.

Cet effort de plusieurs mois a été rendu possible grâce au soutien financier du Sovereign Tech Fund.

Améliorations dans incus-migrate¶

Un certain nombre d’améliorations ont été apportées à notre outil incus-migrate.

Pour rappel, cet outil peut être lancé sur un serveur distant afin de le convertir en conteneur ou VM Incus, ou de convertir des conteneurs ou VM qu’il virtualise en instances importables dans Incus.

Avec cette nouvelle version, incus-migrate supporte à présent :

• Le téléversement d’arbres de fichiers ou d’images disques comme volumes personnalisés
• L’import de disques additionnels ou de systèmes de fichiers lors de la création d’une nouvelle instance
• L’import d’une image OVA comme nouvelle instance
• La sélection d’un serveur ou d’un groupe de serveurs spécifique lorsqu’Incus est clusterisé

Des binaires statiques de incus-migrate sont disponibles sur GitHub, utiles pour procéder à la conversion d’un système qui n’utilise pas déjà Incus.

Accès aux volumes personnalisés en SFTP¶

Nous cherchons progressivement à ce que les volumes personnalisés (de type système de fichiers) supportent une API similaire à celle que nous avons déjà pour les fichiers des instances.

Nous avons fait un premier pas dans ce sens : Incus supporte désormais les opérations en SFTP sur ces volumes, avec la commande incus storage volume file mount. Les autres APIs et commandes devraient débarquer dans Incus 6.14.

Ce travail a été mené par des étudiants de l’Université du Texas à Austin.

Configuration des adresses IP externes des instances sur les réseaux OVN¶

Deux nouvelles clefs de configuration pour les cartes réseau des instances ont été ajoutées :

• ipv4.address.external
• ipv6.address.external

Ces clefs peuvent être utilisées pour configurer quelle adresse IP une instance doit utiliser pour le trafic sortant initié par celle-ci. Il s’agit typiquement de l’adresse externe du réseau (par défaut) ou d’une adresse de forward qui pointe sur l’instance.

Documentation : https://linuxcontainers.org/incus/docs/main/reference/devices_nic/#nictype-ovn

Ce travail a été mené par des étudiants de l’Université du Texas à Austin.

Possibilité de fixer l’adresse MAC de la gateway sur les réseaux OVN¶

OVN gère une table d’association entre les adresses IP et les adresses MAC (équivalente aux tables ARP et NDP). Cette table est peuplée la première fois qu’OVN a besoin d’interagir avec une adresse donnée.

Ce n’est pas toujours idéal, dans la mesure où les réseaux utilisant VRRP ou d’autres mécanismes de MAC virtuelles peuvent avoir besoin de préconfigurer une adresse MAC donnée pour la gateway, et enregistrer l’information dans OVN.

Deux nouvelles clefs de configuration rendent cela possible sur les uplinks OVN de type physical :

• ipv4.gateway.hwaddr
• ipv6.gateway.hwaddr

Documentation: https://linuxcontainers.org/incus/docs/main/reference/network_physical/

Ce travail a été mené par des étudiants de l’Université du Texas à Austin.

Gestion de l’horloge dans les machines virtuelles¶

Incus définit désormais automatiquement l’option invtsc de QEMU sur les machines virtuelles qui n’ont pas pour vocation à être migrées.

De plus, Incus écoute à présent les événements RTC provenant de QEMU afin de rendre persistantes les horloges RTC des VM. Cela permet de mieux gérer les VM Windows ainsi que les autres VM qui n’utilisent pas d’horloge matérielle UTC.

Nouvelles commandes get-client-certificate et get-client-token¶

L’outil en ligne de commande possède deux nouvelles commandes, incus remote get-client-certificate et incus remote get-client-token, permettant de simplifier l’extraction des certificats clients et l’émission de JWT à partir d’un certificat client depuis des scripts externes.

Ce travail a été mené par des étudiants de l’Université du Texas à Austin.

Support de DHCPv6 pour les conteneurs OCI¶

Le client DHCP intégré utilisé pour les conteneurs OCI est maintenant capable de faire du DHCPv6 stateful et stateless.

Ce travail a été mené par des étudiants de l’Université du Texas à Austin.

Configuration des tables réseau de l’hôte pour les cartes réseau routées¶

Incus permettait de contrôler dans quelle table de routage injecter les routes pour les cartes réseau de type routed, mais cela manquait de flexibilité.

Désormais, nous avons de nouvelles clefs de configuration :

• ipv4.host_tables
• ipv6.host_tables

Celles-ci prennent une liste de tables, séparées par des virgules, dans lesquelles injecter les routes.

Documentation: https://linuxcontainers.org/incus/docs/main/reference/devices_nic/#nictype-routed

Ce travail a été mené par des étudiants de l’Université du Texas à Austin.

Support de la publication d’images scindées¶

Jusqu’à présent, lancer incus publish générait des images unifiées, à savoir un seul fichier, souvent un tarball compressé, qui contenait à la fois le disque racine et la configuration Incus.

Désormais, nous supportons la génération d’images scindées, composées de deux fichiers, l’un pour les métadonnées Incus et l’autres pour les données du disque racine.

Dans l’outil en ligne de commande, il suffit de passer l’option --format=split à incus publish.

Ce travail a été mené par des étudiants de l’Université du Texas à Austin.

Preseed de certificats¶

Les preseeds des serveurs Incus peuvent désormais inclure des certificats.

Par exemple :

certificates:
  - type: client
    name: my-client
    certificate: |-
      PEM ENCODED CERTIFICATE

Cette fonctionnalité est particulièrement utile lors du provisionnement automatique de systèmes comme Incus OS.

Ce travail a été mené par des étudiants de l’Université du Texas à Austin.

Configuration du formattage des listes¶

Le fichier de configuration de l’outil en ligne de commande d’Incus (habituellement ~/.config/incus/config.yml) peut maintenant être utilisé pour définir un format d’affichage pour les listes.

Par exemple :

defaults:
  list_format: compact

Cet exemple est équivalent à passer --format=compact à toutes les commandes list.

Ce travail a été mené par des étudiants de l’Université du Texas à Austin.

Ajout d’alias pour les commandes de création et de suppression¶

L’invite de commande Incus a été conçue de telle sorte que :

• Un objet portant un état a besoin d’être créé (create) et supprimé (delete)
• Un objet ou une relation sans état a besoin d’être ajouté (add) et enlevé (remove)

Cette distinction a été faite pour signaler le risque associé à chaque action, mais peut également donner une impression de manque de cohérence, rendant ainsi plus complexe la création de scripts autour d’Incus.

Pour résoudre ce problème, nous avons ajouté un certain nombre d’alias dans l’outil en ligne de commande afin de trouver plus rapidement la commande voulue.

Ce travail a été mené par des étudiants de l’Université du Texas à Austin.

Conversion des appels SQL codés en dur vers notre générateur de code¶

La base de code d’Incus inclut un générateur de code pour les appels à la base de données.
Ce générateur est utile pour garantir la cohérence du comportement et éviter un certain nombre d’erreurs qui peuvent être commises en écrivant des requêtes à la main.

Bien qu’il soit de fait requis que toutes les nouvelles tables de la base utilisent le générateur, nous avons toujours un certain nombre d’objets qui ne l’utilisent pas.

Avec cette nouvelle version, nous avons terminé la migration des objets suivants :

• ACL réseau
• Load-balancers réseau
• Zones réseau

Bien que tous nos tests soient au vert, ce genre de refonte présente un certain risque d’introduction de régressions. Si vous notez le moindre changement de comportement avec ces objets dans Incus 6.13, merci d’ouvrir une issue pour que nous puissions investiguer.

Ce travail a été mené par des étudiants de l’Université du Texas à Austin.

Filtrage côté serveur¶

Cette nouvelle version étend davantage les fonctionnalités de filtrage côté serveur.

Le filtrage est maintenant supporté pour :

• incus network list
• incus storage bucket list
• incus project list
• incus config trust list

Ce travail a été mené par des étudiants de l’Université du Texas à Austin.

Documentation générée à partir du code¶

Nous avons également continué notre projet de génération automatique de documentation pour les clefs de configuration. Dans cette version, nous avons à présent de la documentation générée pour :

• Les périphériques PCI
• Les réseaux OVN
• Les réseaux physiques
• Les réseaux SR-IOV
• Les réseaux macvlan

Ce travail a été mené par des étudiants de l’Université du Texas à Austin.

Intégration des métriques d’Incus OS dans l’API d’export des métriques Incus¶

Lorsqu’Incus est lancé depuis Incus OS, les métriques de l’hôte (extraites avec node-exporter) sont désormais automatiquement incluses dans l’API d’export de métriques d’Incus.

Ce choix a été fait car Incus OS essaie de limiter au maximum le nombre de ports ouverts, et d’imposer au trafic d’être authentifié et autorisé au travers d’une pile logicielle unique (Incus lui-même).

Avis pour les packagers¶

Nous n’utilisons plus la commande externe umoci et lui avons préféré le paquet Go équivalent.

Pour bénéficier du support du nouvel agent Windows, celui-ci doit également être compilé pour Windows, et rendu disponible à Incus en complément de l’agent Linux.

Liste complète des changements¶

Voici une liste complète de tous les changements apportés par cette version :

Documentation¶

La documentation d’Incus peut être consultée sur :
https://linuxcontainers.org/incus/docs/main/

Paquets¶

Incus ne fournit pas de paquet d’installation mais bien un tarball à chaque version. Vous trouverez ci-dessous différentes solutions pour mettre Incus en service.

Installation du serveur Incus sous Linux¶

Incus est disponible sur la plupart des distributions Linux courantes. Vous trouverez des instructions d’installation détaillées dans notre documentation.

https://linuxcontainers.org/incus/docs/main/installing/

Paquet Homebrew du client Incus¶

Le client Incus est disponible sur Homebrew pour Linux et macOS.

https://formulae.brew.sh/formula/incus

Paquet Chocolatey du client Incus¶

Le client Incus est disponible sur Chocolatey pour les utilisateurs de Windows.

https://community.chocolatey.org/packages/incus/6.13.0

Paquet Winget du client Incus¶

Le client Incus est aussi disponible sur Winget pour les utilisateurs de Windows.

https://winstall.app/apps/LinuxContainers.Incus

Support¶

Les versions de fonctionnalité d’Incus ne sont supportées que jusqu’à la sortie de la suivante. Les personnes souhaitant un support plus long et des changements moins fréquents devraient plutôt envisager d’utiliser Incus 6.0 LTS.

Le support communautaire est disponible sur : https://discuss.linuxcontainers.org
Un support commercial est disponible sur : https://zabbly.com/incus
Les bugs peuvent être signalés sur : https://github.com/lxc/incus/issues