Warning libnetwork was moved to https://github.com/moby/moby/tree/master/libnetwork
libnetwork has been merged to the main repo of Moby since Docker 22.06.
The old libnetwork repo (https://github.com/moby/libnetwork) now only accepts PR for Docker 20.10, and will be archived after the EOL of Docker 20.10.
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.
Please refer to the design for more information.
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.
import ( "fmt""log""github.com/docker/docker/pkg/reexec""github.com/docker/libnetwork""github.com/docker/libnetwork/config""github.com/docker/libnetwork/netlabel""github.com/docker/libnetwork/options" ) funcmain(){ifreexec.Init(){return } // Select and configure the network drivernetworkType:="bridge"// Create a new controller instancedriverOptions:= options.Generic{} genericOption:=make(map[string]interface{}) genericOption[netlabel.GenericData] =driverOptionscontroller, err:=libnetwork.New(config.OptionDriverConfig(networkType, genericOption)) iferr!=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", "") iferr!=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") iferr!=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")) iferr!=nil{log.Fatalf("controller.NewSandbox: %s", err) } // A sandbox can join the endpoint via the join api.err=ep.Join(sbx) iferr!=nil{log.Fatalf("ep.Join: %s", err) } // libnetwork client can check the endpoint's operational data via the Info() APIepInfo, err:=ep.DriverInfo() iferr!=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()) }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.