Actions SSH

Debug a workflow interactively:

    # actions-ssh currently uses OIDC for auth, which requires explicit permissions
    permissions:
      id-token: write
      contents: read
    steps:
      - uses: chkimes/[email protected]

Or run it only on failure:

    # actions-ssh currently uses OIDC for auth, which requires explicit permissions
    permissions:
      id-token: write
      contents: read
    steps:
      - uses: chkimes/[email protected]
        if: failure()

By default, SSH is allowed only for the Action's ${{ github.actor }}, however you can override that to be a specific user:

    # actions-ssh currently uses OIDC for auth, which requires explicit permissions
    permissions:
      id-token: write
      contents: read
    steps:
      - uses: chkimes/[email protected]
        with:
          sshUser: chkimes

Make sure you have SSH keys set up in your GitHub settings!

Connecting

Follow the steps in the Actions logs to connect, e.g.:

==================================================================
Connect to the tunnel with:
    ssh chkimes/[email protected]
==================================================================