- Notifications
You must be signed in to change notification settings - Fork881
moby/libnetwork
Folders and files
Name | Name | Last commit message | Last commit date | |
---|---|---|---|---|
Repository files navigation
Warninglibnetwork was moved tohttps://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 thedesign 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.
About
networking for containers
Resources
License
Uh oh!
There was an error while loading.Please reload this page.
Stars
Watchers
Forks
Packages0
Uh oh!
There was an error while loading.Please reload this page.