CI/CD Debugging
Debug Pipelines Interactively
The Problem
Log-based debugging
Scrolling through thousands of log lines hoping to find the needle in the haystack.
Unreproducible failures
The test passes locally but fails in CI. The container is gone before you can inspect it.
Slow feedback loops
Add debug statement, push, wait 20 minutes, repeat. Days lost to simple issues.
How ASD Helps
SSH into Running CI Jobs
Connect to your CI container while it's running. Inspect the exact state when the test failed.
Full Terminal Access
Run commands, check file contents, inspect environment variables. Real debugging, not log archaeology.
Shareable Debug Sessions
Stuck? Share your debug session with a teammate. Two pairs of eyes, same exact environment.
Pause on Failure
Configure your pipeline to pause instead of exit on failure. Debug in the exact failing state.
How It Works
Add ASD to your CI
One line in your pipeline config installs the ASD CLI.
Trigger a tunnel on failure
When a test fails, ASD opens a secure tunnel to the container.
Get notified
Receive a link via Slack, email, or your preferred channel.
Debug interactively
SSH in, inspect the state, fix the issue. All in the browser.
Example
jobs:
test:
runs-on: ubuntu-latest
steps:
- uses: actions/checkout@v4
- run: npm ci
- run: npm test
- name: Debug on failure
if: failure()
run: |
curl -sSL https://install.asd.host | bash
asd up --token ${{ secrets.ASD_TOKEN }}Ready to get started?
Start free. No credit card required.