1
0
Fork 0
mirror of https://github.com/moby/moby.git synced 2022-11-09 12:21:53 -05:00
moby--moby/libnetwork
Roman Volosatovs d7a2635537
libnetwork: make rejoin intervals configurable
This allows the rejoin intervals to be chosen according to the context
within which the component is used, and, in particular, this allows
lower intervals to be used within TestNetworkDBIslands test.

Signed-off-by: Roman Volosatovs <roman.volosatovs@docker.com>
2021-07-12 19:25:49 +02:00
..
api Fixup libnetwork lint errors 2021-06-01 23:48:32 +00:00
bitseq Fixup libnetwork lint errors 2021-06-01 23:48:32 +00:00
cluster
cmd Fix gosec complaints in libnetwork 2021-06-25 18:02:03 +02:00
config libnetwork: replace BurntSushi/toml with pelletier/go-toml 2021-06-05 00:53:49 +02:00
datastore Fixup libnetwork lint errors 2021-06-01 23:48:32 +00:00
diagnostic Fixup libnetwork lint errors 2021-06-01 23:48:32 +00:00
discoverapi
docs
driverapi Fixup libnetwork lint errors 2021-06-01 23:48:32 +00:00
drivers Fix gosec complaints in libnetwork 2021-06-25 18:02:03 +02:00
drvregistry Fixup libnetwork lint errors 2021-06-01 23:48:32 +00:00
etchosts Fixup libnetwork lint errors 2021-06-01 23:48:32 +00:00
hostdiscovery Fixup libnetwork lint errors 2021-06-01 23:48:32 +00:00
idm Fix libnetwork imports 2021-06-01 21:51:23 +00:00
internal Fix libnetwork imports 2021-06-01 21:51:23 +00:00
ipam Fixup libnetwork lint errors 2021-06-01 23:48:32 +00:00
ipamapi Fixup libnetwork lint errors 2021-06-01 23:48:32 +00:00
ipams Fixup libnetwork lint errors 2021-06-01 23:48:32 +00:00
ipamutils Fix libnetwork imports 2021-06-01 21:51:23 +00:00
iptables More libnetwork windows test fixes 2021-06-02 16:53:24 +00:00
netlabel Fix libnetwork imports 2021-06-01 21:51:23 +00:00
netutils netutils: minor cleanups 2021-06-17 10:49:48 +02:00
networkdb libnetwork: make rejoin intervals configurable 2021-07-12 19:25:49 +02:00
ns
options Fixup libnetwork lint errors 2021-06-01 23:48:32 +00:00
osl libnetwork: remove CircleCI config and code 2021-06-09 12:31:52 +02:00
portallocator portallocator: log instead of discard port-range failures 2021-06-10 10:52:59 +02:00
portmapper More libnetwork windows test fixes 2021-06-02 16:53:24 +00:00
resolvconf Fixup libnetwork lint errors 2021-06-01 23:48:32 +00:00
support Fixup libnetwork lint errors 2021-06-01 23:48:32 +00:00
test/integration libnetwork: remove CircleCI config and code 2021-06-09 12:31:52 +02:00
testutils libnetwork: remove CircleCI config and code 2021-06-09 12:31:52 +02:00
types Fix libnetwork imports 2021-06-01 21:51:23 +00:00
.dockerignore
.gitignore
agent.go Fixup libnetwork lint errors 2021-06-01 23:48:32 +00:00
agent.pb.go
agent.proto
CHANGELOG.md
controller.go Fixup libnetwork lint errors 2021-06-01 23:48:32 +00:00
default_gateway.go Fixup libnetwork lint errors 2021-06-01 23:48:32 +00:00
default_gateway_freebsd.go Fix libnetwork imports 2021-06-01 21:51:23 +00:00
default_gateway_linux.go Fix libnetwork imports 2021-06-01 21:51:23 +00:00
default_gateway_windows.go Fix libnetwork imports 2021-06-01 21:51:23 +00:00
drivers_freebsd.go Fix libnetwork imports 2021-06-01 21:51:23 +00:00
drivers_ipam.go Fix libnetwork imports 2021-06-01 21:51:23 +00:00
drivers_linux.go Fix libnetwork imports 2021-06-01 21:51:23 +00:00
drivers_windows.go Fix libnetwork imports 2021-06-01 21:51:23 +00:00
endpoint.go endpoint: remove redundant doUpdateHostsFile() function 2021-06-09 22:38:34 +02:00
endpoint_cnt.go Fix libnetwork imports 2021-06-01 21:51:23 +00:00
endpoint_info.go Fix gosec complaints in libnetwork 2021-06-25 18:02:03 +02:00
endpoint_info_unix.go
endpoint_info_windows.go
endpoint_test.go Fix libnetwork imports 2021-06-01 21:51:23 +00:00
error.go
errors_test.go Fix libnetwork imports 2021-06-01 21:51:23 +00:00
firewall_linux.go Fix libnetwork imports 2021-06-01 21:51:23 +00:00
firewall_linux_test.go Skip libnetwork integration tests on Windows 2021-06-02 16:53:29 +00:00
firewall_others.go
libnetwork_internal_test.go Skip libnetwork integration tests on Windows 2021-06-02 16:53:29 +00:00
libnetwork_linux_test.go Skip libnetwork integration tests on Windows 2021-06-02 16:53:29 +00:00
libnetwork_test.go Skip libnetwork integration tests on Windows 2021-06-02 16:53:29 +00:00
libnetwork_unix_test.go Fixup libnetwork lint errors 2021-06-01 23:48:32 +00:00
libnetwork_windows_test.go Skip libnetwork integration tests on Windows 2021-06-02 16:53:29 +00:00
network.go Fixup libnetwork lint errors 2021-06-01 23:48:32 +00:00
network_unix.go Fix libnetwork imports 2021-06-01 21:51:23 +00:00
network_windows.go Fix libnetwork imports 2021-06-01 21:51:23 +00:00
README.md libnetwork: remove CircleCI config and code 2021-06-09 12:31:52 +02:00
resolver.go Fix gosec complaints in libnetwork 2021-06-25 18:02:03 +02:00
resolver_test.go Skip libnetwork integration tests on Windows 2021-06-02 16:53:29 +00:00
resolver_unix.go Fix gosec complaints in libnetwork 2021-06-25 18:02:03 +02:00
resolver_windows.go
sandbox.go Fixup libnetwork lint errors 2021-06-01 23:48:32 +00:00
sandbox_dns_unix.go Fix gosec complaints in libnetwork 2021-06-25 18:02:03 +02:00
sandbox_dns_windows.go More libnetwork windows test fixes 2021-06-02 16:53:24 +00:00
sandbox_externalkey.go
sandbox_externalkey_unix.go Fixup libnetwork lint errors 2021-06-01 23:48:32 +00:00
sandbox_externalkey_windows.go Fix libnetwork imports 2021-06-01 21:51:23 +00:00
sandbox_store.go Fix libnetwork imports 2021-06-01 21:51:23 +00:00
sandbox_test.go Skip libnetwork integration tests on Windows 2021-06-02 16:53:29 +00:00
service.go Fix libnetwork imports 2021-06-01 21:51:23 +00:00
service_common.go Fixup libnetwork lint errors 2021-06-01 23:48:32 +00:00
service_common_test.go Skip libnetwork integration tests on Windows 2021-06-02 16:53:29 +00:00
service_linux.go Fix gosec complaints in libnetwork 2021-06-25 18:02:03 +02:00
service_unsupported.go
service_windows.go windows: remove redundant init() 2021-06-10 18:00:00 +02:00
store.go libnetwork: processEndpointCreate: Fix deadlock between getSvcRecords and processEndpointCreate 2021-06-29 08:07:14 +02:00
store_linux_test.go Fixup libnetwork lint errors 2021-06-01 23:48:32 +00:00
store_test.go Fixup libnetwork lint errors 2021-06-01 23:48:32 +00:00

libnetwork - networking for containers

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.

package main

import (
	"fmt"
	"log"

	"github.com/docker/docker/pkg/reexec"
	"github.com/docker/docker/libnetwork"
	"github.com/docker/docker/libnetwork/config"
	"github.com/docker/docker/libnetwork/netlabel"
	"github.com/docker/docker/libnetwork/options"
)

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())
}

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.