|
1 | 1 | # Supported tags and respective `Dockerfile` links |
2 | 2 |
|
3 | | -- [`3.3.0`, `s6-3.3.0`, `3.3`, `s6-3.3`](https://github.com/haproxytech/haproxy-docker-ubuntu/blob/main/3.3/Dockerfile) |
4 | | -- [`3.2.9`, `s6-3.2.9`, `3.2`, `s6-3.2`, `latest`](https://github.com/haproxytech/haproxy-docker-ubuntu/blob/main/3.2/Dockerfile) |
| 3 | +- [`3.4-dev0`, `s6-3.4-dev0`, `3.4`, `s6-3.4`](https://github.com/haproxytech/haproxy-docker-ubuntu/blob/main/3.4/Dockerfile) |
| 4 | +- [`3.3.0`, `s6-3.3.0`, `3.3`, `s6-3.3`, `latest`](https://github.com/haproxytech/haproxy-docker-ubuntu/blob/main/3.3/Dockerfile) |
| 5 | +- [`3.2.9`, `s6-3.2.9`, `3.2`, `s6-3.2`](https://github.com/haproxytech/haproxy-docker-ubuntu/blob/main/3.2/Dockerfile) |
5 | 6 | - [`3.1.10`, `s6-3.1.10`, `3.1`, `s6-3.1`](https://github.com/haproxytech/haproxy-docker-ubuntu/blob/main/3.1/Dockerfile) |
6 | 7 | - [`3.0.12`, `s6-3.0.12`, `3.0`, `s6-3.0`](https://github.com/haproxytech/haproxy-docker-ubuntu/blob/main/3.0/Dockerfile) |
7 | 8 | - [`2.8.16`, `s6-2.8.16`, `2.8`, `s6-2.8`](https://github.com/haproxytech/haproxy-docker-ubuntu/blob/main/2.8/Dockerfile) |
@@ -97,29 +98,7 @@ $ docker kill -s USR2 my-running-haproxy |
97 | 98 |
|
98 | 99 | ## Enable Data Plane API |
99 | 100 |
|
100 | | -[Data Plane API](https://www.haproxy.com/documentation/hapee/2-7r1/api/data-plane-api/) sidecar is being distributed by default in all 2.0+ images and to enable it there are a few steps required: |
101 | | - |
102 | | -1. define one or more users through `userlist` |
103 | | -2. enable dataplane api process through `program api` |
104 | | -3. enable haproxy.cfg to be read/write mounted in Docker, either by defining volume being r/w or by rebuilding image with your own haproxy.cfg |
105 | | -4. expose dataplane TCP port in Docker with `--expose` |
106 | | - |
107 | | -Relevant part of haproxy.cfg is below: |
108 | | - |
109 | | -``` |
110 | | -userlist haproxy-dataplaneapi |
111 | | - user admin insecure-password mypassword |
112 | | -
|
113 | | -program api |
114 | | - command /usr/bin/dataplaneapi --host 0.0.0.0 --port 5555 --haproxy-bin /usr/sbin/haproxy --config-file /usr/local/etc/haproxy/haproxy.cfg --reload-cmd "kill -SIGUSR2 1" --restart-cmd "kill -SIGUSR2 1" --reload-delay 5 --userlist haproxy-dataplaneapi |
115 | | - no option start-on-reload |
116 | | -``` |
117 | | - |
118 | | -To run such image we would use the following command (note that volume containing haproxy.cfg is mounted r/w and port tcp/5555 is being exposed): |
119 | | - |
120 | | -```console |
121 | | -$ docker run -d --name my-running-haproxy --expose 5555 -v /path/to/etc/haproxy:/usr/local/etc/haproxy:rw haproxytech/haproxy-ubuntu |
122 | | -``` |
| 101 | +To use Data Plane API it is easiest to use s6-tagged images which all have Data Plane API running by default. |
123 | 102 |
|
124 | 103 | # License |
125 | 104 |
|
|
0 commit comments