Skipper

A self configuring nginx built for docker-compose usage.

The Balance rules in detail:

Scheme: BALANCE_RULE_WEB=URI->URI<CONFIG.FILE

Example: BALANCE_RULE_WEB=http://localhost:8080->http://web<example.conf.erb

The first part until -> is the virtual host, nginx should listen on. In this case localhost:8080. After -> you can define your linked service which will probably scale up or down. Note: The web is a alias in the docker network, means it points to the service web.

< Means 'out of' a template. Mount advanced templates on /home/skipper/templates and reference them in the configuration.

Basic usage:

version: "3.3"
services:
skipper:
build:
context: .
image: paradoxxger/skipper:v0.0.1
environment:
- BALANCE_RULE_WEB=http://localhost:8080->http://web<example.conf.erb
- BALANCE_RULE_WEB2=http://localhost:8081->http://web2<advanced.conf.erb
- INTERVAL=60
volumes:
- ./advanced.conf.erb:/home/skipper/templates/advanced.conf.erb
networks:
frontend:
aliases:
- auto-pilot
ports:
- 8080:8080
- 8081:8081
web:
image: nginx:1.13.7
networks:
frontend:
aliases:
- web
web2:
image: nginx:1.13.7
networks:
frontend:
aliases:
- web2
networks:
frontend:

If you run this compose, you should be able to access localhost:8080 and localhost:8081.

Now, scale your services and watch skipper creating new config files and gracefully reloading nginx.

docker-compose scale web=5

Todo:

• Add support for multiple locations per configuration