From d24f4a5786c96a46043ec89351078e57e8d0a298 Mon Sep 17 00:00:00 2001 From: OlgaGusarenko Date: Fri, 29 May 2015 18:47:40 +0300 Subject: [PATCH] [Murano docs] Examples section review 1. Improves the table appearance. 2. Fixes several mistakes Change-Id: I57f8a6aa7e9dca3f76ef0eb234d86918ff0aeee6 --- doc/source/draft/appdev-guide/examples.rst | 104 ++++++++++++--------- 1 file changed, 59 insertions(+), 45 deletions(-) diff --git a/doc/source/draft/appdev-guide/examples.rst b/doc/source/draft/appdev-guide/examples.rst index 200d9506..7d93f9c7 100644 --- a/doc/source/draft/appdev-guide/examples.rst +++ b/doc/source/draft/appdev-guide/examples.rst @@ -7,49 +7,63 @@ Examples ======== -.. _Zabbix Agent: https://github.com/openstack/murano-apps/tree/master/ZabbixAgent/package -.. _Zabbix Server: https://github.com/openstack/murano-apps/tree/master/ZabbixServer/package -.. _Docker Crate: https://github.com/openstack/murano-apps/tree/master/Docker/Applications/Crate/package +.. list-table:: + :header-rows: 1 + :widths: 30 70 + :stub-columns: 0 + :class: borderless -+-------------------+----------------------------------------------------------------------------+ -| Application Name | Description | -+===================+============================================================================+ -|| || Zabbix Agent is a simple application. It doesn’t deploy a VM by itself, | -|| || but is installed on a specific VM that may contain any other | -|| || applications. This VM is tracked by Zabbix and by its configuration. | -|| || | -|| || So Murano performs the Zabbix agent configuration based on the user | -|| `Zabbix Agent`_ || input. User chooses the way of instance tracking - HTTP or ICMP that may | -|| || perform some modifications in the application package. | -|| || | -|| || It is worth noting that application scripts are written in Python, not | -|| || in Bash as usual. This application does not work without Zabbix server | -|| || application since it's a required property, determined in the | -|| || application definition. | -+-------------------+----------------------------------------------------------------------------+ -|| || Zabbix Server application interacts with Zabbix Agent by calling its | -|| || setUpAgent method and providing information about itself: IP and hostname | -|| `Zabbix Server`_ || of VM on which the server is installed. Server installs MySQL database and| -|| || requests database name, password and some other parameters from the user. | -+-------------------+----------------------------------------------------------------------------+ -|| || This is a good example on how a difficult logic may be simplified with | -|| || the inheritance that is supported by MuranoPL. Definition of this app is | -|| || simple, but the opportunity it provides is fantastic. | -|| || | -|| || Crate is a distributed database, in Murano Application catalog it | -|| || looks like a regular application. It may be deployed on Google Kubernetes | -|| || or regular Docker server. User picks the desired option while filling in | -|| || the form since these options are set in the UI definition. The form field | -|| || has a list of possible options: | -|| `Docker Crate`_ || ... | -|| || type: | -|| || - io.murano.apps.docker.kubernetes.KubernetesPod | -|| || - io.murano.apps.docker.DockerStandaloneHost | -|| || | -|| || Information about the application itself (docker image and port that is | -|| || needed to be opened) is contained in the getContainer method. All other | -|| || actions for the application configuration are located at the | -|| || DockerStandaloneHost definition and its dependencies. Note that this | -|| || application doesn't have a filename:Resources folder at all since the | -|| || installation is made by Docker itself. | -+-------------------+----------------------------------------------------------------------------+ + * - Application name + - Description + + * - | `Zabbix Agent`_ + - Zabbix Agent is a simple application. It doesn’t deploy a VM by itself, + but is installed on a specific VM that may contain any other + applications. This VM is tracked by Zabbix and by its configuration. + + So Murano performs the Zabbix agent configuration based on the user + input. The user chooses the way of instance tracking - HTTP or ICMP that may + perform some modifications in the application package. + + It is worth noting that application scripts are written in Python, not + in Bash as usual. This application does not work without Zabbix server + application since it’s a required property, determined in the + application definition. + + * - | `Zabbix Server`_ + - Zabbix Server application interacts with Zabbix Agent by calling its + setUpAgent method and providing information about itself: IP and hostname + of VM on which the server is installed. + + Server installs MySQL database and requests database name, password and + some other parameters from the user. + + * - | `Docker Crate`_ + - This is a good example on how difficult logic may be simplified with + the inheritance that is supported by MuranoPL. Definition of this app is + simple, but the opportunity it provides is fantastic. + + Crate is a distributed database, in the Murano Application catalog it + looks like a regular application. It may be deployed on Google Kubernetes + or regular Docker server. The user picks the desired option while filling in + the form since these options are set in the UI definition. The form field + has a list of possible options:: + + ... + type: + - io.murano.apps.docker.kubernetes.KubernetesPod + - io.murano.apps.docker.DockerStandaloneHost + + Information about the application itself (docker image and port that is + needed to be opened) is contained in the getContainer method. All other + actions for the application configuration are located at the + DockerStandaloneHost definition and its dependencies. Note that this + application doesn’t have a filename:Resources folder at all since the + installation is made by Docker itself. + + + +.. Links: +.. _`Zabbix Agent`: https://github.com/openstack/murano-apps/tree/master/ZabbixAgent/package +.. _`Zabbix Server`: https://github.com/openstack/murano-apps/tree/master/ZabbixServer/package +.. _`Docker Crate`: https://github.com/openstack/murano-apps/tree/master/Docker/Applications/Crate/package