Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Make the automatic pack version update PRs more descriptive #161

Merged
merged 2 commits into from
Dec 8, 2022

Conversation

edmorley
Copy link
Collaborator

@edmorley edmorley commented Dec 7, 2022

We now use GitHub Actions for all of our repositories (having recently migrated from Circle CI) - and for those that are CNB related and need the Pack CLI, we use the buildpacks/github-actions/setup-pack action.

We intentionally don't set an explicit pack-version, to avoid having to manually update multiple repositories when a new Pack version is released. Instead, we rely on the Action's default Pack version, pin to a specific version of this Action, and then enable GitHub Actions version bumping in Dependabot. This gives us the best of both worlds: determinism but minimal toil.

Dependabot then opens PRs like:
heroku/libcnb.rs#434

However, currently the release notes section of those Dependabot PRs (which we'll look at when reviewing the PR) contain entries like:

- Update default version of setup-pack/action.yml 

...which somewhat buries the lede - that:
(a) the action release actually includes a changed default version of Pack (and not some GitHub Actions schema/API/release version or something), and
(b) what that version now is.

These changelog entries come directly from the commit log, and so the wording is that from the automated bot PRs, eg:
#159

As such, I've updated the template to say more explicitly:

  • what it is changing (Pack version, not some action version),
  • what the new version is,
  • and for bonus points it now links to the Pack release notes (so they'll handily show up when we review our own Dependabot PRs for updating this action).

I don't have an easy way to test this change, so be aware that this is untested.

It is based on the "echo to GITHUB_OUTPUT" approach I see used here:
https://github.com/buildpacks/pack/blob/b10e41f40b119ff5e954d060c24e1085a8b92be6/.github/workflows/delivery-homebrew.yml#L65-L90

...and for which the GitHub docs are here:
https://docs.github.com/en/actions/using-workflows/workflow-commands-for-github-actions#setting-an-output-parameter

Signed-off-by: Ed Morley 501702+edmorley@users.noreply.github.com

We now use GitHub Actions for all of our repositories (having recently
migrated from Circle CI), and for those that are CNB related and need
the Pack CLI, we use the `buildpacks/github-actions/setup-pack` action.

We intentionally don't set an explicit `pack-version`, to avoid having to
manually update multiple repositories when a new Pack version is released.
Instead, we pin to a specific version of this Action, and then enable
Actions version bumping in Dependabot, which gives us PRs like:
heroku/libcnb.rs#434

However, currently the release notes section of those Dependabot PRs
contain entries like:

```
- Update default version of setup-pack/action.yml 
```

...which somewhat buries the lede - that:
(a) the release actually changed the default version of *Pack* (and not
some GitHub Actions schema version or something), and
(b) what that version now is.

These changelog entries come directly from the commit log, and so the
wording is that from the automated bot PRs, eg:
buildpacks#159

As such, I've updated the template to say more explicitly what it is
changing (Pack version, not some action version), what the new version
is, and for bonus points links to the release notes, so they'll handily
show up when we review our own Dependabot PRs for updating this action.

I don't have an easy way to test this change, so be aware that this is
untested. It is based on the "echo to `GITHUB_OUTPUT`" approach I see
used here:
https://github.com/buildpacks/pack/blob/b10e41f40b119ff5e954d060c24e1085a8b92be6/.github/workflows/delivery-homebrew.yml#L65-L90

...and for which the GitHub docs are here:
https://docs.github.com/en/actions/using-workflows/workflow-commands-for-github-actions#setting-an-output-parameter


Signed-off-by: Ed Morley <501702+edmorley@users.noreply.github.com>
@edmorley edmorley requested a review from a team as a code owner December 7, 2022 12:55
@jkutner jkutner added type:enhancement A general enhancement semver:patch A change requiring a patch version bump labels Dec 8, 2022
@jkutner jkutner merged commit 0a00804 into buildpacks:main Dec 8, 2022
@edmorley edmorley deleted the patch-1 branch December 30, 2022 12:27
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
semver:patch A change requiring a patch version bump type:enhancement A general enhancement
Projects
None yet
Development

Successfully merging this pull request may close these issues.

2 participants