6568cef868
[kamal-proxy](https://github.com/basecamp/kamal-proxy) is a custom minimal proxy designed specifically for Kamal. It has some advantages over Traefik: 1. Imperative deployments - we tell it to switch from container A to container B, and it waits for container B to start then switches. No need to poll for health checks ourselves or mess around with forcing health checks to fail. 2. Support for multiple apps - as much as possible, configuration is supplied at runtime by the deploy command, allowing us to have multiple apps share a proxy without conflicting config. 3. First class support for Kamal operations - rather than trying to work out how to make Traefik do what we want, we can build features directly into the proxy, making configuration simpler and avoiding obscure errors
80 lines
2.0 KiB
Ruby
80 lines
2.0 KiB
Ruby
class Kamal::Commands::Proxy < Kamal::Commands::Base
|
|
delegate :argumentize, :optionize, to: Kamal::Utils
|
|
delegate :container_name, to: :proxy_config
|
|
|
|
attr_reader :proxy_config
|
|
|
|
def initialize(config)
|
|
super
|
|
@proxy_config = config.proxy
|
|
end
|
|
|
|
def run
|
|
docker :run,
|
|
"--name", container_name,
|
|
"--detach",
|
|
"--restart", "unless-stopped",
|
|
*proxy_config.publish_args,
|
|
"--volume", "/var/run/docker.sock:/var/run/docker.sock",
|
|
"--volume", "#{container_name}:/root/.config/kamal-proxy",
|
|
*config.logging_args,
|
|
*proxy_config.docker_options_args,
|
|
proxy_config.image
|
|
end
|
|
|
|
def start
|
|
docker :container, :start, container_name
|
|
end
|
|
|
|
def stop
|
|
docker :container, :stop, container_name
|
|
end
|
|
|
|
def start_or_run
|
|
combine start, run, by: "||"
|
|
end
|
|
|
|
def deploy(service, target:)
|
|
optionize({ target: target })
|
|
docker :exec, container_name, "kamal-proxy", :deploy, service, *optionize({ target: target }), *proxy_config.deploy_command_args
|
|
end
|
|
|
|
def remove(service, target:)
|
|
docker :exec, container_name, "kamal-proxy", :remove, service, *optionize({ target: target })
|
|
end
|
|
|
|
def info
|
|
docker :ps, "--filter", "name=^#{container_name}$"
|
|
end
|
|
|
|
def logs(since: nil, lines: nil, grep: nil)
|
|
pipe \
|
|
docker(:logs, container_name, (" --since #{since}" if since), (" --tail #{lines}" if lines), "--timestamps", "2>&1"),
|
|
("grep '#{grep}'" if grep)
|
|
end
|
|
|
|
def follow_logs(host:, grep: nil)
|
|
run_over_ssh pipe(
|
|
docker(:logs, container_name, "--timestamps", "--tail", "10", "--follow", "2>&1"),
|
|
(%(grep "#{grep}") if grep)
|
|
).join(" "), host: host
|
|
end
|
|
|
|
def remove_container
|
|
docker :container, :prune, "--force", "--filter", container_filter
|
|
end
|
|
|
|
def remove_image
|
|
docker :image, :prune, "--all", "--force", "--filter", image_filter
|
|
end
|
|
|
|
private
|
|
def container_filter
|
|
"label=org.opencontainers.image.title=kamal-proxy"
|
|
end
|
|
|
|
def image_filter
|
|
"label=org.opencontainers.image.title=kamal-proxy"
|
|
end
|
|
end
|