2014-04-16 00:53:12 +00:00
|
|
|
page_title: Running a Riak service
|
|
|
|
page_description: Build a Docker image with Riak pre-installed
|
|
|
|
page_keywords: docker, example, package installation, networking, riak
|
|
|
|
|
|
|
|
# Riak Service
|
|
|
|
|
2014-04-18 20:21:55 +00:00
|
|
|
> **Note**:
|
|
|
|
>
|
|
|
|
> - This example assumes you have Docker running in daemon mode. For
|
|
|
|
> more information please see [*Check your Docker
|
|
|
|
> install*](../hello_world/#running-examples).
|
2014-04-23 20:48:28 +00:00
|
|
|
> - **If you don't like sudo** then see [*Giving non-root
|
2014-04-24 12:12:21 +00:00
|
|
|
> access*](/installation/binaries/#dockergroup)
|
2014-04-16 00:53:12 +00:00
|
|
|
|
|
|
|
The goal of this example is to show you how to build a Docker image with
|
|
|
|
Riak pre-installed.
|
|
|
|
|
2014-04-23 20:48:28 +00:00
|
|
|
## Creating a Dockerfile
|
2014-04-16 00:53:12 +00:00
|
|
|
|
2014-04-23 20:48:28 +00:00
|
|
|
Create an empty file called Dockerfile:
|
2014-04-16 00:53:12 +00:00
|
|
|
|
2014-05-01 14:13:34 +00:00
|
|
|
$ touch Dockerfile
|
2014-04-16 00:53:12 +00:00
|
|
|
|
|
|
|
Next, define the parent image you want to use to build your image on top
|
2014-04-23 20:48:28 +00:00
|
|
|
of. We'll use [Ubuntu](https://index.docker.io/_/ubuntu/) (tag:
|
2014-04-16 00:53:12 +00:00
|
|
|
`latest`), which is available on the [docker
|
|
|
|
index](http://index.docker.io):
|
|
|
|
|
|
|
|
# Riak
|
|
|
|
#
|
|
|
|
# VERSION 0.1.0
|
|
|
|
|
|
|
|
# Use the Ubuntu base image provided by dotCloud
|
|
|
|
FROM ubuntu:latest
|
|
|
|
MAINTAINER Hector Castro hector@basho.com
|
|
|
|
|
|
|
|
Next, we update the APT cache and apply any updates:
|
|
|
|
|
|
|
|
# Update the APT cache
|
|
|
|
RUN sed -i.bak 's/main$/main universe/' /etc/apt/sources.list
|
|
|
|
RUN apt-get update
|
|
|
|
RUN apt-get upgrade -y
|
|
|
|
|
|
|
|
After that, we install and setup a few dependencies:
|
|
|
|
|
2014-04-23 20:48:28 +00:00
|
|
|
- `curl` is used to download Basho's APT
|
2014-04-16 00:53:12 +00:00
|
|
|
repository key
|
2014-04-23 20:48:28 +00:00
|
|
|
- `lsb-release` helps us derive the Ubuntu release
|
2014-04-16 00:53:12 +00:00
|
|
|
codename
|
2014-04-23 20:48:28 +00:00
|
|
|
- `openssh-server` allows us to login to
|
2014-04-16 00:53:12 +00:00
|
|
|
containers remotely and join Riak nodes to form a cluster
|
2014-04-23 20:48:28 +00:00
|
|
|
- `supervisor` is used manage the OpenSSH and Riak
|
2014-04-16 00:53:12 +00:00
|
|
|
processes
|
|
|
|
|
|
|
|
<!-- -->
|
|
|
|
|
|
|
|
# Install and setup project dependencies
|
|
|
|
RUN apt-get install -y curl lsb-release supervisor openssh-server
|
|
|
|
|
|
|
|
RUN mkdir -p /var/run/sshd
|
|
|
|
RUN mkdir -p /var/log/supervisor
|
|
|
|
|
|
|
|
RUN locale-gen en_US en_US.UTF-8
|
|
|
|
|
|
|
|
ADD supervisord.conf /etc/supervisor/conf.d/supervisord.conf
|
|
|
|
|
|
|
|
RUN echo 'root:basho' | chpasswd
|
|
|
|
|
2014-04-23 20:48:28 +00:00
|
|
|
Next, we add Basho's APT repository:
|
2014-04-16 00:53:12 +00:00
|
|
|
|
|
|
|
RUN curl -s http://apt.basho.com/gpg/basho.apt.key | apt-key add --
|
|
|
|
RUN echo "deb http://apt.basho.com $(lsb_release -cs) main" > /etc/apt/sources.list.d/basho.list
|
|
|
|
RUN apt-get update
|
|
|
|
|
|
|
|
After that, we install Riak and alter a few defaults:
|
|
|
|
|
|
|
|
# Install Riak and prepare it to run
|
|
|
|
RUN apt-get install -y riak
|
|
|
|
RUN sed -i.bak 's/127.0.0.1/0.0.0.0/' /etc/riak/app.config
|
|
|
|
RUN echo "ulimit -n 4096" >> /etc/default/riak
|
|
|
|
|
|
|
|
Almost there. Next, we add a hack to get us by the lack of
|
|
|
|
`initctl`:
|
|
|
|
|
|
|
|
# Hack for initctl
|
|
|
|
# See: https://github.com/dotcloud/docker/issues/1024
|
|
|
|
RUN dpkg-divert --local --rename --add /sbin/initctl
|
|
|
|
RUN ln -s /bin/true /sbin/initctl
|
|
|
|
|
|
|
|
Then, we expose the Riak Protocol Buffers and HTTP interfaces, along
|
|
|
|
with SSH:
|
|
|
|
|
|
|
|
# Expose Riak Protocol Buffers and HTTP interfaces, along with SSH
|
|
|
|
EXPOSE 8087 8098 22
|
|
|
|
|
|
|
|
Finally, run `supervisord` so that Riak and OpenSSH
|
|
|
|
are started:
|
|
|
|
|
|
|
|
CMD ["/usr/bin/supervisord"]
|
|
|
|
|
2014-04-23 20:48:28 +00:00
|
|
|
## Create a supervisord configuration file
|
2014-04-16 00:53:12 +00:00
|
|
|
|
|
|
|
Create an empty file called `supervisord.conf`. Make
|
2014-04-23 20:48:28 +00:00
|
|
|
sure it's at the same directory level as your Dockerfile:
|
2014-04-16 00:53:12 +00:00
|
|
|
|
|
|
|
touch supervisord.conf
|
|
|
|
|
|
|
|
Populate it with the following program definitions:
|
|
|
|
|
|
|
|
[supervisord]
|
|
|
|
nodaemon=true
|
|
|
|
|
|
|
|
[program:sshd]
|
|
|
|
command=/usr/sbin/sshd -D
|
|
|
|
stdout_logfile=/var/log/supervisor/%(program_name)s.log
|
|
|
|
stderr_logfile=/var/log/supervisor/%(program_name)s.log
|
|
|
|
autorestart=true
|
|
|
|
|
|
|
|
[program:riak]
|
|
|
|
command=bash -c ". /etc/default/riak && /usr/sbin/riak console"
|
|
|
|
pidfile=/var/log/riak/riak.pid
|
|
|
|
stdout_logfile=/var/log/supervisor/%(program_name)s.log
|
|
|
|
stderr_logfile=/var/log/supervisor/%(program_name)s.log
|
|
|
|
|
|
|
|
## Build the Docker image for Riak
|
|
|
|
|
|
|
|
Now you should be able to build a Docker image for Riak:
|
|
|
|
|
2014-05-01 14:13:34 +00:00
|
|
|
$ docker build -t "<yourname>/riak" .
|
2014-04-16 00:53:12 +00:00
|
|
|
|
|
|
|
## Next steps
|
|
|
|
|
|
|
|
Riak is a distributed database. Many production deployments consist of
|
2014-04-23 20:48:28 +00:00
|
|
|
[at least five nodes](
|
|
|
|
http://basho.com/why-your-riak-cluster-should-have-at-least-five-nodes/).
|
2014-04-16 00:53:12 +00:00
|
|
|
See the [docker-riak](https://github.com/hectcastro/docker-riak) project
|
|
|
|
details on how to deploy a Riak cluster using Docker and Pipework.
|