Mercure-Hub: 4. Créer le service

Cette documentation fait partie du guide Automatiser avec la CLI. Consultez le guide complet ici : Démarrez Mercure Hub, récupérez ses identifiants et modifiez sa configuration de façon programmatique avec la CLI Stackhero.

👋 Bienvenue dans la documentation Stackhero !

Stackhero offre un service Mercure-Hub cloud entièrement géré, conçu pour simplifier et fiabiliser la diffusion de données en temps réel. Vous profitez de :

  • Requêtes et tailles de messages illimitées pour une flexibilité maximale.
  • Un domaine personnalisé avec la sécurité HTTPS intégrée (par exemple, https://real-time.votre-entreprise.com).
  • Des mises à jour en un clic pour garder votre hub à jour sans aucune complication.
  • Une performance élevée et une sécurité avancée sur une infrastructure privée et dédiée.
  • Plusieurs régions disponibles : 🇪🇺 Europe et 🇺🇸 USA pour une diffusion à faible latence.

Mettez-vous en route rapidement : il suffit de 5 minutes pour déployer votre environnement Mercure-Hub cloud hosting et commencer à envoyer des mises à jour en temps réel à vos applications.

Voici un exemple de script qui crée un stack, ajoute votre service Mercure Hub dessus, attend son démarrage, récupère sa configuration (y compris les identifiants générés), puis applique une nouvelle configuration.

#!/bin/bash
set -e

export STACKHERO_TOKEN="usr-xxxxxx:your-token"

serviceStore="mercure-hub"   # Le nom du store de service Mercure Hub (voir étape 2)
instance="..."                # Une taille d’instance de l’étape 3
region="europe"               # Un nom de région de l’étape 3

# Créer un stack pour votre service (utilise votre organisation par défaut ; ajoutez --organization si besoin)
stackId=$(stackhero --format=script stack-create \
  --name="My Mercure Hub stack")
echo "Stack créé : ${stackId}"

# Ajouter Mercure Hub au stack (les noms sont résolus automatiquement)
serviceId=$(stackhero --format=script service-add \
  --stack="My Mercure Hub stack" \
  --service-store="${serviceStore}" \
  --instance="${instance}" \
  --region="${region}")
echo "Service ajouté : mercure-hub"

# Attendre que le service soit totalement opérationnel (cela peut prendre quelques minutes)
stackhero service-wait-for --service="mercure-hub"

# Récupérer la configuration du service, y compris les identifiants générés
stackhero service-configuration-get --service="mercure-hub" --format=json