Reference

Répertoires & cache

Disposition sur disque, côté hôte et côté guest, des artefacts et du cache xbee.

Sur l’hôte — `$HOME/.xbee`

Répertoire / fichier	Contenu
`cache-artefacts/`	Ressources téléchargées par l’action `url` et binaires providers `xbee-<nom>`
`cache-elements/`	Dépôts Git des artefacts xbee (aujourd’hui, des packs)
`cache-exports/`	Artefacts builders et manifestes d’intégrité, classés par système
`commands/`	Commandes des packs installés globalement
`tmp/`	Environnements synthétiques et fichiers de travail
`.ssh/`	Clés utilisées pour les connexions aux VM
`xbee-lock.yaml`	Résolution verrouillée des éléments globaux

Images et état des VM locales

Firecracker, Cloud Hypervisor et QEMU séparent les bundles d’images réutilisables de l’état mutable des environnements :

~/.cache/xbee/<provider>/images/<hash>/
~/.local/state/xbee/<provider>/<environnement>/
    instances/<instance>/
    volumes/<volume>.ext4

Le premier emplacement contient les bundles adressés par le hash du pack. Le second contient les disques racine clonés, volumes, configurations, journaux console, sockets et fichiers d’état. Les variables XDG_CACHE_HOME et XDG_STATE_HOME déplacent ces racines conformément aux conventions XDG.

Chaque provider accepte aussi des surcharges destinées au développement : XBEE_FIRECRACKER_IMAGE_STORE, XBEE_CLOUD_HYPERVISOR_IMAGE_STORE et XBEE_QEMU_IMAGE_STORE pour les images ; leurs équivalents suffixés par _STATE pour l’état.

Voir VM locales et microVM pour le cycle de vie des disques d’instance et des volumes externes.

Sur le guest — container

/xbee
<APP>/.xbee/
    hosts/
        <alias>.json

Sur le guest — VM

/xbee
    .xbee/
        hosts/
            <alias>.json

Le répertoire racine peut être remplacé par la propriété internaldir de la configuration Xbee ; ~/.xbee est seulement sa valeur par défaut.

Cache de téléchargement

Le service de download (partagé par xbee, les providers, et xbeeagent) télécharge une ressource référencée par une URL et l’installe dans un cache local — la ressource n’est retéléchargée que si elle est absente du cache :

~/.xbee/cache-artefacts