This adds a docker remote API proxy to the weaveexec image. The proxy
has hooks for (post-) container start and (pre-) container create; the
former attaches a weave interface to a container given a WEAVE_CIDR
environment entry, and the latter adjusts the entrypoint of a container
to wait for the ethwe interface.
Notes:
None of the hooks need to inspect/change large bodies. In order to avoid
a crash when handling images larger than memory we need to ensure that
the entire request body is never loaded into memory (i.e. No
ioutils.ReadAll).
When proxying a raw-stream response, we can't use http.WriteHeader. It
sets the Transfer-Encoding to chunked, which will throw off the clients.
Instead we have to hijack the socket, and write out http status code
manually.
For chunked transfer-encodings, clients (docker-py) depend on each http
chunk containing exactly one JSON object. Therefore, we cannot re-chunk
the body, and have to pass it across verbatim.
Proxy needs to pass multi-cidrs separately when calling weave. Otherwise
they get smashed together on the command line, and the call fails.
When creating the image, if no entrypoint is specified on the container,
it should use the entrypoint of the image. Code for this is based on
powerstrip-weave.
We handle WEAVE_CIDR='' by acting like it is not set. The reason being,
that because WEAVE_CIDR is inherited from images (along with env vars),
setting it to blank is equivalent to unsetting it.
- add ToC and anchors for all headings
- move docker bridge settings into "How it works" - it's a rarely used
feature
- highlight a bunch of features, extracting them from obscurely titled
sub-sections of "manual usage"
- basic rendundancy
- adding/removing extra DNS entries
- service hot-swapping
- ability to retain entries for stopped containers
- using a different local domain
- rename remainder of "manual usage" section to "Using weaveDNS
without `weave run`"
- remove "Unregistering" section - it was out of date and is not
covered by the "add/remove" section
that existed because it was echoing a message to stdout, which it no
longer does.
As a result there is now no mention of the docker tcp host/port
outside config.sh.
Michael Bridgen