xbee

Cloud

Créer et piloter une VM Ubuntu sur Hetzner Cloud

Choisir un pack système XBee, laisser le provider préparer le snapshot, puis piloter une VM Hetzner Cloud.

Ce tutoriel crée un environnement xbee à un seul hôte — un serveur Hetzner Cloud ubuntu:24.04, sans aucun pack applicatif — et le pilote de bout en bout : construction du snapshot, démarrage, connexion shell, arrêt et destruction.

ubuntu:24.04 est un pack système racine XBee, pas un identifiant d’image Hetzner à rechercher. XBee et le provider sélectionnent la base publique et gèrent le snapshot réutilisable.

Prérequis : le jeton Hetzner Cloud

Créez un jeton API en lecture-écriture dans le projet Hetzner Cloud cible, puis exposez-le dans votre shell :

export HCLOUD_TOKEN=<token>

Conservez cette variable dans un fichier hors de tout dépôt versionné et chargez-le avant d’utiliser xbee.

Créer l’environnement

mkdir vm-hetzner
cd vm-hetzner
xbee new env -p hetzner -s ubuntu:24.04

Le xbee-env.yaml généré

schema-version: "1.0"
provider:
  name: hetzner
  location: fsn1
default:
  host:
    system: ubuntu:24.04
    net: xbee-net
    provider:
      serverType: cx23
      ipv4: true
      ipv6: true

host: a
  • location désigne le datacenter cible ; serverType choisit le gabarit du serveur.
  • ipv4 et ipv6 contrôlent l’activation des réseaux publics correspondants.
  • host: a déclare un seul hôte, sans pack applicatif.

Adaptez le type de serveur aux offres disponibles dans la localisation choisie. Pour changer la localisation globale :

xbee config set -p hetzner location <location>

Laisser XBee préparer le snapshot

xbee pack

xbee démarre un serveur temporaire depuis l’image Ubuntu publique, prépare le système, en crée un snapshot, puis détruit le serveur temporaire. Ce snapshot est réutilisé par les futurs xbee up.

Démarrer et piloter la VM

xbee up
xbee enter a

xbee up crée ou redémarre le serveur et attend son accès SSH. xbee enter a ouvre ensuite un shell ; avec un seul hôte, utilisez simplement xbee enter.

Arrêter puis détruire la VM

xbee down
xbee delete

La première commande éteint le serveur sans le supprimer. La seconde détruit le serveur après confirmation ; --force ou -f permet de la passer.

Pour aller plus loin