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