示例:端到端创建一个 service

本文档属于使用 CLI指南的一部分。您可以在此处查看完整指南:安装并使用 Stackhero CLI,从命令行、脚本、CI 和 AI agents 管理您的 stacks 和 services

下面是一个示例脚本,展示了如何创建一个 stack、添加一个 service、等待其就绪并获取其凭据。此示例完全是非交互式的,并使用 STACKHERO_TOKEN 环境变量。

#!/bin/bash
set -e

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

serviceStore="directus"   # 服务 store 名称。参见:`stackhero services-store-list`
instance="1GB"            # 实例(大小)名称。参见:`stackhero instances-store-list --service-store=directus`
region="europe"           # 区域名称。参见:`stackhero regions-list`

# 创建一个 stack(使用您唯一的 organization,如果您有多个,请添加 `--organization`)
stackId=$(stackhero --format=script stack-create \
  --name="My stack")
echo "Stack: ${stackId}"

# 添加一个 service(名称会自动解析,上面的 stack ID 也同样可用)
serviceId=$(stackhero --format=script service-add \
  --stack="My stack" \
  --service-store="${serviceStore}" \
  --instance="${instance}" \
  --region="${region}")
echo "Service: ${serviceId}"

# 等待 service 进入运行状态
stackhero service-wait-for --service="${serviceId}"

# 获取凭据和配置
stackhero service-configuration-get --service="${serviceId}" --format=json

每个 service 文档页面都包含一个可直接运行的 Automate with the CLI 指南,并且针对该 service 进行了定制,因此您可以获得开始所需的一切。