Skip to content

Latest commit

 

History

History
69 lines (40 loc) · 11.5 KB

versioning.md

File metadata and controls

69 lines (40 loc) · 11.5 KB
description
This page introduces the release cycle and versioning approach used in Aidbox development

Versioning

Aidbox docker images are available on Docker Hub.

Version numbering

Starting from October 2024 Aidbox follows a MAJOR.MINOR version scheme:

  • MAJOR version: Formatted as YYMM (e.g., 2409 for September 2024)
  • MINOR version: An increasing number starting from zero

Each update increments the MINOR version. For example:

  • New release: 2409.0
  • Bugfix: 2409.1
  • Bugfix 2: 2409.2
  • New release: 2410.0
  • Bugfix for 2409: 2409.3
  • Bugfix for 2410: 2410.1

Images built for full versions (MAJOR.MINOR) remain unchanged. You can specify the full version instead of the Docker manifest SHA to use a specific build.

Release Channels

Aidbox provides several release channels, each updated with changes and new builds:

Edge

The most recent Aidbox build. We highly recommend using the edge channel in staging and dev environments to get access to new functionality and detect potential issues as soon as possible. Every commit into the Aidbox code base after successful CI is published to the edge channel. The edge channel may have issues and/or regressions.

Latest

The latest channel is identical to the last minor version of the last release.

Latest releases contain new functionality, bugfixes, and optimizations and passed all available QA and review processes by the Health Samurai team. If you're actively developing we recommend using latest. These releases are updated monthly.

Stable

The stable channel is identical to the last minor version of the previous release.

Stable releases are ready for production. The current stable is the previous latest release. These releases are updated monthly.

MAJOR-rc

This channel contains the last changes to the MAJOR release, which are undergoing internal QA processes. After these processes are finished, a new full version is released.

MAJOR

For every release, a tag in the format YYMM (e.g., 2409 for September 2024) is created to allow users to check out a specific Aidbox version. This tag is automatically updated with each minor version and corresponds to the last minor version for the major version.

By using these channels and understanding the version numbering system, you can choose the most appropriate Aidbox build for your development, staging, and production environments.

Long-term support releases

Starting in January 2022 we are introducing long-term support releases. The Aidbox team will backport security and critical bug fixes to LTS releases throughout a two-year support window.

Aidbox LTS releases are scheduled to be published twice a year. If you are not interested in getting new features on a monthly basis but want to get critical bug fixes, please consider switching to LTS releases.

Aidbox versionSupportAvailability startsEnd of life
24102024-102026-10
2402-lts2024-042026-04
2306-lts2023-082025-08
2302-lts2023-042025-04
2206-lts2022-082023-08
2202-lts2022-042023-04

LTS changelog

Aidbox versionDateReason
2302-lts, 2306-lts, 2402-lts2024-10-18Fixed critical security issues
2302-lts, 2306-lts, 2402-lts2024-10-03Fixed critical vulnerabilities
2402-lts2024-09-25Fixed critical vulnerabilities
2302-lts, 2306-lts2024-09-18Fixed critical vulnerabilities
2306-lts, 2302-lts2024-09-06Fixed critical vulnerabilities
2306-lts, 2302-lts2024-01-18Fixed recursion in transaction bundles. Fixed missing search modifier.
2306-lts, 2302-lts2024-01-16Supported JWT without kid signature check
2206-lts, 2302-lts2023-11-01Updated dependencies
2302-lts2023-09-11Updated dependencies
2302-lts2023-07-12Fixed security issue
2206-lts2023-06-29Fixed critical vulnerabilities
2302-lts2023-06-07Fixed security issue
2302-lts2023-05-29Fixed critical vulnerabilities
2302-lts2023-04-28Fixed security issue
2202-lts, 2206-lts2023-04-05Fixed critical vulnerabilities
2202-lts, 2206-lts2023-02-03Fixed critical vulnerabilities
2202-lts, 2206-lts2022-11-03Fixed security issues in Search API.
2202-lts, 2206-lts2022-10-10Fixed critical issue on subscriptions in DB transaction that can break DB connection.