Skip to content

docs: add RELEASING.md#113

Open
monrax wants to merge 1 commit into
mainfrom
docs/releasing-md
Open

docs: add RELEASING.md#113
monrax wants to merge 1 commit into
mainfrom
docs/releasing-md

Conversation

@monrax

@monrax monrax commented Jul 12, 2026

Copy link
Copy Markdown
Collaborator

Summary

Documents the release process for the chart in a new docs/RELEASING.md, and links to it from CONTRIBUTING.md.

Details

  • Add docs/RELEASING.md: version-driven release model (chart-releaser triggered by a version bump in Chart.yaml), who can release, versioning (chart version vs appVersion), and step-by-step release procedure — E2E testing on MicroK8s + EKS, values drift check (values.yaml / values.schema.json / README values reference), optional trivy scan, Chart.yaml update (version + artifacthub.io/changes changelog), cutting the release, and verifying publication on Artifact Hub. Includes a copy-paste release checklist and a troubleshooting section (covers the 422 tag_name already_exists case).
  • Add a "Releasing" section to CONTRIBUTING.md summarizing the flow and linking to docs/RELEASING.md.

Linked issues

This fixes #27

PR Checklist

Please check the items that apply to your change.

  • Tests added/updated
  • Documentation updated
  • This PR includes a new feature
  • This PR includes a bugfix
  • This PR includes a refactor

Testing Checklist

Documentation-only change — no chart templates, values, or workflows modified; install/functional/upgrade tests are not applicable.

Static Validation

  • Linter check passes: helm lint ./charts/graylog
  • Helm renders local template sucessfully: helm template graylog ./charts/graylog --validate

Installation

  • Fresh installation completes successfully: helm install graylog ./charts/graylog
  • All pods reach Running state: kubectl rollout status statefulset/graylog
  • Helm tests pass: helm test graylog

Functional (if applicable)

  • Web UI accessible and login works
  • DataNodes visible in System > Cluster Configuration
  • Inputs can be created and receive data

Upgrade (if applicable)

  • Upgrade from previous release succeeds
  • Scaling up/down works correctly
  • Configuration changes apply correctly

Specific to this PR

  • Verified internal Markdown links resolve (TESTING.md anchor, README values-reference anchor, workflow path) and rendered the doc on the branch.

Notes for reviewers

  • Verify all applicable tests above pass
  • Validate that the linked issues are no longer reproducible, if applicable
  • Sync up with the author before merging
  • The commit history should be preserved - use rebase-merge or standard merge options when applicable

🤖 Generated with Claude Code

Document the version-driven release process for the chart (pre-release
testing, values drift check, optional trivy scan, Chart.yaml update,
cutting the release via chart-releaser, and verifying publication on
Artifact Hub). Closes #27.

Co-Authored-By: Claude Opus 4.8 (1M context) <[EMAIL_ADDRESS_REDACTED]>
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.

Add RELEASING.md

1 participant