mirror of
https://github.com/moby/moby.git
synced 2022-11-09 12:21:53 -05:00
29d01b7dde
We now advise people to configure docker group and add to sudo. Mac shouldn't use sudo. Removed sudo from command examples. Left in installation to be removed in installation doc sweep -- removing requires finer grain control. Signed-off-by: Mary Anthony <mary@docker.com>
112 lines
3.3 KiB
Markdown
112 lines
3.3 KiB
Markdown
page_title: Dockerizing a Riak service
|
|
page_description: Build a Docker image with Riak pre-installed
|
|
page_keywords: docker, example, package installation, networking, riak
|
|
|
|
# Dockerizing a Riak Service
|
|
|
|
The goal of this example is to show you how to build a Docker image with
|
|
Riak pre-installed.
|
|
|
|
## Creating a Dockerfile
|
|
|
|
Create an empty file called `Dockerfile`:
|
|
|
|
$ touch Dockerfile
|
|
|
|
Next, define the parent image you want to use to build your image on top
|
|
of. We'll use [Ubuntu](https://registry.hub.docker.com/_/ubuntu/) (tag:
|
|
`latest`), which is available on [Docker Hub](https://hub.docker.com):
|
|
|
|
# Riak
|
|
#
|
|
# VERSION 0.1.0
|
|
|
|
# Use the Ubuntu base image provided by dotCloud
|
|
FROM ubuntu:latest
|
|
MAINTAINER Hector Castro hector@basho.com
|
|
|
|
After that, we install and setup a few dependencies:
|
|
|
|
- `curl` is used to download Basho's APT
|
|
repository key
|
|
- `lsb-release` helps us derive the Ubuntu release
|
|
codename
|
|
- `openssh-server` allows us to login to
|
|
containers remotely and join Riak nodes to form a cluster
|
|
- `supervisor` is used manage the OpenSSH and Riak
|
|
processes
|
|
|
|
<!-- -->
|
|
|
|
# Install and setup project dependencies
|
|
RUN apt-get update && 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
|
|
|
|
COPY supervisord.conf /etc/supervisor/conf.d/supervisord.conf
|
|
|
|
RUN echo 'root:basho' | chpasswd
|
|
|
|
Next, we add Basho's APT repository:
|
|
|
|
RUN curl -sSL 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
|
|
|
|
After that, we install Riak and alter a few defaults:
|
|
|
|
# Install Riak and prepare it to run
|
|
RUN apt-get update && 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
|
|
|
|
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"]
|
|
|
|
## Create a supervisord configuration file
|
|
|
|
Create an empty file called `supervisord.conf`. Make
|
|
sure it's at the same directory level as your `Dockerfile`:
|
|
|
|
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:
|
|
|
|
$ docker build -t "<yourname>/riak" .
|
|
|
|
## Next steps
|
|
|
|
Riak is a distributed database. Many production deployments consist of
|
|
[at least five nodes](
|
|
http://basho.com/why-your-riak-cluster-should-have-at-least-five-nodes/).
|
|
See the [docker-riak](https://github.com/hectcastro/docker-riak) project
|
|
details on how to deploy a Riak cluster using Docker and Pipework.
|