From 9aeb12f3ae1761fb5b4c0f9c5fb8150aca12c978 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Julian=20Peliz=C3=A4us?= Date: Wed, 11 Mar 2026 17:12:57 +0100 Subject: [PATCH 1/4] doc/reference/releaste-notes: Add page for 3.1 MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Signed-off-by: Julian Pelizäus (cherry picked from commit a966f460b2d5813bfc6c62055335107348440bf7) --- .../release-notes/release-notes-3.1.md | 63 +++++++++++++++++++ 1 file changed, 63 insertions(+) create mode 100644 doc/reference/release-notes/release-notes-3.1.md diff --git a/doc/reference/release-notes/release-notes-3.1.md b/doc/reference/release-notes/release-notes-3.1.md new file mode 100644 index 000000000..8ad29fd92 --- /dev/null +++ b/doc/reference/release-notes/release-notes-3.1.md @@ -0,0 +1,63 @@ +--- +myst: + html_meta: + description: Release notes for MicroCloud 3.1, including highlights about new features, bugfixes, and other updates from the MicroCloud project. +--- + +(ref-release-notes-3.1)= +# MicroCloud 3.1 release notes + +This is a {ref}`feature release ` and is not recommended for production use. +It's the first feature release of the new track 3. + +(ref-release-notes-3.1-highlights)= +## Highlights + +This section highlights new and improved features in this release. + +### Cluster Manager + +Cluster Manager allows you to manage and monitor multiple MicroCloud clusters in a single application. +Starting with this release, a MicroCloud can be connected to an existing deployment of Cluster Manager. + +Check {ref}`howto-cluster-manager` to deploy Cluster Manager. +The {ref}`howto-cluster-manager-requirements` section lists the requirements to get started. +See the {ref}`ref-cluster-manager-architecture` page for an in-depth view of the core components. + +If you already have a Cluster Manager deployment, see {ref}`howto-cluster-manager-enroll` to learn +how to enroll a MicroCloud cluster. + +### Temporary UI access link + +It's fast to deploy a MicroCloud and gain the ability to spawn resources with it from the command line. +To provide the same experience when {ref}`using the UI `, we added a new question to the end of the +interactive `microcloud init` questionnaire: + +`Would you like to create an initial UI access link? (yes/no) [default=yes]:` + +If you answer `yes` (default), MicroCloud creates a temporary UI access link that allows you to immediately enter +the LXD UI after MicroCloud is installed. +The temporary access lasts for 24 hours and is intended to perform further setups (such as configuring permanent access). + +This requires a 6+ version of LXD, which is currently a feature track (non-LTS). + +### MicroOVN 26.03 support (experimental) + +MicroCloud 3.1 can use MicroOVN 26.03, which is a feature release currently available through their `latest/edge` channel. Using this instead of the MicroOVN 24.03 LTS release (snap channel `24.03/stable`) allows us to test the latest features before the 26.03 release is published as the next LTS. + +Make sure you have the `core26` snap installed before trying to install MicroOVN from `latest/edge`: + +```bash +snap install core26 --channel="latest/edge" +snap install microovn --channel="latest/edge" --cohort="+" +``` + +## Upgrading to the new version + +If you are currently running MicroCloud 2 LTS, be aware that upgrading to track 3 is not yet recommended or supported for production clusters. +See the {ref}`howto-upgrade-microcloud` guide for information on how to switch the MicroCloud track. + +(ref-release-notes-3.1-changelog)= +## Change log + +View the [complete list of all changes in this release](https://github.com/canonical/microcloud/compare/2.1.0...3.1). From 293f610576c97b9e46cb0dd0a4dcb1a751050abb Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Julian=20Peliz=C3=A4us?= Date: Tue, 21 Apr 2026 07:59:47 +0200 Subject: [PATCH 2/4] doc/reference/release-notes: Apply suggestions also for 3.1 MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Signed-off-by: Julian Pelizäus (cherry picked from commit 134715a570f23b7c5472a872ebfdd36d527a13ea) --- doc/reference/release-notes/release-notes-3.1.md | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/doc/reference/release-notes/release-notes-3.1.md b/doc/reference/release-notes/release-notes-3.1.md index 8ad29fd92..b41d18d52 100644 --- a/doc/reference/release-notes/release-notes-3.1.md +++ b/doc/reference/release-notes/release-notes-3.1.md @@ -29,7 +29,7 @@ how to enroll a MicroCloud cluster. ### Temporary UI access link -It's fast to deploy a MicroCloud and gain the ability to spawn resources with it from the command line. +It's fast to deploy a MicroCloud and gain the ability to spawn resources from the command line. To provide the same experience when {ref}`using the UI `, we added a new question to the end of the interactive `microcloud init` questionnaire: @@ -37,7 +37,7 @@ interactive `microcloud init` questionnaire: If you answer `yes` (default), MicroCloud creates a temporary UI access link that allows you to immediately enter the LXD UI after MicroCloud is installed. -The temporary access lasts for 24 hours and is intended to perform further setups (such as configuring permanent access). +The temporary access lasts for 24 hours and is intended to allow you to perform further setup (such as configuring permanent access). This requires a 6+ version of LXD, which is currently a feature track (non-LTS). From d3bacff96aa73af1354ac2bf146246ec7d31bd30 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Julian=20Peliz=C3=A4us?= Date: Mon, 20 Apr 2026 16:23:44 +0200 Subject: [PATCH 3/4] doc/reference/release-notes: Add 3.2 MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Signed-off-by: Julian Pelizäus (cherry picked from commit ec3c40603ace40ee83d0fd525adb9096258b0151) --- .../release-notes/release-notes-3.2.md | 33 +++++++++++++++++++ 1 file changed, 33 insertions(+) create mode 100644 doc/reference/release-notes/release-notes-3.2.md diff --git a/doc/reference/release-notes/release-notes-3.2.md b/doc/reference/release-notes/release-notes-3.2.md new file mode 100644 index 000000000..935ce51df --- /dev/null +++ b/doc/reference/release-notes/release-notes-3.2.md @@ -0,0 +1,33 @@ +--- +myst: + html_meta: + description: Release notes for MicroCloud 3.2, including highlights about new features, bugfixes, and other updates from the MicroCloud project. +--- + +(ref-release-notes-3.2)= +# MicroCloud 3.2 release notes + +This is a {ref}`feature release ` and is not recommended for production use. +It's the second feature release of track 3. + +(ref-release-notes-3.2-highlights)= +## Highlights + +This section highlights new and improved features in this release. + +### LXD 6.8 support + +{ref}`LXD 6.8 ` changed many of its API endpoints to be asynchronous (such as storage and network creation). +MicroCloud 3.2 accommodates those changes when creating resources in LXD. + +## Upgrading to the new version + +If you are currently running MicroCloud 2 LTS, be aware that upgrading to track 3 is not yet recommended or supported for production clusters. +See the {ref}`howto-upgrade` guide for information on how to switch the MicroCloud track. + +If you are currently using an earlier release of MicroCloud 3, refer to the {ref}`howto-update` guide for information on how to retrieve and use the latest release on the same track. + +(ref-release-notes-3.2-changelog)= +## Change log + +View the [complete list of all changes in this release](https://github.com/canonical/microcloud/compare/3.1...3.2). From 5ba0b8d880adf0e73fdae7563d68d36fc856efe9 Mon Sep 17 00:00:00 2001 From: Elijah Greenstein Date: Mon, 10 Aug 2026 10:24:40 -0700 Subject: [PATCH 4/4] doc: update MicroCloud 3 release notes in TOC MicroCloud 3.1 and 3.2 release notes have been backported to MicroCloud 2. This commit updates the TOC to use those pages rather than linking out to the `latest` version. Signed-off-by: Elijah Greenstein --- doc/reference/release-notes/index.md | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/doc/reference/release-notes/index.md b/doc/reference/release-notes/index.md index 11f5422fe..ab965a129 100644 --- a/doc/reference/release-notes/index.md +++ b/doc/reference/release-notes/index.md @@ -25,8 +25,8 @@ For full instructions on updating or upgrading MicroCloud, refer to {ref}`howto- ```{toctree} :titlesonly: -MicroCloud 3.2 -MicroCloud 3.1 +MicroCloud 3.2 +MicroCloud 3.1 MicroCloud 2.1.3 LTS MicroCloud 2.1.2 LTS MicroCloud 2.1.1 LTS