xbee

Premiers pas

Utiliser le pack dans un environnement

Un xbee-env.yaml à un hôte pour voir up/down s'exécuter, et surcharger var.

Ce tutoriel reprend le pack hello du tutoriel précédent et l’installe sur un hôte, au sein d’un environnement minimal. C’est l’occasion de voir up et down s’exécuter réellement, et de surcharger var.greeting sans toucher au pack lui-même.

Écrire le xbee-env.yaml

Pour ce tutoriel, ce fichier est écrit à la main. En pratique, xbee new env — exécutée depuis le répertoire du pack, ici hello/ — génère un xbee-env.yaml de départ déjà relié à ce pack ; il ne reste alors qu’à l’adapter, notamment en y surchargeant var comme ci-dessous.

À côté du répertoire hello/ (pas dedans), créez (ou adaptez) un xbee-env.yaml :

schema-version: "1.0"

default:
  host:
    system: ubuntu:24.04

host:
  a:
    pack:
      origin: ./hello
      var:
        greeting: "Bonjour depuis l'environnement !"
  • default.host.system fixe le système par défaut de tout hôte — voir Environnements.
  • L’hôte a référence hello via pack : c’est le pack applicatif installé sur cet hôte, au moment du provisioning.
  • var.greeting, sur ce pack, surcharge la valeur définie dans hello/xbee-pack.yaml — un mécanisme de surcharge analogue à celui d’une dépendance de pack à pack, voir Modèle de données.
  • Ni up ni down ne sont déclarés au niveau de l’environnement : par défaut, xbee exécute la directive de même nom sur tous les hôtes, en parallèle — donc ici, les actions up/down du pack hello sur l’hôte a — voir Environnements.

Provisionner, vérifier, nettoyer

xbee up

résout le graphe (système + pack hello), construit l’image de l’hôte a si nécessaire, puis exécute l’action up du pack hello sur cet hôte : le fichier /xbee/app/hello.txt est écrit avec le message surchargé.

Avec un seul hôte dans l’environnement, xbee enter s’y connecte directement :

xbee enter
cat /xbee/app/hello.txt
# Bonjour depuis l'environnement !
exit
xbee down

exécute l’action down du pack sur l’hôte a, qui supprime hello.txt.

Pour supprimer entièrement l’hôte (au-delà du simple down) :

xbee delete

Pour aller plus loin

  • Plusieurs hôtes, count, alias et parallélisme explicite — voir Environnements.
  • Provisionner sur un vrai provider (AWS, GCP, Azure, VirtualBox) plutôt qu’en local — voir Providers & volumes et Provisionner sur AWS.
  • Le détail des actions disponibles pour up/down/configure au-delà du raccourci shell — voir Actions.