CloudArchive

Differences between revisions 68 and 88 (spanning 20 versions)
Revision 68 as of 2019-06-26 20:39:45
Size: 3504
Editor: petermatulis
Comment:
Revision 88 as of 2020-11-03 12:45:05
Size: 5849
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 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 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.
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 cloud archive.  Update paths will exist for each !OpenStack release. For example, enabling “xenial-queens” will provide access to all !OpenStack Queens packages built for Ubuntu 16.04 LTS (binary and source), any updated dependencies required, and bug/security fixes made after release. 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 "cloud-archive:victoria" will provide access to all !OpenStack Victoria packages built for Ubuntu 20.04 LTS (binary and source), any updated dependencies required, and bug/security fixes published after release.
Line 10: Line 11:
There are no plans to make available !OpenStack packages for non-LTS releases in the cloud archive. 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.
Line 12: Line 13:
=== 14.04 === Any given UCA !OpenStack release can be enabled on exactly one Ubuntu LTS release.
Line 14: Line 15:
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. For more details on !OpenStack release end of life see: [[https://ubuntu.com/about/release-cycle#ubuntu-openstack-release-cycle | Ubuntu OpenStack release cycle]].
Line 16: Line 17:
=== 16.04 === === Reporting bugs ===
Line 18: Line 19:
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.

=== 18.04 ===

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.

For more details on !OpenStack release end of life see: https://www.ubuntu.com/info/release-end-of-life .

== Enabling the Cloud Archive ==

=== Stein ===

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
}}}

=== Ocata ===

NOTE: Ocata cloud archive only supported on Xenial.

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

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

== 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 86: Line 27:
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.

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

==== Victoria ====

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

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

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


== Package Back-Porting Policy ==

The packages in the cloud archive will follow a policy similar to Ubuntu release back-porting policy. For example, Openstack Train originated in Eoan and is back-ported to the Train cloud archive, and Openstack Queens originated in Bionic and is back-ported to the Queens cloud archive.

You may also refer to [[http://reqorts.qa.ubuntu.com/reports/ubuntu-server/cloud-archive/|these tables]] to see what the package version per Openstack release in the cloud archive. Here is an practical case of the qemu package. Openstack train originated in Eoan, and its qemu is 1.4.0-based. The default qemu version of Bionic is 1.2.0-based. Thus 1.4.0 is back-ported to the Bionic Train cloud archive. By using this Bionic Train cloud archive with your Ubuntu Bionic release, the original 1.2.0-based qemu in your Ubuntu Bionic system will be replaced/upgraded to 1.4.0-based qemu.

The Ubuntu Cloud Archive

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.

In order to allow for relatively easy upgrades, and still adhere to Ubuntu processes and policy, Canonical elected to have ubuntu-cloud.archive.canonical.com be the home of the cloud archive. Update paths will exist for each OpenStack release. For example, enabling "cloud-archive:victoria" will provide access to all OpenStack Victoria packages built for Ubuntu 20.04 LTS (binary and source), any updated dependencies required, and bug/security fixes published after release.

Packages go through various stages as they make their way towards a publicly available UCA release. See the Version Tracking page for details.

Any given UCA OpenStack release can be enabled on exactly one Ubuntu LTS release.

For more details on OpenStack release end of life see: Ubuntu OpenStack release cycle.

Reporting bugs

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.

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 Wallaby 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).

Victoria

sudo add-apt-repository cloud-archive:victoria

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

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

Package Back-Porting Policy

The packages in the cloud archive will follow a policy similar to Ubuntu release back-porting policy. For example, Openstack Train originated in Eoan and is back-ported to the Train cloud archive, and Openstack Queens originated in Bionic and is back-ported to the Queens cloud archive.

You may also refer to these tables to see what the package version per Openstack release in the cloud archive. Here is an practical case of the qemu package. Openstack train originated in Eoan, and its qemu is 1.4.0-based. The default qemu version of Bionic is 1.2.0-based. Thus 1.4.0 is back-ported to the Bionic Train cloud archive. By using this Bionic Train cloud archive with your Ubuntu Bionic release, the original 1.2.0-based qemu in your Ubuntu Bionic system will be replaced/upgraded to 1.4.0-based qemu.

OpenStack/CloudArchive (last edited 2020-11-03 12:45:05 by corey.bryant)