Debug build tasks online in Alibaba Cloud DevOps pipelines to troubleshoot issues directly in the build environment.
Enable debug mode
In the task's advanced settings section, turn on Enable Debug mode. The build environment is then retained after the task finishes, so you can log in and debug directly.
-
Two retention policies are available for the build environment:
-
Keep the build environment only when the task fails: The environment is retained only when the task fails, not when it succeeds or when only a quality gate check fails.
-
Keep the build environment regardless of task success: The environment is retained whether the task succeeds or fails. If it is no longer needed, release it manually from the run log card.
-
-
Set a retention time in minutes. The environment is automatically destroyed after this period.
-
Only tasks that run in a Specify Container Environment support debug mode. If your task still uses the default environment, edit the pipeline and add a new instance of the task from the task list. New tasks use Specify Container Environment by default. You can then modify the SDK version or command scripts as needed.
-
When debug mode is enabled, the build environment's retention time consumes pipeline resources, which are billed on a pay-as-you-go basis. For more information, see build resource usage.
Log in to debug
After a task with debug mode finishes, click Debugging on the task card to log in to the build environment.
In the build environment, run command-line operations such as viewing logs to troubleshoot build issues. The login window supports Full Screen and Open in New Window (opening in a new window establishes a new connection).
Destroy the build environment
Destroy the build environment in any of the following ways:
-
Wait for the build environment retention time to expire. The environment is destroyed automatically.
-
On the task card, click Destroy the build environment now to destroy it.
-
When you finish debugging, in the login window, click Log out and destroy the build environment.