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 28c2445dad Do not update /etc/hosts for empty endpoints
There is no need to update the /etc/hosts files
of containers for endpoints which are created/deleted
in a network whose interface list is empty

Signed-off-by: Jana Radhakrishnan <mrjana@docker.com>
2015-06-24 12:09:44 -07:00
..
api workaround to a minor bug in mux which filters out empty query 2015-06-15 01:25:45 -07:00
bitseq Fix datastore value handling in bitseq 2015-06-18 12:07:04 -07:00
client Fixed a basic UI regression due to a recent godep update 2015-06-15 20:19:29 -07:00
cmd Add ovrouter binary 2015-06-18 15:07:18 -07:00
config Few changes to the UI and API implementation 2015-06-14 21:57:18 -07:00
datastore Merge pull request #307 from mavenugo/delp 2015-06-17 17:42:16 -07:00
docs Merge pull request #260 from squaremo/now_with_more_semantics 2015-06-11 15:35:39 -07:00
driverapi Replacing isReservedNetwork with Driver capability 2015-06-10 23:59:38 -07:00
drivers Overlay driver 2015-06-18 15:06:24 -07:00
etchosts Do not update /etc/hosts for empty endpoints 2015-06-24 12:09:44 -07:00
Godeps Updated Godeps 2015-06-18 15:07:22 -07:00
hostdiscovery Reworked endpoint store operation to address a few cases 2015-06-10 23:59:29 -07:00
idm Fix datastore value handling in bitseq 2015-06-18 12:07:04 -07:00
ipallocator Simplify the code in the RegisterSubnet method of ipallocator. 2015-05-12 00:44:34 +00:00
ipam Add datastore to IPAM for configuration 2015-06-17 17:17:19 -07:00
iptables Fixed the tests. 2015-06-16 10:46:51 -07:00
netlabel Overlay driver 2015-06-18 15:06:24 -07:00
netutils Add serialize/deserialize for sequence list 2015-06-17 16:37:59 -07:00
options Remove pkg directory 2015-05-16 16:12:13 -07:00
portallocator Do not warn in packages 2015-06-02 15:11:32 -07:00
portmapper Add dummy proxy on port map 2015-05-22 12:38:28 -07:00
resolvconf Remove pkg directory 2015-05-16 16:12:13 -07:00
sandbox Fixing a windows compile error in docker during vendor-in 2015-06-21 02:32:07 -07:00
test/integration Initial bats based integration tests for testing daemon network configs 2015-04-25 07:33:48 -07:00
types Added a new RetryError to indicate the caller to possibly retry 2015-06-17 16:46:08 -07:00
.gitignore Create a build image to avoid install-deps every time 2015-05-11 21:17:12 +01:00
circle.yml Report Code Coverage and Add Status Badges 2015-04-14 16:19:55 +01:00
controller.go Add LeaveAll support 2015-06-19 18:55:26 -07:00
drivers_freebsd.go Replacing isReservedNetwork with Driver capability 2015-06-10 23:59:38 -07:00
drivers_linux.go Overlay driver 2015-06-18 15:06:24 -07:00
drivers_windows.go Replacing isReservedNetwork with Driver capability 2015-06-10 23:59:38 -07:00
endpoint.go Add LeaveAll support 2015-06-19 18:55:26 -07:00
endpoint_info.go Fix endpoint ip data-store sync issue 2015-06-18 19:07:00 -07:00
error.go Add LeaveAll support 2015-06-19 18:55:26 -07:00
errors_test.go Provide interface to categorize errors 2015-05-20 22:29:29 -07:00
libnetwork_internal_test.go Moved the TOML based Configuration to dnet 2015-06-12 12:46:12 -07:00
libnetwork_test.go Add LeaveAll support 2015-06-19 18:55:26 -07:00
LICENSE Initial commit 2015-02-19 17:20:15 -08:00
MAINTAINERS Add Alessandro as a libnetwork maintainer 2015-05-29 18:46:33 +00:00
Makefile Moved services to dnet top-level and removed experimental 2015-06-08 14:23:41 -07:00
network.go Do not update /etc/hosts for empty endpoints 2015-06-24 12:09:44 -07:00
README.md Moved the TOML based Configuration to dnet 2015-06-12 12:46:12 -07:00
ROADMAP.md Updated Design Document 2015-05-06 13:38:16 -07:00
sandboxdata.go removed a duplicate and incorrect unlock 2015-06-20 08:22:44 -07:00
sandboxdata_test.go Add LeaveAll support 2015-06-19 18:55:26 -07:00
store.go Ignoring locally scoped endpoints/networks from distributed delete 2015-06-19 13:34:16 -07: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.

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.

        // Create a new controller instance
        controller := libnetwork.New()

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

        driverOptions := options.Generic{}
        genericOption := make(map[string]interface{})
        genericOption[netlabel.GenericData] = driverOptions
        err := controller.ConfigureNetworkDriver(networkType, genericOption)
        if err != nil {
                return
        }

        // Create a network for containers to join.
        // NewNetwork accepts Variadic optional arguments that libnetwork and Drivers can make of
        network, err := controller.NewNetwork(networkType, "network1")
        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. This info is contained or accessible
        // from the returned endpoint.
        ep, err := network.CreateEndpoint("Endpoint1")
        if err != nil {
                return
        }

        // A container can join the endpoint by providing the container ID to the join
        // api.
        // Join acceps Variadic arguments which will be made use of by libnetwork and Drivers
        err = ep.Join("container1",
                libnetwork.JoinOptionHostname("test"),
                libnetwork.JoinOptionDomainname("docker.io"))
        if err != nil {
                return
        }

		// libentwork client can check the endpoint's operational data via the Info() API
		epInfo, err := ep.DriverInfo()
		mapData, ok := epInfo[netlabel.PortMap]
		if ok {
			portMapping, ok := mapData.([]netutils.PortBinding)
			if ok {
				fmt.Printf("Current port mapping for endpoint %s: %v", ep.Name(), portMapping)
			}
		}

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.

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.