From 337bed45a3d8aecc1ce3401c4917851a458c4f1e Mon Sep 17 00:00:00 2001 From: Simon Deziel Date: Fri, 29 Nov 2024 17:50:41 -0500 Subject: [PATCH 1/6] doc/support: detail the 3 levels of LTS support Signed-off-by: Simon Deziel --- doc/support.md | 11 +++++++++++ 1 file changed, 11 insertions(+) diff --git a/doc/support.md b/doc/support.md index 8e030f2e5e5e..af213c1dad80 100644 --- a/doc/support.md +++ b/doc/support.md @@ -8,13 +8,22 @@ LXD maintains different release branches in parallel. Long term support (LTS) releases : The current LTS releases are LXD 5.21.x (snap channel `5.21/stable` - this is the default channel), LXD 5.0.x (snap channel `5.0/stable`) and LXD 4.0.x (snap channel `4.0/stable`). + An LTS release starts its life with full support, then moves to maintenance support, and finally to extended support. OS vendors might provide additional support[^1]. + + - Full support: some new features, frequent bugfixes, and security updates are provided. + - Maintenance support: high impact bugfixes and security updates are provided. + - Extended support: only high and critical security updates are provided. + The LTS releases follow the Ubuntu release schedule and are released every two years: - LXD 5.21 is supported until June 2029. It gets frequent bugfix and security updates, but does not receive any feature additions. Updates to this release happen approximately every six months, but this schedule should be seen as a rough estimation that can change based on priorities and discovered bugs. + Currently in full support phase. - LXD 5.0 is supported until June 2027. + Currently in maintenance support phase. - LXD 4.0 is supported until June 2025. + Currently in extended support phase. Feature releases : After LXD 5.21 is released, the next feature release will be LXD 6.x (starting with 6.1). @@ -25,6 +34,8 @@ Feature releases The normal support length for those releases is until the next release comes out. Some Linux distributions might offer longer support for particular feature releases that they decided to ship. +[^1]: Canonical provides additional support through the [Ubuntu Pro](https://ubuntu.com/pro) offering. + % Include content from [../README.md](../README.md) From 3df55ab8e6c49c6427e825e2bc0f1e4d24352927 Mon Sep 17 00:00:00 2001 From: Simon Deziel Date: Tue, 3 Dec 2024 09:17:16 -0500 Subject: [PATCH 2/6] doc/support: don't mention `latest/*` or the now defunct `6.1/stable` channels Signed-off-by: Simon Deziel --- doc/support.md | 3 +-- 1 file changed, 1 insertion(+), 2 deletions(-) diff --git a/doc/support.md b/doc/support.md index af213c1dad80..22a300f49e2c 100644 --- a/doc/support.md +++ b/doc/support.md @@ -26,8 +26,7 @@ Long term support (LTS) releases Currently in extended support phase. Feature releases -: After LXD 5.21 is released, the next feature release will be LXD 6.x (starting with 6.1). - It is available through the snap channels `latest/stable`, `latest/candidate`, and `latest/edge`, in addition to channels for the most recent specific releases (for example, `6.1/stable`). +: After LXD 5.21 is released, the next feature release will be LXD 6.x (starting with 6.1), available from the `6/stable` channel. See `snap info lxd` for a full list of available channels. Feature releases are pushed out about every month and contain new features as well as bugfixes. From d0ef03c8547f0260d54bdfa7976ab62c4a52a665 Mon Sep 17 00:00:00 2001 From: Simon Deziel Date: Tue, 3 Dec 2024 10:21:13 -0500 Subject: [PATCH 3/6] doc/howto/snap: allow linking to cohort note Signed-off-by: Simon Deziel --- doc/howto/snap.md | 1 + 1 file changed, 1 insertion(+) diff --git a/doc/howto/snap.md b/doc/howto/snap.md index 54cbe69f9dae..8d729b094de5 100644 --- a/doc/howto/snap.md +++ b/doc/howto/snap.md @@ -83,6 +83,7 @@ Specify a refresh window See [Control updates with system options](https://snapcraft.io/docs/managing-updates#heading--refresh-hold) in the snap documentation for detailed information. +(howto-snap-cohort)= #### Keep cluster members in sync The cluster members that are part of the LXD deployment must always run the same version of the LXD snap. From b39f6cbde8674f5b5717feb844aef9d6b9321cfe Mon Sep 17 00:00:00 2001 From: Simon Deziel Date: Tue, 3 Dec 2024 10:34:11 -0500 Subject: [PATCH 4/6] doc/installing: add note about cohort and installing specific rev Signed-off-by: Simon Deziel --- doc/installing.md | 14 ++++++++++++++ 1 file changed, 14 insertions(+) diff --git a/doc/installing.md b/doc/installing.md index 1385dcb9fa31..19a7c2f3de0b 100644 --- a/doc/installing.md +++ b/doc/installing.md @@ -64,6 +64,20 @@ Complete the following steps to install the snap: sudo snap install lxd --channel=5.0/stable +```{note} +LXD cluster members all need to use the exact same version of LXD and this requires special consideration due to how snaps are deployed as explained in {ref}`Keep cluster members in sync`. To ensure all the cluster members are offered the same snap revision, it is possible to specify a cohort parameter which will bypass the progressive deployment: + + snap install lxd --cohort="+" + +This can also be specified during refreshes (not required if done at install time): + + snap refresh lxd --cohort="+" + +If for some reason, the cohort mechanism did not work as expected, it is also possible to install a specific snap revision that matches that used on all the cluster members: + + snap install lxd --revision= +``` + For more information about LXD snap packages (regarding more versions, update management etc.), see [Managing the LXD snap](https://discourse.ubuntu.com/t/managing-the-lxd-snap-package/37214). ```{note} From 9d9ff9c318348026209e339c02545712362b4617 Mon Sep 17 00:00:00 2001 From: Simon Deziel Date: Tue, 3 Dec 2024 10:50:07 -0500 Subject: [PATCH 5/6] github: switch to 24.04 runners for documentation step Signed-off-by: Simon Deziel --- .github/workflows/tests.yml | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/.github/workflows/tests.yml b/.github/workflows/tests.yml index 4875d3ad3379..6a9885b5101d 100644 --- a/.github/workflows/tests.yml +++ b/.github/workflows/tests.yml @@ -602,7 +602,7 @@ jobs: documentation: name: Documentation - runs-on: ubuntu-latest + runs-on: ubuntu-24.04 steps: - name: Checkout uses: actions/checkout@11bd71901bbe5b1630ceea73d27597364c9af683 # v4.2.2 From 563d5df065df8330a4317dc84100aa88aad0841a Mon Sep 17 00:00:00 2001 From: Simon Deziel Date: Tue, 3 Dec 2024 10:50:20 -0500 Subject: [PATCH 6/6] github: switch to 24.04 runners for snap step Signed-off-by: Simon Deziel --- .github/workflows/tests.yml | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/.github/workflows/tests.yml b/.github/workflows/tests.yml index 6a9885b5101d..9f74264eca78 100644 --- a/.github/workflows/tests.yml +++ b/.github/workflows/tests.yml @@ -658,7 +658,7 @@ jobs: snap: name: Trigger snap edge build - runs-on: ubuntu-22.04 + runs-on: ubuntu-24.04 needs: [code-tests, system-tests, client, documentation, ui-e2e-tests] if: ${{ github.repository == 'canonical/lxd' && github.event_name == 'push' && github.actor != 'dependabot[bot]' }} steps: