GitHub Actions Bug!

[evanwill]

(re-posting our blog alert about this bug)

As of January 2025+ the GitHub Actions "jekyll.yml" starter workflow in existing projects is broken!

Due to changes in the ubuntu-latest image, the GitHub Action will end up with errors in existing repositories (set up before 2024-01-14) using the workflow--i.e. if you set up a CB-CSV site and are building it with the default GitHub Actions, new builds will likely fail with errors going forward!

Please note that we do not maintain the "jekyll.yml" or GitHub Actions so can not directly fix the default starter workflow.
The incompatibility was fixed 2025-01-14, so NEW projects going forward should work as expected--however, EXISTING collections may still be impacted and require a fix.

To fix it in your project, edit the file ".github/workflows/jekyll.yml" in your repository. There is two possible ways to fix it.

The first option is to update the setup-ruby version.
On line 37, replace:

uses: ruby/setup-ruby@8575951200e472d5f2d95c625da0c7bec8217c42 # v1.161.0

with:

uses: ruby/setup-ruby@v1.207.0

This should fix the error!

Alternatively, the second option is to roll back the image used by your action.
On line 32, replace:

runs-on: ubuntu-latest

with:

runs-on: ubuntu-22.04

This will restore it to the older image which still works correctly.

(you only need one of these options to fix the issue!)

There is an Issue in the CollectionBuilder-CSV repository and a note in the documentation tracking this problem.