Ejemplo: Crear un servicio de principio a fin

Esta documentación forma parte de la guía Usar la CLI. Consulte la guía completa aquí: Instale y use la CLI de Stackhero para gestionar sus stacks y servicios desde la línea de comandos, scripts, CI y agentes de IA.

Aquí tiene un script de ejemplo que muestra cómo puede crear un stack, añadir un servicio, esperar a que esté listo y recuperar sus credenciales. Este ejemplo es totalmente no interactivo y utiliza la variable de entorno STACKHERO_TOKEN.

#!/bin/bash
set -e

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

serviceStore="directus"   # Un nombre de service store. Ver: `stackhero services-store-list`
instance="1GB"            # Un nombre de instancia (tamaño). Ver: `stackhero instances-store-list --service-store=directus`
region="europe"           # Un nombre de región. Ver: `stackhero regions-list`

# Crear un stack (usa su única organización, añada `--organization` si tiene varias)
stackId=$(stackhero --format=script stack-create \
  --name="My stack")
echo "Stack: ${stackId}"

# Añadir un servicio (los nombres se resuelven automáticamente, y el ID del stack anterior también funciona)
serviceId=$(stackhero --format=script service-add \
  --stack="My stack" \
  --service-store="${serviceStore}" \
  --instance="${instance}" \
  --region="${region}")
echo "Service: ${serviceId}"

# Esperar a que el servicio esté en ejecución
stackhero service-wait-for --service="${serviceId}"

# Recuperar credenciales y configuración
stackhero service-configuration-get --service="${serviceId}" --format=json

Cada página de documentación de servicio incluye una guía Automate with the CLI lista para usar y adaptada a ese servicio, para que tenga todo lo necesario para empezar.