This is a draft document to describe the release process for the scorecard GitHub Action.
(If there are improvements you'd like to see, please comment on the tracking issue or issue a pull request to discuss.)
As the first task, a Release Manager should open a tracking issue for the release.
We don't currently have a template for releasing, but the following issue is a good example to draw inspiration from.
We're not striving for perfection with the template, but the tracking issue will serve as a reference point to aggregate feedback, so try your best to be as descriptive as possible.
This section covers changes that need to be issued as a pull request and should be merged before releasing the scorecard GitHub Action.
The postsubmits.yml
workflow runs on every push to main and weekly. It builds and pushes the
ghcr.io/ossf/scorecard-action:latest image, then runs Scorecard on this
repository with that image, uploading the SARIF and publishing the results.
Confirm that the postsubmits.yml run for the commit you plan to release
succeeded, including the Scorecard analysis job (no
error sending scorecard results line in its log). If there isn't one, run the
workflow manually.
Do this before updating the image tag below: once action.yaml points at the
new tag, ossf/scorecard-action@main references an image that won't exist until
the release tag is pushed.
NOTE: we have a chicken-and-egg problem where the commit to be used for the release needs to have the image tag that only gets created after the commit is pushed. We workaround that by pre-selecting and referencing the image tag instead of the SHA which isn't ideal but workable.
Pre-select the tag which will be used for the release. For this document, we'll use: Tag.
Update the image tag in action.yaml to use Tag.
Example:
runs:
using: "docker"
image: "docker://ghcr.io/ossf/scorecard-action:Tag"
Create a pull request with this change and merge into main.
Start from GitHub's generated notes for the range, either by clicking Generate release notes on a new draft release or with:
gh api -X POST repos/ossf/scorecard-action/releases/generate-notes \
-f tag_name=v100.0.0 -f previous_tag_name=<previous tag>Then edit, following v2.4.4:
- Open with a sentence naming the Scorecard version the release moves to, linking that version's Scorecard release notes, which cover the changes to checks and results.
- List the action's own changes. Drop Dependabot bumps unless they change behavior.
- Keep New Contributors and the Full Changelog link as generated.
Save the draft and share it with the other maintainers.
Locally, create a signed tag Tag on commitSHA SHA:
git remote update
git checkout `SHA`
git tag -s -m "v100.0.0" v100.0.0
git push <upstream> v100.0.0Create a GitHub release using the tag you've just created.
Release title: <tag>
The release notes will be the notes you drafted in the previous step.
Ensure the following fields are up to date:
- Security contact email
- Primary Category
- Another Category — optional
Click Publish release.
GitHub's starter workflow is what new users get when they add the action from the Actions tab, so keep it on the latest release.
-
Get the commit SHA of the release tag:
git rev-parse v100.0.0^{commit} -
Open a pull request in actions/starter-workflows that updates the action in
code-scanning/scorecard.ymlto that SHA, keeping the version comment in step:uses: ossf/scorecard-action@<SHA> # v100.0.0
-
Update the example workflow our README points to,
ossf/scorecard'sscorecard-analysis.yml, the same way. -
Verify on GitHub Marketplace that the workflow example uses the new release.
NOTE: GitHub Marketplace uses the default branch as reference documentation