Merge 6ebe637 into 4f2154e

docs/index.rst

@@ -14,6 +14,7 @@ Contents:
    source/glossary
    source/resource
    source/orchestration
+   source/transports
    source/examples
 
 

docs/source/glossary.rst

@@ -9,7 +9,9 @@ Solar Glossary
 Resource
 ========
 
-You can learn more about it in :ref:`Resource Details <resource_details>`
+.. seealso::
+
+    You can learn more about it in :ref:`Resource Details <resource_details>`
 
 .. _res-input-term:
 
@@ -51,26 +53,29 @@ Layer that responsible for action execution and tracking result.
 Transport
 =========
 
-Used in handlers to communicate with managed by solar hosts. List of transports
-should be added to a node. Transports will be added to a resource by means
-of transports id.
+Used in handlers to communicate with managed by solar hosts.
+
+.. seealso::
+
+   :ref:`More details about transports <transports_details>`
 
-Two different types of transports are used: run and sync.
-Run transport - reponsible for running command on remote host.
-Sync transport - uploads required information.
+.. _location-id-term:
 
 location_id
 -----------
 Used in transport layer to find ip address of a node. ::
 
   'location_id': '96bc779540d832284680785ecd948a2d'
 
+.. _transports-id-term:
+
 transports_id
 -------------
 Used to find transports array that will be used for transport selection. ::
 
   'transports_id': '3889e1790e68b80b4f255cf0e13494b1'
 
+
 BAT transport
 -------------
 According to preferences solar will choose best available transport for

docs/source/transports.rst

@@ -0,0 +1,47 @@
+.. _transports_details:
+
+
+Transports
+==========
+
+Transports are used by Solar to communicate with managed nodes.
+Transports are also resuorces, so they have all features of it.
+Transports should be added to a node, but if you need you can add different transports for different resources.
+
+
+How it works
+------------
+
+* Each resource in solar have randomly generated :ref:`transports-id-term`, when you connect resources together,
+* Solar will ensure that correct `transport_id` is passed around. then using this `transport_id` a correct real value is fetched.
+* Changing transports contents will not cause resource.update action for related resources.
+
+Sync transport
+--------------
+
+It uploads required information to target node.
+
+Currently there are following sync transports available:
+
+* ssh
+* rsync
+* solar_agent
+* torrent
+
+
+Run transport
+-------------
+
+It is responsible for running command on remote host.
+
+Currently there are following run transports available:
+
+* ssh
+* solar_agent
+
+
+
+BAT transport
+-------------
+
+A transport that will automaticaly select best available transport (BAT) that is available for given resource. Currently it's default enabled transport, so when you add more transports to your system, then everything happens automaticaly.