Add MultiInstanceConnecting.md

Add Proxy Tarantool client example with multiple routers
Add Proxy Tarantool client example with address provider

Closes #348
Closes #349

Author: iDneprov

Diff for: README.md

@@ -43,8 +43,11 @@ If you use this code in another project don't forget to add `cartridge-driver` d
 </dependency>
 ```
 ## Advanced usage
-* [Proxy methods](docs/ProxyTarantoolClient.md)  
-  Connecting to routers with crud library. It proxies space interface's methods to crud methods.
+* [Using CRUD stored procedures](docs/ProxyTarantoolClient.md)  
+  Connecting to routers with [tarantool/crud](https://github.com/tarantool/crud) library.
+  It proxies space interface's methods to CRUD methods.
+* [Connecting to multiple instances](docs/MultiInstanceConnecting.md)  
+  Connecting to multiple Tarantool instances.
 * [Retrying](docs/RetryingTarantoolClient.md)  
   Retrying transient cluster failures.
 * [TarantoolTuple usage](docs/TarantoolTupleUsage.md)  

Diff for: docs/MultiInstanceConnecting.md

@@ -0,0 +1,23 @@
+[Main page](../README.md)
+
+# Connecting to multiple Tarantool instances
+
+This section shows examples of how to connect to multiple [Cartridge](https://github.com/tarantool/cartridge) routers.  
+We recommend to use balancer in production applications rather than leaving this task to the connector.
+
+## Setting addresses manually  
+  
+Example of TarantoolClient set up with connecting to multiple routers  
+https://github.com/tarantool/cartridge-java/blob/b2d504cf26d431d2a80fa21b5d475d8f89a5181f/src/test/java/io/tarantool/driver/integration/ReconnectIT.java#L291-L301
+https://github.com/tarantool/cartridge-java/blob/b2d504cf26d431d2a80fa21b5d475d8f89a5181f/src/test/java/io/tarantool/driver/integration/ReconnectIT.java#L315-L321
+
+## Setting addresses with address provider
+  
+Example of TarantoolClient set up with address provider  
+You may use the provided code as a reference for your own implementation  
+https://github.com/tarantool/cartridge-java/blob/b2d504cf26d431d2a80fa21b5d475d8f89a5181f/src/test/java/io/tarantool/driver/integration/ProxyTarantoolClientWithAddressProviderExampleIT.java#L75-L82
+Example of TarantoolClusterAddressProvider setup  
+https://github.com/tarantool/cartridge-java/blob/b2d504cf26d431d2a80fa21b5d475d8f89a5181f/src/test/java/io/tarantool/driver/integration/ProxyTarantoolClientWithAddressProviderExampleIT.java#L43-L68
+Do not forget to set tarantool function witch will return addresses  
+The function must be global, so that it can be called from the connector
+https://github.com/tarantool/cartridge-java/blob/b2d504cf26d431d2a80fa21b5d475d8f89a5181f/src/test/resources/cartridge/app/roles/custom.lua#L3-L30

Diff for: docs/ProxyTarantoolClient.md

@@ -1,6 +1,6 @@
 [Main page](../README.md)
 
-# Proxy Tarantool client
+# Using CRUD stored procedures
 
 This section shows the necessary settings for connecting to instances with a user-defined CRUD API exposed as Lua
 stored functions or Cartridge roles implementing the API similar to the one of [tarantool/crud](https://github.com/tarantool/crud).