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

doc/source/guidelines/2017.08.rst

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

doc/source/index.rst

@@ -27,8 +27,8 @@ Active Guidelines
 .. toctree::
    :maxdepth: 1
 
-   guidelines/2016.01.rst
+   guidelines/2017.01.rst
-   guidelines/2016.08.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

next.json

@@ -1,13 +1,13 @@
 {
   "id": "next",
   "schema": "1.6",
-  "reference": "https://git.openstack.org/cgit/openstack/defcore/schema/1.6.json",
+  "reference": "https://git.openstack.org/cgit/openstack/interop/schema/1.6.json",
-  "source": "http://git.openstack.org/cgit/openstack/defcore/",
+  "source": "http://git.openstack.org/cgit/openstack/interop/",
   "status": "draft",
   "cutoff_score": "74",
-  "target_approval": "2017-08-23",
+  "target_approval": "2018-01-28",
-  "replaces": "2017.01",
+  "replaces": "2017.08",
-  "releases": ["mitaka", "newton", "ocata", "pike"],
+  "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"

tox.ini

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