Skip to content

Release Helm chart 3.0.0 for native Server 3.12.0 (schema step) #1227

Closed

Description

@rmcdaniel

Proposed release

Helm chart 3.0.0, with the default appVersion set to native Server 3.12.0, once 3.12.0 is published and qualified (#1225, #1226). This is a chart major under docs/UPGRADING.md: changing the default image now requires an operator action. Every backend moves its native schema (SQLite 14→15, PostgreSQL 15→16, MariaDB 15→16, MySQL 16→17), and the Server never upgrades its schema at startup.

Migration impact

  • Before helm upgrade to 3.0.0: back up the database and every external-payload root.
  • Run the 3.12.0 image's schema-upgrade once. Either enable the existing opt-in native.schemaUpgrade.enabled hook, or run the documented manual Job, with replicas stopped.
  • Without that step, the new pods refuse with native_schema_upgrade_required and stay unready; the existing readiness gating keeps the old pods serving under --atomic.
  • Keep every retained external-payload root mounted. 3.12 resolves each stored object through its original binding (see docs/releases/3.12.0.md).
  • Values keys are unchanged. 2.x values files work as they are.

Rollback impact

  • After schema-upgrade, a 3.11.x binary refuses the database with native_schema_newer_than_binary. Rolling back the chart therefore also means restoring the pre-upgrade database and payload backup; image rollback alone does not work.
  • Before schema-upgrade has run, rolling back to Chart 2.1.0 is an ordinary rollback.

Required checks

  • The chart release workflow: lint, render, chart-testing install on kind, then publishing the immutable OCI chart and an anonymous install verification.
  • The chart's docs/UPGRADING.md section for 3.0.0 carries the steps above.
  • Published 3.12.0 qualification (corpus and Compose) must pass first.

Decision

Release maintainer: General. Proceed to 3.0.0 after 3.12.0 is published and promoted. No approval beyond the normal chart release gates is reserved for this release.

Activity

  1. rmcdaniel commented on Nov 17, 2026

    @rmcdaniel
    MemberAuthor

    Delivered: Chart 3.0.0 (#1228, merged as 13ad454) defaults to native Server 3.12.0. Run 44163442182 passed lint, render and the kind install, published the immutable OCI chart (manifest 3b47f786…) and verified an anonymous install (package cd8dad06…). docs/UPGRADING.md carries the migration and rollback steps above. Stable selection is updated in docs#554.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Metadata

Metadata

Assignees

No one assigned

    Labels

    No labels
    No labels

    Type

    No type

    Projects

    No projects

      Milestone

      No milestone

      Relationships

      None yet

      Development

      No branches or pull requests

      Issue actions