CloudArchive

Differences between revisions 48 and 107 (spanning 59 versions)
Revision 48 as of 2017-03-03 13:19:23
Size: 3344
Editor: corey.bryant
Comment:
Revision 107 as of 2023-10-12 16:47:30
Size: 5756
Editor: corey.bryant
Comment:
Deletions are marked like this. Additions are marked like this.
Line 6: Line 6:
Canonical’s Ubuntu Cloud archive allows users the ability to install newer releases of !OpenStack on an Ubuntu Server (starting with 12.04) 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: Line 8:
In order to allow for relatively easy upgrades, and still adhere to Ubuntu processes and policy, Canonical elected to have archive.canonical.com be the home of the Ubuntu Cloud archive. They will enable update paths for each !OpenStack 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 10: Line 10:
 * e.g. Enabling “xenial-ocata” in the archive will provide access to all !OpenStack Ocata packages built for Ubuntu Server 16.04 LTS (binary and source), any updated dependencies required, and bug/security fixes made after release. == SRU process ==
Line 12: Line 12:
As of now, Canonical has no plans to build or host !OpenStack packages for non-LTS releases of Ubuntu Server in the Ubuntu Cloud archive. 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.
Line 14: Line 14:
=== 14.04 ===
Starting with the Ubuntu Server 14.10 release, newer releases of !OpenStack will be available via Cloud archive for the Ubuntu Server 14.04 LTS release. Juno and Liberty will be supported for 18 months each, and Liberty for 36 months. Mitaka, 16.04's !OpenStack version, is supported in the Cloud Archive for 3 years, i.e. until the end of the Ubuntu 14.04 LTS lifecycle.
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:
Line 17: Line 16:
=== 16.04 ===
Starting with the Ubuntu Server 16.10 release, newer releases of !OpenStack will be available via Cloud archive for the Ubuntu Server 16.04 LTS release. Newton and Pike will be supported for 18 months each, and Ocata for 36 months. When 18.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 16.04 LTS lifecycle.
'''lunar -> antelope-staging -> antelope-proposed -> antelope-updates'''
Line 20: Line 18:
For more details on !OpenStack release end of life and charts see: https://www.ubuntu.com/info/release-end-of-life When backporting fixes to an existing UCA release the original Ubuntu release must also get the update:
Line 22: Line 20:
== How to Enable and Use == '''lunar-proposed -> antelope-staging -> antelope-proposed'''
Line 24: Line 22:
=== Ocata === 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 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. When 24.04's default !OpenStack version (Caracal) is released it will be added to the UCA with support for 36 months (i.e. until the end of the Ubuntu 22.04 LTS lifecycle).

==== 2023.2 Bobcat ====
Line 26: Line 39:
NOTE: Ocata cloud archive only supported on Xenial

sudo add-apt-repository cloud-archive:ocata
sudo add-apt-repository cloud-archive:bobcat
Line 31: Line 42:
=== Newton === ==== 2023.1 Antelope ====
Line 33: Line 45:
NOTE: Newton cloud archive only supported on Xenial

sudo add-apt-repository cloud-archive:newton
sudo add-apt-repository cloud-archive:antelope
Line 38: Line 48:
==== Zed ====
Line 39: Line 50:
=== Mitaka ===
Line 41: Line 51:
NOTE: Mitaka cloud archive only supported on Trusty

sudo add-apt-repository cloud-archive:mitaka
sudo add-apt-repository cloud-archive:zed
Line 46: Line 54:
=== Liberty === === 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 ====
Line 48: Line 61:
NOTE: Liberty cloud archive only supported on Trusty

sudo add-apt-repository cloud-archive:liberty
sudo add-apt-repository cloud-archive:yoga
Line 53: Line 64:
==== Xena ====
Line 54: Line 66:
=== Kilo ===
Line 56: Line 67:
NOTE: Kilo cloud archive only supported on Trusty

sudo add-apt-repository cloud-archive:kilo
sudo add-apt-repository cloud-archive:xena
Line 61: Line 70:
==== Wallaby ====
Line 62: Line 72:
=== Icehouse ===
Line 64: Line 73:
NOTE: Precise only - Icehouse is the base !OpenStack release in Trusty

sudo add-apt-repository cloud-archive:icehouse
sudo add-apt-repository cloud-archive:wallaby
Line 69: Line 76:
=== Then run: === === 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 71: Line 83:
sudo apt-get update
}}}
to update your package listings and then proceed to install/upgrade your !OpenStack packages.
sudo add-apt-repository cloud-archive:ussuri
}}}
Line 75: Line 86:
== Reporting Bugs == == Ceph and the UCA ==
Line 77: Line 88:
To report bugs against packages from the Ubuntu Cloud Archive, please use the 'ubuntu-bug' tool, for example: 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''' ||
|| 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:
Line 83: Line 117:
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.

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 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. When 24.04's default OpenStack version (Caracal) is released it will be added to the UCA with support for 36 months (i.e. until the end of the Ubuntu 22.04 LTS lifecycle).

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

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 2023-10-12 16:47:30 by corey.bryant)