Using tmate

[plocket]

tmate is useful for developing GitHub actions. Here's a quick reminder on how we've used it before.

      - name: Setup tmate session
        uses: mxschmitt/action-tmate@v3

1. Run the action
2. Wait for the GitHub console to start printing something like ssh -i <path to ssh key> randomChars@nyc1.tmate.io. The path is to a file called something like id_rsa (NO public/pub in the name). E.g. ssh -i ~/.ssh/id_rsa randomChars@nyc1.tmate.io.
3. Go to any local terminal and paste that string, with the right path. Press 'enter' to run the command.
4. Press q or something to be able to interact (fix this later if it's some other key).
5. You're now in the folder of the repo and can explore it and run commands on the command line as if you were in the action. Some stuff isn't available there, like the github object. Env vars are available, though, so if you need values, make them into env vars.

Other useful bits might be:

        if: ${{ inputs.enable_tmate }}
        with:
          detached: true

This issue was made to be closed.