y
y
yq
Search…
GitHub Action

Guide

You can use yq in your GitHub action, for instance:
- uses: actions/[email protected]
- name: Get SDK Version from config
id: lookupSdkVersion
uses: mikefarah/[email protected]
with:
cmd: yq '.renutil.version' 'config.yml'
- name: Restore Cache
id: restore-cache
uses: actions/[email protected]
with:
path: ../renpy
key: ${{ runner.os }}-sdk-${{ steps.lookupSdkVersion.outputs.result }}
restore-keys: |
${{ runner.os }}-sdk
# ... more
The yq action sets a result variable in its output, making it available to subsequent steps. In this case it's available as steps.lookupSdkVersion.outputs.result.
Details of how the GitHub action itself is configured can be found here
If you enable step debug logging, you can see additional information about the exact command sent as well as the response returned within the GitHub Action logs.
Thanks @devorbitus!

Environment variables with Github Actions:

GitHub Actions escape and interpolate rules can conflict with some yq syntax. Here is an example of how to quote a variable that could contain dots in a query path (more usage context: ambanum/OpenTermsArchive#899).
- name: Get an entry with a variable that might contain dots or spaces
id: get_username
uses: mikefarah/[email protected]
with:
cmd: yq '.all.children.["${{ matrix.ip_address }}"].username' ops/inventories/production.yml
- name: Reuse a variable obtained in another step
run: echo ${{ steps.get_username.outputs.result }}
Thanks @MattiSG!

Troubleshooting

Write in-place file permission errors

The default user in github action dockerfiles (at the time of writing) seems to be 1001. This is what the yq github action is configured to run with (see the docker file here)
There's a working example defined here and you can see the Github action results here
If you need to set the action to another user, follow the advice here.
Copy link
On this page
Guide
Environment variables with Github Actions:
Troubleshooting
Write in-place file permission errors