0d3ad0eaee
ISSUE: - JoinOption type takes the exported interface Endpoint as parameter. This does not allows libnetwork to control the setter functions which will be executed by processOptions(). Client can now craft any func (e Endpoint), pass it to Endpoint.Join() and have it executed. Beside the fact this allows the client to shot himself in the foot, there seem not to be a real need in having the JoinOption take the Endpoint interface as parameter. CHANGE: - Changing the JoinOption signature to take a pointer to the unexported endpoint structure. So now libnetwork is the only one that can define the Join() method's options setter functions via the self referenced JoinOption[...] functions. Signed-off-by: Alessandro Boch <aboch@docker.com> |
||
---|---|---|
.. | ||
client | ||
cmd | ||
driverapi | ||
drivers | ||
Godeps | ||
ipallocator | ||
netutils | ||
pkg | ||
portmapper | ||
sandbox | ||
test/integration | ||
types | ||
.gitignore | ||
circle.yml | ||
controller.go | ||
drivers.go | ||
endpoint.go | ||
error.go | ||
libnetwork_test.go | ||
LICENSE | ||
MAINTAINERS | ||
Makefile | ||
network.go | ||
README.md | ||
ROADMAP.md | ||
system.go |
libnetwork - networking for containers
Libnetwork provides a native Go implementation for connecting containers
The goal of libnetwork is to deliver a robust Container Network Model that provides a consistent programming interface and the required network abstractions for applications.
NOTE: libnetwork project is under heavy development and is not ready for general use.
Current Status
Please watch this space for updates on the progress.
Currently libnetwork is nothing more than an attempt to modularize the Docker platform's networking subsystem by moving it into libnetwork as a library.
Please refer to the roadmap for more information.
Using libnetwork
There are many networking solutions available to suit a broad range of use-cases. libnetwork uses a driver / plugin model to support all of these solutions while abstracting the complexity of the driver implementations by exposing a simple and consistent Network Model to users.
// Create a new controller instance
controller := libnetwork.New()
// This option is only needed for in-tree drivers. Plugins(in future) will get
// their options through plugin infrastructure.
option := options.Generic{}
err := controller.NewNetworkDriver("bridge", option)
if err != nil {
return
}
netOptions := options.Generic{}
// Create a network for containers to join.
network, err := controller.NewNetwork("bridge", "network1", netOptions)
if err != nil {
return
}
// For each new container: allocate IP and interfaces. The returned network
// settings will be used for container infos (inspect and such), as well as
// iptables rules for port publishing.
ep, err := network.CreateEndpoint("Endpoint1", nil)
if err != nil {
return
}
Future
See the roadmap.
Contributing
Want to hack on libnetwork? Docker's contributions guidelines apply.
Copyright and license
Code and documentation copyright 2015 Docker, inc. Code released under the Apache 2.0 license. Docs released under Creative commons.