Skip to content

常见问题 FAQ ​

概念类 ​

Q:项目和任务到底怎么选? A:要拉代码构建、要依赖先建、要重复发布 → 项目;勘察/改配置/清缓存/导数据等「跑一件事」→ 任务。 任务步骤 ID 位置稳定、可选择性执行;项目命令 ID 每次 update 重生成。见 核心概念、迁移指南。

Q:运行 ID 和构建号有什么区别? A:运行 ID 全局自增,logs/stop/WS 都用它;构建号是项目/任务内第几次,用于日志头部与版本追溯。见 运行历史与取消。

Q:构建到底在哪里发生? A:服务端机器。Git 准备阶段 clone/fetch 到工作区后在本机构建;本地只推代码到 Git 远程并触发。 Docker 形态服务端则在容器内构建。被质疑时出示项目定义与运行日志的 git/mvn/pnpm 证据。见 Git 准备阶段。

Q:归档和删除有什么区别? A:归档软隐藏、历史保留、可恢复;删除硬清理定义/变量/历史/日志,但不碰工作区与 systemd 服务。见 更新、归档与删除。

行为类 ​

Q:Ctrl+C 会取消部署吗? A:默认不会,只断开日志跟随(退出码 0)。要取消加 --cancel-on-interrupt 或 deploy stop <runId>。

Q:为什么 HTTP 200 还失败? A:契约封装 {success,data,errorCode,...},业务错误也走 200。检查 success、运行终态与退出码。见 输出约定与退出码。

Q:自动化为什么突然 401? A:用了登录 JWT(默认 168h 过期)。换 dk_ API Token:长期有效、可撤销。见 登录与身份。

Q:--command-id 报命令不存在? A:项目 update 后命令 ID 全部重生成。选择性运行前重新 project get;任务用稳定的 --step-id 无此问题。

Q:脚本里 command not found,手动登录却有? A:命令走登录 Shell(bash -lc),读 /etc/profile 不读 ~/.bashrc。把 PATH 写进 profile.d。见 工具链安装。

Q:进入队列就算部署成功吗? A:不算。queued 只是受理;必须等终态 success(--wait/-f/Hook wait)。

Q:取消运行会回滚已发布的文件吗? A:不会。取消只杀进程树;副作用已发生。发布脚本要幂等或带健康检查/回滚步骤。

平台类 ​

Q:Windows 能当服务端吗? A:能运行项目/任务(PowerShell 解释器、taskkill 取消);但中间件/工具链实装仅 Linux,Windows 只能 dry-run。

Q:Docker 形态和 systemd 形态怎么选? A:要管理宿主机服务(systemctl)、访问宿主机目录 → systemd 直部署;隔离构建环境、不碰宿主机 → Docker(注意容器内 systemctl 无效)。见 Docker 部署。

Q:多人共用怎么隔离? A:visibility 设 ownerOnly;编辑/执行本就仅 owner/admin;凭据与 API Token 按人分发。见 用户、角色与可见性。

Q:日志会占满磁盘吗? A:单运行超 logMaxBytes(默认 100MB)截断;过期按 logRetentionDays(默认 30 天)清理。磁盘总量仍需监控(/server-info 告警阈值)。

Q:secret.key 丢了会怎样? A:已加密的 Secret 与 Git 凭据无法解密恢复。务必与数据库同批备份。见 安全加固。

还有问题 ​

按现象查 故障排查;契约细节查 API 参考; 真实落地参考 部署案例。