From bc325ae5a0dc3eff3245f9243bc7a2c46d35a6e4 Mon Sep 17 00:00:00 2001 From: Thomas Parrott Date: Wed, 11 Dec 2024 08:46:31 +0000 Subject: [PATCH 1/6] README: Remove monthly from feature release Signed-off-by: Thomas Parrott --- README.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/README.md b/README.md index 891452e18291..cfd7ae212ded 100644 --- a/README.md +++ b/README.md @@ -76,7 +76,7 @@ Terraform provider | https://registry.terraform.io/providers/terraform- Consider the following aspects to ensure that your LXD installation is secure: - Keep your operating system up-to-date and install all available security patches. -- Use only supported LXD versions (LTS releases or monthly feature releases). +- Use only supported LXD versions (LTS releases or the latest feature release). - Restrict access to the LXD daemon and the remote API. - Configure your network interfaces to be secure. - Do not use privileged containers unless required. If you use privileged containers, put appropriate security measures in place. From 5031c8ca9a3c76bc886686f3b9b5255a33ffb0ea Mon Sep 17 00:00:00 2001 From: Thomas Parrott Date: Wed, 11 Dec 2024 08:46:42 +0000 Subject: [PATCH 2/6] SECURITY: Remove monthly from feature release Signed-off-by: Thomas Parrott --- SECURITY.md | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/SECURITY.md b/SECURITY.md index 5faeb2f0560b..74fe3fcfa301 100644 --- a/SECURITY.md +++ b/SECURITY.md @@ -5,12 +5,12 @@ LXD has two types of releases: -- Monthly feature releases +- Feature releases - LTS releases For feature releases, only the latest one is supported, and we usually don't do point releases. Instead, users are expected to wait until the -next monthly release. +next feature release. For LTS releases, we do periodic bugfix releases that include an accumulation of bugfixes from the feature releases. Such bugfix releases From bac73602da1aa62541c29394cc5f62a9d084adb6 Mon Sep 17 00:00:00 2001 From: Thomas Parrott Date: Wed, 11 Dec 2024 08:49:59 +0000 Subject: [PATCH 3/6] doc/installing: Clarified new features in LTS Signed-off-by: Thomas Parrott --- doc/installing.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/doc/installing.md b/doc/installing.md index 19a7c2f3de0b..05f708172e1c 100644 --- a/doc/installing.md +++ b/doc/installing.md @@ -21,7 +21,7 @@ See {ref}`installing-manage-access` for instructions. ``` LTS releases are recommended for production environments, because they benefit from regular bugfix and security updates. -However, there are no new features added to an LTS release, nor any kind of behavioral change. +However, not all new features added to an LTS release, nor any kind of behavioral change. To get all the latest features and monthly updates to LXD, use the feature release branch instead. From 3caf44656cd3f35512dae10863516c3b8f198dc4 Mon Sep 17 00:00:00 2001 From: Thomas Parrott Date: Wed, 11 Dec 2024 08:50:12 +0000 Subject: [PATCH 4/6] doc/support: Removed monthly from feature release Signed-off-by: Thomas Parrott --- doc/support.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/doc/support.md b/doc/support.md index 22a300f49e2c..cde4d6073f62 100644 --- a/doc/support.md +++ b/doc/support.md @@ -29,7 +29,7 @@ Feature releases : 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. + Feature releases are pushed out more often and contain new features as well as bugfixes. 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. From ecc001bb5d84aa0a6d74be996dfb94df3f3a2ce4 Mon Sep 17 00:00:00 2001 From: Thomas Parrott Date: Wed, 11 Dec 2024 08:53:24 +0000 Subject: [PATCH 5/6] doc/support: Clarified 6/stable series Signed-off-by: Thomas Parrott --- doc/support.md | 4 +++- 1 file changed, 3 insertions(+), 1 deletion(-) diff --git a/doc/support.md b/doc/support.md index cde4d6073f62..09d2d7b840de 100644 --- a/doc/support.md +++ b/doc/support.md @@ -26,7 +26,9 @@ 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), available from the `6/stable` channel. +: The current feature series is LXD 6.x (starting with 6.1). + This is available from the `6/stable` snap channel and will continue to follow the LXD 6.x series as it + progresses from a feature release series into an LTS release in 2026. See `snap info lxd` for a full list of available channels. Feature releases are pushed out more often and contain new features as well as bugfixes. From d61414d27e595a886df65da517996f2f381f6419 Mon Sep 17 00:00:00 2001 From: Thomas Parrott Date: Wed, 11 Dec 2024 09:01:57 +0000 Subject: [PATCH 6/6] doc/installing: Fix command tabbing Signed-off-by: Thomas Parrott --- doc/installing.md | 24 +++++++++++++++--------- 1 file changed, 15 insertions(+), 9 deletions(-) diff --git a/doc/installing.md b/doc/installing.md index 05f708172e1c..1381b3d13d9f 100644 --- a/doc/installing.md +++ b/doc/installing.md @@ -54,28 +54,34 @@ Complete the following steps to install the snap: For the current LTS release (**recommended** option), use: - sudo snap install lxd + ```bash + snap install lxd + ``` For the LXD 5.21 LTS release, use: - sudo snap install lxd --channel=5.21/stable + ```bash + sudo snap install lxd --channel=5.21/stable + ``` For the LXD 5.0 LTS release, use: - sudo snap install lxd --channel=5.0/stable + ```bash + 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="+" + snap install lxd --cohort="+" This can also be specified during refreshes (not required if done at install time): - snap refresh lxd --cohort="+" + 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= + 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). @@ -83,12 +89,12 @@ For more information about LXD snap packages (regarding more versions, update ma ```{note} On Ubuntu 18.04 LTS, if you previously had the LXD deb package installed, you can migrate all your existing data over by installing the 5.0 snap and running the following commands: - sudo install lxd --channel=5.0/stable - sudo lxd.migrate + sudo install lxd --channel=5.0/stable + sudo lxd.migrate After successfully running the `lxd.migrate` command, you can then switch to a newer snap channel if desired, like the 5.21 one: - sudo refresh lxd --channel=5.21/stable + sudo refresh lxd --channel=5.21/stable ``` If you want the current user to be able to interact with the LXD daemon, add it to the `lxd` group as the installation process does not add it for you: