2014-04-16 00:53:12 +00:00
|
|
|
page_title: Running a Redis service
|
|
|
|
page_description: Installing and running an redis service
|
|
|
|
page_keywords: docker, example, package installation, networking, redis
|
|
|
|
|
|
|
|
# Redis 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
|
|
|
|
|
|
|
Very simple, no frills, Redis service attached to a web application
|
|
|
|
using a link.
|
|
|
|
|
|
|
|
## Create a docker container for Redis
|
|
|
|
|
|
|
|
Firstly, we create a `Dockerfile` for our new Redis
|
|
|
|
image.
|
|
|
|
|
|
|
|
FROM ubuntu:12.10
|
|
|
|
RUN apt-get update
|
|
|
|
RUN apt-get -y install redis-server
|
|
|
|
EXPOSE 6379
|
|
|
|
ENTRYPOINT ["/usr/bin/redis-server"]
|
|
|
|
|
|
|
|
Next we build an image from our `Dockerfile`.
|
|
|
|
Replace `<your username>` with your own user name.
|
|
|
|
|
2014-05-01 14:13:34 +00:00
|
|
|
$ sudo docker build -t <your username>/redis .
|
2014-04-16 00:53:12 +00:00
|
|
|
|
|
|
|
## Run the service
|
|
|
|
|
2014-04-23 20:48:28 +00:00
|
|
|
Use the image we've just created and name your container `redis`.
|
2014-04-16 00:53:12 +00:00
|
|
|
|
2014-04-23 20:48:28 +00:00
|
|
|
Running the service with `-d` runs the container in detached mode, leaving
|
|
|
|
the container running in the background.
|
2014-04-16 00:53:12 +00:00
|
|
|
|
2014-04-23 20:48:28 +00:00
|
|
|
Importantly, we're not exposing any ports on our container. Instead
|
|
|
|
we're going to use a container link to provide access to our Redis
|
2014-04-16 00:53:12 +00:00
|
|
|
database.
|
|
|
|
|
2014-05-01 14:13:34 +00:00
|
|
|
$ sudo docker run --name redis -d <your username>/redis
|
2014-04-16 00:53:12 +00:00
|
|
|
|
|
|
|
## Create your web application container
|
|
|
|
|
2014-04-23 20:48:28 +00:00
|
|
|
Next we can create a container for our application. We're going to use
|
|
|
|
the `-link` flag to create a link to the `redis` container we've just
|
|
|
|
created with an alias of `db`. This will create a secure tunnel to the
|
|
|
|
`redis` container and expose the Redis instance running inside that
|
|
|
|
container to only this container.
|
2014-04-16 00:53:12 +00:00
|
|
|
|
2014-05-01 14:13:34 +00:00
|
|
|
$ sudo docker run --link redis:db -i -t ubuntu:12.10 /bin/bash
|
2014-04-16 00:53:12 +00:00
|
|
|
|
|
|
|
Once inside our freshly created container we need to install Redis to
|
|
|
|
get the `redis-cli` binary to test our connection.
|
|
|
|
|
2014-05-01 14:13:34 +00:00
|
|
|
$ apt-get update
|
|
|
|
$ apt-get -y install redis-server
|
|
|
|
$ service redis-server stop
|
2014-04-16 00:53:12 +00:00
|
|
|
|
2014-04-23 20:48:28 +00:00
|
|
|
As we've used the `--link redis:db` option, Docker
|
2014-04-16 00:53:12 +00:00
|
|
|
has created some environment variables in our web application container.
|
|
|
|
|
2014-05-01 14:13:34 +00:00
|
|
|
$ env | grep DB_
|
2014-04-16 00:53:12 +00:00
|
|
|
|
|
|
|
# Should return something similar to this with your values
|
|
|
|
DB_NAME=/violet_wolf/db
|
|
|
|
DB_PORT_6379_TCP_PORT=6379
|
|
|
|
DB_PORT=tcp://172.17.0.33:6379
|
|
|
|
DB_PORT_6379_TCP=tcp://172.17.0.33:6379
|
|
|
|
DB_PORT_6379_TCP_ADDR=172.17.0.33
|
|
|
|
DB_PORT_6379_TCP_PROTO=tcp
|
|
|
|
|
2014-04-23 20:48:28 +00:00
|
|
|
We can see that we've got a small list of environment variables prefixed
|
|
|
|
with `DB`. The `DB` comes from the link alias specified when we launched
|
|
|
|
the container. Let's use the `DB_PORT_6379_TCP_ADDR` variable to connect to
|
|
|
|
our Redis container.
|
2014-04-16 00:53:12 +00:00
|
|
|
|
2014-05-01 14:13:34 +00:00
|
|
|
$ redis-cli -h $DB_PORT_6379_TCP_ADDR
|
|
|
|
$ redis 172.17.0.33:6379>
|
|
|
|
$ redis 172.17.0.33:6379> set docker awesome
|
2014-04-16 00:53:12 +00:00
|
|
|
OK
|
2014-05-01 14:13:34 +00:00
|
|
|
$ redis 172.17.0.33:6379> get docker
|
2014-04-16 00:53:12 +00:00
|
|
|
"awesome"
|
2014-05-01 14:13:34 +00:00
|
|
|
$ redis 172.17.0.33:6379> exit
|
2014-04-16 00:53:12 +00:00
|
|
|
|
|
|
|
We could easily use this or other environment variables in our web
|
|
|
|
application to make a connection to our `redis`
|
|
|
|
container.
|