taubyte-orchestrator

Compare original and translation side by side

🇺🇸

Original

English
🇨🇳

Translation

Chinese

Taubyte Orchestrator

Taubyte Orchestrator

When to Use

适用场景

Use for any Taubyte request before running resource-specific operations.
适用于任何Taubyte请求,在运行资源特定操作之前执行。

Mandatory gate order

强制门执行顺序

  1. taubyte-cli-prereqs
    (hard gate: Node.js and Docker — install/start when possible, else prompt;
    @taubyte/cli
    /
    @taubyte/dream
    ; auth via
    taubyte-auth-and-profile
    before GitHub-backed repo work)
  2. taubyte-auth-and-profile
    (profiles,
    tau login --new
    , switches — complements Step 1 login)
  3. taubyte-execution-modes
  4. taubyte-core-constraints
  5. taubyte-cloud-selection
  6. taubyte-scope-routing
  7. taubyte-project-and-application
  8. taubyte-context-log
  9. taubyte-resource-creation
  10. taubyte-go-sdk-constraints
    (for Go function code paths)
  11. taubyte-build-runtime-config
    (if server-side vars/config/build logic is needed)
  12. taubyte-push-build-verify
  13. taubyte-dream-local-operations
    or
    taubyte-remote-cloud-operations
  14. taubyte-debugging-and-recovery
    on failure
  1. taubyte-cli-prereqs
    (硬性检查项:Node.jsDocker —— 尽可能自动安装/启动,否则提示用户;需安装**
    @taubyte/cli
    ** /
    @taubyte/dream
    ;在处理基于GitHub的仓库工作前,需通过**
    taubyte-auth-and-profile
    **完成认证)
  2. taubyte-auth-and-profile
    (配置文件、
    tau login --new
    命令、切换配置文件 —— 补充步骤1中的登录操作)
  3. taubyte-execution-modes
  4. taubyte-core-constraints
  5. taubyte-cloud-selection
  6. taubyte-scope-routing
  7. taubyte-project-and-application
  8. taubyte-context-log
  9. taubyte-resource-creation
  10. taubyte-go-sdk-constraints
    (针对Go函数代码路径)
  11. taubyte-build-runtime-config
    (若需要服务器端变量/配置/构建逻辑)
  12. taubyte-push-build-verify
  13. taubyte-dream-local-operations
    taubyte-remote-cloud-operations
  14. 执行失败时触发
    taubyte-debugging-and-recovery

Optional local host access gates (Dream)

可选本地主机访问检查项(Dream)

  • taubyte-hosts-file-editor
    when
    .localtau
    resources must open by hostname.
  • taubyte-local-host-launch
    to validate/launch website or API URLs using FQDN + port.
  • .localtau
    资源需要通过主机名访问时,执行
    taubyte-hosts-file-editor
  • 执行
    taubyte-local-host-launch
    以验证/启动使用FQDN+端口的网站或API URL。

Auto-execution policy for local runtime checks

本地运行时检查的自动执行策略

  • When user asks to "execute locally", "open URL", "run function", or "test website/function", do this automatically after push/deploy:
    1. run
      taubyte-hosts-file-editor
      (attempt automatic hosts update first),
    2. run
      taubyte-local-host-launch
      (hostname-based curl/browser-ready URLs),
    3. return concrete URLs and curl commands.
  • If hosts elevation fails, provide exact manual hosts lines and continue verification with
    curl --resolve
    .
  • If Docker is unavailable on Dream path, stop runtime claims and report the blocker explicitly.
  • 当用户要求“本地执行”、“打开URL”、“运行函数”或“测试网站/函数”时,在推送/部署后自动执行以下操作:
    1. 运行
      taubyte-hosts-file-editor
      (先尝试自动更新主机文件),
    2. 运行
      taubyte-local-host-launch
      (生成基于主机名的curl命令或可直接在浏览器打开的URL),
    3. 返回具体的URL和curl命令。
  • 如果主机文件提权更新失败,提供精确的手动主机文件添加内容,并使用
    curl --resolve
    继续验证。
  • 如果Dream路径下Docker不可用,停止运行时相关操作并明确报告阻塞问题。

Rules

规则

  • Applications: do not create or select an application by default. Follow
    taubyte-scope-routing
    and
    taubyte-project-and-application
    : use project-only context for simple website or function (and global resources) unless the user wants multiple contexts/applications or the task is application-scoped.
  • Do not skip or reorder gates.
  • If
    taubyte-cli-prereqs
    fails (missing Node or Docker / daemon not running, missing
    tau login
    when GitHub is needed, or missing
    tau
    /
    dream
    ), stop immediately.
  • Default to non-interactive mode.
  • Use JSON verification (
    tau --json current
    ) after context changes.
  • Keep commands sequential when selection/context can change.
  • Load
    taubyte-reference-index
    when additional command/topic depth is needed.
  • Load
    taubyte-spore-drive-sdk
    only for cloud deployment/self-hosting requests.
  • 应用程序: 默认不创建或选择应用程序。遵循**
    taubyte-scope-routing
    taubyte-project-and-application
    的规则:对于简单的网站函数**(以及全局资源),仅使用项目级上下文,除非用户需要多上下文/多应用程序或任务是应用程序范围的。
  • 不得跳过或重新排序检查项。
  • 如果
    taubyte-cli-prereqs
    检查失败(缺少NodeDocker/守护进程未运行,处理GitHub相关工作时未完成
    tau login
    ,或缺少
    tau
    /
    dream
    工具),立即停止操作。
  • 默认使用非交互模式。
  • 上下文变更后使用JSON验证(
    tau --json current
    )。
  • 当选择/上下文可能发生变化时,保持命令按顺序执行。
  • 当需要更深入的命令/主题信息时,加载
    taubyte-reference-index
  • 仅在云部署/自托管请求时加载
    taubyte-spore-drive-sdk