Create 2017.08 Guideline

Create the 2017.08 Guideline candidate, to be moved from review to
approved status if and when approved by the OpenStack Foundation
Board of Directors.  A vote is expected at the August 22, 2017
Board meeting.

Note: this patch also adds back test information for two Capabilities
that were deprecated (and keeps them marked as not required).  The
tests associated with these were inadvertently removed in
Iabb1d0820300442e407d8b92dfb575ac71471d06 but should instead have
simply had their "required-since" status nullified, as removing
them entirely breaks the jsonToRst.py script and leaves users
unable to easily find the tests that are no longer required due to
the deprecation.

Change-Id: Ifce3fe1e3401e7f887ddeae2a41078dca7e16625
This commit is contained in:
Mark T. Voelker 2017-06-09 17:56:32 -04:00
parent d2e4de1483
commit e60481879b
5 changed files with 3588 additions and 9 deletions

3382
2017.08.json Normal file

File diff suppressed because it is too large Load Diff

View File

@ -0,0 +1,193 @@
============================================
OpenStack Interoperability Guideline 2017.08
============================================
:Status: advisory
:Replaces: 2017.01
:JSON Master: http://git.openstack.org/cgit/openstack/interop/tree/2017.08.json
This document outlines the mandatory capabilities and designated
sections required to exist in a software installation in order to
be eligible to use marks controlled by the OpenStack Foundation.
This document was generated from the `master JSON version <2017.08.json>`_.
Releases Covered
==============================
Applies to Mitaka, Newton, Ocata, Pike
Platform Components
==============================
:Required: Compute, Object
:Advisory: None
:Deprecated: None
:Removed: None
Compute Component Capabilities
==============================
Required Capabilities
-----------------------
* compute-availability-zones-list (Nova)
* compute-flavors-list (Nova)
* compute-images-create (Nova)
* compute-instance-actions-get (Nova)
* compute-instance-actions-list (Nova)
* compute-keypairs-create (Nova)
* compute-list-api-versions (Nova)
* compute-quotas-get (Nova)
* compute-servers-create (Nova)
* compute-servers-delete (Nova)
* compute-servers-get (Nova)
* compute-servers-host (Nova)
* compute-servers-invalid (Nova)
* compute-servers-list (Nova)
* compute-servers-lock (Nova)
* compute-servers-name (Nova)
* compute-servers-reboot (Nova)
* compute-servers-rebuild (Nova)
* compute-servers-resize (Nova)
* compute-servers-stop (Nova)
* compute-servers-update (Nova)
* compute-servers-verify (Nova)
* compute-servers-metadata-delete (Nova)
* compute-servers-metadata-get (Nova)
* compute-servers-metadata-list (Nova)
* compute-servers-metadata-set (Nova)
* compute-servers-metadata-update (Nova)
* compute-volume-attach (Nova)
* identity-v3-api-discovery (Keystone)
* identity-v3-list-projects (Keystone)
* identity-v3-tokens-create (Keystone)
* images-v2-index (Glance)
* images-v2-update (Glance)
* images-v2-list (Glance)
* images-v2-delete (Glance)
* images-v2-get (Glance)
* networks-l2-CRUD (Neutron)
* networks-security-groups-CRUD (Neutron)
* networks-subnet-pools-CRUD (Neutron)
* volumes-v2-create-delete (Cinder)
* volumes-v2-snapshot-create-delete (Cinder)
* volumes-v2-get (Cinder)
* volumes-v2-list (Cinder)
* volumes-v2-update (Cinder)
* volumes-v2-copy-image-to-volume (Cinder)
* volumes-v2-clone (Cinder)
* volumes-v2-availability-zones (Cinder)
* volumes-v2-extensions (Cinder)
* volumes-v2-metadata (Cinder)
* volumes-v2-reserve (Cinder)
* volumes-v2-readonly (Cinder)
* volumes-v2-upload (Cinder)
Advisory Capabilities
-----------------------
* networks-l3-router (Neutron)
* networks-l3-CRUD (Neutron)
* networks-list-api-versions (Neutron)
* volumes-list-api-versions (Cinder)
* volumes-v3-create-delete (Cinder)
* volumes-v3-snapshot-create-delete (Cinder)
* volumes-v3-get (Cinder)
* volumes-v3-list (Cinder)
* volumes-v3-update (Cinder)
* volumes-v3-copy-image-to-volume (Cinder)
* volumes-v3-clone (Cinder)
* volumes-v3-availability-zones (Cinder)
* volumes-v3-extensions (Cinder)
* volumes-v3-metadata (Cinder)
* volumes-v3-reserve (Cinder)
* volumes-v3-readonly (Cinder)
Deprecated Capabilities
-------------------------
* volumes-v2-attach-detach (Cinder)
* volumes-v3-attach-detach (Cinder)
Removed Capabilities
----------------------
None
Object Component Capabilities
=============================
Required Capabilities
-----------------------
* objectstore-account-quotas (Swift)
* objectstore-account-list (Swift)
* objectstore-container-acl (Swift)
* objectstore-container-quotas (Swift)
* objectstore-container-create (Swift)
* objectstore-container-delete (Swift)
* objectstore-container-list (Swift)
* objectstore-container-metadata (Swift)
* objectstore-info-request (Swift)
* objectstore-object-copy (Swift)
* objectstore-object-create (Swift)
* objectstore-object-delete (Swift)
* objectstore-object-get (Swift)
* objectstore-object-versioned (Swift)
* objectstore-temp-url-get (Swift)
* objectstore-temp-url-put (Swift)
* identity-v3-tokens-create (Keystone)
Advisory Capabilities
-----------------------
None
Deprecated Capabilities
-------------------------
None
Removed Capabilities
----------------------
None
Designated Sections
=====================================
The following designated sections apply to the same releases as
this specification.
Required Designated Sections
----------------------------
* Cinder : Designated sections are the API implementation code
* Glance : Designated sections are the API implementation code and domain
model.
* Keystone : Designation is outlined per API grouping. Identity (user and
group) management APIs will not be designated. API access (with exception of
auth) may be prohibited by policy (resulting in HTTP 403). Designated APIs
include v3 version where applicable.
* Neutron : By default, designated for all code backing required capabilities
except pluggable components such as plugins, drivers, and API extensions
other than those listed below.
* Nova : By default, designated except scheduler, filter, drivers, API
extensions and networking. Additional properties allowed on Nova 2.0 API
responses.
* Swift : Designated sections are proxy server, object server, container
server, account server and select middleware
Advisory Designated Sections
----------------------------
None
Deprecated Designated Sections
------------------------------
* Keystone : Designation is outlined per API grouping.
Removed Designated Sections
---------------------------
None

View File

@ -27,8 +27,8 @@ Active Guidelines
.. toctree::
:maxdepth: 1
guidelines/2016.01.rst
guidelines/2016.08.rst
guidelines/2017.01.rst
guidelines/2017.08.rst
==================
Proposed Guideline
@ -50,6 +50,8 @@ Inactive Guidelines
guidelines/2015.04.rst
guidelines/2015.05.rst
guidelines/2015.07.rst
guidelines/2016.01.rst
guidelines/2016.08.rst
================================
Interoperability Issues Reports

View File

@ -1,13 +1,13 @@
{
"id": "next",
"schema": "1.6",
"reference": "https://git.openstack.org/cgit/openstack/defcore/schema/1.6.json",
"source": "http://git.openstack.org/cgit/openstack/defcore/",
"reference": "https://git.openstack.org/cgit/openstack/interop/schema/1.6.json",
"source": "http://git.openstack.org/cgit/openstack/interop/",
"status": "draft",
"cutoff_score": "74",
"target_approval": "2017-08-23",
"replaces": "2017.01",
"releases": ["mitaka", "newton", "ocata", "pike"],
"target_approval": "2018-01-28",
"replaces": "2017.08",
"releases": ["newton", "ocata", "pike", "queens"],
"platform": {
"required": ["compute", "object"],
"advisory": [],
@ -105,6 +105,7 @@
"objectstore-container-create",
"objectstore-container-delete",
"objectstore-container-list",
"objectstore-container-metadata",
"objectstore-info-request",
"objectstore-object-copy",
"objectstore-object-create",
@ -116,7 +117,6 @@
"identity-v3-tokens-create"
],
"advisory": [
"objectstore-container-metadata"
],
"deprecated" : [],
"removed": [
@ -1083,7 +1083,7 @@
"admin": false,
"description": "List projects a user belongs to",
"project": "keystone",
"required-since": "",
"required-since": "2017.08",
"tests": {
"tempest.api.identity.v3.test_projects.IdentityV3ProjectsTest.test_list_projects_returns_only_authorized_projects": {
"idempotent_id": "id-86128d46-e170-4644-866a-cc487f699e1d"

View File

@ -44,6 +44,7 @@ commands=
jsonlint -s 2016.01.json
jsonlint -s 2016.08.json
jsonlint -s 2017.01.json
jsonlint -s 2017.08.json
jsonlint -s doc/source/schema/1.5.json
jsonlint -s doc/source/schema/1.6.json
@ -54,3 +55,4 @@ commands=
jsonschema doc/source/schema/1.5.json -i 2016.01.json
jsonschema doc/source/schema/1.6.json -i 2016.08.json
jsonschema doc/source/schema/1.6.json -i 2017.01.json
jsonschema doc/source/schema/1.6.json -i 2017.08.json