Skip to content

chore: align REF configuration and migrate to SemVer#7

Open
lewisjared wants to merge 13 commits intomainfrom
chore/align-ref-configuration
Open

chore: align REF configuration and migrate to SemVer#7
lewisjared wants to merge 13 commits intomainfrom
chore/align-ref-configuration

Conversation

@lewisjared
Copy link
Copy Markdown
Contributor

@lewisjared lewisjared commented Apr 9, 2026

Summary

Align deployment configuration and migrate from CalVer to SemVer.

Versioning: The AFT repo and Helm chart now share a single SemVer version (0.1.0). appVersion in Chart.yaml independently tracks climate-ref core (0.12.3). Bump workflow offers patch/minor/major. The unused .bumpversion-helm.toml is deleted.

Configuration: REF_CONFIGURATION aligned to /ref across API and workers. REF_SOFTWARE_ROOT added to worker defaults. Frontend bumped to v0.2.1, docker-compose images pinned to v0.12.3.

Helm: API template falls back to defaults.volumes/defaults.volumeMounts when not overridden, removing duplication in CI values. Minimal deployment CI test added with API re-enabled.

Test plan

  • helm lint passes with all values files
  • bump-my-version bump patch --dry-run updates all 4 targets
  • Minimal and full deployment tests pass in CI

- Set REF_CONFIGURATION=/ref for both API and worker defaults
- Add REF_SOFTWARE_ROOT=/ref/software to worker defaults
- Remove REF_DATABASE_URL from API defaults (read from ref.toml)
- Deployments can use volume subPath mounts to select different
  config directories without overriding REF_CONFIGURATION
- Set REF_CONFIGURATION=/ref for both API and worker defaults
- Add REF_SOFTWARE_ROOT=/ref/software to worker defaults
- Remove REF_DATABASE_URL from API defaults (read from ref.toml)
- Add minimal CI test that verifies workers, dragonfly, and flower
  start healthy with just env var config and no pre-existing state
- API image tag: main -> v0.2.0
- REF_CONFIGURATION: /app/.ref -> /ref
- Remove REF_DATABASE_URL from API env docs (read from ref.toml)
- Worker image tag: v0.11.1 -> v0.12.3
- Add REF_CONFIGURATION and REF_SOFTWARE_ROOT to worker env docs
- OCI install example: 0.11.1 -> 0.12.3
The .bumpversion.toml had current_version="2026.03.0" but
pyproject.toml and versions.toml were at "2026.02.0", causing
the bump workflow to fail.
Unify repo and helm chart versioning under a single SemVer scheme.
The chart version tracks the AFT repo release, while appVersion
tracks the climate-ref core version independently.

- Rewrite .bumpversion.toml for SemVer (major/minor/patch)
- Delete unused .bumpversion-helm.toml
- Update all version references from 2026.02.0 to 0.1.0
- Bump frontend image to v0.2.1
- Pin docker-compose images to v0.12.3 instead of :main
- Update bump workflow options to patch/minor/major
- Bump bump-my-version to >=1.3.0
- Update project description and classifiers
- API template falls back to defaults.volumes/volumeMounts when
  api-specific values are not set, removing duplication in CI values
- Re-enable API in minimal deployment test (fixed in frontend v0.2.1)
- Remove unused jq install from packaging workflow
- Fix stray comment character in __init__.py
@lewisjared lewisjared changed the title chore: align REF_CONFIGURATION between API and workers chore: align REF configuration and migrate to SemVer Apr 10, 2026
Empty list `[]` is truthy in Helm templates, preventing `| default`
fallback from triggering. Remove to match the pattern used by the
API section.
Flower image uses a named user which fails runAsNonRoot verification.
Set runAsUser: 1000 in flower and worker defaults so the chart works
out of the box without per-deployment overrides.

Also override runAsNonRoot for API in minimal CI test until the
frontend image runs as non-root.
The frontend image writes to /root/.cache on startup, which fails
with readOnlyRootFilesystem: true. Relax both runAsNonRoot and
readOnlyRootFilesystem until the frontend image is fixed.
Add a Helm pre-install/pre-upgrade hook Job that runs `ref db migrate`
before deployments start, preventing race conditions between API and
orchestrator database migrations.

Bump frontend image to v0.2.3 which runs as non-root, removing the
need for security context overrides in CI.
Brings in the new `ref db migrate` command required by the Helm
pre-install migration Job, plus other v0.13.0 changes.

- pyproject.toml and versions.toml: all 6 components 0.12.3 -> 0.13.0
- helm/values.yaml: default worker image tag to v0.13.0
- helm/Chart.yaml: appVersion to 0.13.0
- docker/docker-compose.yaml: climate-ref images to v0.13.0
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.

1 participant