CloudArchive

Differences between revisions 83 and 106 (spanning 23 versions)
⇤ ← Revision 83 as of 2020-07-22 14:56:04 →
Size: 4909
Editor: tiago.pasqualini
Comment:
← Revision 106 as of 2023-10-12 16:45:42 → ⇥
Size: 5750
Editor: corey.bryant
Comment:
Deletions are marked like this. Additions are marked like this.
Line 6: Line 6:
Canonical’s Ubuntu Cloud Archive (UCA) gives users the ability to install newer releases of !OpenStack on an Ubuntu LTS release (only) as they become available up through to 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
[[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 published 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:
Packages go through various stages as they make their way towards a publicly available UCA release. See the [[OpenStack/VersionTracking | Version Tracking]] page for details. == SRU process ==
Line 13: Line 12:
Any given UCA !OpenStack release can be enabled on exactly one Ubuntu LTS release. 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 15: Line 14:
For more details on !OpenStack release end of life see: [[https://ubuntu.com/about/release-cycle#ubuntu-openstack-release-cycle | Ubuntu OpenStack release cycle]]. 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:
=== Reporting bugs === '''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 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 3 years (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 3 years (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 3 years (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 ==
Line 28: Line 118:

== 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.

'''Important''': It is good practice to run `sudo apt update` both before and after the `add-apt-repository` command.

=== Ubuntu 20.04 LTS ===

On 20.04, !OpenStack Victoria and !OpenStack X are supported for 18 months each, and !OpenStack W for 36 months. When 22.04's default !OpenStack version is released it will be added to the UCA with support for 3 years (i.e. until the end of the Ubuntu 20.04 LTS lifecycle).

=== Ubuntu 18.04 LTS ===

On 18.04, !OpenStack Rocky and !OpenStack Train are supported for 18 months each, and !OpenStack Stein for 36 months. When 20.04's default !OpenStack version is released it will be added to the UCA with support for 3 years (i.e. until the end of the Ubuntu 18.04 LTS lifecycle).

==== Ussuri ====

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

==== Train ====

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

==== Stein ====

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

==== Rocky ====

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

=== Ubuntu 16.04 LTS ===

On 16.04, !OpenStack Newton and !OpenStack Pike are supported for 18 months each, and !OpenStack Ocata for 36 months. !OpenStack Queens, 18.04's default !OpenStack version, is supported in the UCA for 3 years (i.e. until the end of the Ubuntu 16.04 LTS lifecycle).

==== Queens ====

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

=== Ubuntu 14.04 LTS ===

On 14.04, !OpenStack Juno and !OpenStack Liberty are supported for 18 months each, and !OpenStack Kilo for 36 months. !OpenStack Mitaka, 16.04's default !OpenStack version, is supported in the UCA for 3 years (i.e. until the end of the Ubuntu 14.04 LTS lifecycle).

==== Mitaka ====

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

== Ceph and the UCA ==

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

|| '''Ceph release''' || '''Default archive''' || '''UCA release''' || '''Ubuntu release''' ||
|| 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 ||

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 3 years (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 3 years (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 3 years (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 2025-05-21 14:44:58 by gboutry)