Getting Started

Quickstart

Entrer dans un container xbee, puis provisionner un environnement minimal.

Entrer dans un container

En dehors de tout pack ou environnement, xbee enter instancie un container avec le pack système par défaut (ubuntu:24.04) et ouvre une session shell dedans, dans le répertoire courant de l’hôte :

xbee enter

Créer un pack

xbee new pack mon-pack

crée un répertoire mon-pack contenant un xbee-pack.yaml minimal. Exécutée dans un répertoire déjà existant, xbee new pack (sans nom) transforme ce répertoire en pack — mais échoue si c’est déjà le cas.

Déclarer un environnement minimal

Un xbee-env.yaml décrit au moins un hôte et le système qu’il utilise :

default:
  host:
    system: ubuntu:24.04
    net: default

host: a

ubuntu:24.04 est un pack système racine fourni par XBee. Il désigne un système logique portable, pas une image Docker, une AMI ou un identifiant d’image cloud que vous auriez à trouver et maintenir. Le même nom peut être conservé lorsque l’environnement passe de Docker à un provider VM : XBee sélectionne alors la matérialisation native décrite par le pack système.

Aucun bloc provider n’est nécessaire : xbee sélectionne alors automatiquement son provider interne Docker. L’hôte a sera un container local. C’est le mode le plus rapide pour développer et tester un environnement avant de cibler des VM.

Démarrer l’environnement

xbee up

xbee résout le graphe de dépendances de chaque hôte (système, dépendances, builders), construit ou réutilise les images nécessaires, puis exécute la directive up — par défaut, sur tous les hôtes, en parallèle. Voir Environnements pour la syntaxe complète de up / down / configure.

Ce fonctionnement est comparable à Docker Compose pour un environnement local multi-container, mais xbee décrit des hôtes à partir de packs réutilisables et peut ensuite exécuter le même modèle sur des providers VM. Voir Provider interne Docker.

xbee down

arrête l’environnement de façon symétrique.