1
0
Fork 0
mirror of https://github.com/moby/moby.git synced 2022-11-09 12:21:53 -05:00
moby--moby/libnetwork
Alessandro Boch 0d3ad0eaee Control scope of JoinOption functions
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>
2015-04-30 10:49:31 -07:00
..
client libnetwork client base infra 2015-04-26 21:08:00 -07:00
cmd - Added support for Join/Leave methods to Endpoint. 2015-04-29 14:49:32 +00:00
driverapi - Added support for Join/Leave methods to Endpoint. 2015-04-29 14:49:32 +00:00
drivers Added null driver support for handling --net=none and -n=false cases 2015-04-30 05:56:59 +00:00
Godeps Updated Godeps 2015-04-30 06:32:52 +00:00
ipallocator Libnetwork refactor for container network model 2015-04-13 21:40:50 +00:00
netutils Enhance Endpoint interface 2015-04-20 03:21:01 -07:00
pkg fix some typos 2015-04-20 04:12:54 +00:00
portmapper fix some typos 2015-04-20 04:12:54 +00:00
sandbox - Added Join option support 2015-04-30 05:58:12 +00:00
test/integration Initial bats based integration tests for testing daemon network configs 2015-04-25 07:33:48 -07:00
types Refactor driverapi, sandbox pkgs 2015-04-21 09:44:39 -07:00
.gitignore Refactor driverapi, sandbox pkgs 2015-04-21 09:44:39 -07:00
circle.yml Report Code Coverage and Add Status Badges 2015-04-14 16:19:55 +01:00
controller.go Reorganized the libnetwork code to seperate Controller, Network and Endpoint 2015-04-30 01:25:01 +00:00
drivers.go Added null driver support for handling --net=none and -n=false cases 2015-04-30 05:56:59 +00:00
endpoint.go Control scope of JoinOption functions 2015-04-30 10:49:31 -07:00
error.go - Added support for Join/Leave methods to Endpoint. 2015-04-29 14:49:32 +00:00
libnetwork_test.go - Added Join option support 2015-04-30 05:58:12 +00:00
LICENSE Initial commit 2015-02-19 17:20:15 -08:00
MAINTAINERS Add MAINTAINERS 2015-04-01 14:43:06 +01:00
Makefile - Fixed the makefile which was not checking failures in test code 2015-04-16 19:00:36 +00:00
network.go Reorganized the libnetwork code to seperate Controller, Network and Endpoint 2015-04-30 01:25:01 +00:00
README.md - Added support for Join/Leave methods to Endpoint. 2015-04-29 14:49:32 +00:00
ROADMAP.md - Added support for Join/Leave methods to Endpoint. 2015-04-29 14:49:32 +00:00
system.go Remove golint warnings 2015-03-04 13:29:28 -08:00

libnetwork - networking for containers

Circle CI Coverage Status GoDoc

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.

Code and documentation copyright 2015 Docker, inc. Code released under the Apache 2.0 license. Docs released under Creative commons.