- [Make your own keepalived image](#make-your-own-keepalived-image)
- [Make your own keepalived image](#make-your-own-keepalived-image)
- [Tests](#tests)
- [Tests](#tests)
- [Under the hood: osixia/light-baseimage](#under-the-hood-osixialight-baseimage)
- [Under the hood: osixia/light-baseimage](#under-the-hood-osixialight-baseimage)
@@ -25,7 +33,7 @@ A docker image to run Keepalived.
This image require the kernel module ip_vs loaded on the host (`modprobe ip_vs`) and need to be run with : --cap-add=NET_ADMIN --net=host
This image require the kernel module ip_vs loaded on the host (`modprobe ip_vs`) and need to be run with : --cap-add=NET_ADMIN --net=host
docker run --cap-add=NET_ADMIN --net=host -d osixia/keepalived:0.2.0
docker run --cap-add=NET_ADMIN --net=host -d osixia/keepalived:0.2.2
## Beginner Guide
## Beginner Guide
@@ -35,10 +43,18 @@ but setting your own keepalived.conf is possible. 2 options:
- Link your config file at run time to `/container/service/keepalived/assets/keepalived.conf` :
- Link your config file at run time to `/container/service/keepalived/assets/keepalived.conf` :
docker run --volume /data/my-keepalived.conf:/container/service/keepalived/assets/keepalived.conf --detach osixia/keepalived:0.2.0
docker run --volume /data/my-keepalived.conf:/container/service/keepalived/assets/keepalived.conf --detach osixia/keepalived:0.2.2
- Add your config file by extending or cloning this image, please refer to the [Advanced User Guide](#advanced-user-guide)
- Add your config file by extending or cloning this image, please refer to the [Advanced User Guide](#advanced-user-guide)
### Fix docker mounted file problems
You may have some problems with mounted files on some systems. The startup script try to make some file adjustment and fix files owner and permissions, this can result in multiple errors. See [Docker documentation](https://docs.docker.com/v1.4/userguide/dockervolumes/#mount-a-host-file-as-a-data-volume).
To fix that run the container with `--copy-service` argument :
docker run [your options] osixia/keepalived:0.2.2 --copy-service
### Debug
### Debug
The container default log level is **info**.
The container default log level is **info**.
@@ -46,11 +62,11 @@ Available levels are: `none`, `error`, `warning`, `info`, `debug` and `trace`.
Example command to run the container in `debug` mode:
Example command to run the container in `debug` mode:
docker run --detach osixia/keepalived:0.2.0 --loglevel debug
docker run --detach osixia/keepalived:0.2.2 --loglevel debug
See all command line options:
See all command line options:
docker run osixia/keepalived:0.2.0 --help
docker run osixia/keepalived:0.2.2 --help
## Environment Variables
## Environment Variables
@@ -70,7 +86,7 @@ See how to [set your own environment variables](#set-your-own-environment-variab
If you want to set this variable at docker run command add the tag `#PYTHON2BASH:` and convert the yaml in python:
If you want to set this variable at docker run command add the tag `#PYTHON2BASH:` and convert the yaml in python:
docker run --env KEEPALIVED_UNICAST_PEERS="#PYTHON2BASH:['192.168.1.10', '192.168.1.11']" --detach osixia/keepalived:0.2.0
docker run --env KEEPALIVED_UNICAST_PEERS="#PYTHON2BASH:['192.168.1.10', '192.168.1.11']" --detach osixia/keepalived:0.2.2
To convert yaml to python online : http://yaml-online-parser.appspot.com/
To convert yaml to python online : http://yaml-online-parser.appspot.com/
@@ -86,25 +102,13 @@ See how to [set your own environment variables](#set-your-own-environment-variab
- **KEEPALIVED_COMMAND_LINE_ARGUMENTS** Keepalived command line arguments; Defaults to `--log-detail --dump-conf`
- **KEEPALIVED_COMMAND_LINE_ARGUMENTS** Keepalived command line arguments; Defaults to `--log-detail --dump-conf`
### Set environment variables at run time :
Environment variable can be set directly by adding the -e argument in the command line, for example :
docker run --env KEEPALIVED_INTERFACE="eno1" --env KEEPALIVED_PASSWORD="password!" \
@@ -112,7 +116,7 @@ Environment variables can be set by adding the --env argument in the command lin
For example if your environment file is in : /data/environment/my-env.yaml
For example if your environment file is in : /data/environment/my-env.yaml
docker run --volume /data/environment/my-env.yaml:/container/environment/01-custom/env.yaml \
docker run --volume /data/environment/my-env.yaml:/container/environment/01-custom/env.yaml \
--detach osixia/keepalived:0.2.0
--detach osixia/keepalived:0.2.2
Take care to link your environment file to `/container/environment/XX-somedir` (with XX < 99 so they will be processed before default environment files) and not directly to `/container/environment` because this directory contains predefined baseimage environment files to fix container environment (INITRD, LANG, LANGUAGE and LC_CTYPE).
Take care to link your environment file to `/container/environment/XX-somedir` (with XX < 99 so they will be processed before default environment files) and not directly to `/container/environment` because this directory contains predefined baseimage environment files to fix container environment (INITRD, LANG, LANGUAGE and LC_CTYPE).
@@ -122,13 +126,13 @@ This is the best solution if you have a private registry. Please refer to the [A
## Advanced User Guide
## Advanced User Guide
### Extend osixia/keepalived:0.2.0 image
### Extend osixia/keepalived:0.2.2 image
If you need to add your custom TLS certificate, bootstrap config or environment files the easiest way is to extends this image.
If you need to add your custom TLS certificate, bootstrap config or environment files the easiest way is to extends this image.
Blocking a user prevents them from interacting with repositories, such as opening or commenting on pull requests or issues. Learn more about blocking a user.
Bertrand Gouny
osixia
ofreax