sablier/plugins/caddy/README.md

Caddy Sablier Plugin

• Caddy Sablier Plugin
  • Build the custom Caddy image with Sablier middleware in it
    • By using the provided Dockerfile
    • By updating your Caddy Dockerfile
  • Configuration
    • Exemple with a minimal configuration
  • Running end to end tests

Build the custom Caddy image with Sablier middleware in it

In order to use the custom plugin for Caddy, you need to bundle it with Caddy. Here I'll show you two options with Docker.

By using the provided Dockerfile

docker build https://github.com/acouvreur/sablier.git#v1.8.0-beta.17:plugins/caddy 
  --build-arg=CADDY_VERSION=2.6.4
  -t caddy:2.6.4-with-sablier

Note: You can change main for any other branch (such as beta, or tags v1.8.0-beta.17)

By updating your Caddy Dockerfile

ARG CADDY_VERSION=2.6.4
FROM caddy:${CADDY_VERSION}-builder AS builder

ADD https://github.com/acouvreur/sablier.git#v1.8.0-beta.17 /sablier

RUN xcaddy build \
    --with github.com/acouvreur/sablier/plugins/caddy=/sablier/plugins/caddy

FROM caddy:${CADDY_VERSION}

COPY --from=builder /usr/bin/caddy /usr/bin/caddy

Configuration

You can have the following configuration:

:80 {
	route /my/route {
    sablier [<sablierURL>=http://sablier:10000] {
			[names container1,container2,...]
			[group mygroup]
			[session_duration 30m]
			dynamic {
				[display_name This is my display name]
				[show_details yes|true|on]
				[theme hacker-terminal]
				[refresh_frequency 2s]
			}
			blocking {
				[timeout 1m]
			}
		}
    reverse_proxy myservice:port
  }
}

Exemple with a minimal configuration

Almost all options are optional and you can setup very simple rules to use the server default values.

:80 {
	route /my/route {
    sablier {
			group mygroup
			dynamic
		}
    reverse_proxy myservice:port
  }
}

Running end to end tests

1. Build local sablier docker build -t caddy:local .
2. Build local caddy docker build -t acouvreur/sablier:local ../..
3. Run test cd e2e/docker && bash ./run.sh