Skip to content
Quibble

Upgrades

import { Aside } from ‘@astrojs/starlight/components’;

Quibble follows Semantic Versioning. Patch and minor releases are safe to upgrade without reading the changelog. Major releases may include database migrations or breaking changes.

Check the current version

Section titled “Check the current version”
Terminal window
helm list -n quibble

Before upgrading

Section titled “Before upgrading”
  1. Back up Postgres — see Backups & Restore.
  2. Read the CHANGELOG for any migration notes.
  3. Ensure no games are currently in progress — active WebSocket state is not persisted across restarts.

Upgrade with Helm

Section titled “Upgrade with Helm”
Terminal window
helm repo update
helm upgrade quibble quibble/quibble \
  --namespace quibble \
  --values values.yaml

Helm will perform a rolling update of the API and web deployments.

Database migrations

Section titled “Database migrations”

Migrations run automatically on API startup via goose. No manual step is required. If the API pod fails to start after an upgrade, check its logs for migration errors:

Terminal window
kubectl logs -n quibble deployment/quibble-api

Rolling back

Section titled “Rolling back”

If an upgrade causes issues, roll back the Helm release:

Terminal window
helm rollback quibble -n quibble

This restores the previous chart version. If a migration was applied, you may need to run a manual rollback migration — check the CHANGELOG for instructions.