433 字约 1 分钟
何时需要登录调试？
用户脚本在 Docker 容器内执行，本地与 CI 环境可能不一致， 导致本地正常但 CI 构建失败。 此时可在日志页面点击「登录调试」登入容器排查问题。
如何使用？
流水线执行时启动 Docker 容器运行用户脚本， 构建结束后默认销毁容器，需在构建环境存活期间完成调试。
以下两种情况可登录调试：
- 构建过程中：直接点击「登录调试」
- 构建结束后：在日志页面勾选
Debug选项（位于Rebuild旁），然后点击Rebuild。 新触发的构建结束后环境保留 5 分钟供调试。
- 定时检测：系统定时检测登录状态——无人登录则自动销毁，有人登录则继续保留，最长 1 小时。
调试技巧
点击 Rebuild 时可选择需要执行的 Pipeline、Stage、Job，便于复现问题环境。
例如，构建在 install 阶段失败，怀疑是依赖安装命令与本地行为不一致， 可只勾选该 Stage 重新执行，再通过「登录调试」进入容器核对产物 （如 node_modules）是否与本地一致。
提示：
- 选择 Pipeline、Stage、Job 后，未选中的任务不会执行， 适合快速定位失败发生在哪个环节；
- 若所选 Stage 依赖前置任务（如产物、依赖等），请按需将前置任务一起勾选， 否则重跑时可能因缺少前置产物而失败。