Skip to content

Fix the release-drafter config so the job stops failing on every merge - #11

Merged
enk21 merged 1 commit into
mainfrom
claude/fix-release-drafter
Aug 20, 2026
Merged

Fix the release-drafter config so the job stops failing on every merge#11
enk21 merged 1 commit into
mainfrom
claude/fix-release-drafter

Conversation

@jacobecox

Copy link
Copy Markdown
Collaborator

Release Drafter fails on every merge to main with "template" is required. It has never worked in this repository.

Why

The config was four lines, and the load-bearing one was _extends: .github.

That is release-drafter's inheritance directive — it reads a base config from a repo named .github in the same organization. This file was copied from the Jenkins plugin template, where jenkinsci/.github exists and supplies the required template key.

controlplane-com/.github does not exist (the API returns 404), so nothing was inherited.

The failure output confirms it — every inherited field came back empty:

name-template: '', categories: [], header: '', footer: ''

Only tag-template, which was set locally, had a value.

The fix

Inline the config rather than inherit it, so the repo doesn't depend on an org-level repository that may never be created. Verified by parsing the result: _extends is gone (it survives only inside an explanatory comment) and template is present.

Trimmed while inlining: categories reduced to labels this repo plausibly uses instead of the full Jenkins set, and the jenkinsci-specific replacers (JENKINS-, JEP-, HELPDESK- issue links) dropped since they point at trackers this project doesn't use.

The two tag schemes don't collide

Worth stating explicitly, since this repo now has two:

Producer Tag shape
release-drafter cpln-jenkins-plugin-$NEXT_MINOR_VERSION
publish-image.yml v2.0.0, v2.0.1, …

The image workflow selects with git tag -l 'v[0-9]*.[0-9]*.[0-9]*', which a cpln-jenkins-plugin-2.1 tag does not match. So drafted releases cannot perturb image versioning.

Not addressed

release-drafter@v6 runs on Node 20, which GitHub is deprecating. That warning comes from the action itself, not the config — it appears on passing runs too, and clearing it means waiting for an upstream release.

🤖 Generated with Claude Code

The Release Drafter job has failed on every merge to main with `"template" is
required`, and it has never worked in this repository.

The config was four lines, and the load-bearing one was `_extends: .github`.
That is release-drafter's inheritance directive: it reads a base config from a
repo named `.github` in the SAME organization. The file was copied from the
Jenkins plugin template, where jenkinsci/.github exists and supplies the
required `template` key. controlplane-com/.github does not exist -- the API
returns 404 -- so nothing was inherited.

The failure output showed exactly that: every inherited field came back empty
(name-template '', categories [], header '', footer ''). Only tag-template,
which was set locally, had a value.

This inlines a config instead of inheriting one, so the repo does not depend on
an org-level repository that may never be created. Categories are trimmed to
labels this repo plausibly uses rather than carrying the full Jenkins set, and
the jenkinsci-specific replacers (JENKINS/JEP/HELPDESK issue links) are dropped
because they point at trackers this project does not use.

tag-template keeps the existing cpln-jenkins-plugin-$NEXT_MINOR_VERSION shape.
That deliberately does not collide with the vX.Y.Z tags the image publish
workflow pushes: it matches on 'v[0-9]*.[0-9]*.[0-9]*', which a
cpln-jenkins-plugin-2.1 tag does not satisfy.

Not addressed: release-drafter@v6 runs on Node 20, which GitHub is deprecating.
That warning is emitted by the action itself and is unrelated to the config; it
appears on passing runs too, and fixing it means waiting for an upstream
release.
@enk21
enk21 merged commit 7b3df89 into main Aug 20, 2026
2 checks passed
@enk21
enk21 deleted the claude/fix-release-drafter branch August 20, 2026 18:04
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants