From 304843e3091c0c79bb2f70871f79ef724d40abf7 Mon Sep 17 00:00:00 2001 From: Shilla Saebi Date: Wed, 27 May 2015 12:51:05 -0400 Subject: [PATCH] murano documentation and cleanup MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit project name muranos official name and capitalization changed see: https://wiki.openstack.org/wiki/Documentation/Conventions removed unnecessary capitalizations throughout the docs corrected grammar and vocabulary to follow standards added β€œan” instead of β€œa” before words that start with vowels corrected spelling throughout several docs Change-Id: I43678b35bc8df289468900133816607a9fbda1cc --- doc/source/specification/index.rst | 12 ++-- doc/source/specification/murano-api.rst | 64 +++++++++---------- doc/source/specification/murano-env-temp.rst | 16 ++--- .../specification/murano-repository.rst | 8 +-- 4 files changed, 50 insertions(+), 50 deletions(-) diff --git a/doc/source/specification/index.rst b/doc/source/specification/index.rst index 3591d582..045b9f3d 100644 --- a/doc/source/specification/index.rst +++ b/doc/source/specification/index.rst @@ -22,9 +22,9 @@ General information * **Introduction** - Murano Service API is a programmatic interface used for interaction with - Murano. Other interaction mechanisms like Murano Dashboard or Murano CLI - should use API as underlying protocol for interaction. + The murano service API is a programmatic interface used for interaction with + murano. Other interaction mechanisms like the murano dashboard or the murano CLI + should use the API as an underlying protocol for interaction. * **Allowed HTTPs requests** @@ -53,9 +53,9 @@ General information * **Authentication** - All requests include a Keystone authentication token header - (X-Auth-Token). Clients must authenticate with Keystone before - interacting with the Murano service. + All requests include a keystone authentication token header + (X-Auth-Token). Clients must authenticate with keystone before + interacting with the murano service. .. include:: murano-api.rst .. include:: murano-repository.rst diff --git a/doc/source/specification/murano-api.rst b/doc/source/specification/murano-api.rst index 74a7c5db..609351e0 100644 --- a/doc/source/specification/murano-api.rst +++ b/doc/source/specification/murano-api.rst @@ -18,33 +18,33 @@ Glossary * **Environment** - Environment is a set of applications managed by a single tenant. They could be related logically with each other or not. - Applications within single Environment may comprise some complex configuration while applications in different Environments are always - independent from one another. Each Environment is associated with single + The environment is a set of applications managed by a single tenant. They could be related logically with each other or not. + Applications within a single environment may comprise of complex configuration while applications in different environments are always + independent from one another. Each environment is associated with a single OpenStack project (tenant). .. _`sessions`: * **Session** - Since Murano environment are available for local modification for different users and from different locations, it's needed to store local modifications somewhere. - So sessions were created to provide this opportunity. After user adds application to the environment - new session is created. - After user sends environment to deploy, session with set of applications changes status to *deploying* and all other open sessions for that environment becomes invalid. + Since murano environments are available for local modification for different users and from different locations, it's needed to store local modifications somewhere. + Sessions were created to provide this opportunity. After a user adds an application to the environment - a new session is created. + After a user sends an environment to deploy, a session with a set of applications changes status to *deploying* and all other open sessions for that environment become invalid. One session could be deployed only once. * **Object Model** - Applications are defined in MuranoPL object model, which is defined as JSON object. - Murano API doesn't know anything about it. + Applications are defined in MuranoPL object model, which is defined as a JSON object. + The murano API doesn't know anything about it. * **Package** A .zip archive, containing instructions for an application deployment. * **Environment-Template** - The Environment template is the specification of a set of applications managed by a single tenant, which are - related each other. The environment template is stored in a environment template catalogue, and it can be - managed by the user (creation, deletion, updating...). Finally, it can be deployed on Openstack by translating + The environment template is the specification of a set of applications managed by a single tenant, which are + related to each other. The environment template is stored in an environment template catalog, and it can be + managed by the user (creation, deletion, updating). Finally, it can be deployed on OpenStack by translating into an environment. @@ -82,7 +82,7 @@ Environment API | 401 | User is not authorized to perform the operation | +----------------+-----------------------------------------------------------+ -List Environments +List environments ----------------- *Request* @@ -98,7 +98,7 @@ List Environments *Response* -This call returns list of environments. Only the basic properties are +This call returns a list of environments. Only the basic properties are returned. :: @@ -128,7 +128,7 @@ returned. ] } -Create Environment +Create environment ------------------ +----------------------+------------+--------------------------------------------------------+ @@ -165,7 +165,7 @@ Create Environment } -Update Environment +Update environment ------------------ +----------------------+------------+--------------------------------------------------------+ @@ -219,12 +219,12 @@ Update Environment | 409 | Environment with specified name already exists | +----------------+-----------------------------------------------------------+ -Get Environment Details +Get environment details ----------------------- *Request* -Return information about environment itself and about applications, including to this environment. +Return information about the environment itself and about applications, including this environment. +----------+----------------------------------+-----------------------------------+----------------------------------+ | Method | URI | Header | Description | @@ -277,7 +277,7 @@ Return information about environment itself and about applications, including to "id": "20d4a012628e4073b48490a336a8acbf" } -Delete Environment +Delete environment ------------------ *Request* @@ -289,7 +289,7 @@ Delete Environment | DELETE | /environments/{id} | Remove specified Environment. | +----------+----------------------------------+----------------------------------+ -Environment Configuration API +Environment configuration API ============================= Multiple `sessions`_ could be opened for one environment simultaneously, but only one session going @@ -318,7 +318,7 @@ User could not open new session for environment that in | | | deployed | +----------------------+------------+-------------------------------------------+ -Configure Environment / Open session +Configure environment / open session ------------------------------------ During this call new working session is created, and session ID should be sent in a request header with name ``X-Configuration-Session``. @@ -359,10 +359,10 @@ During this call new working session is created, and session ID should be sent i | | deploying status | +----------------+-----------------------------------------------------------+ -Deploy Session +Deploy session -------------- -With this request all local changes made within environment start to deploy on Openstack. +With this request all local changes made within the environment start to deploy on OpenStack. *Request* @@ -386,7 +386,7 @@ With this request all local changes made within environment start to deploy on O | 403 | Session is already deployed or deployment is in progress | +----------------+-----------------------------------------------------------+ -Get Session Details +Get session details ------------------- *Request* @@ -423,7 +423,7 @@ Get Session Details | 403 | Session is invalid | +----------------+-----------------------------------------------------------+ -Delete Session +Delete session -------------- *Request* @@ -447,7 +447,7 @@ Delete Session | 403 | Session is in deploying state and could not be deleted | +----------------+-----------------------------------------------------------+ -Environment Deployments API +Environment deployments API =========================== Environment deployment API allows to track changes of environment status, deployment events and errors. @@ -534,19 +534,19 @@ Returns information about all deployments of the specified environment. | 401 | User is not authorized to access this environment | +----------------+-----------------------------------------------------------+ -Application Management API +Application management API ========================== All applications should be created within an environment and all environment modifications are held within the session. Local changes apply only after successful deployment of an environment session. -Get Application Details +Get application details ----------------------- Using GET requests to applications endpoint user works with list containing all -applications for specified environment. User can request whole list, -specific application, or specific attribute of specific application using tree -traversing. To request specific application, user should add to endpoint part +applications for specified environment. A user can request a whole list, +specific application, or specific attribute of a specific application using tree +traversing. To request a specific application, the user should add to endpoint part an application id, e.g.: */environments//services/*. For selection of specific attribute on application, simply appending part with attribute name will work. For example to request application name, user @@ -596,7 +596,7 @@ should use next endpoint: */environments//services//name POST applications ----------------- -New application can be added to the Murano environment using session. +New application can be added to the murano environment using session. Result JSON is calculated in Murano dashboard, which based on `UI definition `_ *Request* @@ -686,7 +686,7 @@ Statistic API Statistic API intends to provide billing feature -Instance Environment Statistics +Instance environment statistics ------------------------------- *Request* diff --git a/doc/source/specification/murano-env-temp.rst b/doc/source/specification/murano-env-temp.rst index f893a178..d359dea5 100644 --- a/doc/source/specification/murano-env-temp.rst +++ b/doc/source/specification/murano-env-temp.rst @@ -13,10 +13,10 @@ License for the specific language governing permissions and limitations under the License. -Environment Template API +Environment template API ======================== -Manage environment template definitions in Murano. It is possible to create, update, delete and deploy into Openstack by translating +Manage environment template definitions in Murano. It is possible to create, update, delete and deploy into OpenStack by translating it into an environment. In addition, applications can be added or delete to the environment template. **Environment Template Properties** @@ -67,7 +67,7 @@ List Environments Templates *Response* -This call returns list of environment templates. Only the basic properties are +This call returns a list of environment templates. Only the basic properties are returned. :: @@ -96,7 +96,7 @@ returned. } -Create Environment Template +Create environment template --------------------------- +----------------------+------------+---------------------------------------------------------+ @@ -145,8 +145,8 @@ Create Environment Template +----------------+-----------------------------------------------------------+ -Get Environment Templates Details ------------------------ +Get environment templates details +--------------------------------- *Request* @@ -156,7 +156,7 @@ environment template. +----------+--------------------------------+-------------------------------------------------+ | Method | URI | Description | +==========+================================+=================================================+ -| GET | /templates/{env-temp-id} | Obtains the enviroment template information | +| GET | /templates/{env-temp-id} | Obtains the environment template information | +----------+--------------------------------+-------------------------------------------------+ * `env-temp-id` - environment template ID, required @@ -192,7 +192,7 @@ environment template. | 404 | The environment template does not exit | +----------------+-----------------------------------------------------------+ -Delete Environment Template +Delete environment template --------------------------- *Request* diff --git a/doc/source/specification/murano-repository.rst b/doc/source/specification/murano-repository.rst index 9e95fe0d..b9ce4120 100644 --- a/doc/source/specification/murano-repository.rst +++ b/doc/source/specification/murano-repository.rst @@ -13,7 +13,7 @@ License for the specific language governing permissions and limitations under the License. -Application Catalog API +Application catalog API ======================= Manage application definitions in the Application Catalog. @@ -220,13 +220,13 @@ Display details for a package. **Response 403** -* In attempt to get non-public package by user whose tenant is not an owner of this package. +* In attempt to get a non-public package by a user whose tenant is not an owner of this package. **Response 404** -* In case specified package id doesn't exist. +* In case the specified package id doesn't exist. -Update a Package +Update a package ================ `/v1/catalog/packages/{id} [PATCH]`