new file mode 100644

@@ -0,0 +1,53 @@

+:title: Sharing data between 2 couchdb databases

+:description: Sharing data between 2 couchdb databases

+:keywords: docker, example, package installation, networking, couchdb, data volumes

+

+.. _running_redis_service:

+

+Create a redis service

+======================

+

+.. include:: example_header.inc

+

+Here's an example of using data volumes to share the same data between 2 couchdb containers.

+This could be used for hot upgrades, testing different versions of couchdb on the same data, etc.

+

+Create first database

+---------------------

+

+Note that we're marking /var/lib/couchdb as a data volume.

+

+.. code-block:: bash

+

+    COUCH1=$(docker run -d -v /var/lib/couchdb shykes/couchdb:2013-05-03)

+

+Add data to the first database

+------------------------------

+

+We're assuming your docker host is reachable at `localhost`. If not, replace `localhost` with the public IP of your docker host.

+

+.. code-block:: bash

+

+    HOST=localhost

+    URL="http://$HOST:$(docker port $COUCH1 5984)/_utils/"

+    echo "Navigate to $URL in your browser, and use the couch interface to add data"

+

+Create second database

+----------------------

+

+This time, we're requesting shared access to $COUCH1's volumes.

+

+.. code-block:: bash

+

+    COUCH2=$(docker run -d -volumes-from $COUCH1) shykes/couchdb:2013-05-03)

+

+Browse data on the second database

+----------------------------------

+

+.. code-block:: bash

+

+    HOST=localhost

+    URL="http://$HOST:$(docker port $COUCH2 5984)/_utils/"

+    echo "Navigate to $URL in your browser. You should see the same data as in the first database!"

+

+Congratulations, you are running 2 Couchdb containers, completely isolated from each other *except* for their data.

@@ -18,3 +18,4 @@ Contents:

    python_web_app

    running_redis_service

    running_ssh_service

+   couchdb_data_volumes