Created with FancyGist

untitled.md

0:00 This is a quick demo of GitHub Actions Debugging. We start with VS Code open in our repository. We will use the GitHub Actions extension to check on our latest workflow run. 0:12 We see that this step failed, so we'll use the GitHub Actions Debugger to fix the issue. First we'll go to the failed job, and click on rerun and debug job. 0:23 This will take us to an active debugging session in our workflow file, with the debugger paused before the first step. 0:29 We'll set a breakpoint in the task that's failing and hit continue to run the first two steps and hit the breakpoint. 0:36 Here I have access to the variables, call stack, and watch Windows as I would expect in any normal debugging session. 0:44 I can see that the step simply checks if a file exists. The actions extension allows me to navigate the remote file system to see if this file exists and I quickly notice that it's not where it's supposed to be. 0:55 I now click Click on Step over to run this step and see how its state changes. I can also click on Reverse to do time travel debugging and return to my first checkpoint at the beginning of the file. 1:06 I can now open the script that creates the file and attempt to correct the issue, all in the remote file system where the workflow is running. 1:13 The script just needs to be updated to place the file in the expected location. I can now go and advance through the steps and see how it affects the state of the runner as well as the file system, and I can verify that the file is now being created in the right place. 1:28 This debugger adapter for actions is auditable and offers fine control over what commands are allowed. As an example, we've blocked the ability to step into in this debugging session, and our audit log tells us when a user attempts this operation. 1:42 Here we attempt to step into and see that the operation is denied by our dat proxy. We're working on debugging adapters to step into bash and PowerShell scripts, but that will have to wait for the next demo. 1:55 We hope you have enjoyed this demo of GitHub Actions Debugging.