From 177b20185add1e74cd1a34bcb9208b74ce7155aa Mon Sep 17 00:00:00 2001 From: Sean Eagan Date: Mon, 11 Jun 2018 12:00:34 -0500 Subject: [PATCH] Remove api guide in favor of swagger Docs This removes the API guide as it was out of date, and the recently added swagger docs are much more accurate and useful. Ideally we should implement hosting of the swagger docs somewhere, but not much benefit in continuing to host an inaccurate api guide in the meantime. Change-Id: I4bee4dda7332e1c8ca1a60aa15c793efb937375f --- doc/source/operations/guide-api.rst | 589 ---------------------------- doc/source/operations/index.rst | 1 - 2 files changed, 590 deletions(-) delete mode 100644 doc/source/operations/guide-api.rst diff --git a/doc/source/operations/guide-api.rst b/doc/source/operations/guide-api.rst deleted file mode 100644 index 2f4e00bb..00000000 --- a/doc/source/operations/guide-api.rst +++ /dev/null @@ -1,589 +0,0 @@ -Armada Restful API v1.0 -======================= - -Description -~~~~~~~~~~~ - -The Armada API provides the services similar to the cli via Restful endpoints - - -Base URL -~~~~~~~~ - -https://armada.localhost/api/v1.0/ - -DEFAULT -~~~~~~~ - -GET ``/releases`` ------------------ - - -Summary -+++++++ - -Get tiller releases - - - -Request -+++++++ - - -Responses -+++++++++ - -**200** -^^^^^^^ - -obtain all running releases - -**Example:** - -.. code-block:: javascript - - { - "message": { - "namespace": [ - "armada-release", - "armada-release" - ], - "default": [ - "armada-release", - "armada-release" - ] - } - } - -**403** -^^^^^^^ - -Unable to Authorize or Permission - - -**405** -^^^^^^^ - -Failed to perform action - -GET ``/status`` ---------------- - - -Summary -+++++++ - -Get armada running state - - -Request -+++++++ - - -Responses -+++++++++ - -**200** -^^^^^^^ - -obtain armada status - -**Example:** - -.. code-block:: javascript - - { - "message": { - "tiller": { - "state": True, - "version": "v2.5.0" - } - } - } - -**403** -^^^^^^^ - -Unable to Authorize or Permission - - -**405** -^^^^^^^ - -Failed to perform action - - -POST ``/validatedesign`` ------------------------- - - -Summary -+++++++ - -Validates Armada manifest - - -Request -+++++++ - - -Responses -+++++++++ - -**200** -^^^^^^^ - -obtain valid status true/false - - -**Example:** - -.. code-block:: javascript - - { - "valid": true - } - -**403** -^^^^^^^ - -Unable to Authorize or Permission - - -**405** -^^^^^^^ - -Failed to perform action - - -POST ``/apply`` ---------------- - - -Summary -+++++++ - -Install/Update Armada Manifest - -Request -+++++++ - -Body -^^^^ - -.. csv-table:: - :delim: | - :header: "Name", "Required", "Type", "Format", "Properties", "Description" - :widths: 20, 10, 15, 15, 30, 25 - - disable-update-post | boolean | | | | - disable-update-pre | boolean | | | | - dry-run | boolean | | | | - enable-chart-cleanup | boolean | | | | - tiller-host | string | | | | - tiller-port | int | | | | - timeout | int | | | | - wait | boolean | | | | - - -**Armada schema:** - -.. code-block:: javascript - - { - "api": true, - "armada": {} - } - -Responses -+++++++++ - -**200** -^^^^^^^ - -Successful installation/update of manifest - -**Example:** - -.. code-block:: javascript - - { - "message": { - "installed": [ - "armada-release", - "armada-release" - ], - "updated": [ - "armada-release", - "armada-release" - ], - "diff": [ - "values": "value diff", - "values": "value diff 2" - ] - } - } - -**403** -^^^^^^^ - -Unable to Authorize or Permission - - -**405** -^^^^^^^ - -Failed to perform action - -POST ``/rollback/{release}`` ----------------------------- - - -Summary -+++++++ - -Rollback release name - - -Parameters -++++++++++ - -.. csv-table:: - :delim: | - :header: "Name", "Located in", "Required", "Type", "Format", "Properties", "Description" - :widths: 20, 15, 10, 10, 10, 20, 30 - - release | path | Yes | string | | | name of the release to rollback - version | query | No | integer | | | version of the release to rollback to - dry_run | query | No | boolean | | | perform dry run - wait | query | No | boolean | | | whether to wait for rollback to complete before returning - timeout | query | No | integer | | | time to wait for rollback to complete before timing out - -Request -+++++++ - - -Responses -+++++++++ - -**200** -^^^^^^^ - -Successfully Test release response - -**Example:** - -.. code-block:: javascript - - { - "message": { - "message": "Rollback of release xyz complete" - } - } - -**403** -^^^^^^^ - -Unable to Authorize or Permission - - -**405** -^^^^^^^ - -Failed to perform action - - -POST ``/test/{release}`` ------------------------- - - -Summary -+++++++ - -Test release name - - -Parameters -++++++++++ - -.. csv-table:: - :delim: | - :header: "Name", "Located in", "Required", "Type", "Format", "Properties", "Description" - :widths: 20, 15, 10, 10, 10, 20, 30 - - release | path | Yes | string | | | name of the release to test - -Request -+++++++ - - -Responses -+++++++++ - -**200** -^^^^^^^ - -Successfully Test release response - -**Example:** - -.. code-block:: javascript - - { - "message": { - "message": "armada-release", - "result": "No test found." - } - } - -**403** -^^^^^^^ - -Unable to Authorize or Permission - - -**405** -^^^^^^^ - -Failed to perform action - -POST ``/tests`` ---------------- - - -Summary -+++++++ - -Test manifest releases - -Request -+++++++ - -Body -^^^^ - -.. csv-table:: - :delim: | - :header: "Name", "Required", "Type", "Format", "Properties", "Description" - :widths: 20, 10, 15, 15, 30, 25 - - armada | Yes | | | | - -**Armada schema:** - -.. code-block:: javascript - - { - "armada": {} - } - -Responses -+++++++++ - -**200** -^^^^^^^ - -Successful Test of manifest - -**Example:** - -.. code-block:: javascript - - { - "message": { - "failed": [ - "armada-release", - "armada-release" - ], - "passed": [ - "armada-release", - "armada-release" - ], - "skipped": [ - "armada-release", - "armada-release" - ] - } - } - -**403** -^^^^^^^ - -Unable to Authorize or Permission - - -**405** -^^^^^^^ - -Failed to perform action - -Data Structures -~~~~~~~~~~~~~~~ - -Armada Request Model Structure ------------------------------- - -.. csv-table:: - :delim: | - :header: "Name", "Required", "Type", "Format", "Properties", "Description" - :widths: 20, 10, 15, 15, 30, 25 - - disable-update-post | boolean | | | | - disable-update-pre | boolean | | | | - dry-run | boolean | | | | - enable-chart-cleanup | boolean | | | | - tiller-host | string | | | | - tiller-port | int | | | | - timeout | int | | | | - wait | boolean | | | | - -**Armada schema:** - -Armada Response Model Structure -------------------------------- - -.. csv-table:: - :delim: | - :header: "Name", "Required", "Type", "Format", "Properties", "Description" - :widths: 20, 10, 15, 15, 30, 25 - - message | No | | | | - -**Message schema:** - -.. csv-table:: - :delim: | - :header: "Name", "Required", "Type", "Format", "Properties", "Description" - :widths: 20, 10, 15, 15, 30, 25 - - installed | No | array of string | | | - updated | No | array of string | | | - values | No | array of string | | | - - -Releases Response Model Structure ---------------------------------- - -.. csv-table:: - :delim: | - :header: "Name", "Required", "Type", "Format", "Properties", "Description" - :widths: 20, 10, 15, 15, 30, 25 - - message | No | | | | - -**Message schema:** - - -.. csv-table:: - :delim: | - :header: "Name", "Required", "Type", "Format", "Properties", "Description" - :widths: 20, 10, 15, 15, 30, 25 - - namespace | No | array of string | | | - -Status Response Model Structure -------------------------------- - -.. csv-table:: - :delim: | - :header: "Name", "Required", "Type", "Format", "Properties", "Description" - :widths: 20, 10, 15, 15, 30, 25 - - message | No | | | | - - - -**Message schema:** - - -.. csv-table:: - :delim: | - :header: "Name", "Required", "Type", "Format", "Properties", "Description" - :widths: 20, 10, 15, 15, 30, 25 - - tiller | No | | | | - - - -**Tiller schema:** - - -.. csv-table:: - :delim: | - :header: "Name", "Required", "Type", "Format", "Properties", "Description" - :widths: 20, 10, 15, 15, 30, 25 - - state | No | string | | | - version | No | string | | | - - - -Test Response Model Structure ------------------------------ - -.. csv-table:: - :delim: | - :header: "Name", "Required", "Type", "Format", "Properties", "Description" - :widths: 20, 10, 15, 15, 30, 25 - - message | No | | | | - -**Message schema:** - - -.. csv-table:: - :delim: | - :header: "Name", "Required", "Type", "Format", "Properties", "Description" - :widths: 20, 10, 15, 15, 30, 25 - - message | No | string | | | - result | No | string | | | - -Tests Request Model Structure ------------------------------ - -.. csv-table:: - :delim: | - :header: "Name", "Required", "Type", "Format", "Properties", "Description" - :widths: 20, 10, 15, 15, 30, 25 - - armada | Yes | | | | - - - -**Armada schema:** - - -Tests Response Model Structure ------------------------------- - -.. csv-table:: - :delim: | - :header: "Name", "Required", "Type", "Format", "Properties", "Description" - :widths: 20, 10, 15, 15, 30, 25 - - message | No | | | | - - -**Message schema:** - - -.. csv-table:: - :delim: | - :header: "Name", "Required", "Type", "Format", "Properties", "Description" - :widths: 20, 10, 15, 15, 30, 25 - - failed | No | array of string | | | - passed | No | array of string | | | - skipped | No | array of string | | | - - -Validate Response Model Structure ---------------------------------- - -.. csv-table:: - :delim: | - :header: "Name", "Required", "Type", "Format", "Properties", "Description" - :widths: 20, 10, 15, 15, 30, 25 - - valid | No | boolean | | | diff --git a/doc/source/operations/index.rst b/doc/source/operations/index.rst index 26363c83..62a5118e 100644 --- a/doc/source/operations/index.rst +++ b/doc/source/operations/index.rst @@ -10,7 +10,6 @@ Operations Guide :maxdepth: 2 :caption: Contents: - guide-api guide-build-armada-yaml guide-configure guide-troubleshooting