Skip to content

Commit

Permalink
Doc: Remove monthly from feature release (#14637)
Browse files Browse the repository at this point in the history
Closes #14634
  • Loading branch information
tomponline authored Dec 11, 2024
2 parents 37db5e2 + d61414d commit b0c8364
Show file tree
Hide file tree
Showing 4 changed files with 23 additions and 15 deletions.
2 changes: 1 addition & 1 deletion README.md
Original file line number Diff line number Diff line change
Expand Up @@ -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.
Expand Down
4 changes: 2 additions & 2 deletions SECURITY.md
Original file line number Diff line number Diff line change
Expand Up @@ -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
Expand Down
26 changes: 16 additions & 10 deletions doc/installing.md
Original file line number Diff line number Diff line change
Expand Up @@ -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.

Expand Down Expand Up @@ -54,41 +54,47 @@ 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<howto-snap-cohort>`. 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=<revision_number>
snap install lxd --revision=<revision_number>
```
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}
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:
Expand Down
6 changes: 4 additions & 2 deletions doc/support.md
Original file line number Diff line number Diff line change
Expand Up @@ -26,10 +26,12 @@ 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 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.

Expand Down

0 comments on commit b0c8364

Please sign in to comment.