Versions
Which worker versions the application works with, and what changed between them that a site can notice.
Worker versions the application supports
The application works with every worker version from 2.0.0 on, choosing per site what that version understands. Four thresholds matter:
| From worker | What changes |
|---|---|
| 2.1.0 | The platform decides per site which release it installs, and the worker keeps a rollback copy of itself. A site on an older worker is brought to this line by uploading the zip once. |
| 2.1.8 | The site's own maintenance flag expires on its own. The application refuses to start an update round on a worker older than this, because a round that cannot finish would otherwise hold the site dark. |
| 2.2.0 | Restore from a backup that exists only in external storage. An older worker cannot, and such a restore is reported as unsupported rather than as a missing backup. |
| 2.3.0 | The site reports and takes its work on its own schedule; the platform's credential travels in a header of its own; a credential per site; signed instructions. A site below 2.3.0 keeps working as long as the platform can reach it. |
The dashboard shows each site's worker version, and a site behind the current stable release is brought up to it by rollout when the platform can reach it — Plugin updates.
What a version number means
A worker release goes through release candidates — 2.3.0-rc.1, -rc.2 — on test sites before it is published as stable, and only the stable version is listed in the changelog and rolled out. A published version is never changed; the next change is a new version. A patch (2.3.0 → 2.3.1) is a compatible fix; a minor (2.3 → 2.4) is a compatible set of user-relevant features.
Breaking changes, by kind
For a site
- 2.1.8: sites below this version are excluded from scheduled update rounds until updated.
- 2.2.0: needed to restore from a backup whose only copy is in external storage.
For an integration
- The API is versioned under
/api/v1. Nothing in it has been removed — API → Changes.
For this documentation
- Worker versions before 2.0.0 are not described here; the records that would support such a description do not exist.