summaryrefslogtreecommitdiffstats
path: root/README.md
diff options
context:
space:
mode:
authorSaravanakumar Arumugam <sarumuga@redhat.com>2017-02-28 15:11:52 +0530
committerSaravanakumar Arumugam <sarumuga@redhat.com>2017-02-28 15:11:52 +0530
commita8fb3ccd9ad9f94d817563e3677a02d90a9ce27b (patch)
tree3d25783f4f491ed57f1c089c5ec963a4c51725a6 /README.md
parentf373f3a9c78a6fdd8b1bd3c1f8688a3d837e367b (diff)
downloadgluster-a8fb3ccd9ad9f94d817563e3677a02d90a9ce27b.tar.gz
gluster-a8fb3ccd9ad9f94d817563e3677a02d90a9ce27b.tar.bz2
gluster-a8fb3ccd9ad9f94d817563e3677a02d90a9ce27b.tar.xz
gluster-a8fb3ccd9ad9f94d817563e3677a02d90a9ce27b.zip
Update README for gluster-object.
Also, added section for gluster-server. Signed-off-by: Saravanakumar Arumugam <sarumuga@redhat.com>
Diffstat (limited to 'README.md')
-rw-r--r--README.md43
1 files changed, 42 insertions, 1 deletions
diff --git a/README.md b/README.md
index 0629287..5920382 100644
--- a/README.md
+++ b/README.md
@@ -1,4 +1,6 @@
-This repo contains dockerfiles (CentOS, Fedora, Red Hat) for GlusterFS containers.
+This repo contains dockerfiles (CentOS, Fedora, Red Hat) for GlusterFS containers namely server, client and object.
+
+## Gluster Server Docker container:
Although Setting up a glusterfs environment is a pretty simple and straight forward procedure, Gluster community do maintain docker images for gluster both in Fedora and CentOS in the docker hub for the ease of users. This blog is intented to walk the user through the steps of running GlusterFS with the help of docker.
The community maintains docker images of GlusterFS release in both Fedora and CentOS distributions. The following are the steps to build the GlusterFS docker images that we maintain:
@@ -45,6 +47,7 @@ Before this, ensure the following directories are created in the system from whe
- /var/log/glusterfs
Also, ensure they are empty to avoid any conflicts.
Now run the following command:
+
~~~
$ docker run -v /etc/glusterfs:/etc/glusterfs:z -v /var/lib/glusterd:/var/lib/glusterd:z -v /var/log/glusterfs:/var/log/glusterfs:z -v /sys/fs/cgroup:/sys/fs/cgroup:ro -d --privileged=true --net=host -v /dev/:/dev gluster/gluster-centos
@@ -118,3 +121,41 @@ That’s it!
Additional Ref# https://goo.gl/3031Mm
+
+## Gluster Object Docker container:
+
+### To pull gluster-object:
+~~~
+$ docker pull gluster/gluster-object
+
+~~~
+
+### To run gluster-object container:
+
+On the host machine, mount one or more gluster volumes under the directory
+`/mnt/gluster-object` with mountpoint name being same as that of the volume.
+
+For example, if you have two gluster volumes named `test` and `test2`, they
+should be mounted at `/mnt/gluster-object/test` and `/mnt/gluster-object/test2`
+respectively. This directory on the host machine containing all the individual
+glusterfs mounts is then bind-mounted inside the container. This avoids having
+to bind mount individual gluster volumes.
+
+The same needs to be updated in etc/sysconfig/swift-volumes.
+
+For example(in swift-volumes):
+GLUSTER_VOLUMES='tv1'
+
+Where tv1 is the volume name.
+
+~~~
+$ docker run -d --privileged -v /sys/fs/cgroup/:/sys/fs/cgroup/:ro -p 8080:8080 -v /mnt/gluster-object:/mnt/gluster-object gluster/gluster-object
+
+~~~
+
+Now, We can get/put objects into the gluster volume, using the gluster-object Docker container.
+Refer this link[1] for testing.
+
+[1] https://github.com/gluster/gluster-swift/blob/master/doc/markdown/quick_start_guide.md#using_swift
+
+