Skip to content

fix(build): remove floating minor version tag from Docker metadata#198

Merged
bedatty merged 1 commit intodevelopfrom
fix/remove-floating-minor-tag
Apr 1, 2026
Merged

fix(build): remove floating minor version tag from Docker metadata#198
bedatty merged 1 commit intodevelopfrom
fix/remove-floating-minor-tag

Conversation

@bedatty
Copy link
Copy Markdown
Contributor

@bedatty bedatty commented Apr 1, 2026

Lerian

GitHub Actions Shared Workflows


Description

Removes the type=semver,pattern={{major}}.{{minor}} tag from the Docker metadata step in the build workflow.

This floating minor tag (e.g. 1.4) conflicts with DockerHub tag immutability settings. When v1.4.0 is published, the 1.4 tag is created and locked. Subsequent patch releases like v1.4.1 then fail because they try to overwrite the immutable 1.4 tag.

After this change, the build workflow generates only:

  • Exact version tag (e.g. 1.4.1) — via {{version}}
  • Major tag (e.g. 1) — via {{major}}, only on release tags

Type of Change

  • feat: New workflow or new input/output/step in an existing workflow
  • fix: Bug fix in a workflow (incorrect behavior, broken step, wrong condition)
  • perf: Performance improvement (e.g. caching, parallelism, reduced steps)
  • refactor: Internal restructuring with no behavior change
  • docs: Documentation only (README, docs/, inline comments)
  • ci: Changes to self-CI (workflows under .github/workflows/ that run on this repo)
  • chore: Dependency bumps, config updates, maintenance
  • test: Adding or updating tests
  • BREAKING CHANGE: Callers must update their configuration after this PR

Breaking Changes

None.

Testing

  • YAML syntax validated locally
  • Triggered a real workflow run on a caller repository using @develop or the beta tag
  • Verified all existing inputs still work with default values
  • Confirmed no secrets or tokens are printed in logs
  • Checked that unrelated workflows are not affected

Caller repo / workflow run: https://github.com/LerianStudio/product-console/actions/runs/23855041026/job/69545602065

Related Issues

Summary by CodeRabbit

  • Chores
    • Updated Docker image tagging configuration in the build workflow to streamline tag generation.

The {{major}}.{{minor}} semver pattern (e.g. 1.4) conflicts with
DockerHub tag immutability on patch releases. When v1.4.0 is
published the 1.4 tag is created and locked, so subsequent patch
releases like v1.4.1 fail trying to overwrite it.

Remove the floating minor tag, keeping only the exact version tag
(e.g. 1.4.1) and the major tag (e.g. 1).
@bedatty bedatty requested a review from a team as a code owner April 1, 2026 16:44
@coderabbitai
Copy link
Copy Markdown

coderabbitai bot commented Apr 1, 2026

No actionable comments were generated in the recent review. 🎉

ℹ️ Recent review info
⚙️ Run configuration

Configuration used: Path: .coderabbit.yml

Review profile: ASSERTIVE

Plan: Pro

Run ID: aa8f15e2-9753-4e20-8049-c9d4fb8b51a4

📥 Commits

Reviewing files that changed from the base of the PR and between f2e73da and 8f52c0e.

📒 Files selected for processing (1)
  • .github/workflows/build.yml
💤 Files with no reviewable changes (1)
  • .github/workflows/build.yml

Walkthrough

Removed a semantic version tag rule from Docker metadata action configuration in the build workflow. The major.minor pattern tag is no longer generated during image builds. The version and major tags remain unchanged.

Changes

Cohort / File(s) Summary
Docker Build Configuration
.github/workflows/build.yml
Removed semantic version tag pattern type=semver,pattern={{major}}.{{minor}} from docker/metadata-action output. Existing version and major tags (conditionally gated) are retained.

Estimated code review effort

🎯 1 (Trivial) | ⏱️ ~2 minutes

🚥 Pre-merge checks | ✅ 3
✅ Passed checks (3 passed)
Check name Status Explanation
Title check ✅ Passed Title accurately identifies the main change: removal of the floating minor version tag from Docker metadata configuration.
Description check ✅ Passed Description covers all required sections: explains the problem, documents the fix, specifies type of change as 'fix', lists testing performed, and includes caller validation link.
Docstring Coverage ✅ Passed No functions found in the changed files to evaluate docstring coverage. Skipping docstring coverage check.

✏️ Tip: You can configure your own custom pre-merge checks in the settings.

✨ Finishing Touches
🧪 Generate unit tests (beta)
  • Create PR with unit tests
  • Commit unit tests in branch fix/remove-floating-minor-tag

Comment @coderabbitai help to get the list of available commands and usage tips.

@lerian-studio lerian-studio added size/XS PR changes < 50 lines workflow Changes to one or more reusable workflow files labels Apr 1, 2026
@lerian-studio
Copy link
Copy Markdown

🔍 Lint Analysis

Check Files Scanned Status
YAML Lint 1 file(s) ✅ success
Action Lint 1 file(s) ✅ success
Pinned Actions 1 file(s) ✅ success
Markdown Link Check no changes ⏭️ skipped
Spelling Check 1 file(s) ✅ success
Shell Check 1 file(s) ✅ success
README Check 1 file(s) ✅ success
Composite Schema no changes ⏭️ skipped

🔍 View full scan logs

@lerian-studio
Copy link
Copy Markdown

🛡️ CodeQL Analysis Results

Languages analyzed: actions

✅ No security issues found.


🔍 View full scan logs | 🛡️ Security tab

@bedatty bedatty merged commit f1bd3c0 into develop Apr 1, 2026
17 checks passed
@github-actions github-actions bot deleted the fix/remove-floating-minor-tag branch April 1, 2026 16:58
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

size/XS PR changes < 50 lines workflow Changes to one or more reusable workflow files

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants