CloudArchive

Differences between revisions 78 and 80 (spanning 2 versions)
Revision 78 as of 2020-06-11 18:34:15
Size: 4364
Editor: petermatulis
Comment: Add a link to the version tracker (finally)
Revision 80 as of 2020-07-06 22:17:48
Size: 6072
Editor: petermatulis
Comment: Ceph and Juju additions
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 9: Line 9:
[[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. [[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.
Line 11: 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 pocket. See the [[OpenStack/VersionTracking | Version Tracking]] page for details.
Line 13: Line 13:
A UCA !OpenStack release can be enabled on exactly one Ubuntu LTS release.
Line 14: Line 15:
=== 20.04 === 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:
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. === Reporting bugs ===
Line 18: Line 19:
=== 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.

=== 16.04 ===

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.

=== 14.04 ===

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

== Enabling the Cloud Archive ==

=== Ussuri ===

NOTE: Ussuri cloud archive only supported on Bionic.

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

=== Train ===

NOTE: Train cloud archive only supported on Bionic.

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

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

=== 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 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. An !OpenStack release is therefore available (in the UCA) to an LTS release six months after its own release, coinciding with the next release of Ubuntu. As !OpenStack releases become available in the UCA and as releases fall out of support this section will be updated.

The UCA can be leveraged in two ways. With:

 1. Traditional tooling
 1. Juju !OpenStack charms

=== Traditional tooling ===

With traditional tooling, 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.

==== 20.04 ====

On Ubuntu 20.04 LTS, !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).

==== 18.04 ====

On Ubuntu 18.04 LTS, !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
}}}

==== 16.04 ====

On Ubuntu 16.04 LTS, !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
}}}

==== 14.04 ====

On Ubuntu 14.04 LTS, !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
}}}

=== Juju OpenStack charms ===

The UCA is made available to [[https://docs.openstack.org/charm-guide/ | Charmed OpenStack]] through a configuration option passed to a charm at deployment time.

There are two configuration options available, depending on whether the software is an actual !OpenStack project or whether it is considered supportive of !OpenStack:

 * `openstack-origin`
 * `source`

The special value of 'distro' given to either of these options designates the normal package archives available to a Juju machine's Ubuntu release.

Examples:

 1. Deploy Keystone from !OpenStack Train on Bionic

 {{{
 juju deploy --config openstack-origin=cloud:bionic-train keystone
 }}}

 1. Deploy a Ceph OSD that is compatible with Charmed !OpenStack Train on Bionic

 {{{
 juju deploy --config source=cloud:bionic-train ceph-osd
 }}}

Although this information is passed to an individual charm, the underlying host is nonetheless configured system-wide. The end result is equivalent to that of the traditional tooling method.

== Ceph and the UCA ==

The below table shows the mapping of UCA pocket to Ceph release, and includes what will result from a Ubuntu release's default archive ("distro").

|| '''Ceph release''' || '''Default archive''' || '''UCA pocket''' ||
|| Octopus || Focal || - ||
|| Octopus || - || bionic-ussuri ||
|| Nautilus || - || bionic-train ||
|| Nautilus || - || bionic-stein ||
|| Mimic || - || bionic-rocky ||
|| Luminous || Bionic || - ||
|| Luminous || - || xenial-queens ||
|| Jewel || Xenial || - ||
|| Jewel || - || trusty-mitaka ||
|| Firefly || Trusty || - ||

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

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

A 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. An OpenStack release is therefore available (in the UCA) to an LTS release six months after its own release, coinciding with the next release of Ubuntu. As OpenStack releases become available in the UCA and as releases fall out of support this section will be updated.

The UCA can be leveraged in two ways. With:

  1. Traditional tooling
  2. Juju OpenStack charms

Traditional tooling

With traditional tooling, 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.

20.04

On Ubuntu 20.04 LTS, 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).

18.04

On Ubuntu 18.04 LTS, 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

16.04

On Ubuntu 16.04 LTS, 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

14.04

On Ubuntu 14.04 LTS, 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

Juju OpenStack charms

The UCA is made available to Charmed OpenStack through a configuration option passed to a charm at deployment time.

There are two configuration options available, depending on whether the software is an actual OpenStack project or whether it is considered supportive of OpenStack:

  • openstack-origin

  • source

The special value of 'distro' given to either of these options designates the normal package archives available to a Juju machine's Ubuntu release.

Examples:

  1. Deploy Keystone from OpenStack Train on Bionic

     juju deploy --config openstack-origin=cloud:bionic-train keystone
  2. Deploy a Ceph OSD that is compatible with Charmed OpenStack Train on Bionic

     juju deploy --config source=cloud:bionic-train ceph-osd

Although this information is passed to an individual charm, the underlying host is nonetheless configured system-wide. The end result is equivalent to that of the traditional tooling method.

Ceph and the UCA

The below table shows the mapping of UCA pocket to Ceph release, and includes what will result from a Ubuntu release's default archive ("distro").

Ceph release

Default archive

UCA pocket

Octopus

Focal

-

Octopus

-

bionic-ussuri

Nautilus

-

bionic-train

Nautilus

-

bionic-stein

Mimic

-

bionic-rocky

Luminous

Bionic

-

Luminous

-

xenial-queens

Jewel

Xenial

-

Jewel

-

trusty-mitaka

Firefly

Trusty

-

OpenStack/CloudArchive (last edited 2023-10-12 16:47:30 by corey.bryant)