moby--moby/libnetwork
Alessandro Boch 421f6e0bf6 Merge pull request #1487 from mrjana/networkdb
Do not hold ack channel in ack table after closing
2016-10-03 11:44:42 -07:00
..
Godeps Godep changes. 2016-09-27 13:53:58 -07:00
api Fix test failures 2016-09-22 19:25:42 +00:00
bitseq Fix bitseq.SetAnyInRange 2016-09-13 11:52:12 -07:00
client Add mflag package locally to libnetwork 2016-09-07 13:47:32 -07:00
cluster Honor user provided listen address for gossip 2016-09-22 11:41:57 -07:00
cmd Make libnetwork understand pluginv2. 2016-09-27 15:29:10 -07:00
config Make libnetwork understand pluginv2. 2016-09-27 15:29:10 -07:00
datastore Merge pull request #1205 from allencloud/fix-typos 2016-08-01 09:49:31 -07:00
discoverapi Adding Advertise-addr support 2016-07-21 02:44:25 -07:00
docs Merge pull request #1205 from allencloud/fix-typos 2016-08-01 09:49:31 -07:00
driverapi Make libnetwork understand pluginv2. 2016-09-27 15:29:10 -07:00
drivers Merge pull request #1466 from rony36/master 2016-10-03 10:54:43 -07:00
drvregistry Make libnetwork understand pluginv2. 2016-09-27 15:29:10 -07:00
etchosts Fix file descriptor leaks 2016-07-01 16:29:51 -07:00
hostdiscovery Merge pull request #1205 from allencloud/fix-typos 2016-08-01 09:49:31 -07:00
idm
ipam IPAM allocator to not accept a datastore update if already present 2016-05-12 16:43:51 -07:00
ipamapi Make libnetwork understand pluginv2. 2016-09-27 15:29:10 -07:00
ipams Make libnetwork understand pluginv2. 2016-09-27 15:29:10 -07:00
ipamutils use grep to find a/an misuse 2016-06-03 16:35:33 +08:00
iptables modprobe when needed 2016-03-21 16:35:28 -07:00
ipvs Merge pull request #1205 from allencloud/fix-typos 2016-08-01 09:49:31 -07:00
netlabel DNS support 2016-09-20 13:02:02 -07:00
netutils Fix CircleCI 2016-08-30 12:23:19 -07:00
networkdb Do not hold ack channel in ack table after closing 2016-10-03 09:50:02 -07:00
ns Gracefully handle missing xfrm modules 2016-06-20 17:25:32 -07:00
options use grep to find a/an misuse 2016-06-03 16:35:33 +08:00
osl Ensure purging neighbor cache for stale deletes 2016-09-07 10:45:40 -07:00
portallocator
portmapper bridge,portmapper: custom docker-proxy path 2016-09-25 18:07:58 +02:00
resolvconf Remove all netlink/osl deps from ipam/ipamutils 2016-04-10 11:05:39 -07:00
test/integration Provide a way for libnetwork to make use of Agent mode functionalities 2016-06-05 18:41:21 -07:00
testutils Migrate libnetwork to use netlink.Handle 2016-06-08 21:05:36 -07:00
types Merge pull request #1205 from allencloud/fix-typos 2016-08-01 09:49:31 -07:00
.dockerignore
.gitignore
CHANGELOG.md Changelog for 0.8.0-dev.2 2016-05-07 11:16:00 -07:00
Dockerfile.build Switch to golang 1.5.4 2016-05-20 16:35:34 +02:00
LICENSE
MAINTAINERS
Makefile Make the docker proxy a standalone binary not a re-exec 2016-07-04 13:17:16 +01:00
README.md Add support to accepting arbitrary network ID 2016-04-15 12:34:21 -07:00
ROADMAP.md fix typos 2016-05-30 18:20:52 +08:00
Vagrantfile
agent.go Avoid returning early on agent join failures 2016-09-27 08:36:10 -07:00
agent.pb.go Add container short-id as an alias for swarm mode tasks 2016-08-02 20:28:33 -07:00
agent.proto Add container short-id as an alias for swarm mode tasks 2016-08-02 20:28:33 -07:00
circle.yml for fix CI tools/cmd/vet has been deleted 2016-05-24 17:41:41 +09:00
controller.go Clear ingress resources on graceful shutdown 2016-09-29 15:01:44 -07:00
default_gateway.go fix typo in comments and log 2016-07-30 02:21:10 +08:00
default_gateway_freebsd.go
default_gateway_linux.go Add support to accepting arbitrary network ID 2016-04-15 12:34:21 -07:00
default_gateway_solaris.go Get libnetwork to build on Solaris 2016-04-14 14:03:50 -07:00
default_gateway_windows.go
drivers_experimental_linux.go Moving MacVlan driver out of experimental 2016-06-13 22:42:20 -07:00
drivers_freebsd.go
drivers_ipam.go Moving IPAM initalization out of drvRegistry into libnetwork core 2016-07-05 16:42:34 -07:00
drivers_linux.go Moving MacVlan driver out of experimental 2016-06-13 22:42:20 -07:00
drivers_solaris.go Get libnetwork to build on Solaris 2016-04-14 14:03:50 -07:00
drivers_stub_linux.go
drivers_windows.go
endpoint.go DNS support 2016-09-20 13:02:02 -07:00
endpoint_cnt.go Fix endpoint cnt decline overflow 2016-07-14 22:52:44 -04:00
endpoint_info.go Ensure drivertable entries in joininfo is uptodate 2016-08-02 14:06:41 -07:00
error.go Provide a way for libnetwork to make use of Agent mode functionalities 2016-06-05 18:41:21 -07:00
errors_test.go
libnetwork_internal_test.go DNS support 2016-09-20 13:02:02 -07:00
libnetwork_test.go Merge pull request #1456 from AkihiroSuda/fix-test-failures 2016-09-22 13:19:06 -07:00
machines
network.go DNS support 2016-09-20 13:02:02 -07:00
network_unix.go DNS support 2016-09-20 13:02:02 -07:00
network_windows.go DNS support 2016-09-20 13:02:02 -07:00
resolver.go DNS support 2016-09-20 13:02:02 -07:00
resolver_unix.go DNS support 2016-09-20 13:02:02 -07:00
resolver_windows.go Move the iptables setup for embedded DNS into a reexec process 2016-04-15 23:37:20 -07:00
sandbox.go Check for ExecFunc failure 2016-09-21 13:53:08 -07:00
sandbox_dns_unix.go Check for ExecFunc failure 2016-09-21 13:53:08 -07:00
sandbox_dns_windows.go Add network restore to support docker live restore container 2016-06-13 23:48:00 -07:00
sandbox_externalkey.go
sandbox_externalkey_solaris.go Get libnetwork to build on Solaris 2016-04-14 14:03:50 -07:00
sandbox_externalkey_unix.go Moving the UDS file out of /var/lib/docker and into /run/ 2016-07-15 13:38:23 -07:00
sandbox_externalkey_windows.go
sandbox_store.go Better error handling in restoring sandbox states 2016-07-27 00:55:46 -07:00
sandbox_test.go Do not allow network creation if datastore is missing 2016-05-12 16:36:54 -07:00
service.go Cleanup service bindings when leaving cluster 2016-08-19 18:11:15 -07:00
service_linux.go Delay port redirect until packet reaches container 2016-09-21 16:11:36 -07:00
service_unsupported.go Merge pull request #1398 from sanimej/access 2016-08-30 23:06:12 +02:00
store.go Avoid k/v store endpoint update in swarm mode 2016-08-23 14:14:11 -07:00
store_test.go Migrate libnetwork to use netlink.Handle 2016-06-08 21:05:36 -07:00
support.sh Simple support script to gather libnetwork info 2016-08-23 14:19:33 -07:00
wrapmake.sh

README.md

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.

Design

Please refer to the design 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.

func main() {
	if reexec.Init() {
		return
	}

	// Select and configure the network driver
	networkType := "bridge"

	// Create a new controller instance
	driverOptions := options.Generic{}
	genericOption := make(map[string]interface{})
	genericOption[netlabel.GenericData] = driverOptions
	controller, err := libnetwork.New(config.OptionDriverConfig(networkType, genericOption))
	if err != nil {
		log.Fatalf("libnetwork.New: %s", err)
	}

	// Create a network for containers to join.
	// NewNetwork accepts Variadic optional arguments that libnetwork and Drivers can use.
	network, err := controller.NewNetwork(networkType, "network1", "")
	if err != nil {
		log.Fatalf("controller.NewNetwork: %s", err)
	}

	// 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. This info is contained or accessible
	// from the returned endpoint.
	ep, err := network.CreateEndpoint("Endpoint1")
	if err != nil {
		log.Fatalf("network.CreateEndpoint: %s", err)
	}

	// Create the sandbox for the container.
	// NewSandbox accepts Variadic optional arguments which libnetwork can use.
	sbx, err := controller.NewSandbox("container1",
		libnetwork.OptionHostname("test"),
		libnetwork.OptionDomainname("docker.io"))
	if err != nil {
		log.Fatalf("controller.NewSandbox: %s", err)
	}

	// A sandbox can join the endpoint via the join api.
	err = ep.Join(sbx)
	if err != nil {
		log.Fatalf("ep.Join: %s", err)
	}

	// libnetwork client can check the endpoint's operational data via the Info() API
	epInfo, err := ep.DriverInfo()
	if err != nil {
		log.Fatalf("ep.DriverInfo: %s", err)
	}

	macAddress, ok := epInfo[netlabel.MacAddress]
	if !ok {
		log.Fatalf("failed to get mac address from endpoint info")
	}

	fmt.Printf("Joined endpoint %s (%s) to sandbox %s (%s)\n", ep.Name(), macAddress, sbx.ContainerID(), sbx.Key())
}

Future

Please refer to roadmap for more information.

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.