1
0
Fork 0
mirror of https://github.com/moby/moby.git synced 2022-11-09 12:21:53 -05:00
moby--moby/libnetwork
Jana Radhakrishnan b0d046a1af Remove all netlink/osl deps from ipam/ipamutils
Currently ipam/ipamutils has a bunch of dependencies
in osl and netlink which makes the ipam/ipamutils harder
to use independently with other applications. This PR
modularizes ipam/ipamutils into a standalone package
with no OS level dependencies.

Signed-off-by: Jana Radhakrishnan <mrjana@docker.com>
2016-04-10 11:05:39 -07:00
..
api Move exposed ports from Endpoint to Sandbox 2016-03-06 09:31:26 -08:00
bitseq Fix some typos in comments and strings 2016-03-01 16:45:14 +01:00
client Move exposed ports from Endpoint to Sandbox 2016-03-06 09:31:26 -08:00
cmd Remove all netlink/osl deps from ipam/ipamutils 2016-04-10 11:05:39 -07:00
config Allow to pass global datastore config 2016-02-17 13:13:58 -08:00
datastore Fix some typos. 2016-02-29 19:20:50 +08:00
discoverapi Fix some typos. 2016-02-29 19:20:50 +08:00
docs Use newly introduce plugins method to validate plugin response 2016-04-08 23:10:25 -07:00
driverapi Move exposed ports from Endpoint to Sandbox 2016-03-06 09:31:26 -08:00
drivers Remove all netlink/osl deps from ipam/ipamutils 2016-04-10 11:05:39 -07:00
etchosts Fix out of bound slice access in Delete() 2016-03-06 10:03:03 -08:00
Godeps Update Godeps 2016-04-08 12:58:08 -07:00
hostdiscovery Use gofmt with -s instead of goimports 2016-02-12 14:07:00 +01:00
idm Fix some typos. 2016-02-29 19:20:50 +08:00
ipam Remove all netlink/osl deps from ipam/ipamutils 2016-04-10 11:05:39 -07:00
ipamapi Add nil ipam driver 2016-03-02 10:55:38 +07:00
ipams Remove pre-defined networks from package init 2016-04-04 15:25:29 -04:00
ipamutils Remove all netlink/osl deps from ipam/ipamutils 2016-04-10 11:05:39 -07:00
iptables modprobe when needed 2016-03-21 16:35:28 -07:00
netlabel Handle datastore update in Ipam and overlay drivers 2016-02-16 13:49:49 -08:00
netutils Remove all netlink/osl deps from ipam/ipamutils 2016-04-10 11:05:39 -07:00
networkdb Add network scoped gossip database 2016-04-08 12:58:09 -07:00
ns
options
osl Remove all netlink/osl deps from ipam/ipamutils 2016-04-10 11:05:39 -07:00
portallocator
portmapper Use gofmt with -s instead of goimports 2016-02-12 14:07:00 +01:00
resolvconf Remove all netlink/osl deps from ipam/ipamutils 2016-04-10 11:05:39 -07:00
test/integration Fix when connecting/disconnecting to/from default gw network 2016-04-06 09:29:41 -07:00
testutils Fixed build tags for linux files 2016-02-17 11:45:51 -08:00
types Remove all netlink/osl deps from ipam/ipamutils 2016-04-10 11:05:39 -07:00
.dockerignore
.gitignore IPAM to run consistency check over its bitmasks 2016-01-14 08:26:14 -08:00
CHANGELOG.md Changelog for v0.7.0-dev.10 2016-03-19 07:05:45 -07:00
circle.yml
controller.go Reload config should initialize only the appropriate datastore 2016-03-25 01:10:03 -07:00
default_gateway.go Fix when connecting/disconnecting to/from default gw network 2016-04-06 09:29:41 -07:00
default_gateway_freebsd.go
default_gateway_linux.go Don't allow passing EnableIPv6 as a driver option (a label) 2016-01-30 16:01:29 +00:00
default_gateway_windows.go
Dockerfile.build tools/cmd/vet has been deleted and go tool vet works natively on 1.5+ 2016-04-08 16:33:39 +08:00
drivers.go Add nil ipam driver 2016-03-02 10:55:38 +07:00
drivers_experimental_linux.go Make macvlan and ipvlan drivers as experimental 2016-03-09 19:43:20 -05:00
drivers_freebsd.go
drivers_linux.go Make macvlan and ipvlan drivers as experimental 2016-03-09 19:43:20 -05:00
drivers_stub_linux.go Make macvlan and ipvlan drivers as experimental 2016-03-09 19:43:20 -05:00
drivers_windows.go Renaming driver name to lower case for usability and allowing portmapping to surface 2016-02-25 15:53:08 -08:00
endpoint.go Resolver sockets not flushed on default gw change 2016-04-10 10:40:06 -07:00
endpoint_cnt.go Fixing a possible endpoint_cnt state inconsistency issue 2016-03-15 21:07:42 -07:00
endpoint_info.go Force delete sandbox during sandboxCleanup 2016-01-17 14:47:49 -08:00
error.go
errors_test.go
libnetwork_internal_test.go Persist ipam driver options 2016-04-08 08:18:09 -07:00
libnetwork_test.go Avoid V6 queries in docker domain going to external nameservers 2016-03-19 03:07:08 -07:00
LICENSE
machines
MAINTAINERS Chen Chun as libnetwork maintainer 2016-02-22 09:26:08 -08:00
Makefile Make macvlan and ipvlan drivers as experimental 2016-03-09 19:43:20 -05:00
network.go Remove all netlink/osl deps from ipam/ipamutils 2016-04-10 11:05:39 -07:00
README.md Fix up example code 2015-12-23 11:47:14 -08:00
resolver.go Remove all netlink/osl deps from ipam/ipamutils 2016-04-10 11:05:39 -07:00
ROADMAP.md
sandbox.go Remove all netlink/osl deps from ipam/ipamutils 2016-04-10 11:05:39 -07:00
sandbox_dns_unix.go Remove all netlink/osl deps from ipam/ipamutils 2016-04-10 11:05:39 -07:00
sandbox_dns_windows.go Windows HNS integration 2016-02-12 15:01:37 -08:00
sandbox_externalkey.go
sandbox_externalkey_unix.go Fix netns path setting from hook 2016-03-16 07:57:27 -07:00
sandbox_externalkey_windows.go Fix netns path setting from hook 2016-03-16 07:57:27 -07:00
sandbox_store.go Log stale resource cleanup 2016-03-16 11:57:19 -07:00
sandbox_test.go expose Endpoints API for a Sandbox 2016-01-25 16:23:00 -08:00
store.go Reload config should initialize only the appropriate datastore 2016-03-25 01:10:03 -07:00
store_test.go
Vagrantfile
wrapmake.sh

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.