SuperAPI AI 工具集

package-once-blue

部署与运维

查看项目

更新于 10-16 02:37

技能介绍

用途:在部署目录中使用随附的 blue 启动器,创建和运维单服务器 Basecamp ONCE 部署,覆盖 colors.yml 配置、构建、dry-run、provisioning、删除与状态查询。

主要能力:该包通过 colors-compute 面向单台主机;库负责 provider 选择、凭据、远程状态与 SSH 密钥生命周期。ONCE 负责应用配置、SMTP、DNS 与 GitHub 发布。修改期望状态前先阅读 configuration.md;为应用仓库添加持续部署时阅读 github-deploy.md。

使用方式:启动器以 uv 运行并解析不可变包依赖。初始化时保留已有期望状态与无关文件,复制随附启动器并赋予可执行权限,创建或修订 colors.yml 中的非机密设置,忽略生成输出与私有环境文件。用 ./blue build 和 ./blue create --dry-run 验证;这两条命令不联系 provider,也不证明凭据或线上健康。用 ./blue describe 查看记录的 compute 状态与应用检查,SSH 前需已验证地址。

限制与安全:机密放在 COLORS_PAR_* 环境变量中,只询问变量名及是否已设置,不询问值;不要读取 .envrc.private 或私钥,不要读取或编辑生成的 .colors/。一次部署只用一个 color。真实 create 或 delete 需用户授权;已有授权直接适用。compute 所有权失败会停止后续资源创建。期望状态中保持 compute-prevent-destroy: true,授权删除可在该次调用使用 COLORS_PAR_COMPUTE_PREVENT_DESTROY=false。已有单体 compute 状态需显式审查迁移,缺失、不可读或不一致状态应拒绝而非重建。失败操作保留状态以供检查与重试。不要向本包添加 compute 模板或 provider 分支,应更新其依赖以获得 provider 支持。create 与 build 在远程 Ansible 前串行化包拥有的 SSH 别名阶段;本地所有权检查失败会停止应用收敛,GitHub 发布在远程收敛之后。