Mercure-Hub: 4. Criar o serviço

Esta documentação faz parte do guia Automatize com a CLI. Consulte o guia completo aqui: Inicie o Mercure Hub, recupere as suas credenciais e altere a sua configuração programaticamente com a Stackhero CLI.

👋 Bem-vindo à documentação da Stackhero!

A Stackhero disponibiliza um serviço Mercure-Hub cloud totalmente gerido, concebido para simplificar e garantir a entrega de dados em tempo real. Beneficia de:

  • Pedidos e tamanhos de mensagens ilimitados para máxima flexibilidade.
  • Um domínio personalizado com HTTPS integrado (por exemplo, https://real-time.sua-empresa.com).
  • Atualizações com um clique para manter o seu hub sempre atualizado sem complicações.
  • Elevada performance e forte segurança numa infraestrutura privada e dedicada.
  • Várias regiões disponíveis: 🇪🇺 Europa e 🇺🇸 USA para entrega de baixa latência.

Comece rapidamente: bastam 5 minutos para lançar o seu ambiente de Mercure-Hub cloud hosting e começar a enviar atualizações em tempo real para as suas aplicações.

Segue-se um exemplo de script que cria um stack, adiciona o seu serviço Mercure Hub, aguarda que este inicie, recupera a sua configuração (incluindo as credenciais geradas) e depois aplica uma nova configuração.

#!/bin/bash
set -e

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

serviceStore="mercure-hub"   # O nome do serviço store Mercure Hub (ver passo 2)
instance="..."                # Um tamanho de instância do passo 3
region="europe"               # Um nome de região do passo 3

# Criar um stack para o seu serviço (utiliza a sua organização por defeito; adicione --organization se necessário)
stackId=$(stackhero --format=script stack-create \
  --name="My Mercure Hub stack")
echo "Stack criado: ${stackId}"

# Adicionar Mercure Hub ao stack (os nomes são resolvidos automaticamente)
serviceId=$(stackhero --format=script service-add \
  --stack="My Mercure Hub stack" \
  --service-store="${serviceStore}" \
  --instance="${instance}" \
  --region="${region}")
echo "Serviço adicionado: mercure-hub"

# Aguardar que o serviço esteja totalmente operacional (pode demorar alguns minutos)
stackhero service-wait-for --service="mercure-hub"

# Recuperar a configuração do serviço, incluindo as credenciais geradas
stackhero service-configuration-get --service="mercure-hub" --format=json