Display build number in summary and support offsetting of Riff Raff Build number

[paulmr]

What does this change?

This change address what I believe is a common use case, where a project has switched from a previous build tool to GitHub actions, and we want the GitHub Actions Riff-Raff build number to start counting from the last build number in the previous tool.

This also adds a "Riff Raff" section to the job summary which outputs the build number selected (whether or not it has been modified).

How to test

If you provide the optional buildNumberOffset argument when calling this action, that value should be added to the build number (e.g. in the default case, without also providing a buildNumber parameter, this would get added to the GitHub Run Number).

If this optional parameter is not provided then the build number should remain unchanged.

In either case, after running the action, you should be able to click on the run to see it's summary, and at the bottom you will see a Riff Raff section outputting the build number.

An example of where I have run this on an actual build can be seen here:

https://github.com/guardian/kindle-publication-check/actions/runs/3439230129

Images

This is an example of the output added to the job summary:

[akash1810]

This is excellent! Wonder if we should add more detail to the table? e.g. the Riff-Raff project name, a deep-link to Riff-Raff to deploy to CODE?

[paulmr]

Thanks a lot reviewing Akash!

This is excellent! Wonder if we should add more detail to the table? e.g. the Riff-Raff project name, a deep-link to Riff-Raff to deploy to CODE?

Yes, I love this idea. I will admit I was being a little bit sheepish about adding too much to the summary in case we weren't happy to make a big deal out of it, but I think this is definitely a good idea to add more info.

[paulmr]

I have updated this to default the offset to zero, and also added the project name to the build summary:

[nicl]

This is great :) will save a lot of time for people when migrating projects off Teamcity. And the table summary looks really helpful too.

[akash1810]

I've made the v2.0.1 release for this now, and updated the v2 tag. Any projects using guardian/actions-riff-raff@v2 should see this wonderful annotation.