diff --git a/doc/source/install/get-started.rst b/doc/source/install/get-started.rst index 5d619d87de..640c1bd354 100644 --- a/doc/source/install/get-started.rst +++ b/doc/source/install/get-started.rst @@ -41,6 +41,18 @@ The OpenStack Image service includes the following components: glance-api Accepts Image API calls for image discovery, retrieval, and storage. + .. note:: + + An OpenStack Community Goal in the Pike release was `Control Plane API + endpoints deployment via WSGI`_. As currently constituted, however, + glance-api is **not suitable** to be run in such a configuration. Instead + we recommend that Glance be run in the traditional manner as a standalone + server. See the "Known Issues" section of the `Glance Release Notes`_ for + the Pike and Queens releases for more information. + + .. _`Control Plane API endpoints deployment via WSGI`: https://governance.openstack.org/tc/goals/pike/deploy-api-in-wsgi.html + .. _`Glance Release Notes`: https://docs.openstack.org/releasenotes/glance/index.html + glance-registry Stores, processes, and retrieves metadata about images. Metadata includes items such as size and type. diff --git a/doc/source/install/index.rst b/doc/source/install/index.rst index 519df884c4..dabb61c77e 100644 --- a/doc/source/install/index.rst +++ b/doc/source/install/index.rst @@ -24,22 +24,33 @@ install.rst verify.rst -Ocata -~~~~~ -To install Glance, see the Ocata Image service install guide for +Supported Releases +================== + +Queens (Latest Release) +~~~~~~~~~~~~~~~~~~~~~~~ + +To install Glance, see the Queens Image service install guide for each distribution: -- `Ubuntu `__ -- `CentOS and RHEL `__ -- `openSUSE and SUSE Linux Enterprise `__ +- `Ubuntu `__ +- `CentOS and RHEL `__ +- `openSUSE and SUSE Linux Enterprise `__ -Newton -~~~~~~ +Pike (Maintained Release) +~~~~~~~~~~~~~~~~~~~~~~~~~ -To install Glance, see the Newton Image service install guide for +To install Glance, see the Pike Image service install guide for each distribution: -- `Ubuntu `__ -- `CentOS and RHEL `__ -- `openSUSE and SUSE Linux Enterprise `__ +- `Ubuntu `__ +- `CentOS and RHEL `__ +- `openSUSE and SUSE Linux Enterprise `__ + +Ocata (Legacy Release) +~~~~~~~~~~~~~~~~~~~~~~ + +To install Glance, see the `Ocata Image service install guide`_. + +.. _`Ocata Image service install guide`: https://docs.openstack.org/glance/ocata/installing.html