40n8.me/baseimage-docker
1
0
Fork 0
mirror of /repos/baseimage-docker.git synced 2025-12-30 08:01:31 +01:00
Code Issues Releases Wiki Activity

Update README

Browse Source
This commit is contained in:
Hongli Lai (Phusion) 2013-11-12 12:37:16 +01:00
parent 16ccc1e40d
commit 0773820b7a
No known key found for this signature in database
GPG Key ID: 06A131094B6F4332
1 changed files with 29 additions and 1 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

30
README.md
View File

@ -7,7 +7,7 @@ Baseimage-docker is a [Docker](http://www.docker.io) image meant to serve as a g
* **Twitter**: https://twitter.com/phusion_nl
* **Blog**: http://blog.phusion.nl/
## Why should I use baseimage-docker?
### Why should I use baseimage-docker?
Why use baseimage-docker instead of doing everything yourself in Dockerfile?
@ -32,6 +32,14 @@ Why use baseimage-docker instead of doing everything yourself in Dockerfile?
Baseimage-docker is very lightweight: it only consumes 4 MB of memory.
## Inspecting baseimage-docker
To look around in the image, run:
docker run -rm -t -i phusion/baseimage bash -l
You don't have to download anything manually. The above command will automatically pull the baseimage-docker image from the Docker registry.
## Using baseimage-docker as base image
The image is called `phusion/baseimage`, and is available on the Docker registry.
@ -58,6 +66,26 @@ By default, it allows SSH access for the key in `image/insecure_key`. This makes
# Clean up APT when done.
RUN apt-get clean && rm -rf /var/lib/apt/lists/* /tmp/* /var/tmp/*
### Adding additional daemons
You can add additional daemons to the image by creating runit entries. You only have to write a small shell script which runs your daemon, and runit will keep it up and running for you, restarting it when it crashes, etc.
The shell script must be called `run`, must be executable, and is to be placed in the directory `/etc/services/<NAME>`.
Here's an example showing you how to a memached server runit entry can be made.
### In memcached.sh (make sure this file is chmod +x):
#!/bin/sh
# `chpst` is part of running. `chpst -u memcache` runs the given command
# as the user `memcache`. If you omit this, the command will be run as root.
exec chpst -u memcache /usr/bin/memcached >>/var/log/memcached.log 2>&1
### In Dockerfile:
RUN mkdir /etc/services/memcached
ADD redis.sh /etc/services/memcached/run
Note that the shell script must run the daemon **without letting it daemonize/fork it**. Usually, daemons provide a command line flag or a config file option for that.
## Building the image yourself
If for whatever reason you want to build the image yourself instead of downloading it from the Docker registry, follow these instructions.