Diff for "OpenStack/CloudArchive"

CloudArchive

Differences between revisions 78 and 110 (spanning 32 versions)

Contents

The Ubuntu Cloud Archive
SRU process
Using the UCA
Ceph and the UCA
Reporting a bug

The Ubuntu Cloud Archive

Canonical’s Ubuntu Cloud Archive (UCA) gives users the ability to install backported OpenStack versions on Ubuntu LTS releases.

The Ubuntu and OpenStack projects publish new releases every six months at approximately the same time. Each Ubuntu release therefore includes a new OpenStack version by default. It is this OpenStack version that is backported to the latest LTS via the UCA. The Ubuntu OpenStack release cycle graphic represents this scheme visually over time.

SRU process

The SRU process for OpenStack and the UCA is used during the development of a new UCA release and when backporting any updated dependencies and bug/security fixes to an existing UCA release.

For example, in terms of a new UCA release, Ubuntu Lunar ships with OpenStack 2023.1 Antelope by default. In this timeframe, the latest LTS is Ubuntu 22.04 (Jammy). Antelope packages (binary and source) are therefore backported to Jammy via the Antelope UCA release. In order for this to happen, individual Lunar packages are backported according to this staged process:

lunar -> antelope-staging -> antelope-proposed -> antelope-updates

When backporting fixes to an existing UCA release the original Ubuntu release must also get the update:

lunar-proposed -> antelope-staging -> antelope-proposed

When Lunar reaches end-of-life, Antelope package updates will be uploaded directly to the Antelope UCA.

This process can be monitored live with the Ubuntu Cloud Archive Tracker. It includes package versions for each of the above stages and for all UCA releases. The first column in the tracker is Ubuntu and represents the first stage in the above two scenarios.

Using the UCA

The release schedule of OpenStack and Ubuntu are generally synchronised: a new OpenStack release becomes available in the UCA every six months and coincides with each release of Ubuntu. As OpenStack releases are added to the UCA and as releases fall out of support this section will be updated.

A UCA OpenStack release is enabled on a host with the add-apt-repository command (it is recommended to run sudo apt update both before and after).

Ubuntu 24.04 LTS

On 24.04, OpenStack Dalmatian (non-SLURP) is supported for 9 months, OpenStack Epoxy for 36 months.

2025.1 Epoxy

sudo add-apt-repository cloud-archive:epoxy

2024.2 Dalmatian

sudo add-apt-repository cloud-archive:dalmatian

Ubuntu 22.04 LTS

On 22.04, OpenStack Zed is supported for 18 months, OpenStack Antelope for 36 months, and OpenStack Bobcat (non-SLURP) is supported for 9 months. 24.04's default OpenStack version (Caracal) is supported in the UCA for 36 months (i.e. until the end of the Ubuntu 22.04 LTS lifecycle).

2024.1 Caracal

sudo add-apt-repository cloud-archive:caracal

2023.2 Bobcat

sudo add-apt-repository cloud-archive:bobcat

2023.1 Antelope

sudo add-apt-repository cloud-archive:antelope

Zed

sudo add-apt-repository cloud-archive:zed

Ubuntu 20.04 LTS

On 20.04, OpenStack Victoria and OpenStack Xena are supported for 18 months each, and OpenStack Wallaby for 36 months. 22.04's default OpenStack version (Yoga) is supported in the UCA for 36 months (i.e. until the end of the Ubuntu 20.04 LTS lifecycle).

Yoga

sudo add-apt-repository cloud-archive:yoga

Xena

sudo add-apt-repository cloud-archive:xena

Wallaby

sudo add-apt-repository cloud-archive:wallaby

Ubuntu 18.04 LTS

On 18.04, OpenStack Rocky and OpenStack Train are supported for 18 months each, and OpenStack Stein for 36 months. OpenStack Ussuri, 20.04's default OpenStack version, is supported in the UCA for 36 months (i.e. until the end of the Ubuntu 18.04 LTS lifecycle).

Ussuri

sudo add-apt-repository cloud-archive:ussuri

Ceph and the UCA

The below table shows the relationship between UCA release, Ceph release, Ubuntu LTS release, and Ubuntu default archive ("distro").

Ceph release	Default archive	UCA release	Ubuntu LTS release
Squid	yes	-	Noble
Squid	-	jammy-caracal	Jammy
Reef	-	jammy-bobcat	Jammy
Quincy	yes	-	Jammy
Quincy	-	focal-yoga	Focal
Pacific	-	focal-xena	Focal
Pacific	-	focal-wallaby	Focal
Octopus	yes	-	Focal
Octopus	-	bionic-ussuri	Bionic
Nautilus	-	bionic-train	Bionic
Mimic	-	bionic-stein	Bionic
Mimic	-	bionic-rocky	Bionic
Luminous	yes	-	Bionic
Luminous	-	xenial-queens	Xenial
Jewel	yes	-	Xenial
Jewel	-	trusty-mitaka	Trusty
Firefly	yes	-	Trusty

Reporting a bug

To report bugs against packages from the UCA, please use the ubuntu-bug tool.

For example:

ubuntu-bug nova-compute

This will ensure that bugs are raised against the cloud-archive project on Launchpad.

OpenStack/CloudArchive (last edited 2025-05-21 14:44:58 by gboutry)

-  ⇤ ← Revision 78 as of 2020-06-11 18:34:15 → 
  Size: 4364
  Editor: petermatulis
  Comment: Add a link to the version tracker (finally)
+   ← Revision 110 as of 2025-05-21 14:44:58 → ⇥
  Size: 6250
  Editor: gboutry
  Comment:
-Deletions are marked like this.
+Additions are marked like this.
 Line 6:
-Canonical’s Ubuntu Cloud Archive (UCA) gives users the ability to install newer releases of !OpenStack on an Ubuntu LTS release as they become available up through the next Ubuntu LTS release.  Bug processing and patch contributions will follow standard Ubuntu practice and policy where applicable.
+Canonical’s [[https://ubuntu-cloud.archive.canonical.com | Ubuntu Cloud Archive (UCA)]] gives users the ability to install backported !OpenStack versions on Ubuntu LTS releases.
 Line 8:
-In order to allow for relatively easy upgrades, and still adhere to Ubuntu processes and policy, Canonical elected to have 	
[[http://ubuntu-cloud.archive.canonical.com/|ubuntu-cloud.archive.canonical.com]] be the home of the cloud archive.  Update paths will exist for each !OpenStack release. For example, enabling “bionic-ussuri” will provide access to all !OpenStack Ussuri packages built for Ubuntu 18.04 LTS (binary and source), any updated dependencies required, and bug/security fixes made after release.
+The [[https://wiki.ubuntu.com/Releases | Ubuntu]] and [[https://releases.openstack.org/ | OpenStack]] projects publish new releases every six months at approximately the same time. Each Ubuntu release therefore includes a new !OpenStack version by default. It is this !OpenStack version that is backported to the latest LTS via the UCA. The [[https://ubuntu.com/about/release-cycle#openstack-release-cycle | Ubuntu OpenStack release cycle]] graphic represents this scheme visually over time.
-Line 11:
+Line 10:
-There are no plans to make available !OpenStack packages for non-LTS releases in the cloud archive.
+== SRU process ==

The [[OpenStack/StableReleaseUpdates | SRU process for OpenStack and the UCA]] is used during the development of a new UCA release and when backporting any updated dependencies and bug/security fixes to an existing UCA release.

For example, in terms of a new UCA release, Ubuntu Lunar ships with !OpenStack 2023.1 Antelope by default. In this timeframe, the latest LTS is Ubuntu 22.04 (Jammy). Antelope packages (binary and source) are therefore backported to Jammy via the Antelope UCA release. In order for this to happen, individual Lunar packages are backported according to this staged process:

'''lunar -> antelope-staging -> antelope-proposed -> antelope-updates'''

When backporting fixes to an existing UCA release the original Ubuntu release must also get the update:

'''lunar-proposed -> antelope-staging -> antelope-proposed'''

When Lunar reaches end-of-life, Antelope package updates will be uploaded directly to the Antelope UCA.

This process can be monitored live with the [[https://openstack-ci-reports.ubuntu.com/reports/cloud-archive/index.html | Ubuntu Cloud Archive Tracker]]. It includes package versions for each of the above stages and for all UCA releases. The first column in the tracker is '''Ubuntu''' and represents the first stage in the above two scenarios.

== Using the UCA ==

The release schedule of !OpenStack and Ubuntu are generally synchronised: a new !OpenStack release becomes available in the UCA every six months and coincides with each release of Ubuntu. As !OpenStack releases are added to the UCA and as releases fall out of support this section will be updated.

A UCA !OpenStack release is enabled on a host with the `add-apt-repository` command (it is recommended to run `sudo apt update` both before and after).

=== Ubuntu 24.04 LTS ===

On 24.04, !OpenStack Dalmatian (non-SLURP) is supported for 9 months, !OpenStack Epoxy for 36 months.

==== 2025.1 Epoxy ====

{{{
sudo add-apt-repository cloud-archive:epoxy
}}}

==== 2024.2 Dalmatian ====

{{{
sudo add-apt-repository cloud-archive:dalmatian
}}}

=== Ubuntu 22.04 LTS ===

On 22.04, !OpenStack Zed is supported for 18 months, !OpenStack Antelope for 36 months, and !OpenStack Bobcat (non-SLURP) is supported for 9 months. 24.04's default !OpenStack version (Caracal) is supported in the UCA for 36 months (i.e. until the end of the Ubuntu 22.04 LTS lifecycle).

==== 2024.1 Caracal ====

{{{
sudo add-apt-repository cloud-archive:caracal
}}}
-Line 14:
+Line 59:
-=== 20.04 ===
+==== 2023.2 Bobcat ====
-Line 16:
+Line 61:
-Starting with Ubuntu 20.10, newer releases of !OpenStack are available via cloud archive for Ubuntu 20.04 LTS.  Victoria and !OpenStack X are supported for 18 months each, and !OpenStack W for 36 months.  When 22.04's !OpenStack version is released that will be added to the cloud archive with support for 3 years, i.e. until the end of the Ubuntu 20.04 LTS lifecycle.
+{{{
sudo add-apt-repository cloud-archive:bobcat
}}}
-Line 18:
+Line 65:
-=== 18.04 ===
+==== 2023.1 Antelope ====
-Line 20:
+Line 67:
-Starting with Ubuntu 18.10, newer releases of !OpenStack are available via cloud archive for Ubuntu 18.04 LTS.  Rocky and Train are supported for 18 months each, and Stein for 36 months.  When 20.04's !OpenStack version is released that will be added to the cloud archive with support for 3 years, i.e. until the end of the Ubuntu 18.04 LTS lifecycle.
+{{{
sudo add-apt-repository cloud-archive:antelope
}}}
-Line 22:
+Line 71:
-=== 16.04 ===
+==== Zed ====
-Line 24:
+Line 73:
-Starting with Ubuntu 16.10, newer releases of !OpenStack are available via cloud archive for Ubuntu 16.04 LTS.  Newton and Pike are supported for 18 months each, and Ocata for 36 months.  Queens, 18.04's default !OpenStack version, is supported in the cloud archive for 3 years, i.e. until the end of the Ubuntu 16.04 LTS lifecycle.
+{{{
sudo add-apt-repository cloud-archive:zed
}}}
-Line 26:
+Line 77:
-=== 14.04 ===
+=== Ubuntu 20.04 LTS ===
-Line 28:
+Line 79:
-Starting with Ubuntu 14.10, newer releases of !OpenStack are available via cloud archive for Ubuntu 14.04 LTS.  Juno and Liberty are supported for 18 months each, and Kilo for 36 months.  Mitaka, 16.04's default !OpenStack version, is supported in the cloud archive for 3 years, i.e. until the end of the Ubuntu 14.04 LTS lifecycle.
+On 20.04, !OpenStack Victoria and !OpenStack Xena are supported for 18 months each, and !OpenStack Wallaby for 36 months. 22.04's default !OpenStack version (Yoga) is supported in the UCA for 36 months (i.e. until the end of the Ubuntu 20.04 LTS lifecycle).
-Line 30:
+Line 81:
-For more details on !OpenStack release end of life see: [[https://ubuntu.com/about/release-cycle#ubuntu-openstack-release-cycle|Ubuntu OpenStack release cycle]].
+==== Yoga ====
-Line 32:
+Line 83:
-== Enabling the Cloud Archive ==
+{{{
sudo add-apt-repository cloud-archive:yoga
}}}
-Line 34:
+Line 87:
-=== Ussuri ===
+==== Xena ====
-Line 36:
+Line 89:
-NOTE: Ussuri cloud archive only supported on Bionic.
+{{{
sudo add-apt-repository cloud-archive:xena
}}}

==== Wallaby ====

{{{
sudo add-apt-repository cloud-archive:wallaby
}}}

=== Ubuntu 18.04 LTS ===

On 18.04, !OpenStack Rocky and !OpenStack Train are supported for 18 months each, and !OpenStack Stein for 36 months. !OpenStack Ussuri, 20.04's default !OpenStack version, is supported in the UCA for 36 months (i.e. until the end of the Ubuntu 18.04 LTS lifecycle).

==== Ussuri ====
-Line 42:
+Line 109:
-=== Train ===
+== Ceph and the UCA ==
-Line 44:
+Line 111:
-NOTE: Train cloud archive only supported on Bionic.
+The below table shows the relationship between UCA release, Ceph release, Ubuntu LTS release, and Ubuntu default archive ("distro").
-Line 46:
+Line 113:
-{{{
sudo add-apt-repository cloud-archive:train
}}}
+|| '''Ceph release''' || '''Default archive''' || '''UCA release'''    || '''Ubuntu LTS release''' ||
|| Squid        || yes             || -             || Noble  ||
|| Squid        || -               || jammy-caracal || Jammy  ||
|| Reef         || -               || jammy-bobcat  || Jammy  ||
|| Quincy       || yes             || -             || Jammy  ||
|| Quincy       || -               || focal-yoga    || Focal  ||
|| Pacific      || -               || focal-xena    || Focal  ||
|| Pacific      || -               || focal-wallaby || Focal  ||
|| Octopus      || yes             || -             || Focal  ||
|| Octopus      || -               || bionic-ussuri || Bionic ||
|| Nautilus     || -               || bionic-train  || Bionic ||
|| Mimic        || -               || bionic-stein  || Bionic ||
|| Mimic        || -               || bionic-rocky  || Bionic ||
|| Luminous     || yes             || -             || Bionic ||
|| Luminous     || -               || xenial-queens || Xenial ||
|| Jewel        || yes             || -             || Xenial ||
|| Jewel        || -               || trusty-mitaka || Trusty ||
|| Firefly      || yes             || -             || Trusty ||
-Line 50:
+Line 132:
-=== Stein ===
+== Reporting a bug ==
-Line 52:
+Line 134:
-NOTE: Stein cloud archive only supported on Bionic.

{{{
sudo add-apt-repository cloud-archive:stein
}}}

=== Rocky ===

NOTE: Rocky cloud archive only supported on Bionic.

{{{
sudo add-apt-repository cloud-archive:rocky
}}}

=== Queens ===

NOTE: Queens cloud archive only supported on Xenial (Bionic includes Queens by default).

{{{
sudo add-apt-repository cloud-archive:queens
}}}

=== Mitaka ===

NOTE: Mitaka cloud archive only supported on Trusty (Xenial includes Mitaka by default)

{{{
sudo add-apt-repository cloud-archive:mitaka
}}}

== Updating package listings ==

After having enabled a cloud archive, update your package listings before attempting to install/upgrade your !OpenStack packages.

{{{
sudo apt update
}}}

== Ubuntu OpenStack Version Tracking ==

Packages go through various stages as they make their way towards a publicly available UCA pocket. See the [[OpenStack/VersionTracking|Version Tracking]] page for details.

== Reporting bugs ==

To report bugs against packages from the Ubuntu Cloud Archive, please use the 'ubuntu-bug' tool.
+To report bugs against packages from the UCA, please use the `ubuntu-bug` tool.
-Line 104:
+Line 142:
-This will ensure that bugs are raised against the cloud-archive project on Launchpad.
+This will ensure that bugs are raised against the [[https://launchpad.net/cloud-archive | cloud-archive]] project on Launchpad.

Ubuntu Wiki