From 7dc6d449bd716bcd9ca26f6a2be714c5bd75d738 Mon Sep 17 00:00:00 2001 From: Jose Diaz-Gonzalez Date: Fri, 24 Jun 2016 23:57:10 -0400 Subject: [PATCH] Minor re-ordering of commands to match our existing doc structure [ci skip] --- docs/proxy.md | 29 +++++++++++++---------------- 1 file changed, 13 insertions(+), 16 deletions(-) diff --git a/docs/proxy.md b/docs/proxy.md index 7b710aced..692cba32d 100644 --- a/docs/proxy.md +++ b/docs/proxy.md @@ -1,20 +1,24 @@ # Proxy plugin -As of dokku 0.5.0, the proxy functionality has been decoupled from the nginx-vhosts plugin into the proxy plugin. In the future this will allow other proxy software (HAProxy for example) to be used instead of nginx. +> New as of 0.5.0, Enhanced in 0.6.0 -As of dokku 0.6.0, Dokku also has the ability to map host ports to container ports. +``` +proxy Show proxy settings for app +proxy:disable Disable proxy for app +proxy:enable Enable proxy for app +proxy:ports List proxy port mappings for app +proxy:ports-add :: [::...] Set proxy port mappings for app +proxy:ports-clear Clear all proxy port mappings for app +proxy:ports-remove [|::...] Unset proxy port mappings for app +proxy:set Set proxy type for app +``` + +In Dokku 0.5.0, port proxying was decoupled from the `nginx-vhosts` plugin into the proxy plugin. Dokku 0.6.0 introduced the ability to map host ports to specific container ports. In the future this will allow other proxy software - such as HAProxy or Caddy - to be used in place of nginx. ## Container network interface binding > New as of 0.5.0 -``` -proxy Show proxy settings for app -proxy:disable Disable proxy for app -proxy:enable Enable proxy for app -proxy:set Set proxy type for app -``` - By default, the deployed docker container running your app's web process will bind to the internal docker network interface (i.e. `docker inspect --format '{{ .NetworkSettings.IPAddress }}' $CONTAINER_ID`). This behavior can be modified per app by disabling the proxy (i.e. `dokku proxy:disable `). In this case, the container will bind to an external interface (i.e. `0.0.0.0`) and your app container will be directly accessible by other hosts on your network. > If a proxy is disabled, dokku will bind your container's port to a random port on the host for every deploy, e.g. `0.0.0.0:32771->5000/tcp`. @@ -42,13 +46,6 @@ d6499edb0edb dokku/node-js-app:latest "/bin/bash -c '/star About a mi > New as of 0.6.0 -``` -proxy:ports List proxy port mappings for app -proxy:ports-add :: [::...] Set proxy port mappings for app -proxy:ports-clear Clear all proxy port mappings for app -proxy:ports-remove [|::...] Unset proxy port mappings for app -``` - You can now configure `host -> container` port mappings with the `proxy:ports-*` commands. This mapping is currently supported by the built-in nginx-vhosts plugin. ```shell